source: 1dwg/branches/v1.1/doc/source/specification.rst @ 284

Last change on this file since 284 was 284, checked in by prjemian, 6 years ago

simplify to just one XSLT, rename, and revise XML files accordingly, update the docs (and call the format "cansas1d:1.1" now)

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision URL
File size: 1.8 KB


.. index:: ! cansas1d:1.1 standard

The canSAS 1-D standard for reduced 1-D SAS data is implemented using XML files. A single file can contain SAS data from a single experiment or multiple experiments. All types of relevant data (I(Q) , metadata) are described for each experiment. More details are provided below.

This is the definitive specification of cansas1d:1.1, the canSAS standard format for storing small-angle scattering data in XML files. The standard is defined using the rules of XML Schema (

.. index:: ! XML; well-formed
.. index::
        single: cansas1d:1.1 standard
        single: validation

Note that the cansas1d:1.1 XML data files must adhere to the XML rules which includes being well-formed (including the use of closing tags). [1] Files that can be validated against :ref:`cansas1d.xsd` ( are deemed to be valid cansas1d:1.1 data files.

[1]For example, see for an explanation of the XML syntax.

In this document, curly braces, {}, are used to indicate text that is supplied by the user. Such as, an attribute may be written


and this means that the user would replace {text} with text that gives, in this example, a name such as final detector. Thus resulting in:

name="final detector"

which is a well-formed XML attribute.

.. index:: element; {any}

Another example is an instance of the {any} element. Suppose one had analysis data, then {any} would be replaced with analysis and the element might look like this:

   ... analysis content goes here ...


.. toctree::
   :maxdepth: 2
Note: See TracBrowser for help on using the repository browser.