414 Kasha Laboratory

Institute of Molecular Biophysics

Florida State University, Tallahassee, FL 32306-4380

Phone: (850) 644-6448 (Office) | (850) 645-1333 (Lab)

soma@sb.fsu.edu | www.sb.fsu.edu/~soma


Soma’s Data Processing Notes

Notes on Data Processing-1

HKL Data Processing Tips for Synchrotron Datasets



TABLE OF CONTENTS

Introduction. 1

License. 1

HKL.1.97.9. 2

Synchrotron data. 2

Wavelength. 2

Keyword ‘step’ 2

‘Fixing’ the distance. 3

Keyword ‘y scale’ 1

Keyword ‘film rotation’ 2

Conclusions. 3

ã 2000-2004 Thayumanasamy Somasundaram

414 Kasha Laboratory

Institute of Molecular Biophysics, Florida State University,

Tallahassee, FL 32306-4380

E-mail: soma@sb.fsu.edu • URL: http://www.sb.fsu.edu/~soma

Phone: 850.644.6448 (Office) • 850 645 1333

Fax: 850.644.7244

August 10, 2004

 

 


Data Processing Tips-1

HKL Suite Data Processing Tips for Synchrotron Datasets

Version: Aug.10, 2004; Original: May 10, 2003

Introduction

HKL Research Inc has recently released a new version of HKL Suite (Denzo, XdisplayF, and Scalepack).  This version is called HKL 1.97.9 and has several modifications including, slightly modified Graphical User Interface (GUI), ability to read and process several new detector formats including Quantum 4 CCD, and handle large number of reflections for scaling.  The new executables have new names, especially those ones used for scaling.

Processing of synchrotron data necessitates the ability to read charge-coupled device (CCD) detectors.  Most of the synchrotron sites have Area Detector Systems Corporation’s (ADSC) Quantum Q4 detector.  Some synchrotrons have Mar USA’s MarCCD165 or 225.  Our own CCD detector is a MarCCD165.  In order to read these formats, specific keywords have to be used in Denzo and XdisplayF (see below)

X-Ray Facility has acquired one new license for version 1.97.9 (currently XRF has one license for version 1.97.2, one for 1.96.9).  Each version can be used by ten (10) different people or in different computers simultaneously.  This means that synchrotron data can be processed in HP Alphas and Linux operating systems.

License

List of computers with licenses:  HKL executable will not run on a computer that does not have a license to run the program since licenses are tied to specific hardware found on the computer.  The following table shows the list of computers that have licenses to run various versions of HKL suite.  Please let Soma know if there is an error in this table.

No

Computer

HKL 1.97.9

1.97.2

HKL.1.96.9

1

Arg sb.fsu.edu

Yes

Yes

Yes

2

Lys.sb.fsu.edu

Yes

Yes

Yes

3

Leu.sb.fsu.edu

Yes

Yes

Yes

4

Tyr.sb.fsu.edu

Yes

Yes

Yes

5

Raccoon.sb.fsu.edu

Yes

Yes

Yes

6

Neptune.sb.fsu.edu

Yes

Yes

Yes

7

Tampa.sb.fsu.edu

Yes

Yes

Yes

8

Orlando.sb.fsu.edu

Yes

Yes

No

9

Mozart.sb.fsu.edu

Yes

Yes

No

10

Dallas.sb.fsu.edu

Yes

Yes

No

11

Miami.sb.fsu.edu

Yes

Yes

No

Table 1.  List of computers with HKL licenses.  Orange: Alphas; Green: Linux machines; Yellow:X-Ray PI Linux machines

All executable are located in one central directory (see below) and you are NOT required to copy any of the executable to your home directory to run these programs.  Instead, create an alias that points to one of the executables.

Alpha version: /tyr/e/users/soma/HKL.1.97.9/

Alpha version: /tyr/e/users/soma/HKL.1.96.9/

Linux version: neptune:/usr/local/xray/HKL.1.97.9/

Linux version: neptune:/usr/local/xray/HKL.1.96.6/

Linux version: raccoon:/usr/local/xray/HKL.1.97.9/

Linux version: raccoon:/usr/local/xray/HKL.1.96.6/

HKL.1.97.9

Version 1.97.9 executables have slightly different names.  The new names are given below along with their capabilities:


xdisp

denzo

scalepack

scalepack8m

scalepack16m

scalepackmanyframes


Scalepack8m can handle 8 x106 observations, 60,000 hkl pairs, 2000 frames and 50,000 rejections.  For scalepack16m, the corresponding numbers are: 16 x106, 60,000 pairs, 2000 frames and 100,000 rejections.  For scalepackmanyframes the relevant numbers are: 2 x106, 100,000 pairs, 4000 frames and 50,000 rejections.

Version 1.6.0 and upward require only one display program called ‘xdisp’.  Xdisp executable along with a modifier can read various formats.  Given below are the various modifiers needed to read home and synchrotron data.  Add the relevant modifier to ‘xdisp’ to read a specific format, e.g., ‘xdisp raxis myxtal001.osc’ for R-axis 105 µm data collected at home.

xdisp b raxis b myxtal001.osc     |Regular r-axis data

 

xdisp b raxis b 210 b myxtal001.osc   |Small r-axis format

 

xdisp b raxis2n b myxtal001.osc       |New r-axis data (note 2n)

 

xdisp b raxis2n b 210 b myxtal001.osc |New small r-axis format (note 2n)

 

xdisp b ccd b unsupported-m165 b xtal01.001  |MarCCD165 format

 

xdisp b ccd b adsc b unsupported-q4 b xtal01.001   |Quantum 4 format

 

 b : indicates a required empty space.

 

The same modifiers are required while processing the data using Denzo with the keyword ‘format’.  In the following section, some tips for processing data sets collected specifically at synchrotron are discussed.

Synchrotron data

As mentioned in the Introduction, synchrotron data sets are usually collected in Quantum 4 CCD or MariCCD225 formats which are different from Image Plate detector format.  Since only Denzo and XdisplayF deal with the different formats, most attention should be given to auto.dat, site.dat, and expr.dat (or the equivalent of these files).  There are several important differences in the data set collected at synchrotrons.  The first one is the wavelength of x-rays.  This value can be anywhere between 0.9 to 1.5Å depending upon the experimental station.  The second major difference is that the phi axis or spindle axis is usually horizontal (in R-Axis it is vertical and in Mar it is horizontal).  The third difference is rotation of spindle can be clockwise or anti-clockwise.  The fourth difference is ‘Y Scale’ which is the ratio of pixel size on fast reading direction (say y) to slow reading direction.  The next difference is the film rotation.

Wavelength

Home sources (rotating anodes) are limited to a few distinct wavelengths depending upon the target used (copper, molybdenum, gold, or iron).  In macromolecular crystallographic facilities, it is usually a copper target and therefore the wavelength lambda (l) is 1.541Å.

However, in synchrotron it is possible to get wavelengths in the range from 0.9 to 1.5Å and the user has to modify the Denzo keyword ‘wavelength’ appropriately.  Given below is an illustration where a data set collected at 0.948Å is processed with wrong wavelength of 1.541Å.  For comparison, data processed with the correct wavelength of 0.948Å is also shown.  Note that in the wrong processing the predictions (overlaps) are much closer compared to the correct processing.  The log file will also show that crystal cell dimensions are about 1.6 times (1.541/0.948=1.62) larger for the wrong one compared to the correct one.

Denzo predictions on data. Wrong wavelength (1.541Å) instead of 0.948Å. Note heavy overlaps. Cell: 180.37, 180.68, 255.94; 90.81, 90.81, 91.15.

Data only (Frame 2)

Denzo predictions on data. Correct wavelength of 0.948Å used. Cell: 110.05, 111.49, 153.12; 90.76, 90.26, 90.74

Figure 1.  Incorrect & correct wavelength usage during synchrotron data processing

Keyword ‘step’

Synchrotron phi axis rotation can be different from that we usually see at home.  One such example is at F1 Station at CHESS where they use anti-clockwise rotation to achieve the movement of phi axis.  To distinguish this we have to add a special Denzo keyword ‘