XTCE13 — clarify semantics of context cals (possibly same as context alarms)

Clarify that the list of contexts is in a specific ordering, and that as it stands now the <xsd:sequence> is in an order and that's the ordering. Or, consider adding a required "ordering" attribute to enforce the order. Or perhaps that subtly changes the semantics and we don't want to do any of it in which case we might say that...

Add additional ContextCalibrator annotation

The ContextCalibratorListType alludes to the desired behavior, but that definition does not appear on the elements themselves in the FloatDataEncodingType and IntegerDataEncodingType definitions.

Propose to update the annotation on these.

Existing FloatDataEncodingType:

<complexType name="FloatDataEncodingType">
<annotation>
<documentation xml:lang="en">For common encodings of floating point data</documentation>
</annotation>
<complexContent>
<extension base="xtce:DataEncodingType">
<sequence>
<element name="DefaultCalibrator" type="xtce:CalibratorType" minOccurs="0">
<annotation>
<documentation xml:lang="en">Calibrator to be applied to the raw uncalibrated value to arrive at the engineering/calibrated value when no Context Calibrators are provided or evaluate to true, based on their MatchCriteria.</documentation>
</annotation>
</element>
<element name="ContextCalibratorList" type="xtce:ContextCalibratorListType" minOccurs="0">
<annotation>
<documentation xml:lang="en">Calibrator to be applied to the raw uncalibrated value to arrive at the engineering/calibrated value when a MatchCriteria evaluates to true.</documentation>
</annotation>
</element>
</sequence>
<attribute name="encoding" type="xtce:FloatEncodingType" default="IEEE754_1985">
<annotation>
<documentation xml:lang="en">Specifies real/decimal numeric value to raw encoding method, with the default being "IEEE754_1985".</documentation>
</annotation>
</attribute>
<attribute name="sizeInBits" type="xtce:FloatEncodingSizeInBitsType" default="32">
<annotation>
<documentation xml:lang="en">Number of bits to use for the float raw encoding method, with 32 being the default. Not every number of bits is valid for each encoding method.</documentation>
<appinfo>Verify the number of bits for encoding is valid for the encoding method.</appinfo>
</annotation>
</attribute>
<attribute name="changeThreshold" type="double" use="optional">
<annotation>
<documentation>A changeThreshold may optionally be specified to inform systems of the minimum change in value that is significant. This is used by some systems to limit the telemetry processing and/or recording requirements. If the value is unspecified or zero, any change is significant.</documentation>
</annotation>
</attribute>
</extension>
</complexContent>
</complexType>

New FloatDataEncodingType (note only 1 sentence change in the documentation):

<complexType name="FloatDataEncodingType">
<annotation>
<documentation xml:lang="en">For common encodings of floating point data</documentation>
</annotation>
<complexContent>
<extension base="xtce:DataEncodingType">
<sequence>
<element name="DefaultCalibrator" type="xtce:CalibratorType" minOccurs="0">
<annotation>
<documentation xml:lang="en">Calibrator to be applied to the raw uncalibrated value to arrive at the engineering/calibrated value when no Context Calibrators are provided or evaluate to true, based on their MatchCriteria.</documentation>
</annotation>
</element>
<element name="ContextCalibratorList" type="xtce:ContextCalibratorListType" minOccurs="0">
<annotation>
<documentation xml:lang="en">Calibrator to be applied to the raw uncalibrated value to arrive at the engineering/calibrated value when a MatchCriteria evaluates to true. The first in the list to match takes precedence.</documentation>
</annotation>
</element>
</sequence>
<attribute name="encoding" type="xtce:FloatEncodingType" default="IEEE754_1985">
<annotation>
<documentation xml:lang="en">Specifies real/decimal numeric value to raw encoding method, with the default being "IEEE754_1985".</documentation>
</annotation>
</attribute>
<attribute name="sizeInBits" type="xtce:FloatEncodingSizeInBitsType" default="32">
<annotation>
<documentation xml:lang="en">Number of bits to use for the float raw encoding method, with 32 being the default. Not every number of bits is valid for each encoding method.</documentation>
<appinfo>Verify the number of bits for encoding is valid for the encoding method.</appinfo>
</annotation>
</attribute>
<attribute name="changeThreshold" type="double" use="optional">
<annotation>
<documentation>A changeThreshold may optionally be specified to inform systems of the minimum change in value that is significant. This is used by some systems to limit the telemetry processing and/or recording requirements. If the value is unspecified or zero, any change is significant.</documentation>
</annotation>
</attribute>
</extension>
</complexContent>
</complexType>

Existing IntegerDataEncodingType:

<complexType name="IntegerDataEncodingType">
<annotation>
<documentation xml:lang="en">For all major encodings of integer data</documentation>
</annotation>
<complexContent>
<extension base="xtce:DataEncodingType">
<sequence>
<element name="DefaultCalibrator" type="xtce:CalibratorType" minOccurs="0">
<annotation>
<documentation xml:lang="en">Calibrator to be applied to the raw uncalibrated value to arrive at the engineering/calibrated value when no Context Calibrators are provided or evaluate to true, based on their MatchCriteria.</documentation>
</annotation>
</element>
<element name="ContextCalibratorList" type="xtce:ContextCalibratorListType" minOccurs="0">
<annotation>
<documentation xml:lang="en">Calibrator to be applied to the raw uncalibrated value to arrive at the engineering/calibrated value when a MatchCriteria evaluates to true.</documentation>
</annotation>
</element>
</sequence>
<attribute name="encoding" type="xtce:IntegerEncodingType" default="unsigned">
<annotation>
<documentation xml:lang="en">Specifies integer numeric value to raw encoding method, with the default being "unsigned".</documentation>
</annotation>
</attribute>
<attribute name="sizeInBits" type="xtce:PositiveLongType" default="8">
<annotation>
<documentation xml:lang="en">Number of bits to use for the raw encoding, with 8 being the default.</documentation>
</annotation>
</attribute>
<attribute name="changeThreshold" type="xtce:NonNegativeLongType" use="optional">
<annotation>
<documentation xml:lang="en">A changeThreshold may optionally be specified to inform systems of the minimum change in value that is significant. This is used by some systems to limit the telemetry processing and/or recording requirements, such as for an analog-to-digital converter that dithers in the least significant bit. If the value is unspecified or zero, any change is significant.</documentation>
</annotation>
</attribute>
</extension>
</complexContent>
</complexType>

New IntegerDataEncodingType (note only 1 sentence change in the documentation):

<complexType name="IntegerDataEncodingType">
<annotation>
<documentation xml:lang="en">For all major encodings of integer data</documentation>
</annotation>
<complexContent>
<extension base="xtce:DataEncodingType">
<sequence>
<element name="DefaultCalibrator" type="xtce:CalibratorType" minOccurs="0">
<annotation>
<documentation xml:lang="en">Calibrator to be applied to the raw uncalibrated value to arrive at the engineering/calibrated value when no Context Calibrators are provided or evaluate to true, based on their MatchCriteria.</documentation>
</annotation>
</element>
<element name="ContextCalibratorList" type="xtce:ContextCalibratorListType" minOccurs="0">
<annotation>
<documentation xml:lang="en">Calibrator to be applied to the raw uncalibrated value to arrive at the engineering/calibrated value when a MatchCriteria evaluates to true. The first in the list to match takes precedence.</documentation>
</annotation>
</element>
</sequence>
<attribute name="encoding" type="xtce:IntegerEncodingType" default="unsigned">
<annotation>
<documentation xml:lang="en">Specifies integer numeric value to raw encoding method, with the default being "unsigned".</documentation>
</annotation>
</attribute>
<attribute name="sizeInBits" type="xtce:PositiveLongType" default="8">
<annotation>
<documentation xml:lang="en">Number of bits to use for the raw encoding, with 8 being the default.</documentation>
</annotation>
</attribute>
<attribute name="changeThreshold" type="xtce:NonNegativeLongType" use="optional">
<annotation>
<documentation xml:lang="en">A changeThreshold may optionally be specified to inform systems of the minimum change in value that is significant. This is used by some systems to limit the telemetry processing and/or recording requirements, such as for an analog-to-digital converter that dithers in the least significant bit. If the value is unspecified or zero, any change is significant.</documentation>
</annotation>
</attribute>
</extension>
</complexContent>
</complexType>