Command Script Editor Panel

Summary

This panel displays a log of commands issued during the current Maestro session, and permits editing of those commands to create a script that can then be run to recreate the operations represented by the commands. A limit on the number of commands stored can be set in the General - History tab of the Preferences panel.

Opening the Command Script Editor Panel

To open the Command Script Editor panel, you can:

Command Script Editor Panel Features

Command History list

At the top of the Command Script Editor panel is the Command history list, which displays a log of commands issued during the current Maestro session. You can select commands by clicking on them.

Select All and Deselect All buttons

Entries in the Command history list can be selected and incorporated into script files, or scripts—groups of commands that perform specified operations.

To select all items in the list, click Select All. To deselect all the commands, click Deselect All. You can also select multiple entries with the usual shift-click and control-click actions.

Copy Selection to Script button

Copy the selected commands from the Command history list to the Script area in the lower part of the panel. Multiple selections can be made from the list, and the selections need not be contiguous.

If the copy operation takes more than a second or so, a progress dialog box is displayed. You can cancel the operation in this dialog box.

Copy Selection for Python button

Copy the current selection of commands in the command history list onto the clipboard as Python commands. Multiple selections can be made from the list, and the selections need not be contiguous.

Each Maestro command is wrapped as

maestro.command('maestro-command')

so you can paste it directly into another location, such as the Python Shell panel.

Log commands option

Usually, all Maestro commands are logged and displayed in the Command history list. If you wish to prevent the logging of commands to the list at any time during a session, deselect the Log Commands option.

Deselecting Log commands does not affect the saving of commands to a log file. For more information on saving log files, see the Quit Panel topic.

Hide transformation commands option

This option prevents Workspace transformation (rotation, translation, zoom) commands from being logged in the Command history list. If you want to include transformation commands in the Command history list, deselect this option.

Script text area

The Script text area is an editable area in which you can make changes to the script.

Run Script button

Clicking this button executes the command series that currently appears in the Script text area.

If the execution takes more than a second or so, a progress dialog box is displayed. You can stop the script in this dialog box.

Stop Script button

This button interrupts the execution of a command script.

Expand Command Aliases button

Command aliases are not permitted in command scripts. To locate and expand out any aliases that might be present in the current command script, click this button.

Open Local button

This button allows you to open a command script in the current working directory and read its contents into the Script text area.

Open Global button

The Maestro installation includes some "standard" command scripts. Clicking Open Global allows you to select one to read in. The files are located in the directory

$SCHRODINGER/maestro-vversion/data/res/
Save As button

The commands currently displayed in the Script text area can be saved to a file for later execution or editing. Click Save As to save the current command script to a file. A file selector panel opens, in which you can navigate to the desired location and name the file. Note that the .cmd suffix should be used when saving Maestro command script files.

Related Topics


Legal Notice

File: window_menu/cse_panel.html
Last updated: 19 Jun 2014