| 1 |
File types |
| 2 |
========== |
| 3 |
|
| 4 |
**WARNING:** The manual is current several versions out of date. While it may |
| 5 |
still be useful for some users, please refer to the tutorial for the most |
| 6 |
up-to-date information. |
| 7 |
|
| 8 |
.. _filetypes: |
| 9 |
|
| 10 |
Output file types |
| 11 |
----------------- |
| 12 |
|
| 13 |
RAW outputs the following file types: |
| 14 |
|
| 15 |
.cfg – These are files containing all of RAW’s settings (configuration files). |
| 16 |
This file type is not human readable. |
| 17 |
|
| 18 |
.dat – These are files containing :ref:`three column scattering profile data <savingdata>` |
| 19 |
with a “header” at the start or end of the file for additional information. This file type |
| 20 |
is human readable. |
| 21 |
|
| 22 |
.ift – These are files containing :ref:`three column BIFT data <savingiftdata>` followed by four column |
| 23 |
scattering profile data, with a “header” at the start or end of the file for additional |
| 24 |
information. This file type is human readable. |
| 25 |
|
| 26 |
.msk – These are files containing a RAW mask. This file type is not human readable. |
| 27 |
|
| 28 |
.out – These are files containing GNOM P(r) data and are written in the standard |
| 29 |
format described in the ATSAS manual for GNOM. This file is human readable. |
| 30 |
|
| 31 |
.sec – These are files containing :ref:`SEC-SAXS curves <savingsecdata>`, which can be |
| 32 |
loaded back into RAW and contain all of the relevant scattering profiles and |
| 33 |
structural parameters. This file type is not human readable. |
| 34 |
|
| 35 |
.wsp – These are files for :ref:`saved workspaces <workspaces>`. This file type is not human readable. |
| 36 |
|
| 37 |
|
| 38 |
Input file types |
| 39 |
---------------- |
| 40 |
|
| 41 |
In addition to the output file types described above, all of which can be read in by RAW, |
| 42 |
RAW can load the following types of input files. |
| 43 |
|
| 44 |
*ASCII files:* |
| 45 |
|
| 46 |
.csv – If data is in a 3 column csv format, it is loaded assuming the columns are q, I, Error. |
| 47 |
|
| 48 |
.dat (2 column) – If a .dat file has exactly 2 columns separated |
| 49 |
by whitespace, it is loaded as q I. |
| 50 |
|
| 51 |
.dat (4 column) – Produced by FoXs when fitting a theoretical curve to a scattering profile. |
| 52 |
Loads the experimental and simulated (_FIT) scattering profiles. |
| 53 |
|
| 54 |
.fir – Output by various ATSAS programs such as DAMMIF. Loads the experimental and simulated |
| 55 |
(_FIT) scattering profiles. |
| 56 |
|
| 57 |
.fit – Output by various ATSAS programs such as DAMMIF. Loads the experimental (often smoothed) |
| 58 |
and simulated (_FIT) scattering profiles. |
| 59 |
|
| 60 |
.int – Output by CRYSOL if no fitting is used. Loads the scattering intensity in solution. |
| 61 |
|
| 62 |
.rad – Depreciated file format for RAW saved scattering profiles. |
| 63 |
|
| 64 |
.txt - 2 or 3 column data can be read in as if it was a .dat file. |
| 65 |
|
| 66 |
*Image files:* |
| 67 |
|
| 68 |
Image files are often distinguished not just by their extension, but by their header format. |
| 69 |
For example, many detectors produce tif files, but require different methods to read in the |
| 70 |
appropriate header data. RAW uses the fabIO python module to load images. The complete list o |
| 71 |
f images and extensions supported can be found here: |
| 72 |
`http://pythonhosted.org/fabio/getting_started.html#list-of-file-formats-that-fabio-can-read-and-write <http://pythonhosted.org/fabio/getting_started.html#list-of-file-formats-that-fabio-can-read-and-write>`_ |
| 73 |
|
| 74 |
We reproduce that here with the detector/format followed by the file extension in parenthesis: |
| 75 |
* ADSC Quantum (.img) |
| 76 |
|
| 77 |
* Bruker (.sfrm) |
| 78 |
|
| 79 |
* CIF binary files (.cbf) |
| 80 |
|
| 81 |
* EDNA-XML (.xml) |
| 82 |
|
| 83 |
* ESRF EDF (.edf) |
| 84 |
|
| 85 |
* Eiger (.h5) |
| 86 |
|
| 87 |
* FReLoN |
| 88 |
|
| 89 |
* Fit2D spreadsheet (spr) |
| 90 |
|
| 91 |
* Gatan Digital Micrograph (.dm3) |
| 92 |
|
| 93 |
* General Electric (.No?) |
| 94 |
|
| 95 |
* HDF5 (Hierarchical Data Format 5) (.h5) |
| 96 |
|
| 97 |
* Hamamatsu CCD (.tif) |
| 98 |
|
| 99 |
* MarCCD/Mar165 (.mccd) |
| 100 |
|
| 101 |
* Mar345 image plate (.mar3450) |
| 102 |
|
| 103 |
* Nonius KappaCCD (.kccd) |
| 104 |
|
| 105 |
* Numpy 2D array (.npy) |
| 106 |
|
| 107 |
* Oxford Diffraction (.img) |
| 108 |
|
| 109 |
* Pixi (.?) |
| 110 |
|
| 111 |
* Pilatus Tiff (.tif or .tiff) |
| 112 |
|
| 113 |
* Portable aNy Map (.pnm) |
| 114 |
|
| 115 |
* Rigaku SAXS format (.img) |
| 116 |
|
| 117 |
* Tagged Image File Format (.tif) |
| 118 |
|
| 119 |
In addition, we have written custom methods to support the following detector/file formats: |
| 120 |
|
| 121 |
* 32 bit TIF (.tif) |
| 122 |
|
| 123 |
* FLICAM (.tif) |
| 124 |
|
| 125 |
* ILL SANS D11 |
| 126 |
|
| 127 |
* Medoptics (.tif) |
| 128 |
|
| 129 |
* Multiwire (.mpa) |
| 130 |
|
| 131 |
* SAXSLab300 |
| 132 |
|