Xds: Difference between revisions

From XDSwiki
Jump to navigation Jump to search
mNo edit summary
No edit summary
Line 1: Line 1:
== What is XDS, and how to obtain it? ==
[http://www.mpimf-heidelberg.mpg.de/~kabsch/xds XDS] is the main program of the [[Main_page|XDS program package]]. Binaries are available for Linux, SGI, Alpha and Mac platforms.  
XDS is a program package written for the "reduction" of 2-dimensional data images ("frames") obtained from crystals irradiated with monochromatic X-rays. The package mainly consists of the programs XDS (which processes a single dataset), [[XSCALE]] (for scaling of several datasets) , [[XDSCONV]] (for conversion of output file to other formats) and [[VIEW]] (for visualizing).


The author of the program is Wolfgang Kabsch (Wolfgang dot Kabsch at mpimf-heidelberg dot mpg dot de).  
XDS is run simply using
xds
for the single-processor version, and
xds_par
for the parallel version of the program. Several instances of the single or parallel version of the program can be run at the same time ''on the same dataset'' (see MAXIMUM_NUMBER_OF_JOBS= keyword).


The program is free for academic use, and can be downloaded from http://www.mpimf-heidelberg.mpg.de/~kabsch/xds/html_doc/downloading.html .  
XDS reads the file [[XDS.INP]] which contains the keywords and parameters for a run of the program. To reduce a dataset, it goes through the steps ("JOB"s)
* [[XYCORR]]
* [[INIT]]
* [[COLSPOT]]
* [[IDXREF]]
* [[DEFPIX]]
* [[INTEGRATE]]
* [[CORRECT]]
(additional, optional JOBs are [[XPLAN]] and [[DIRB]]).


Documentation is at http://www.mpimf-heidelberg.mpg.de/~kabsch/xds .
Each step writes a logfile with a name corresponding to the name of the step, with ".LP" appended.
 
== Links to XDS papers by Wolfgang Kabsch ==
 
[http://dx.doi.org/10.1107/S0021889887009737 ''J. Appl. Cryst.'' (1988). 21, 67-72. Automatic indexing of rotation diffraction patterns. ]
 
[http://dx.doi.org/10.1107/S0021889888007903 ''J. Appl. Cryst.'' (1988). 21, 916-924. Evaluation of single-crystal X-ray diffraction data from a position-sensitive detector]
 
[http://dx.doi.org/10.1107/S0021889893005588 ''J. Appl. Cryst.'' (1993). 26, 795-800. Automatic processing of rotation diffraction data from crystals of initially unknown symmetry and cell constants]
 
[http://www.iucr.org/iucr-top/comm/commit/volf.html Chapters 11.3 and 25.2.9 in ''International Tables for Crystallography Volume F: Crystallography of Biological Macromolecules''] (don't know the link to PDFs of these)
 
== Purpose of the Wiki ==
The purpose of this Wiki is to provide an accurate resource for XDS users, and to provide explanations and hints for the successful use of XDS. I (Kay Diederichs) try to keep the Wiki up-to-date with XDS versions and insights. I collect [[Tips and Tricks]] for XDS usage, explanations of its output, and recommendations for the parameters in [[XDS.INP]] (if it appears useful to deviate from their defaults).
 
To see what's there already, go to [[Special:Allpages|List of all pages]]. A good starting point is the article about [[XDS.INP]] where the keywords and parameters for running XDS are described. There is also a [[wishlist]], and [[Known Bugs]], and [[Quality Control]] (under construction).
 
== Contributing to the Wiki ==
The MediaWiki software used here works in the same way as the well-known Wikipedia. This means that anyone with a userid and password can edit existing pages, and create new ones. I might enable or disable account creation as it appears suitable. If you would like to get an account, and "create login" does not appear at http://strucbio.biologie.uni-konstanz.de/xdswiki/index.php/Special:Userlogin, email me, Kay dot Diederichs at uni-konstanz dot de, to have me enable it temporarily. I ask you to choose the user name such that your real name may be recognized.
 
== Wiki contents ==
 
* [[Special:Allpages|List of all pages]] - to see which pages exist already ...
 
* [[Topics]] as an attempt to provide a hierarchy of pages

Revision as of 20:13, 10 February 2008

XDS is the main program of the XDS program package. Binaries are available for Linux, SGI, Alpha and Mac platforms.

XDS is run simply using 

xds

for the single-processor version, and 

xds_par

for the parallel version of the program. Several instances of the single or parallel version of the program can be run at the same time on the same dataset (see MAXIMUM_NUMBER_OF_JOBS= keyword).

XDS reads the file XDS.INP which contains the keywords and parameters for a run of the program. To reduce a dataset, it goes through the steps ("JOB"s)

(additional, optional JOBs are XPLAN and DIRB).

Each step writes a logfile with a name corresponding to the name of the step, with ".LP" appended.

Retrieved from "https://wiki.uni-konstanz.de/xds/index.php?title=Xds&oldid=1767"