Pointless: Difference between revisions
(attention space groups 17 and 18 !) |
(add the I2 versus C2 stuff to the "Attention" section - thanks to Ethan Merrit) |
||
Line 1: | Line 1: | ||
The pointless program (see [http://dx.doi.org/10.1107/S0907444905036693 Scaling and Assessment of Data Quality, Philip Evans, Acta Cryst D 62, 72-82]) serves to identify space group possibilities from unmerged data. | The pointless program (see [http://dx.doi.org/10.1107/S0907444905036693 Scaling and Assessment of Data Quality, Philip Evans, Acta Cryst D 62, 72-82]) serves to identify space group possibilities from unmerged data. | ||
The | HTML documentation is at http://www.ccp4.ac.uk/html/pointless.html . The pre-release version may be obtained from ftp://ftp.mrc-lmb.cam.ac.uk/pub/pre/ . | ||
Typical usage for space group determination is | Typical usage for space group determination is | ||
pointless xdsin XDS_ASCII.HKL | pointless xdsin XDS_ASCII.HKL | ||
Typical usage for converting to multi-record MTZ file (for scaling with SCALA) is | ("xdsin" can be left out) | ||
Typical usage for converting to multi-record MTZ file (for scaling with SCALA or AIMLESS) is | |||
pointless -copy xdsin XDS_ASCII.HKL hklout XDS_ASCII.mtz | pointless -copy xdsin XDS_ASCII.HKL hklout XDS_ASCII.mtz | ||
Line 19: | Line 21: | ||
will make an R-factor search for the correct origin. | will make an R-factor search for the correct origin. | ||
'''Attention''': the space group number that pointless writes into the logfile (e.g. " | '''Attention''': the space group number that pointless writes into the logfile (e.g. "17") is the generic one (as in the International Tables vol A), not the specific one (which could be 17, 1018 or 2017) that is used as a special convention within CCP4 to encode which of a,b and c is the two-fold screw axis. At the same time, pointless re-indexes orthorhombic such that a<b<c : this is what is called "cell-based setting" in the pointless documentation, and unfortunately it's the default. However, users of [[XDSCONV]] want the "symmetry-based setting" because XDSCONV does not understand 1017 and 2017 (and those numbers are not even in the logfile, only in the MTZ file which is not used by XDSCONV anyway). This also affects the distinction between space groups C2 and I2. | ||
This is discussed under the headings "A note on setting conventions" and "SETTING CELL_BASED || SYMMETRY-BASED || C2" in the [http://www.ccp4.ac.uk/html/pointless.html pointless documentation]. | |||
The upshot is: for space groups 17 and 18, | The upshot is: for space groups 5, 17 and 18, XDS users want to use the "symmetry-based setting". It does not hurt to ''always'' (i.e. for all 65 space groups that proteins crystallize in) use it, so an easy way is e.g.: | ||
echo -e SETTING SYMMETRY-BASED\\n CHIRALITY CHIRAL | pointless xdsin XDS_ASCII.HKL | echo -e SETTING SYMMETRY-BASED\\n CHIRALITY CHIRAL | pointless xdsin XDS_ASCII.HKL |
Revision as of 17:50, 4 October 2014
The pointless program (see Scaling and Assessment of Data Quality, Philip Evans, Acta Cryst D 62, 72-82) serves to identify space group possibilities from unmerged data.
HTML documentation is at http://www.ccp4.ac.uk/html/pointless.html . The pre-release version may be obtained from ftp://ftp.mrc-lmb.cam.ac.uk/pub/pre/ .
Typical usage for space group determination is
pointless xdsin XDS_ASCII.HKL
("xdsin" can be left out)
Typical usage for converting to multi-record MTZ file (for scaling with SCALA or AIMLESS) is
pointless -copy xdsin XDS_ASCII.HKL hklout XDS_ASCII.mtz
(the -copy option does not seem to be required for the latest versions)
More complicated operations may be scripted:
#!/bin/csh -f pointless <<eof xdsin XDS_ASCII.HKL centre eof
will make an R-factor search for the correct origin.
Attention: the space group number that pointless writes into the logfile (e.g. "17") is the generic one (as in the International Tables vol A), not the specific one (which could be 17, 1018 or 2017) that is used as a special convention within CCP4 to encode which of a,b and c is the two-fold screw axis. At the same time, pointless re-indexes orthorhombic such that a<b<c : this is what is called "cell-based setting" in the pointless documentation, and unfortunately it's the default. However, users of XDSCONV want the "symmetry-based setting" because XDSCONV does not understand 1017 and 2017 (and those numbers are not even in the logfile, only in the MTZ file which is not used by XDSCONV anyway). This also affects the distinction between space groups C2 and I2.
This is discussed under the headings "A note on setting conventions" and "SETTING CELL_BASED || SYMMETRY-BASED || C2" in the pointless documentation.
The upshot is: for space groups 5, 17 and 18, XDS users want to use the "symmetry-based setting". It does not hurt to always (i.e. for all 65 space groups that proteins crystallize in) use it, so an easy way is e.g.:
echo -e SETTING SYMMETRY-BASED\\n CHIRALITY CHIRAL | pointless xdsin XDS_ASCII.HKL
which also shows how to send several commands to pointless.
See also: