|
|
| (93 intermediate revisions by 4 users not shown) |
| Line 1: |
Line 1: |
| ==Disclaimer==
| | This manual has been superseded (replaced) by a PDF: |
|
| |
|
| This description is meant to inform the community how to layout
| | http://svn.smallangles.net/trac/canSAS/browser/1dwg/tags/v1.0/doc/cansas-1d-1_0-manual.pdf?format=raw |
| the information within the XML files. However, should the
| |
| information in this document and the [[cansas1d.xsd | canSAS 1D SAS XML Schema]]
| |
| differ, the XML Schema will be deemed to have the most correct description
| |
| of the standard.
| |
| | |
| ==General Layout of the XML Data==
| |
| | |
| ===required XML file header===
| |
| <pre>
| |
| <?xml version="1.0"?>
| |
| <SASroot xmlns="http://www.smallangles.net/cansas1d"
| |
| xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
| |
| xsi:schemaLocation="http://www.smallangles.net/cansas1d http://www.smallangles.net/cansas1d/cansas1d.xsd"
| |
| version="1.0">
| |
| </pre>
| |
| | |
| ===overall file: layout of SASroot===
| |
| *SASroot
| |
| **SASentry
| |
| **SASentry
| |
| **SASentry ... (for each data set, time-slice, step in a series, new sample, etc.)
| |
| | |
| ===each data set: layout of the SASentry===
| |
| | |
| *SASentry
| |
| **Title
| |
| **Run
| |
| **SASdata (this is where the reduced 1-D SAS data is stored)
| |
| **SASsample
| |
| **SASinstrument
| |
| **SASprocess
| |
| **SASprocess
| |
| **SASprocess... (for each processing or analysis step)
| |
| **SASnote
| |
| **SASnote
| |
| **SASnote... (anything at all)
| |
| | |
| ==Definition of terms==
| |
| | |
| ;term:quantity <br> description
| |
| ;<tt>aperture</tt>: [0..inf] <br> describes an aperture position, size, and shape
| |
| ;<tt>beam_center</tt>: [..] <br>
| |
| ;<tt>beam_shape</tt>: [..] <br>
| |
| ;<tt>beam_size</tt>: [..] <br>
| |
| ;<tt>date</tt>: [..] <br>
| |
| ;<tt>description</tt>: [..] <br>
| |
| ;<tt>details</tt>: [..] <br>
| |
| ;<tt>distance</tt>: [..] <br>
| |
| ;<tt>I</tt>: [..] <br>
| |
| ;<tt>ID</tt>: [..] <br>
| |
| ;<tt>Idata</tt>: [..] <br>
| |
| ;<tt>Idev</tt>: [..] <br>
| |
| ;<tt>name</tt>: [..] <br>
| |
| ;<tt>offset</tt>: [..] <br>
| |
| ;<tt>orientation</tt>: [..] <br>
| |
| ;<tt>pitch</tt>: [..] <br>
| |
| ;<tt>pixel_size</tt>: [..] <br>
| |
| ;<tt>Q</tt>: [..] <br>
| |
| ;<tt>Qdev</tt>: [..] <br>
| |
| ;<tt>Qfwhm</tt>: [..] <br>
| |
| ;<tt>Qmean</tt>: [..] <br>
| |
| ;<tt>radiation</tt>: [..] <br>
| |
| ;<tt>roll</tt>: [..] <br>
| |
| ;<tt>Run</tt>: [..] <br>
| |
| ;<tt>SAScollimation</tt>: [..] <br>
| |
| ;<tt>SASdetector</tt>: [..] <br>
| |
| ;<tt>SASentry</tt>: [1..inf] <br> Describes a single 1-D SAS data scan. <br> Time-resolved experiments or others with series data should put each step in the series into its own SASentry.
| |
| ;<tt>SASinstrument</tt>: [1..1] <br> describes the SAS instrument used to provide this SASentry
| |
| ;<tt>SASnote</tt>: [0..inf] <br> allows for other information to be added to a SASentry
| |
| ;<tt>SASprocess</tt>: [0..inf] <br> describes a data processing or analysis step
| |
| ;<tt>SASprocessnote</tt>: [..] <br>
| |
| ;<tt>SASroot</tt>: [1..1] <br> (required) root node of the canSAS 1-D reduced SAS data file in XML
| |
| ;<tt>SASsample</tt>: [1..1] <br> describes the sample
| |
| ;<tt>SASsource</tt>: [..] <br>
| |
| ;<tt>SDD</tt>: [..] <br>
| |
| ;<tt>Shadowfactor</tt>: [..] <br>
| |
| ;<tt>size</tt>: [..] <br>
| |
| ;<tt>temperature</tt>: [..] <br>
| |
| ;<tt>term</tt>: [..] <br>
| |
| ;<tt>thickness</tt>: [..] <br>
| |
| ;<tt>Title</tt>: [..] <br>
| |
| ;<tt>transmission</tt>: [..] <br>
| |
| ;<tt>wavelength_max</tt>: [..] <br>
| |
| ;<tt>wavelength_min</tt>: [..] <br>
| |
| ;<tt>wavelength_spread</tt>: [..] <br>
| |
| ;<tt>wavelength</tt>: [..] <br>
| |
| ;<tt>x</tt>: [..] <br>
| |
| ;<tt>y</tt>: [..] <br>
| |
| ;<tt>yaw</tt>: [..] <br>
| |
| ;<tt>z</tt>: [..] <br>
| |
| | |
| ==attributes==
| |
| | |
| ;<tt>name</tt>:
| |
| ;<tt>type</tt>:
| |
| ;<tt>unit</tt>:
| |
| ;<tt>version</tt>:
| |
| | |
| ==rules==
| |
| # no whitespace padding of value fields
| |
| # Q=(4 π / λ) sin(θ) <br> where λ is the wavelength of the radiation and 2θ is the angle through which the detected radiation has been scattered.
| |
| # units to be given in standard SI abbreviations (eg, m, cm, mm, nm, K) with the following exceptions:
| |
| ##um=micrometres
| |
| ##C=celsius
| |
| ##A=Angstroms
| |
| ##percent=%.
| |
| ##fraction
| |
| ##a.u.=arbitrary units
| |
| ##none=no units are relevant (such as dimensionless)
| |
| # where reciprocal units need to be quoted the format shall be "1/abbreviation"
| |
| # Unicode characters MUST NOT be used
| |
| # axes:
| |
| ##z is along the flight path (positive value in the direction of the detector)
| |
| ##x is orthogonal to z in the horizontal plane (positive values increase to the right when viewed towards the incoming radiation)
| |
| ##y is orthogonal to z and x in the vertical plane (positive values increase upwards)
| |
| #angles:
| |
| ##roll is about z
| |
| ##pitch is about x
| |
| ##yaw is about y
| |
| | |
| ==Validation of XML against the Schema==
| |
| # open browser to: http://www.xmlvalidation.com/
| |
| # paste content of candidate XML file into the form and press <validate>
| |
| # paste content of [[cansas1d.xsd]] XSD file into form and press <continue validation>
| |
| # check the results
| |
