Control File Editor
Control file editors provide special features for BGMN *.sav, *.str, and *.lst files.
Context help
Placing the cursor on a keyword automatically displays the corresponding BGMN help text in the Context Help module.
If the module is not shown, it must be opened manually from the "Window -> Context Help" menu.
Mouse context menu
Right-clicking the mouse (Ctrl-click on Mac OS) opens a context menu. The actions presented in the menu are dependent of the type of file loaded in the editor, as well as on the keyword under the cursor at the time of opening the menu.
Generic actions
Generic text editing actions are available for all types of files and are independent of the keyword under the cursor:
- Undo: Undoes the last action
- Redo: Redoes the last undone action
- Cut: Cuts the selected text and stores it in the clipboard
- Copy: Copies the selected text to the clipboard
- Paste: Pastes the text in the clipboard
- Delete: Deletes the selected text
- Select all: Selects all text in the document
- Show context help: Displays this help text
Refinement control files (*.sav)
Generic control file actions:
- Comment line: Prepends a comment sign (%) to the line
- Uncomment line: Removes a leading comment sign (%) from the line
File actions:
- Open file as text: Opens the text file under the cursor in a new editor. Available for STRUC, VAL, LIST, OUTPUT, DIAGRAMM, STRUCOUT, SimpleSTRUCOUT, PDBOUT, RESOUT, FCFOUT, UNT, and UNTC files.
- Open file as graph: Opens the file under the cursor as a graph in a new project. Available for VAL, DIAGRAMM, UNT, and UNTC files.
Toggle actions:
- Set to disabled: Sets the value of the parameter to N. Available for PROTOKOLL, SAVE, DDM.
- Set to enabled: Sets the value of the parameter to Y. Available for PROTOKOLL, SAVE, DDM.
Numeric value:
- Decrease value: Decreases the value of the parameter by 1. Available for WMIN, WMAX, RU, NTHREADS.
- Increase value: Increases the value of the parameter by 1. Available for WMIN, WMAX, RU, NTHREADS.
Refinement state:
- Refine parameter: Sets the parameter to refined and adjusts the parameter numbering in the entire file. Available for EPS1, EPS2, EPS3, EPS4.
- Fix parameter: Sets the parameter to fixed and adjusts the parameter numbering in the entire file. Available for EPS1, EPS2, EPS3, EPS4.
Output files:
Adding output files is only available on STRUC keywords. The file name of the output file is composed of the file name of the STRUC file and the
project name. This avoids overwriting output files generated by other projects in the same directory.
The parameter number of the output file is identical to the number of the STRUC keyword.
- Add STRUCOUT file: Adds a *.str output file for BGMN with the refined parameters as default values.
- Add SimpleSTRUCOUT file: Adds a *.str output file for BGMN that contains a list of structure factors F<hkl> but no atomic positions.
- Add RESOUT and FCFOUT file: Adds a *.res and an *.fcf output file. The *.res file contains refined atomic coordinates in ShelX format. The *.fcf file
contains observed and calculated structure amplitudes |F| and phase angles in ShelX format. Both files are required to generate electron density maps
in Profex.
- Add PDBOUT file: Adds a *.pdb output file that contains the refined atomic coordinates in PDB (protein database) format.
LAMBDA:
- On the LAMBDA keyword, all available *.lam files are listed in the context menu to change the value of the LAMBDA parameter.
Structure files (*.str)
Generic structure file actions:
- Comment line: Prepends a comment sign (//) to the line
- Uncomment line: Removes a leading comment sign (//) from the line
- Refine all fractional coordinates: Sets all fractional coordinates (x, y, z) to refined.
- Fix all fractional coordinates: Fixes all fractional coordinates (x, y, z)
- Refine all TDS: Sets all fixed TDS to refined isotropically. Anisotropic TDS are ignored.
- Fix all TDS: Sets all isotropically refined TDS to fixed. Anisotropic TDS are ignored.
Numeric value:
- Increase value: Increases the value of the parameter by 1 (by 2 for SPHAR). Available for RP, LeBail, SPHAR.
- Decrease value: Decreases the value of the parameter by 1 (by 2 for SPHAR). Available for RP, LeBail, SPHAR.
Refinement state:
- Refine parameter: Sets the parameter under the mouse cursor to refined. Available for A, B, C, ALPHA, BETA, GAMMA, k1, B2, x, y, z.
- Refine isotropically: Sets the parameter under the mouse cursor to refined isotropically. Available for B1, k2, TDS.
- Refine anisotropically: Sets the parameter under the mouse cursor to refined anisotropically. Available for B1, k2, TDS.
- Fix parameter: Sets the parameter under the mouse cursor to fixed. Available for A, B, C, ALPHA, BETA, GAMMA, k1, k2, B1, B2, x, y, z, TDS.
Substitutions:
- Add substitution: Changes a
E=<element>
declaration to E=(<element>(p),XX(1-p)) PARAM=p=0_0^1
to
refine a substitution. The second scattering factor XX must be replaced manually by an existing scattering factor symbol. Available for E.
- Remove substitution: Changes a
E=(<element>(p),<element>(1-p)) PARAM=p=0_0^1
statement to E=<element>
.
The second scattering factor is discarded. Available for E.
Syntax highlighting
Syntax highlighting is used to assist editing the files by displaying comment lines, parameters, keywords, and values in different colors.
Spell checking
The spell checker marks illegal space characters by a red underline.