To better serve a diverse user community, 11-BM mail-in data is available in different formats. Users may select the format(s) most appropriate for their analysis needs. A description of these different formats is given below.
During an 11-BM scan individual patterns from the sample are collected simultaneously on all 12 detectors. These data are later merged into a pseudo-single pattern. Data consisting of a single merged pattern are appropriate for nearly all 11-BM users.
Corrections are applied to the data when it is merged. The corrections are necessary to merge the data from the 12 separate detectors, and correct for small offset variations, differences in sensitivity, and minor fluctuations in wavelength (typically ~ 0.003%). The correction values are determined by a Rietveld refinement performed regularly on scans of a mixture of NIST standard reference materials, Si (SRM 640c) and Al2O3 (SRM 676), where the Si lattice constant determines the wavelength for each detector.
The pattern intensity and uncertainties (e.g. error or esd) are corrected to account for the number of contributing detectors at each 2θ value. The final merged single pattern has a 2θ offset of exactly zero degrees, and a single wavelength value that is provided with the dataset. Users may request the calibration data set used for their samples be sent by
contacting beamline staff; please reference the name of the calibration file (e.g. aug09/11bmb_0311.calib)
The free program
CMPR opens GSAS (.fxye) files from 11-BM, and can be used to view your data and convert to a several popular alternative formats.
Still having trouble with data formats? The 11-BM
FAQ page answers a few common questions, or
contact us: 11-BM staff may be able to help.
Merged Data Formats
GSAS data (.fxye)
GSAS supports many formats for powder diffraction data input. The .fxye format for GSAS has an intial header line followed by a variable number of comment lines (prefixed by a # character), then an addtional header line. The data are listed next in three columns: 1st column is 2θ position (in centidegrees, i.e. degrees × 100), 2nd is intensity, and 3rd is standard uncertainty for the intensity values (esd). This format may not be supported by all software that claims to read GSAS input files (see GSAS .raw format below)
This format is supported by recent versions of
GSAS+EXPGUI and other
Rietveld software including recent versions of
Jana2006. The freely distributed
powder diffraction data utility CMPR will also read .fxye files. CMPR can be used to display and index the diffraction data (just a few its many features) as well as export to alternative ASCII data formats.
Note for
JADE users: although recent verions of Jade do appear to open .fxye files, we have heard reports that it may truncate significant digits in the intensity and ESD value columns. The pdCIF format (see below) is a better choice for Jade users.
When GSAS format files (.fxye or .raw) are requested from the web site, the appropriate GSAS instrument
parameter file (.prm) is generated and included.
GSAS data (.raw)
GSAS also supports a second common format. In this format, the angular range of the data and the step size are indicated in a header and the intensities and their uncertainties (esd) are alternated with five pair of numbers per line (8 characters per number), as described in the
GSAS manual.
Several different file extensions, including .gsa, .gsas, .raw, or .gs are used by different programs for this type of file. These various file extensions occasionally cause some software confusion. Feel free to rename your file extension as required for a given software package.
When GSAS format files (.fxye or .raw) are requested from the web site, the appropriate GSAS instrument
parameter file (.prm) is generated and included.
TOPAS data (.xye)
The TOPAS .xye file is similar to the three column GSAS .fxye format, except 2θ position angles are expressed in degrees, not centidegrees. Topas will ignore the file header information which is bracketed between the characters "/*" and "*/", and prefixed by a "#" character.
pdCIF data (.cif)
The
Crystallographic Information File (CIF) is a standard format developed by the
IUCr for communication of diffraction data and results. The
pdCIF format defines data names that allow CIF to be used for powder diffraction data. A number of programs, including
JADE,
EXPGUI,
CMPR,
FOX and
pdCIFplot
can read diffraction data from
pdCIF files.
Spreadsheet text format (.csv)
This text spreadsheet format contains three columns of comma separated values, proceeded by a short file header. The first 2θ position (in degrees), second is intensity, and third is standard uncertainty for the intensity values (esd). This format may be conveniently opened in most spreadsheet or plotting programs.
Fullprof (.xy)
The Fullprof INSTRM=10 format containing three columns of data; position (in degrees), intensity, and sigma. The file begins with the keyword XYDATA, and the header also contains values for the INTER and TEMP keywords which enable use of sequential refinements with FullProf. Comment lines in the file header begin the "!" character.
Raw Data Formats
For expert users, 11-BM can also provide raw un-merged datasets. These files contain the 12 individual patterns collected by each detector during the scan. Although there may be certain circumstances requiring this raw data, one of the merged formats described above will be more useful for the majority of users. Please feel free to
contact 11-BM staff if you feel raw 11-BM data might be appropriate for your research.
EPICS MDA (.mda)
Files on 11-BM are collected using the savedata routine in
EPICS and
stored as a binary (.mda) file. Note that this file contains
intensity values for each of the 12 detectors separately. It is
necessary to compute the 2θ values from the step size,
starting angle and detector offsets. There are a small number of
programs that can directly read these files. We typically use the
11-BM python merge program to read and reduce these data to the
pseudo single-detector formats above. A version of this program can
be downloaded from
this
site (see the included README.txt file for installation
instructions). The MDA file can also be read with program
MDA2ASCII to translate it to the .ASC file
below. We have been able to build the Dohn Arms'
MDAUTILS for Linux, Mac and Windows. A recent
version of powder diffraction data utility
CMPR can call MDA2ASCII automatically to
directly plot the files.
When .mda format files are requested, the instrument calibration file appropriate for processing the data is also sent. This contains the wavelength, 2θ offset and sensitivity correction for each detector.
ASCII (.asc)
The ASCII files created by
MDA2ASCII (.asc) can be read by humans and powder diffraction data utility
CMPR. As far as we know, they contain exactly the same information as in the .mda file, and have about the have the same file size.When .asc format files are requested, the instrument calibration file appropriate for processing the data is also sent. This contains the wavelength, 2theta offset and sensitivity correction for each detector.