Pointless: Difference between revisions

Jump to navigation Jump to search
869 bytes added ,  8 September 2015
no edit summary
(add the I2 versus C2 stuff to the "Attention" section - thanks to Ethan Merrit)
No edit summary
 
(4 intermediate revisions by the same user not shown)
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]) is part of CCP4 and 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/ .  
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
  echo SETTING SYMMETRY-BASED | pointless XDS_ASCII.HKL


("xdsin" can be left out)
One may send several commands to pointless:
echo SETTING SYMMETRY-BASED\\n CHIRALITY CHIRAL | pointless XDS_ASCII.HKL


Typical usage for converting to multi-record MTZ file (for scaling with SCALA or AIMLESS) is
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 XDS_ASCII.HKL hklout XDS_ASCII.mtz


(the -copy option does not seem to be required for the latest versions)
(the -copy option is not required)


More complicated operations may be scripted:
More complicated operations may be scripted:
  #!/bin/csh -f
  #!/bin/csh -f
  pointless <<eof
  pointless <<eof
SETTING SYMMETRY-BASED
  xdsin XDS_ASCII.HKL
  xdsin XDS_ASCII.HKL
  centre
  centre
Line 21: Line 23:
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. "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.
Why "SETTING SYMMETRY-BASED"? 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, 1017 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 pointless default. However, users of [[XDS]], [[XSCALE]] and [[XDSCONV]] want the "symmetry-based setting" because these programs do not understand 1017 and 2017 (and those numbers are not even in the logfile, only in the MTZ file). This also affects space group 18 ("P 21 21 2"), and in space group 5 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].
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 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.:
What can go wrong when using the default? For example, the space group assignment of data sets differing a tiny amount in two cell parameters may flip between two alternatives, i.e. the assignment is not stable. E.g. two datasets from a P222<sub>1</sub> crystal with axes of 100,120.5,120.7 and 100,120.7,120.5 would be considered (and re-indexed!) by cell-based assignment as P222<sub>1</sub> and P22<sub>1</sub>2, respectively, with ugly consequences for data merging and all downstream steps of data usage. The example shows that enforcing a<b<c would be considered more important than assigning the spacegroup in a reliable way, which makes little sense.  


  echo -e SETTING SYMMETRY-BASED\\n CHIRALITY CHIRAL | pointless xdsin XDS_ASCII.HKL
The upshot is: for space groups 5, 17 and 18, XDS users want to use the "symmetry-based setting", and it does not hurt to ''always'' use it, i.e. for all 65 space groups that proteins crystallize in. This deviation from the default of pointless has several advantages (avoiding the ambiguity, and avoiding change of space group assignment upon small change of axes), and no disadvantage.  
 
which also shows how to send several commands to pointless.


See also:  
See also:  
2,652

edits

Cookies help us deliver our services. By using our services, you agree to our use of cookies.

Navigation menu