Debian Codegraph @

docs/source/manual/File_types.rst

raw
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