- Systems
- Parameters
- DataSource
- Parameter
- Basic parameters
AbsoluteTimeParameter
AbsoluteTimeParameter.__init__()
AbsoluteTimeParameter.aliases
AbsoluteTimeParameter.data_source
AbsoluteTimeParameter.encoding
AbsoluteTimeParameter.extra
AbsoluteTimeParameter.initial_value
AbsoluteTimeParameter.long_description
AbsoluteTimeParameter.name
AbsoluteTimeParameter.persistent
AbsoluteTimeParameter.qualified_name
AbsoluteTimeParameter.reference
AbsoluteTimeParameter.short_description
AbsoluteTimeParameter.system
AbsoluteTimeParameter.units
BinaryParameter
BinaryParameter.__init__()
BinaryParameter.aliases
BinaryParameter.data_source
BinaryParameter.encoding
BinaryParameter.extra
BinaryParameter.initial_value
BinaryParameter.long_description
BinaryParameter.max_length
BinaryParameter.min_length
BinaryParameter.name
BinaryParameter.persistent
BinaryParameter.qualified_name
BinaryParameter.short_description
BinaryParameter.system
BinaryParameter.units
FloatParameter
FloatParameter.__init__()
FloatParameter.alarm
FloatParameter.aliases
FloatParameter.bits
FloatParameter.calibrator
FloatParameter.context_alarms
FloatParameter.data_source
FloatParameter.encoding
FloatParameter.extra
FloatParameter.initial_value
FloatParameter.long_description
FloatParameter.maximum
FloatParameter.maximum_inclusive
FloatParameter.minimum
FloatParameter.minimum_inclusive
FloatParameter.name
FloatParameter.persistent
FloatParameter.qualified_name
FloatParameter.short_description
FloatParameter.system
FloatParameter.units
IntegerParameter
IntegerParameter.__init__()
IntegerParameter.alarm
IntegerParameter.aliases
IntegerParameter.bits
IntegerParameter.calibrator
IntegerParameter.context_alarms
IntegerParameter.data_source
IntegerParameter.encoding
IntegerParameter.extra
IntegerParameter.initial_value
IntegerParameter.long_description
IntegerParameter.maximum
IntegerParameter.minimum
IntegerParameter.name
IntegerParameter.persistent
IntegerParameter.qualified_name
IntegerParameter.short_description
IntegerParameter.signed
IntegerParameter.system
IntegerParameter.units
StringParameter
StringParameter.__init__()
StringParameter.aliases
StringParameter.data_source
StringParameter.encoding
StringParameter.extra
StringParameter.initial_value
StringParameter.long_description
StringParameter.max_length
StringParameter.min_length
StringParameter.name
StringParameter.persistent
StringParameter.qualified_name
StringParameter.short_description
StringParameter.system
StringParameter.units
- Enumerated parameters
BooleanParameter
BooleanParameter.__init__()
BooleanParameter.aliases
BooleanParameter.data_source
BooleanParameter.encoding
BooleanParameter.extra
BooleanParameter.initial_value
BooleanParameter.long_description
BooleanParameter.name
BooleanParameter.one_string_value
BooleanParameter.persistent
BooleanParameter.qualified_name
BooleanParameter.short_description
BooleanParameter.system
BooleanParameter.units
BooleanParameter.zero_string_value
EnumeratedParameter
EnumeratedParameter.__init__()
EnumeratedParameter.alarm
EnumeratedParameter.aliases
EnumeratedParameter.choices
EnumeratedParameter.context_alarms
EnumeratedParameter.data_source
EnumeratedParameter.encoding
EnumeratedParameter.extra
EnumeratedParameter.initial_value
EnumeratedParameter.label_for()
EnumeratedParameter.long_description
EnumeratedParameter.name
EnumeratedParameter.persistent
EnumeratedParameter.qualified_name
EnumeratedParameter.short_description
EnumeratedParameter.system
EnumeratedParameter.units
- Complex parameters
AggregateParameter
AggregateParameter.__init__()
AggregateParameter.aliases
AggregateParameter.data_source
AggregateParameter.encoding
AggregateParameter.extra
AggregateParameter.find_member()
AggregateParameter.initial_value
AggregateParameter.long_description
AggregateParameter.members
AggregateParameter.name
AggregateParameter.persistent
AggregateParameter.qualified_name
AggregateParameter.short_description
AggregateParameter.system
AggregateParameter.units
ArrayParameter
ArrayParameter.__init__()
ArrayParameter.aliases
ArrayParameter.data_source
ArrayParameter.data_type
ArrayParameter.encoding
ArrayParameter.extra
ArrayParameter.initial_value
ArrayParameter.length
ArrayParameter.long_description
ArrayParameter.name
ArrayParameter.persistent
ArrayParameter.qualified_name
ArrayParameter.short_description
ArrayParameter.system
ArrayParameter.units
- Containers
- Algorithms
- Commands
- Encodings
- Calibrators
- Alarms
- Ancillary
- Data Types
- Exceptions
- Expressions
- Verifiers
Parameters¶
DataSource¶
- class yamcs.pymdb.DataSource¶
Bases:
Enum
The nature of the source entity for which a parameter receives a value
- TELEMETERED = 1¶
A telemetered parameter is one that will have values in telemetry
- CONSTANT = 3¶
A constant parameter is one that is used as a constant in the system (e.g. a vehicle id)
- LOCAL = 4¶
A local parameter is one that is used purely by the software locally (e.g. a ground command counter)
- GROUND = 5¶
A ground parameter is one that is generated by an asset which is not the spacecraft
Parameter¶
- class yamcs.pymdb.Parameter¶
Bases:
DataType
Base class for a telemetry parameter.
If parameters are to be used as entries of telemetry or command containers, an encoding should also be specified, describing the raw encoding.
Implementations are:
AbsoluteTimeParameter
,BinaryParameter
,BooleanParameter
,EnumeratedParameter
,FloatParameter
,IntegerParameter
andStringParameter
.And complex parameters
AggregateParameter
andArrayParameter
. These do not directly specify an encoding, but group together other parameters.Each of these implementations matches a native engineering type in Yamcs.
- __init__(system: System, name: str, *, aliases: Mapping[str, str] | None = None, data_source: DataSource = DataSource.TELEMETERED, initial_value: Any = None, persistent: bool = True, short_description: str | None = None, long_description: str | None = None, extra: Mapping[str, str] | None = None, units: str | None = None, encoding: Encoding | None = None) → None¶
- data_source: DataSource¶
The nature of the source entity for which this parameter receives a value
- encoding: Encoding | None¶
How this data is sent or received from some non-native, off-platform device. (e.g. a spacecraft)
- initial_value: Any¶
Initial value
- persistent: bool¶
If true, the parameter’s last value is restored in case of a restart of the Yamcs system.
If
initial_value
is set too, attr:initial_value is only used once (when there is no other value to persist).
Basic parameters¶
- class yamcs.pymdb.AbsoluteTimeParameter¶
Bases:
Parameter
,AbsoluteTimeDataType
A parameter where engineering values represent an instant in time
- __init__(system: System, name: str, reference: Epoch | datetime | AbsoluteTimeParameter, aliases: Mapping[str, str] | None = None, data_source: DataSource = DataSource.TELEMETERED, initial_value: Any = None, persistent: bool = True, short_description: str | None = None, long_description: str | None = None, extra: Mapping[str, str] | None = None, units: str | None = None, encoding: TimeEncoding | None = None) → None¶
- data_source: DataSource¶
The nature of the source entity for which this parameter receives a value
- encoding: Encoding | None¶
How this data is sent or received from some non-native, off-platform device. (e.g. a spacecraft)
- initial_value: Any¶
Initial value
- persistent: bool¶
If true, the parameter’s last value is restored in case of a restart of the Yamcs system.
If
initial_value
is set too, attr:initial_value is only used once (when there is no other value to persist).
- property qualified_name: str¶
Absolute path of this item covering the full system tree. For example, an item
C
in a subystemB
of a top-level systemA
is represented as/A/B/C
- reference: Epoch | datetime | AbsoluteTimeParameter¶
- class yamcs.pymdb.BinaryParameter¶
Bases:
Parameter
,BinaryDataType
A parameter where engineering values represent binary
- __init__(system: System, name: str, min_length: int | None = None, max_length: int | None = None, aliases: Mapping[str, str] | None = None, data_source: DataSource = DataSource.TELEMETERED, initial_value: Any = None, persistent: bool = True, short_description: str | None = None, long_description: str | None = None, extra: Mapping[str, str] | None = None, units: str | None = None, encoding: Encoding | None = None) → None¶
- data_source: DataSource¶
The nature of the source entity for which this parameter receives a value
- encoding: Encoding | None¶
How this data is sent or received from some non-native, off-platform device. (e.g. a spacecraft)
- initial_value: Any¶
Initial value
- persistent: bool¶
If true, the parameter’s last value is restored in case of a restart of the Yamcs system.
If
initial_value
is set too, attr:initial_value is only used once (when there is no other value to persist).
- class yamcs.pymdb.FloatParameter¶
Bases:
Parameter
,FloatDataType
A parameter where engineering values represent a decimal
- __init__(system: System, name: str, bits: Literal[32, 64] = 32, minimum: float | None = None, minimum_inclusive: bool = True, maximum: float | None = None, maximum_inclusive: bool = True, aliases: Mapping[str, str] | None = None, data_source: DataSource = DataSource.TELEMETERED, initial_value: Any = None, persistent: bool = True, short_description: str | None = None, long_description: str | None = None, extra: Mapping[str, str] | None = None, units: str | None = None, encoding: Encoding | None = None, calibrator: Calibrator | None = None, alarm: ThresholdAlarm | None = None, context_alarms: Sequence[ThresholdContextAlarm] | None = None) → None¶
- alarm: ThresholdAlarm | None¶
Specification for alarm monitoring
- bits: Literal[32, 64]¶
- calibrator: Calibrator | None¶
Describes how a raw value is transformed to an engineering value
- context_alarms: list[ThresholdContextAlarm]¶
Alarm specification when a specific context expression applies
- data_source: DataSource¶
The nature of the source entity for which this parameter receives a value
- encoding: Encoding | None¶
How this data is sent or received from some non-native, off-platform device. (e.g. a spacecraft)
- initial_value: Any¶
Initial value
- persistent: bool¶
If true, the parameter’s last value is restored in case of a restart of the Yamcs system.
If
initial_value
is set too, attr:initial_value is only used once (when there is no other value to persist).
- class yamcs.pymdb.IntegerParameter¶
Bases:
Parameter
,IntegerDataType
A parameter where engineering values represent an integer
- __init__(system: System, name: str, signed: bool = True, bits: int = 32, minimum: int | None = None, maximum: int | None = None, aliases: Mapping[str, str] | None = None, data_source: DataSource = DataSource.TELEMETERED, initial_value: Any = None, persistent: bool = True, short_description: str | None = None, long_description: str | None = None, extra: Mapping[str, str] | None = None, units: str | None = None, encoding: Encoding | None = None, calibrator: Calibrator | None = None, alarm: ThresholdAlarm | None = None, context_alarms: Sequence[ThresholdContextAlarm] | None = None) → None¶
- alarm: ThresholdAlarm | None¶
Specification for alarm monitoring
- calibrator: Calibrator | None¶
Describes how a raw value is transformed to an engineering value
- context_alarms: list[ThresholdContextAlarm]¶
Alarm specification when a specific context expression applies
- data_source: DataSource¶
The nature of the source entity for which this parameter receives a value
- encoding: Encoding | None¶
How this data is sent or received from some non-native, off-platform device. (e.g. a spacecraft)
- initial_value: Any¶
Initial value
- persistent: bool¶
If true, the parameter’s last value is restored in case of a restart of the Yamcs system.
If
initial_value
is set too, attr:initial_value is only used once (when there is no other value to persist).
- class yamcs.pymdb.StringParameter¶
Bases:
Parameter
,StringDataType
A parameter where engineering values represent a character string
- __init__(system: System, name: str, min_length: int | None = None, max_length: int | None = None, aliases: Mapping[str, str] | None = None, data_source: DataSource = DataSource.TELEMETERED, initial_value: Any = None, persistent: bool = True, short_description: str | None = None, long_description: str | None = None, extra: Mapping[str, str] | None = None, units: str | None = None, encoding: Encoding | None = None) → None¶
- data_source: DataSource¶
The nature of the source entity for which this parameter receives a value
- encoding: Encoding | None¶
How this data is sent or received from some non-native, off-platform device. (e.g. a spacecraft)
- initial_value: Any¶
Initial value
- persistent: bool¶
If true, the parameter’s last value is restored in case of a restart of the Yamcs system.
If
initial_value
is set too, attr:initial_value is only used once (when there is no other value to persist).
Enumerated parameters¶
Enumerated parameters can only represent discrete values. Booleans are a special kind of enumerated parameter that only knows two states.
- class yamcs.pymdb.BooleanParameter¶
Bases:
Parameter
,BooleanDataType
A parameter where engineering values represent a boolean enumeration
- __init__(system: System, name: str, zero_string_value: str = 'False', one_string_value: str = 'True', aliases: Mapping[str, str] | None = None, data_source: DataSource = DataSource.TELEMETERED, initial_value: Any = None, persistent: bool = True, short_description: str | None = None, long_description: str | None = None, extra: Mapping[str, str] | None = None, units: str | None = None, encoding: Encoding | None = None) → None¶
- data_source: DataSource¶
The nature of the source entity for which this parameter receives a value
- encoding: Encoding | None¶
How this data is sent or received from some non-native, off-platform device. (e.g. a spacecraft)
- initial_value: Any¶
Initial value
- persistent: bool¶
If true, the parameter’s last value is restored in case of a restart of the Yamcs system.
If
initial_value
is set too, attr:initial_value is only used once (when there is no other value to persist).
- class yamcs.pymdb.EnumeratedParameter¶
Bases:
Parameter
,EnumeratedDataType
A parameter where engineering values represent states in an enumeration
- __init__(system: System, name: str, choices: Choices, alarm: EnumerationAlarm | None = None, context_alarms: Sequence[EnumerationContextAlarm] | None = None, aliases: Mapping[str, str] | None = None, data_source: DataSource = DataSource.TELEMETERED, initial_value: Any = None, persistent: bool = True, short_description: str | None = None, long_description: str | None = None, extra: Mapping[str, str] | None = None, units: str | None = None, encoding: Encoding | None = None) → None¶
- alarm: EnumerationAlarm | None¶
Specification for alarm monitoring
- choices: Choices¶
- context_alarms: list[EnumerationContextAlarm]¶
Alarm specification when a specific context expression applies
- data_source: DataSource¶
The nature of the source entity for which this parameter receives a value
- encoding: Encoding | None¶
How this data is sent or received from some non-native, off-platform device. (e.g. a spacecraft)
- initial_value: Any¶
Initial value
- persistent: bool¶
If true, the parameter’s last value is restored in case of a restart of the Yamcs system.
If
initial_value
is set too, attr:initial_value is only used once (when there is no other value to persist).
Complex parameters¶
- class yamcs.pymdb.AggregateParameter¶
Bases:
Parameter
,AggregateDataType
A parameter where engineering values represent a structure of other data types, referred to as members
- __init__(system: System, name: str, members: Sequence[Member], aliases: Mapping[str, str] | None = None, data_source: DataSource = DataSource.TELEMETERED, initial_value: Any = None, persistent: bool = True, short_description: str | None = None, long_description: str | None = None, extra: Mapping[str, str] | None = None, encoding: Encoding | None = None) → None¶
- data_source: DataSource¶
The nature of the source entity for which this parameter receives a value
- encoding: Encoding | None¶
How this data is sent or received from some non-native, off-platform device. (e.g. a spacecraft)
- initial_value: Any¶
Initial value
- persistent: bool¶
If true, the parameter’s last value is restored in case of a restart of the Yamcs system.
If
initial_value
is set too, attr:initial_value is only used once (when there is no other value to persist).
- class yamcs.pymdb.ArrayParameter¶
Bases:
Parameter
,ArrayDataType
A parameter where engineering values represent an array where each element is of another data type
- __init__(system: System, name: str, data_type: DataType, length: int | DynamicInteger, aliases: Mapping[str, str] | None = None, data_source: DataSource = DataSource.TELEMETERED, initial_value: Any = None, persistent: bool = True, short_description: str | None = None, long_description: str | None = None, extra: Mapping[str, str] | None = None, encoding: Encoding | None = None) → None¶
- data_source: DataSource¶
The nature of the source entity for which this parameter receives a value
- encoding: Encoding | None¶
How this data is sent or received from some non-native, off-platform device. (e.g. a spacecraft)
- initial_value: Any¶
Initial value
- length: int | DynamicInteger¶
- persistent: bool¶
If true, the parameter’s last value is restored in case of a restart of the Yamcs system.
If
initial_value
is set too, attr:initial_value is only used once (when there is no other value to persist).