change names & order of columns in Idata

[prjemian]

The present standard for the order of the columns in the SAS out put file disagrees with the order agreed at the meeting. This agreement was on human-readable (not by consensus on this point—there was one dissenter) 2-6 ordered columns (the dissenter wanted the information sequential, but did not dispute order), in the following order Q; I(Q)[; Idev(Q)[; Qdev(Q) [; Qmean(Q); ShadowFactor (Q)]]]. The order of the columns WAS agreed, and for a reason: It was the one Steve and Ron used for their collaboration, the one IPNS and we use in our text outputs, and the one NIST uses in their text outputs, and the one indicating frequency of use. The history of this standard can be verified by looking at Steve and Ron’s original examples in http://svn.smallangles.net/svn/canSAS/1dwg/trunk/. Ken suggests a return in the standard to this order, with the columns in braces being optional, but the first two of them (Idev(Q) and Qdev '''in that order''') very strongly recommended.

[prjemian]

Imported from trac issue 6. Created by prjemian on 2008-03-20T13:09:00, last modified: 2008-03-20T13:09:00

[prjemian]

Trac comment by prjemian on 2008-03-20 13:10:30:

Suggest that the change be implemented as:

Q; I [; Idev] [; Qdev] [; Qmean] [; ShadowFactor]

Qfwhm will be dropped

[prjemian]

Trac comment by prjemian on 2008-03-20 13:18:49:

Andrew Jackson requests: ''Can we have dQv and dQh fields to describe slit smeared data?''

Add these columns, as well: Qh,Qv, with the special rule that: Qdev xor (dQv or dQh) That is, Qdev, dQv, or dQh are optional but Qdev cannot be appear with either of the other two. (That logic should be a bear, er ''challenge'' to implement in XML Schema.)

Columns will be: Q; I [; Idev] [ [; Qdev] | [ [; dQv] [; dQh] ] ] [; Qmean] [; ShadowFactor?]

[prjemian]

Trac comment by prjemian on 2008-03-22 23:25:04:

here's how it will be done in the cansas1d.xsd XML schema: (documentation removed)

{{{ xsd:choice

<element name="Qdev" minOccurs="0" maxOccurs="1"
    type="tns:floatUnitType" default="0">
</element>
xsd:sequence
    <element name="dQw" minOccurs="0" maxOccurs="1"
        type="tns:floatUnitType" default="0">
    </element>
    <element name="dQl" minOccurs="0" maxOccurs="1"
        type="tns:floatUnitType" default="0">
    </element>
/xsd:sequence

/xsd:choice }}}

[prjemian]

Trac comment by prjemian on 2008-03-30 14:30:05:

Slight change of plans after reviewing principles with the persons requesting the change. The desire is to represent the resolution in two dimensions of Bonse-Hart type SAS instrument. The terms '''dQh''' and '''dQv''' refer to horizontal and vertical components. These terms still remain dependent on the orientation of the SAS instrument. (Most Bonse-Hart instruments scan in the horizontal plane with vertical rotation axis. Synchrotron Bonse-Hart USAXS prefer to scan in the vertical plane with horizontal rotation axis due to favorable polarization term.)

After review, made the change to the more appropriate terms: '''dQw''' and '''dQl'''

'''dQw''': resolution in the Q-scanning direction

'''dQl''': resolution in the direction transverse to Q scanning

{{{ xsd:choice

<element name="Qdev" minOccurs="0" maxOccurs="1" 
    type="tns:floatUnitType" default="0" />
xsd:sequence
    <element name="dQw" minOccurs="0" maxOccurs="1" 
        type="tns:floatUnitType" default="0" />
    <element name="dQl" minOccurs="0" maxOccurs="1" 
        type="tns:floatUnitType" default="0" />
/xsd:sequence

/xsd:choice

}}}