Filling Out the Old Spectral Dictionary Classes
The Spectral Discipline Dictionary contains classes used in the <Discipline_Area> of a label to describe the spectral characteristics of an array-type data object.
Contents
<Spectral_Characteristics>
This is the wrapper class that should be used to identifier all the classes relevant to a single spectral data object. If your product contains spectral objects with differing characteristics, then this class should be repeated once for each unique set of characteristics. You can also indicate that the characteristics in this class apply to more than one spectrum in the product, when that is the case.
<comment>
OPTIONAL
This is a place for additional free-format text description, as needed.
<bin_width_desc>
REQUIRED
You must supply a description of how the bin width for this spectrum was determined or calculated. Include the shape of the bin (gaussian, square wave, etc.) and define what "bin width" means (e.g., full width at half max).
<Local_Internal_Reference>
REQUIRED
This class provides a reference to a spectral data object elsewhere in the label. It may be repeated for each spectral data object sharing these characteristics.
<local_identifier_reference>
REQUIRED
The value of this attribute must correspond to the value of a <local_identifier> attribute in one of the spectral data objects defined elsewhere in this product label. Case counts.
<local_reference_type>
REQUIRED
This attribute must have the value spectral_characteristics_to_array_object
<comment>
OPTIONAL
A place for free-format text notes to users.
<Axis_Uniformly_Sampled>
OPTIONAL
- [But NOTE that at least one of <Axis_Uniformly_Sampled>, <Axis_Bin_Set>, and <Spectral_Lookup> must be specified.]
Use this class when the spectrum is uniformly sampled (i.e., in such a way that the bin centers and widths can be calculated) along an axis. You may repeat this class for each axis that is uniformly sample, if there is more than one.
<sampling_parameter_type>
REQUIRED
This attribute must contain one of the following values:
- frequency
- wavelength
- wavenumber
<sampling_interval>
REQUIRED
This value indicates the point-to-point difference in the sampling bins in units appropriate to the sampling_parameter_type. You must specify the correct unit as an XML attribute. So, for example:
<sampling_interval unit="Hz">52</sampling_interval>
...assuming the sampling_parameter_type was "frequency".
Valid units for each sampling_parameter_type are (spelling and case count):
- frequency
- Hz
- wavelength
- Angstrom
- cm
- m
- micrometer
- mm
- nm
- wavenumber
- cm**-1
- m**-1
- nm**-1
<bin_width>
REQUIRED
This attribute specifies the total width of a bin, in the same units as used for sampling_interval. You must specify the unit.
<first_center_value>
REQUIRED
This attribute is the value of the sampling parameter at the center of the first spectral bin, in the same units as used for sampling_interval. You must specify the unit.
<last_center_value>
REQUIRED
This attribute is the value of the sampling parameter at the center of the last spectral bin, in the same units as used for sampling_interval. You must specify the unit.
|
<Local_Internal_Reference>
REQUIRED
This class provides a reference to a spectral data object elsewhere in the label. It may be repeated in the extremely unlikely even that you have two axes which are uniformly sampled in precisely the same way.
<local_identifier_reference>
REQUIRED
The value of this attribute must correspond to the value of a <local_identifier> attribute in one of the spectral data objects defined elsewhere in this product label. Case counts.
<local_reference_type>
REQUIRED
This attribute must have the value spectral_characteristics_to_array_object
<comment>
OPTIONAL
A place for free-format text notes to users.