The Procedure file edit form

Spire can present a Procedure file in a graphical form, with entry boxes for the user to enter or verify values. This only works if the Procedure file has a proper Procedure file header. If your Procedure file does not have a properly written header, Spire will try to inform you about errors it encountered. After making the desired changes to the form, and hitting the Save button, Spire will write the new values into the procedure file.

Below is a Procedure header that produces the form on the right. Note the three sections for Registers, Input files, Output files (you can have as many filename sections as you want, but only one register section).

x91 = 1 ; The first particle number x87 = 2 ; Overview number x59 = 0.75 ; Peak separation distance ; ----------- Input files -------------- FR G [params]../params ; Parameter file FR G [filenums]../filenums ; File numbers FR G [mic]../Micrographs/mic{****x55} ; Micrographs FR G [refvol]../reference_volume ; Reference volume FR G [noise]./noise ; Noise file ; ----------- Output files -------------- FR G [ser]win/ser ; Template for particle images FR G [sndc]coords/sndc{****x55} ; Coordinate doc files ; -------------- END Procedure HEADER ---------------

Sections: each section must begin with a comment line that has text enclosed in a row of minus signs, such as
; ------ Input files -----
Sections are outlined in the form with the section heading in the upper left corner.

Registers: the comment is used as a label, the register's value appears in the entry box.
Only assignments of the form X11 = 1.234 are acceptable, with a floating point number on the right side of the equal sign. Assignments that are functions of already set registers (e.g., X22 = X11 + 1) are not shown in the form.

Filename sections: the comment appears as a button label, the symbolic parameter's text value appears in the entry box.
The button label, when pressed, allows the user to browse for a file.
Note: this replaces a relative path name with the full absolute file path name in the Procedure file, e.g. ../filenums.hcc can become /usr13/bbaxter/projects/hcc/filenums.hcc (see below).

Be careful of Procedure files that have template file names, e.g., win/ser will be expanded by SPIDER to win/ser000066. In this case you do not want to replace the text with a specific file name.
If the filename includes SPIDER's file numbering convention (e.g., mic{****x11}) Spire will attempt to keep the register in the filename.

• Save: write the values currently in the Procedure form into the Procedure file.
• Save as: write the current values into a Procedure file with a new name.
• Editor: open up the Procedure file in a text editor (specified in the Options menu - under Preferences). Important! If you make changes in a text editor, exit the Procedure form via the Cancel button, or else Spire will not save the changes you want
• Execute!: close the window and run the Procedure file in SPIDER. (Same as running it from a Dialog.)
• Cancel: close the window without making any changes to the Procedure file text.