Spot2pdb: Difference between revisions

From XDSwiki
Jump to navigation Jump to search
(start)
 
No edit summary
Line 1: Line 1:
[ftp://turn5.biologie.uni-konstanz.de/pub/linux_bin/spot2pdb] is a jiffy that serves to create pseudo-PDB files for visualization of reciprocal space, based on SPOT.XDS and XPARM.XDS . The "atom" positions in the pseudo-PDB files are actually reflections positions.
[ftp://turn5.biologie.uni-konstanz.de/pub/linux_bin/spot2pdb spot2pdb],[ftp://turn5.biologie.uni-konstanz.de/pub/sources/spot2pdb.f90] is a jiffy that serves to create pseudo-PDB files for visualization of reciprocal space, based on <code>SPOT.XDS</code> and <code>XPARM.XDS</code>. The "atom" positions in the pseudo-PDB files are actually reflections positions.


The usage is simple: just run
The usage is simple: just run
  spot2pdb
  spot2pdb
in a XDS directory containing SPOT.XDS and XPARM.XDS . The program then creates SPOT-indexed.pdb and SPOT-notindexed.pdb, depending on whether SPOT.XDS has indices attached to spot positions or not (or just 0 0 0). Thus it is useful directly after COLSPOT, but even more after IDXREF. Reflections of SPOT-indexed.pdb can be clicked, and have (atomname residuename sequencenumber) corresponding to (H K L).
in a XDS directory containing <code>SPOT.XDS</code> and <code>XPARM.XDS</code>. The program then creates <code>SPOT-indexed.pdb</code> and <code>SPOT-notindexed.pdb</code>, depending on whether <code>SPOT.XDS</code> has indices attached to spot positions or not (or just 0 0 0). Thus it is useful directly after COLSPOT, but even more after IDXREF. Reflections of <code>SPOT-indexed.pdb</code> can be clicked, and have (atomname residuename sequencenumber) corresponding to (H K L).


By default, the program creates pseudo-PDB files with reflections up to 6Å. The maximum resolution can be adjusted with the -r option.
By default, the program creates pseudo-PDB files with reflections up to 6Å. The maximum resolution can be adjusted with the -r option.
Line 9: Line 9:
Visualization can then be achieved with
Visualization can then be achieved with
  coot SPOT-*.pdb
  coot SPOT-*.pdb
'''Since there exist duplicate residue numbers in SPOT-indexed.pdb, one needs a ~/.coot with the line
'''Since there exist duplicate residue numbers in <code>SPOT-indexed.pdb</code>, one needs a <code>~/.coot</code> with the line
  (allow-duplicate-sequence-numbers)'''
  (allow-duplicate-sequence-numbers)'''


Line 19: Line 19:


Notes:
Notes:
* the mapping used by dials.rs_mapper uses the (unrefined) frame header values, and possibly assumptions (as implemented in iotbx.detectors) about geometry aspects, like ROTATION_AXIS, not stored in the header. On the other hand, XPARM.XDS may have different assumptions about geometry aspects, and uses the geometry as refined by IDXREF. Ideally, these two mappings should agree.  
* the mapping used by <code>dials.rs_mapper</code> uses the (unrefined) frame header values, and possibly assumptions (as implemented in <code>iotbx.detectors</code>) about geometry aspects, like ROTATION_AXIS, not stored in the header. On the other hand, XPARM.XDS may have different assumptions about geometry aspects, and uses the geometry as refined by IDXREF. Ideally, these two mappings should agree.
* if no XPARM.XDS exists, one may use [ftp://turn5.biologie.uni-konstanz.de/pub/linux_bin/generate_XPARM.XDS XDS.INP as a source of geometry information].
* Since <code>dials.rs_mapper</code> uses the STARTING_ANGLE information from the frame headers, the mappings can only agree if <code>XDS.INP</code> also has this item. [[generate_XDS.INP]] versions since 0.82 write <code>XDS.INP</code> with STARTING_ANGLE information; earlier versions don't.  
* if no <code>XPARM.XDS</code> exists, one may use [ftp://turn5.biologie.uni-konstanz.de/pub/linux_bin/generate_XPARM.XDS XDS.INP as a source of geometry information].
*

Revision as of 18:53, 6 March 2018

spot2pdb,[1] is a jiffy that serves to create pseudo-PDB files for visualization of reciprocal space, based on SPOT.XDS and XPARM.XDS. The "atom" positions in the pseudo-PDB files are actually reflections positions.

The usage is simple: just run

spot2pdb

in a XDS directory containing SPOT.XDS and XPARM.XDS. The program then creates SPOT-indexed.pdb and SPOT-notindexed.pdb, depending on whether SPOT.XDS has indices attached to spot positions or not (or just 0 0 0). Thus it is useful directly after COLSPOT, but even more after IDXREF. Reflections of SPOT-indexed.pdb can be clicked, and have (atomname residuename sequencenumber) corresponding to (H K L).

By default, the program creates pseudo-PDB files with reflections up to 6Å. The maximum resolution can be adjusted with the -r option.

Visualization can then be achieved with

coot SPOT-*.pdb

Since there exist duplicate residue numbers in SPOT-indexed.pdb, one needs a ~/.coot with the line

(allow-duplicate-sequence-numbers)

Even better visualization of the raw data and their abstraction as reflection positions is achieved with

coot --pdb SPOT-*.pdb --map rs_mapper_output.ccp4

provided that dials.rs_mapper is run beforehand. The latter is as easy as

dials.rs_mapper /path/to/reflection/files.ext

and produces a CCP4 map file with pixel contents mapped to reciprocal space, to 6Å.

Notes:

  • the mapping used by dials.rs_mapper uses the (unrefined) frame header values, and possibly assumptions (as implemented in iotbx.detectors) about geometry aspects, like ROTATION_AXIS, not stored in the header. On the other hand, XPARM.XDS may have different assumptions about geometry aspects, and uses the geometry as refined by IDXREF. Ideally, these two mappings should agree.
  • Since dials.rs_mapper uses the STARTING_ANGLE information from the frame headers, the mappings can only agree if XDS.INP also has this item. generate_XDS.INP versions since 0.82 write XDS.INP with STARTING_ANGLE information; earlier versions don't.
  • if no XPARM.XDS exists, one may use XDS.INP as a source of geometry information.