source: sasview/src/sas/sasgui/guiframe/media/data_formats_help.rst @ 280f929

ESS_GUIESS_GUI_DocsESS_GUI_batch_fittingESS_GUI_bumps_abstractionESS_GUI_iss1116ESS_GUI_iss879ESS_GUI_iss959ESS_GUI_openclESS_GUI_orderingESS_GUI_sync_sascalccostrafo411magnetic_scattrelease-4.1.1release-4.1.2release-4.2.2ticket-1009ticket-1094-headlessticket-1242-2d-resolutionticket-1243ticket-1249ticket885unittest-saveload
Last change on this file since 280f929 was 280f929, checked in by smk78, 5 years ago

SESANS data format information added by Wim. Re-commit to the src
folder.

  • Property mode set to 100644
File size: 2.9 KB
RevLine 
[280f929]1.. data_formats.rst
2
3.. This is a port of the original SasView html help file to ReSTructured text
4.. by S King, ISIS, during SasView CodeCamp-III in Feb 2015.
5.. WG Bouwman, DUT, added during CodeCamp-V in Oct 2016 the SESANS data format
6
7.. _Formats:
8
9Data Formats
10============
11
12SasView reads several different 1D (I(Q) vs Q), 2D SANS(I(Qx,Qy) vs (Qx,Qy))
13and SESANS (P(z) vs z)
14data files. But please note that SasView does not at present load data where
15the Q and I(Q) data are in separate files.
16
171D Formats SANS
18---------------
19
20SasView will read files with 2 to 4 columns of numbers in the following order:
21
22    Q, I(Q), (dI(Q), dQ(Q))
23   
24where dQ(Q) is the instrumental resolution in Q and assumed to have originated
25from pinhole geometry.
26
27Numbers can be separated by spaces or commas.
28
29SasView recognises the following file extensions:
30
31*  .TXT
32*  .ASC
33*  .DAT
34*  .XML (in canSAS format v1.0 and 1.1)
35
36If using CSV output from, for example, a spreadsheet, ensure that it is not
37using commas as delimiters for thousands.
38
39For a description of the CanSAS/SASXML format see:
40http://www.cansas.org/formats/canSAS1d/1.1/doc/
41
42For a description of the NIST 1D format see:
43http://danse.chem.utk.edu/trac/wiki/NCNROutput1D_IQ
44
45For a description of the ISIS 1D format see:
46http://www.isis.stfc.ac.uk/instruments/loq/software/colette-ascii-file-format-descriptions9808.pdf
47
48.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ
49
502D Formats SANS
51---------------
52
53SasView will only read files in the NIST 2D format with the extensions
54.ASC or .DAT
55
56Most of the header lines can be removed except the last line, and only the
57first three columns (Qx, Qy, and I(Qx,Qy)) are actually required.
58
59For a description of the NIST 2D format see:
60http://danse.chem.utk.edu/trac/wiki/NCNROutput1D_2DQxQy
61
62.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ
63
64SESANS Format
65-------------
66
67The current file extension is .ses or .sesans (not case sensitive).
68
69The file format is to have a list of name-value pairs as a header at the top of the file, detailing general experimental parameters necessary for fitting and analyzing data. This list should contain all information necessary for the file to be 'portable' between users.
70
71Following that is a 6 column list of instrument experimental variables:
72
73- Spin echo length (z, in Angstroms)
74- Spin echo length error (:math:`\Delta` z, in Angstroms) (experimental resolution)
75- neutron wavelength (:math:`\lambda`, in Angstroms) (essential for ToF instruments)
76- neutron wavelength error (:math:`\Delta \lambda`, in Angstroms)
77- Normalized polarization (:math:`P/P_0`, unitless)
78- Normalized polarization error (:math:`\Delta(P/P_0)`, unitless) (measurement error)
79
80
81.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ
82
83.. note::  This help document was last changed by Wim Bouwman, 05Oct2016
Note: See TracBrowser for help on using the repository browser.