1,330
edits
SHELXL: Difference between revisions
Jump to navigation
Jump to search
add PDB2INS; add Lübben reference; remove outdated compilation hints for Mac
(add PDB2INS; add Lübben reference; remove outdated compilation hints for Mac) |
|||
| Line 10: | Line 10: | ||
== Input files for SHELXL == | == Input files for SHELXL == | ||
SHELXL usually requires two input files: an .ins file containing crystal data, instructions and atoms, and an .hkl file containing h, k, l, F<sup>2</sup> and σ(F<sup>2</sup>) in fixed ‘HKLF 4’ format [alternatively F and σ(F) may input; this requires the instruction ‘HKLF 3’]. The .ins file will usually be generated from a PDB format file using the ‘I’ option in SHELXPRO. This sets up the TITL...UNIT instructions followed by standard refinement instructions, restraints, instructions for generating hydrogen atoms (commented out until needed) and atoms in '''''crystal coordinates'''''. For residues other than the 20 standard amino-acids, suitable restraints (see below) must be added by hand (see below). The ‘I’ option in SHELXPRO provides a way of renumbering the residues; since SHELXL does not (currently) recognize chain identifiers, chains must be emulated by (for example) adding 1000, 2000 etc. to the residue numbers. SHELXPRO can also perform the reverse operation when preparing a PDB file for deposition (the ‘B’ option). After each refinement job, the output .res file is edited or renamed to a new .ins file that serves as the input for the next refinement job. The updating of the .res file to .ins may also be performed by ‘U’ option in SHELXPRO; do not use the "I" option and the .pdb file for this, because all the special instructions in the .ins file will be lost.<br> | SHELXL usually requires two input files: an .ins file containing crystal data, instructions and atoms, and an .hkl file containing h, k, l, F<sup>2</sup> and σ(F<sup>2</sup>) in fixed ‘HKLF 4’ format [alternatively F and σ(F) may input; this requires the instruction ‘HKLF 3’]. | ||
Until 2019, the following text held: ''The .ins file will usually be generated from a PDB format file using the ‘I’ option in SHELXPRO. This sets up the TITL...UNIT instructions followed by standard refinement instructions, restraints, instructions for generating hydrogen atoms (commented out until needed) and atoms in '''''crystal coordinates'''''. For residues other than the 20 standard amino-acids, suitable restraints (see below) must be added by hand (see below). The ‘I’ option in SHELXPRO provides a way of renumbering the residues; since SHELXL does not (currently) recognize chain identifiers, chains must be emulated by (for example) adding 1000, 2000 etc. to the residue numbers. SHELXPRO can also perform the reverse operation when preparing a PDB file for deposition (the ‘B’ option). After each refinement job, the output .res file is edited or renamed to a new .ins file that serves as the input for the next refinement job. The updating of the .res file to .ins may also be performed by ‘U’ option in SHELXPRO; do not use the "I" option and the .pdb file for this, because all the special instructions in the .ins file will be lost.''<br> | |||
Since 2019, the .ins file should be produced by PDB2INS (Lübben and Sheldrick, 2019). | |||
The .hkl file contains the reflection intensity data. It is not necessary to sort the data, eliminate systematic absences or merge equivalents, SHELXL can do this anyway. If it is desired to refine (using complex scattering factors) against separate F<sup>2</sup>-values for h,k,l and –h,-k,-l some care is needed; there are problems using data processing software (such as CCP4) that does not keep these measurements separate, and ‘MERG 2’ must be specified in the .ins file to prevent SHELXL from merging the Friedel opposites (and setting all f” values to zero). A further problem on continuing a refinement started with another program is to ensure consistent flagging of the free-R reflections. For this reason it is strongly recommended that Tim Grüne's program [[mtz2hkl]] is used for this conversion. The Bruker [[XPREP]] program provides general facilities for setting Rfree flags and for transferring and extending free-R flags consistently from one reflection file to another taking space group symmetry into account. When twinning or NCS are present, it is better to flag thin resolution shells, otherwise random reflections should be flagged.<br> | The .hkl file contains the reflection intensity data. It is not necessary to sort the data, eliminate systematic absences or merge equivalents, SHELXL can do this anyway. If it is desired to refine (using complex scattering factors) against separate F<sup>2</sup>-values for h,k,l and –h,-k,-l some care is needed; there are problems using data processing software (such as CCP4) that does not keep these measurements separate, and ‘MERG 2’ must be specified in the .ins file to prevent SHELXL from merging the Friedel opposites (and setting all f” values to zero). A further problem on continuing a refinement started with another program is to ensure consistent flagging of the free-R reflections. For this reason it is strongly recommended that Tim Grüne's program [[mtz2hkl]] is used for this conversion. The Bruker [[XPREP]] program provides general facilities for setting Rfree flags and for transferring and extending free-R flags consistently from one reflection file to another taking space group symmetry into account. When twinning or NCS are present, it is better to flag thin resolution shells, otherwise random reflections should be flagged.<br> | ||
| Line 156: | Line 160: | ||
SHELXC/D/E and test data may be downloaded from the SHELX fileserver. Users should register online at http://shelx.uni-ac.gwdg.de/SHELX/ . Downloading instructions will then be emailed. The programs are free to academics but a small license fee is required for 'for-profit' use. <br> | SHELXC/D/E and test data may be downloaded from the SHELX fileserver. Users should register online at http://shelx.uni-ac.gwdg.de/SHELX/ . Downloading instructions will then be emailed. The programs are free to academics but a small license fee is required for 'for-profit' use. <br> | ||
== References and other sources of information == | |||
Lübben, A.V. and Sheldrick, G.M. (2019). "PDB2INS: bridging the gap between small-molecule and macromolecular refinement", ''J. Appl. Cryst.''. '''52''', 669–673 [https://journals.iucr.org/j/issues/2019/03/00/fs5176/index.html open access] .<br> | |||
Sheldrick, G.M. (2015). "Crystal structure refinement with SHELXL", ''Acta Crystallogr''. '''C71''', 3-8 [https://journals.iucr.org/c/issues/2015/01/00/fa3356/index.html open access] .<br> | |||
Gruene, T. et ''al.'' (2014). "Refinement of Macromolecular Structures against Neutron Data with SHELXL-2013". ''J. Appl. Cryst.''. '''47''', 462-466 [''Reference for refinement against neutron data and for hydrogen restraints'']. | |||
Sheldrick, G.M. (2008). "A short history of SHELX", ''Acta Crystallogr''. '''D64''', 112-122 [''Standard reference for all SHELX... programs''].<br> | Sheldrick, G.M. (2008). "A short history of SHELX", ''Acta Crystallogr''. '''D64''', 112-122 [''Standard reference for all SHELX... programs''].<br> | ||
The following additional sources of information may be found via the SHELX homepage (http://shelx.uni-ac.gwdg.de/SHELX): "SHELX-97 Manual as PDF", "Mini-protein refinement tutorial". "P1-Lysozyme refinement tutorial", "Thomas Schneider's FAQs" and "FAQs: Macromolecules" | The following additional sources of information may be found via the SHELX homepage (http://shelx.uni-ac.gwdg.de/SHELX): "SHELX-97 Manual as PDF", "Mini-protein refinement tutorial". "P1-Lysozyme refinement tutorial", "Thomas Schneider's FAQs" and "FAQs: Macromolecules" | ||