# Difference between revisions of "2012 Data Discussion Examples"

Line 233: | Line 233: | ||

different use from original 1D format, refers to a single reduced data set that can be represented thus (such as from one detector) | different use from original 1D format, refers to a single reduced data set that can be represented thus (such as from one detector) | ||

− | SASdata has | + | SASdata has some possible, as shown in this example: |

<pre> | <pre> | ||

@Q_indices=",Time,,*,*" | @Q_indices=",Time,,*,*" | ||

@I_indices="T,Time,P,Q,Q" | @I_indices="T,Time,P,Q,Q" | ||

+ | @Mask_indices=",,,Q,Q" | ||

</pre> | </pre> | ||

Line 247: | Line 248: | ||

=== @I_indices === | === @I_indices === | ||

Comma-separated list that describes which objects correspond to the indices of the I object. | Comma-separated list that describes which objects correspond to the indices of the I object. | ||

+ | For indices that involve Q, use the term "Q" and the @Q_indices attribute will provide more information. | ||

+ | |||

+ | === @Mask_indices === | ||

+ | Comma-separated list that describes which objects correspond to the indices of the Mask object. | ||

For indices that involve Q, use the term "Q" and the @Q_indices attribute will provide more information. | For indices that involve Q, use the term "Q" and the @Q_indices attribute will provide more information. |

## Revision as of 07:34, 31 July 2012

# 1D

## example of simple 1D SAS data, I(Q)

SASroot SASentry SASdata @Q_indices="*" @I_indices="Q" I: float[100] Q: float[100]

(see the Discussion page for an XML representation with the recommended minimum content)

## example of simple 1D SAS data in a time series, I(Q, t)

SASroot SASentry SASdata @Q_indices=",*" @I_indices="Time,*" I: float[nTime,100] Q: float[100] Time: float[nTime]

## example of generic 1D SAS data in a time series, I(Q(t), t)

SASroot SASentry SASdata @Q_indices="Time,*" @I_indices="Time,Q" I: float[nTime,100] Q: float[nTime,100] Time: float[nTime]

# 2D

## example of simple 2D (image) SAS data, I(Q)

SASroot SASentry SASdata @Q_indices="*,*" @I_indices="Q,Q" I: float[100, 512] Qx: float[100, 512] Qy: float[100, 512]

## example of a simple masked 2D (image) SAS data, I(Q)

SASroot SASentry SASdata @Q_indices="*,*" @I_indices="Q,Q" @Mask_indices="Q,Q" I: float[100, 512] Qx: float[100, 512] Qy: float[100, 512] Mask: int[100, 512]

## example of generic 2D SAS data, I(Q)

Could use this model, for example, to describe data from multiple detectors (by listing individual pixels off all detectors). Or, could describe data from one detector of any geometry. This is the most flexible.

SASroot SASentry SASdata @Q_indices="*" @I_indices="Q" I: float[100*512] Qx: float[100*512] Qy: float[100*512] Qz: float[100*512]

## example of generic 2D SAS data in a time series, I(Q(t),t)

SASroot SASentry SASdata @Q_indices="Time,*" @I_indices="Time,Q" I: float[nTime,100*512] Qx: float[nTime,100*512] Qy: float[nTime,100*512] Qz: float[nTime,100*512] Time: float[nTime]

## example of 2D SAS data as images in a time series with a time-dependent mask, I(Q(t),t)

This example explores a bit of complexity added to the previous example.

SASroot SASentry SASdata @Q_indices="Time,*,*" @I_indices="Time,Q,Q" @Mask_indices="Time,Q,Q" I: float[nTime,100,512] Qx: float[nTime,100,512] Qy: float[nTime,100,512] Qz: float[nTime,100,512] Time: float[nTime] Mask: int[nTime,100,512]

## example of generic 2D SAS data in a time, T, & P series, I(t,T,P,Q(t,T,P))

SASroot SASentry SASdata @Q_indices="Time,Temperature,Pressure,*" @I_indices="Time,Temperature,Pressure,Q" I: float[nTime,nTemperature,nPressure,100*512] Qx: float[nTime,nTemperature,nPressure,100*512] Qy: float[nTime,nTemperature,nPressure,100*512] Qz: float[nTime,nTemperature,nPressure,100*512] Time: float[nTime] T: float[nTemperature] P: float[nPressure]

## example of generic 2D SAS data (images) in a time, T, & P series, I(T,t,P,Q(t))

SASroot SASentry SASdata @Q_indices=",Time,,*,*" @I_indices="Temperature,Time,Pressure,Q,Q" I: float[nTemperature,nTime,nPressure,100,512] Qx: float[nTime,100,512] Qy: float[nTime,100,512] Qz: float[nTime,100,512] Time: float[nTime] Temperature: float[nTemperature] Pressure: float[nPressure]

## example of simple 2D SAS/WAS data, Isas(Q) & Iwas(Q)

Consider the multi-technique experiment that produces small-angle and wide-angle scattering data images. The reduced data results in images as well. Each image might be described separately (see example of SAS data with several detectors for an alternative). Here the SAS data image is 100 x 512 pixels. The WAS data (not covered by this canSAS standard) is 256 x 256 pixels.

SASroot SASentry SASdata @Q_indices="*,*" @I_indices="Q,Q" I: float[100, 512] Qx: float[100, 512] Qy: float[100, 512] WASdata @Q_indices="*,*" @I_indices="Q,Q" I: float[256, 256] Qx: float[256, 256] Qy: float[256, 256]

## example of SAS data with several detectors, I(Q)

Here, the data are appended to common data objects. This hypothetical case has reduced data derived from three detectors, Ia(Q), Ib(Q), and Ic(Q):

- Ia(Q) is derived from a 2D detector (100 x 512 pixels)
- Ib(Q) is derived from a 1D detector (2000 pixels)
- Ic(Q) is derived from a 2D detector (256 x 256 pixels)

SASroot SASentry SASdata @Q_indices="*" @I_indices="Q" I: float[100*512 + 2000 + 256*256] Qx: float[100*512 + 2000 + 256*256] Qy: float[100*512 + 2000 + 256*256] Qz: float[100*512 + 2000 + 256*256]

# invalid case

## example of **over-simple** 2D (image) SAS data, I(Q)

Invalid because the method of addressing the Q values is different from all the above.

SASroot SASentry SASdata @Q_indices="*,*" @I_indices=" ??? " I: float[100, 512] Qx: float[100] Qy: float[512]

# terms

## SASroot

same use as original 1D format

## SASentry

some changes from the original 1D format

## SASdata

different use from original 1D format, refers to a single reduced data set that can be represented thus (such as from one detector)

SASdata has some possible, as shown in this example:

@Q_indices=",Time,,*,*" @I_indices="T,Time,P,Q,Q" @Mask_indices=",,,Q,Q"

Commas are used as delimiters in all cases.

### @Q_indices

Comma-separated list that describes which indices are used (from the I object) to reference Q. Leave a position empty if that index is not used to describe Q, Use a "*" to describe an index that uses the Q definition. For other data storage objects, name the object for the position where it should appear.

### @I_indices

Comma-separated list that describes which objects correspond to the indices of the I object. For indices that involve Q, use the term "Q" and the @Q_indices attribute will provide more information.

### @Mask_indices

Comma-separated list that describes which objects correspond to the indices of the Mask object. For indices that involve Q, use the term "Q" and the @Q_indices attribute will provide more information.