- Introduction
- Getting Started
- Systems and Subsystems
- Parameters
- Encodings
- Containers: Telemetry Packets
- Calibrators
- Alarms
- Commands
- Command Verification
- Algorithms
- Expressions
- CCSDS and CSP Headers
- Structuring Large Models
- Generating XTCE
Appendices
Name Summary¶
All public names of the yamcs.pymdb package, grouped by the chapter
that describes them. Everything is importable directly from
yamcs.pymdb, except where a submodule is noted.
Systems — Systems and Subsystems¶
SystemTop-level system, root of a model tree.
SubsystemA system nested inside another system.
Parameters — Parameters¶
ParameterBase class of all parameter kinds.
IntegerParameter,FloatParameter,EnumeratedParameter,BooleanParameter,StringParameter,BinaryParameter,AbsoluteTimeParameter,AggregateParameter,ArrayParameterThe nine parameter kinds, by engineering type.
DataSourceEnum: where a parameter’s values come from (
TELEMETERED,DERIVED,CONSTANT,LOCAL,GROUND).EpochEnum of standard time epochs (
GPS,J2000,TAI,UNIX) for absolute-time types.ChoicesType alias for enumeration states: a sequence of tuples, or a Python
Enumclass.MemberBase class for aggregate members.
IntegerMember,FloatMember,EnumeratedMember,BooleanMember,StringMember,BinaryMember,AbsoluteTimeMember,AggregateMember,ArrayMemberMember variants of each data kind, for use inside aggregates and arrays.
ParameterValueReference to a parameter’s value, e.g. as a dynamic array length.
ArgumentValueReference to an argument’s value, e.g. as a dynamic array length in commands.
DynamicIntegerDeprecated alias; use
ParameterValueorArgumentValue.DataType,IntegerDataType,FloatDataType,EnumeratedDataType,BooleanDataType,StringDataType,BinaryDataType,AbsoluteTimeDataType,AggregateDataType,ArrayDataTypeShared data-kind base classes. Rarely constructed directly, but useful with
isinstancewhen post-processing a model.
Encodings — Encodings¶
EncodingBase class of all encodings.
IntegerEncoding,FloatEncoding,StringEncoding,BinaryEncodingRaw representations for the respective value kinds.
IntegerTimeEncoding,FloatTimeEncoding,TimeEncodingEncodings for absolute times, adding
offset/scale(TimeEncodingis the union of the two).IntegerEncodingScheme,FloatEncodingSchemeEnums selecting the binary scheme (two’s complement, IEEE 754, …).
CharsetEnum of character sets for string encodings.
uint1_t…uint32_t,int8_t…int32_t,uint16le_t,uint32le_t,int16le_t,int32le_t,float32_t,float64_t,float32le_t,float64le_t,bool_tPredefined encoding constants for common cases.
Containers — Containers: Telemetry Packets¶
ContainerA telemetry packet (or reusable packet fragment).
ParameterEntryPlaces a parameter in a container (also usable in commands).
ContainerEntryEmbeds a container inside another container.
Calibrators — Calibrators¶
CalibratorBase class for raw-to-engineering conversions.
PolynomialCalibration by polynomial coefficients.
InterpolateCalibration by piecewise linear interpolation.
Alarms — Alarms¶
AlarmBase class for alarm definitions.
AlarmLevelEnum of severity levels (
WATCH…SEVERE).ThresholdAlarmNumeric limit alarms per severity level.
EnumerationAlarmAlarm levels per enumeration state.
ThresholdContextAlarm,EnumerationContextAlarmAlternative alarm specifications that apply while a context expression holds.
Commands — Commands¶
CommandA telecommand definition.
CommandLevelEnum of command significance (
NORMAL,VITAL,CRITICAL,FORBIDDEN).ArgumentBase class of all argument kinds.
IntegerArgument,FloatArgument,EnumeratedArgument,BooleanArgument,StringArgument,BinaryArgument,AbsoluteTimeArgument,AggregateArgument,ArrayArgumentThe nine argument kinds, by engineering type.
ArgumentEntryPlaces an argument in the encoded command.
FixedValueEntryPlaces a constant in the encoded command.
CommandEntryType alias:
ArgumentEntry,ParameterEntryorFixedValueEntry.TransmissionConstraintTelemetry condition that must hold before a command is released.
Command verification — Command Verification¶
VerifierBase class of all verifiers.
TransferredToRangeVerifier,SentFromRangeVerifier,ReceivedVerifier,AcceptedVerifier,QueuedVerifier,ExecutionVerifier,CompleteVerifier,FailedVerifierVerifiers per command lifecycle stage.
AlgorithmCheck,ContainerCheck,ExpressionCheck,CheckThe checks a verifier can perform (
Checkis the union).TerminationActionEnum: effect of a verifier outcome on the whole command (
SUCCESS,FAIL).
Algorithms — Algorithms¶
AlgorithmA named algorithm attached to a system.
InputParameter,OutputParameterBindings between parameters and algorithm variables.
Trigger,ParameterTrigger,ContainerTriggerWhen an algorithm runs.
UnnamedAlgorithm,UnnamedJavaAlgorithm,UnnamedJavaScriptAlgorithmInline algorithms for encoders, decoders and verifier checks.
hex_string_decoder,remaining_binary_decoder,reverse_binary_decoder,reverse_binary_encoderReady-made decoders/encoders shipping with Yamcs.
AncillaryData,AncillaryDataItemRicher form of the
extraoption of inline algorithms, supporting URLs and MIME types per item.
Expressions — Expressions¶
eq,ne,lt,lte,gt,gteComparison helpers.
all_of,any_ofAND / OR combinators.
Expression,EqExpression,NeExpression,LtExpression,LteExpression,GtExpression,GteExpression,AndExpression,OrExpressionClass forms of the helpers above.
ParameterMember,ArgumentMemberReferences to a member inside an aggregate parameter or argument.
Packet headers — CCSDS and CSP Headers¶
ccsds.add_ccsds_header,ccsds.CcsdsHeaderCCSDS Space Packet primary header (module
yamcs.pymdb.ccsds).csp.add_csp_header,csp.CspHeaderCubeSat Space Protocol header (module
yamcs.pymdb.csp).
Generating and validating — Generating XTCE¶
System.dump,System.dumpsExport a system tree as XTCE.
checks.check_complete_verifiers,checks.check_float_encoding,checks.check_little_endian_onlyModel sanity checks (module
yamcs.pymdb.checks).ExportError,DuplicateNameError,SizeCalculationErrorExceptions raised by the library.