cansas1d documentation

Disclaimer

This description is meant to inform the community how to layout the information within the XML files. However, should the information in this document and the 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

<?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 cansas1d.xsd"
	version="0.1a">

NOTE

We (canSAS) will have to be able to provide the cansas1d.xsd as a page on the WWW. We should use that URL here.

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
description

aperture

[0..inf]
describes an aperture position, size, and shape

beam_center

[..]

beam_shape

[..]

beam_size

[..]

date

[..]

description

[..]

details

[..]

distance

[..]

I

[..]

ID

[..]

Idata

[..]

Idev

[..]

name

[..]

offset

[..]

orientation

[..]

pitch

[..]

pixel_size

[..]

Q

[..]

Qdev

[..]

Qfwhm

[..]

Qmean

[..]

radiation

[..]

roll

[..]

Run

[..]

SAScollimation

[..]

SASdetector

[..]

SASentry

[1..inf]
Describes a single 1-D SAS data scan.
Time-resolved experiments or others with series data should put each step in the series into its own SASentry.

SASinstrument

[1..1]
describes the SAS instrument used to provide this SASentry

SASnote

[0..inf]
allows for other information to be added to a SASentry

SASprocess

[0..inf]
describes a data processing or analysis step

SASprocessnote

[..]

SASroot

[1..1]
(required) root node of the canSAS 1-D reduced SAS data file in XML

SASsample

[1..1]
describes the sample

SASsource

[..]

SDD

[..]

Shadowfactor

[..]

size

[..]

temperature

[..]

term

[..]

thickness

[..]

Title

[..]

transmission

[..]

wavelength_max

[..]

wavelength_min

[..]

wavelength_spread

[..]

wavelength

[..]

x

[..]

y

[..]

yaw

[..]

z

[..]

attributes

name

type

unit

version

rules

1. no whitespace padding of value fields
2. Q=(4 π / λ) sin(θ)
   where λ is the wavelength of the radiation and 2θ is the angle through which the detected radiation has been scattered.
3. units to be given in standard SI abbreviations (eg, m, cm, mm, nm, K) with the following exceptions:
   1. um=micrometres
   2. C=celsius
   3. A=Angstroms
   4. percent=%.
   5. fraction
   6. a.u.=arbitrary units
   7. none=no units are relevant (such as dimensionless)
4. where reciprocal units need to be quoted the format shall be "1/abbreviation"
5. Unicode characters MUST NOT be used
6. axes:
   1. z is along the flight path (positive value in the direction of the detector)
   2. x is orthogonal to z in the horizontal plane (positive values increase to the right when viewed towards the incoming radiation)
   3. y is orthogonal to z and x in the vertical plane (positive values increase upwards)
7. angles:
   1. roll is about z
   2. pitch is about x
   3. yaw is about y

Validation of XML against the Schema

1. open browser to: http://www.xmlvalidation.com/
2. paste content of candidate XML file into the form and press <validate>
3. paste content of cansas1d.xsd XSD file into form and press <continue validation>
4. check the results