source: sasview/src/sas/guiframe/media/data_formats_help.rst @ 4e080980

.. data_formats.rst

.. This is a port of the original SasView html help file to ReSTructured text
.. by S King, ISIS, during SasView CodeCamp-III in Feb 2015.

Data Formats
============

1D_Formats_

2D_Formats_

.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ

.. _1D_Formats:

1D Formats
----------

SasView will read files with 2 to 4 columns of numbers in the following order: 

    Q, I(Q), (dI(Q), dQ(Q))
    
where dQ(Q) is the instrumental resolution in Q and assumed to have originated 
from pinhole geometry.

Numbers can be separated by spaces or commas.

SasView recognises the following file extensions:

*  .TXT
*  .ASC
*  .DAT
*  .XML (in canSAS format v1.0 and 1.1)

If using CSV output from, for example, a spreadsheet, ensure that it is not 
using commas as delimiters for thousands.

For a description of the CanSAS/SASXML format see:
http://www.cansas.org/formats/canSAS1d/1.1/doc/

For a description of the NIST 1D format see:
http://danse.chem.utk.edu/trac/wiki/NCNROutput1D_IQ

For a description of the ISIS 1D format see:
http://www.isis.stfc.ac.uk/instruments/loq/software/colette-ascii-file-format-descriptions9808.pdf

*NOTE! SasView does not at present load data where the Q and I(Q) data are in 
separate files.*

.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ

.. _2D_Formats:

2D Formats
----------

SasView will only read files in the NIST 2D format with the extensions 
.ASC or .DAT

Most of the header lines can be removed except the last line, and only the 
first three columns (Qx, Qy, and I(Qx,Qy)) are actually required.

For a description of the NIST 2D format see:
http://danse.chem.utk.edu/trac/wiki/NCNROutput1D_2DQxQy 

.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ

.. note::  This help document was last changed by Steve King, 18Feb2015