ccsds-ndm-py 0.0.2__cp39-abi3-win_amd64.whl → 0.0.4__cp39-abi3-win_amd64.whl

ccsds_ndm/__init__.pyi

@@ -94,6 +94,15 @@ class Acm:
     @header.setter
     def header(self, value: AdmHeader) -> None: ...
     @property
+    def id(self) -> Optional[str]:
+        """
+        The message identifier.
+        """
+        ...
+
+    @id.setter
+    def id(self, value: Optional[str]) -> None: ...
+    @property
     def segment(self) -> AcmSegment:
         """
         ACM Segment.
@@ -102,19 +111,41 @@ class Acm:
 
     @segment.setter
     def segment(self, value: AcmSegment) -> None: ...
-    def to_file(self, path, format):
+    def to_file(self, path, format, validate=True):
         """ """
         ...
 
-    def to_str(self, format):
+    def to_str(self, format, validate=True):
         """ """
         ...
 
+    def validate(self, strict=True):
+        """
+        Validate the message against CCSDS rules.
+
+        Parameters
+        ----------
+        strict : bool, optional
+            If True (default), raises ValueError on the first error found.
+            If False, returns a list of validation error messages (or None if valid).
+        """
+        ...
+
+    @property
+    def version(self) -> str:
+        """
+        The message version.
+        """
+        ...
+
+    @version.setter
+    def version(self, value: str) -> None: ...
+
 class AcmAttitudeDetermination:
     """
     ACM Data: Attitude Determination Data Section.
     """
-    def __init__(ad_id, comment) -> None: ...
+    def __init__(ad_id=None, comment=None) -> None: ...
     def __getstate__(self, /):
         """
         Helper for pickle.
@@ -125,7 +156,9 @@ class AcmAttitudeState:
     """
     ACM Data: Attitude State Time History Section.
     """
-    def __init__(ref_frame_a, ref_frame_b, att_type, att_lines, comment) -> None: ...
+    def __init__(
+        ref_frame_a, ref_frame_b, att_type, att_lines, comment=None
+    ) -> None: ...
     def __getstate__(self, /):
         """
         Helper for pickle.
@@ -136,7 +169,9 @@ class AcmCovarianceMatrix:
     """
     ACM Data: Covariance Time History Section.
     """
-    def __init__(cov_basis, cov_ref_frame, cov_type, cov_lines, comment) -> None: ...
+    def __init__(
+        cov_basis, cov_ref_frame, cov_type, cov_lines, comment=None
+    ) -> None: ...
     def __getstate__(self, /):
         """
         Helper for pickle.
@@ -147,7 +182,9 @@ class AcmData:
     """
     ACM Data Section.
     """
-    def __init__(att, phys, cov, man, ad, user) -> None: ...
+    def __init__(
+        att=None, phys=None, cov=None, man=None, ad=None, user=None
+    ) -> None: ...
     def __getstate__(self, /):
         """
         Helper for pickle.
@@ -182,12 +219,17 @@ class AcmData:
 
     @user.setter
     def user(self, value: UserDefined) -> None: ...
+    def validate(self, metadata):
+        """
+        Validate the data section against CCSDS rules.
+        """
+        ...
 
 class AcmManeuverParameters:
     """
     ACM Data: Maneuver Specification Section.
     """
-    def __init__(man_id, comment) -> None: ...
+    def __init__(man_id=None, comment=None) -> None: ...
     def __getstate__(self, /):
         """
         Helper for pickle.
@@ -246,12 +288,17 @@ class AcmMetadata:
 
     @object_name.setter
     def object_name(self, value: str) -> None: ...
+    def validate(self):
+        """
+        Validate the metadata section against CCSDS rules.
+        """
+        ...
 
 class AcmPhysicalDescription:
     """
     ACM Data: Space Object Physical Characteristics Section.
     """
-    def __init__(comment) -> None: ...
+    def __init__(comment=None) -> None: ...
     def __getstate__(self, /):
         """
         Helper for pickle.
@@ -284,6 +331,11 @@ class AcmSegment:
 
     @metadata.setter
     def metadata(self, value: AcmMetadata) -> None: ...
+    def validate(self, header):
+        """
+        Validate the segment against CCSDS rules.
+        """
+        ...
 
 class AdditionalParameters:
     """
@@ -436,7 +488,7 @@ class AdmHeader:
     Represents the `admHeader` complex type from the XSD.
     """
     def __init__(
-        creation_date, originator, classification, message_id, comment
+        creation_date, originator, classification=None, message_id=None, comment=None
     ) -> None: ...
     def __getstate__(self, /):
         """
@@ -554,6 +606,15 @@ class Aem:
     @header.setter
     def header(self, value: AdmHeader) -> None: ...
     @property
+    def id(self) -> Optional[str]:
+        """
+        The message identifier.
+        """
+        ...
+
+    @id.setter
+    def id(self, value: Optional[str]) -> None: ...
+    @property
     def segments(self) -> list[AemSegment]:
         """
         AEM Segments.
@@ -562,19 +623,45 @@ class Aem:
 
     @segments.setter
     def segments(self, value: list[AemSegment]) -> None: ...
-    def to_file(self, path, format):
-        """ """
+    def to_file(self, path, format, validate=True):
+        """
+        Write to file.
+        """
         ...
 
-    def to_str(self, format):
-        """ """
+    def to_str(self, format, validate=True):
+        """
+        Serialize to string.
+        """
+        ...
+
+    def validate(self, strict=True):
+        """
+        Validate the message against CCSDS rules.
+
+        Parameters
+        ----------
+        strict : bool, optional
+            If True (default), raises ValueError on the first error found.
+            If False, returns a list of validation error messages (or None if valid).
+        """
         ...
 
+    @property
+    def version(self) -> str:
+        """
+        The message version.
+        """
+        ...
+
+    @version.setter
+    def version(self, value: str) -> None: ...
+
 class AemData:
     """
     AEM Data Section.
     """
-    def __init__(attitude_states, comment) -> None: ...
+    def __init__(attitude_states, comment=None) -> None: ...
     def __getstate__(self, /):
         """
         Helper for pickle.
@@ -591,14 +678,27 @@ class AemData:
     @attitude_states.setter
     def attitude_states(self, value: list[AttitudeState]) -> None: ...
     @property
-    def attitude_states_numpy(self) -> tuple[list[str], numpy.ndarray]:
+    def attitude_states_epochs(self) -> list[str]:
         """
-        Get attitude states as a tuple of epoch strings and a 2D NumPy array.
+        Epochs for attitude states (ISO 8601).
+        """
+        ...
+
+    @attitude_states_epochs.setter
+    def attitude_states_epochs(self, value: list[str]) -> None: ...
+    @property
+    def attitude_states_numpy(self) -> numpy.ndarray:
+        """
+        Get attitude states as a 2D NumPy array.
+
+        Use `attitude_states_epochs` for the corresponding epochs.
+
+        Currently only supports Quaternion Ephemeris states.
         """
         ...
 
     @attitude_states_numpy.setter
-    def attitude_states_numpy(self, value: tuple[list[str], numpy.ndarray]) -> None: ...
+    def attitude_states_numpy(self, value: numpy.ndarray) -> None: ...
     @property
     def comment(self) -> list[str]:
         """
@@ -609,6 +709,16 @@ class AemData:
 
     @comment.setter
     def comment(self, value: list[str]) -> None: ...
+    @staticmethod
+    def from_numpy(epochs, array, comment=None):
+        """ """
+        ...
+
+    def validate(self, attitude_type):
+        """
+        Validate the data section against CCSDS rules.
+        """
+        ...
 
 class AemMetadata:
     """
@@ -853,6 +963,11 @@ class AemMetadata:
 
     @useable_stop_time.setter
     def useable_stop_time(self, value: str) -> None: ...
+    def validate(self):
+        """
+        Validate the metadata section against CCSDS rules.
+        """
+        ...
 
 class AemSegment:
     def __init__(metadata, data) -> None: ...
@@ -880,6 +995,11 @@ class AemSegment:
 
     @metadata.setter
     def metadata(self, value: AemMetadata) -> None: ...
+    def validate(self):
+        """
+        Validate the segment against CCSDS rules.
+        """
+        ...
 
 class AngVelState:
     """
@@ -1015,6 +1135,15 @@ class Apm:
     @header.setter
     def header(self, value: AdmHeader) -> None: ...
     @property
+    def id(self) -> Optional[str]:
+        """
+        The message identifier.
+        """
+        ...
+
+    @id.setter
+    def id(self, value: Optional[str]) -> None: ...
+    @property
     def segment(self) -> ApmSegment:
         """
         APM Segment.
@@ -1023,27 +1152,53 @@ class Apm:
 
     @segment.setter
     def segment(self, value: ApmSegment) -> None: ...
-    def to_file(self, path, format):
-        """ """
+    def to_file(self, path, format, validate=True):
+        """
+        Write to file.
+        """
         ...
 
-    def to_str(self, format):
-        """ """
+    def to_str(self, format, validate=True):
+        """
+        Serialize to string.
+        """
+        ...
+
+    def validate(self, strict=True):
+        """
+        Validate the message against CCSDS rules.
+
+        Parameters
+        ----------
+        strict : bool, optional
+            If True (default), raises ValueError on the first error found.
+            If False, returns a list of validation error messages (or None if valid).
+        """
         ...
 
+    @property
+    def version(self) -> str:
+        """
+        The message version.
+        """
+        ...
+
+    @version.setter
+    def version(self, value: str) -> None: ...
+
 class ApmData:
     """
     APM Data Section.
     """
     def __init__(
         epoch,
-        quaternion_state,
-        euler_angle_state,
-        angular_velocity,
-        spin,
-        inertia,
-        maneuver_parameters,
-        comment,
+        quaternion_state=None,
+        euler_angle_state=None,
+        angular_velocity=None,
+        spin=None,
+        inertia=None,
+        maneuver_parameters=None,
+        comment=None,
     ) -> None: ...
     def __getstate__(self, /):
         """
@@ -1409,7 +1564,7 @@ class Cdm:
     - Relative position and velocity of Object2 with respect to Object1.
     - Metadata describing how the data was determined (orbit determination settings).
     """
-    def __init__(header, body, id=None, version=...) -> None: ...
+    def __init__(header, body) -> None: ...
     def __getstate__(self, /):
         """
         Helper for pickle.
@@ -1508,7 +1663,7 @@ class Cdm:
 
     @id.setter
     def id(self, value: Optional[str]) -> None: ...
-    def to_file(self, path, format):
+    def to_file(self, path, format, validate=True):
         """
         Write the CDM to a file.
 
@@ -1518,10 +1673,12 @@ class Cdm:
             The output file path.
         format : str
             The output format ('kvn' or 'xml').
+        validate : bool, optional
+            Whether to validate the message before writing (default: True).
         """
         ...
 
-    def to_str(self, format):
+    def to_str(self, format, validate=True):
         """
         Serialize the CDM to a string.
 
@@ -1529,6 +1686,8 @@ class Cdm:
         ----------
         format : str
             The output format ('kvn' or 'xml').
+        validate : bool, optional
+            Whether to validate the message before writing (default: True).
 
         Returns
         -------
@@ -1537,6 +1696,18 @@ class Cdm:
         """
         ...
 
+    def validate(self, strict=True):
+        """
+        Validate the message against CCSDS rules.
+
+        Parameters
+        ----------
+        strict : bool, optional
+            If True (default), raises ValueError on the first error found.
+            If False, returns a list of validation error messages (or None if valid).
+        """
+        ...
+
     @property
     def version(self) -> str:
         """
@@ -1708,31 +1879,31 @@ class CdmCovarianceMatrix:
         cndot_rdot,
         cndot_tdot,
         cndot_ndot,
-        cdrg_r,
-        cdrg_t,
-        cdrg_n,
-        cdrg_rdot,
-        cdrg_tdot,
-        cdrg_ndot,
-        cdrg_drg,
-        csrp_r,
-        csrp_t,
-        csrp_n,
-        csrp_rdot,
-        csrp_tdot,
-        csrp_ndot,
-        csrp_drg,
-        csrp_srp,
-        cthr_r,
-        cthr_t,
-        cthr_n,
-        cthr_rdot,
-        cthr_tdot,
-        cthr_ndot,
-        cthr_drg,
-        cthr_srp,
-        cthr_thr,
-        comment,
+        cdrg_r=None,
+        cdrg_t=None,
+        cdrg_n=None,
+        cdrg_rdot=None,
+        cdrg_tdot=None,
+        cdrg_ndot=None,
+        cdrg_drg=None,
+        csrp_r=None,
+        csrp_t=None,
+        csrp_n=None,
+        csrp_rdot=None,
+        csrp_tdot=None,
+        csrp_ndot=None,
+        csrp_drg=None,
+        csrp_srp=None,
+        cthr_r=None,
+        cthr_t=None,
+        cthr_n=None,
+        cthr_rdot=None,
+        cthr_tdot=None,
+        cthr_ndot=None,
+        cthr_drg=None,
+        cthr_srp=None,
+        cthr_thr=None,
+        comment=None,
     ) -> None: ...
     def __getstate__(self, /):
         """
@@ -2244,10 +2415,16 @@ class CdmCovarianceMatrix:
 
     @cthr_thr.setter
     def cthr_thr(self, value: float) -> None: ...
+    @staticmethod
+    def from_numpy(array, comment=None):
+        """ """
+        ...
+
     def to_numpy(self):
         """
-        Returns the full 9x9 covariance matrix as a NumPy array.
-        If the optional 7,8,9 rows (Drag, SRP, Thrust) are missing, they are filled with 0.0.
+        Returns the covariance matrix as a NumPy array.
+        The size will be 6x6, 7x7, 8x8, or 9x9 depending on whether optional
+        Drag, SRP, and Thrust parameters are provided, as per CCSDS 508.0-B-1.
         """
         ...
 
@@ -2265,7 +2442,13 @@ class CdmData:
     covariance_matrix : CdmCovarianceMatrix
         Object covariance at TCA.
     """
-    def __init__(state_vector, covariance_matrix, comments) -> None: ...
+    def __init__(
+        state_vector,
+        covariance_matrix=None,
+        od_parameters=None,
+        additional_parameters=None,
+        comments=None,
+    ) -> None: ...
     def __getstate__(self, /):
         """
         Helper for pickle.
@@ -2291,14 +2474,37 @@ class CdmData:
     @comment.setter
     def comment(self, value: list[str]) -> None: ...
     @property
-    def covariance_matrix(self) -> CdmCovarianceMatrix:
+    def covariance_matrix(self) -> Optional[CdmCovarianceMatrix]:
         """
         Covariance Matrix.
         """
         ...
 
     @covariance_matrix.setter
-    def covariance_matrix(self, value: CdmCovarianceMatrix) -> None: ...
+    def covariance_matrix(self, value: Optional[CdmCovarianceMatrix]) -> None: ...
+    @property
+    def covariance_matrix_numpy(self) -> numpy.ndarray:
+        """
+        Covariance matrix as a NumPy array (convenience method).
+
+        Returns:
+            numpy.ndarray: 9x9 covariance matrix.
+        """
+        ...
+
+    @covariance_matrix_numpy.setter
+    def covariance_matrix_numpy(self, value: numpy.ndarray) -> None: ...
+    @staticmethod
+    def from_numpy(
+        state_vector,
+        covariance_matrix=None,
+        od_parameters=None,
+        additional_parameters=None,
+        comments=None,
+    ):
+        """ """
+        ...
+
     @property
     def od_parameters(self) -> Optional[OdParameters]:
         """
@@ -2317,6 +2523,19 @@ class CdmData:
 
     @state_vector.setter
     def state_vector(self, value: CdmStateVector) -> None: ...
+    @property
+    def state_vector_numpy(self) -> numpy.ndarray:
+        """
+        State vector as a NumPy array (convenience method).
+
+        Returns:
+            numpy.ndarray: 1D array of shape (6,) containing [X, Y, Z, X_DOT, Y_DOT, Z_DOT].
+            Units: [km, km, km, km/s, km/s, km/s]
+        """
+        ...
+
+    @state_vector_numpy.setter
+    def state_vector_numpy(self, value: numpy.ndarray) -> None: ...
 
 class CdmHeader:
     """
@@ -2467,10 +2686,10 @@ class CdmMetadata:
         catalog_name,
         object_name,
         international_designator,
+        ref_frame,
         ephemeris_name=...,
         covariance_method=None,
         maneuverable=None,
-        ref_frame=None,
         object_type=None,
         operator_contact_position=None,
         operator_organization=None,
@@ -2539,7 +2758,7 @@ class CdmMetadata:
     @covariance_method.setter
     def covariance_method(self, value: CovarianceMethodType) -> None: ...
     @property
-    def earth_tides(self) -> Optional[str]:
+    def earth_tides(self) -> Optional[bool]:
         """
         Indication of whether solid Earth and ocean tides were used for the OD of the object.
 
@@ -2548,7 +2767,7 @@ class CdmMetadata:
         ...
 
     @earth_tides.setter
-    def earth_tides(self, value: Optional[str]) -> None: ...
+    def earth_tides(self, value: Optional[bool]) -> None: ...
     @property
     def ephemeris_name(self) -> str:
         """
@@ -2591,7 +2810,7 @@ class CdmMetadata:
     @international_designator.setter
     def international_designator(self, value: str) -> None: ...
     @property
-    def intrack_thrust(self) -> Optional[str]:
+    def intrack_thrust(self) -> Optional[bool]:
         """
         Indication of whether in-track thrust modeling was used for the OD of the object.
 
@@ -2600,7 +2819,7 @@ class CdmMetadata:
         ...
 
     @intrack_thrust.setter
-    def intrack_thrust(self, value: Optional[str]) -> None: ...
+    def intrack_thrust(self, value: Optional[bool]) -> None: ...
     @property
     def maneuverable(self) -> ManeuverableType:
         """
@@ -2738,7 +2957,7 @@ class CdmMetadata:
     @ref_frame.setter
     def ref_frame(self, value: ReferenceFrameType) -> None: ...
     @property
-    def solar_rad_pressure(self) -> Optional[str]:
+    def solar_rad_pressure(self) -> Optional[bool]:
         """
         Indication of whether solar radiation pressure perturbations were used for the OD of the
         object.
@@ -2748,7 +2967,7 @@ class CdmMetadata:
         ...
 
     @solar_rad_pressure.setter
-    def solar_rad_pressure(self, value: Optional[str]) -> None: ...
+    def solar_rad_pressure(self, value: Optional[bool]) -> None: ...
 
 class CdmObjectType:
     """
@@ -2819,6 +3038,21 @@ class CdmStateVector:
         """
         ...
 
+    @staticmethod
+    def from_numpy(array):
+        """ """
+        ...
+
+    def to_numpy(self) -> numpy.ndarray:
+        """
+        Return the state vector as a NumPy array.
+
+        Returns:
+            numpy.ndarray: 1D array of shape (6,) containing [X, Y, Z, X_DOT, Y_DOT, Z_DOT].
+            Units: [km, km, km, km/s, km/s, km/s]
+        """
+        ...
+
     @property
     def x(self) -> float:
         """
@@ -3690,8 +3924,8 @@ class KeplerianElements:
         ra_of_asc_node,
         arg_of_pericenter,
         gm,
-        true_anomaly,
-        mean_anomaly,
+        true_anomaly=None,
+        mean_anomaly=None,
     ) -> None: ...
     def __getstate__(self, /):
         """
@@ -3848,8 +4082,8 @@ class ManeuverParameters:
         man_tor_1,
         man_tor_2,
         man_tor_3,
-        man_delta_mass,
-        comment,
+        man_delta_mass=None,
+        comment=None,
     ) -> None: ...
     def __getstate__(self, /):
         """
@@ -3984,9 +4218,9 @@ class MeanElements:
         ra_of_asc_node,
         arg_of_pericenter,
         mean_anomaly,
-        semi_major_axis,
-        mean_motion,
-        gm,
+        semi_major_axis=None,
+        mean_motion=None,
+        gm=None,
     ) -> None: ...
     def __getstate__(self, /):
         """
@@ -4183,7 +4417,7 @@ class Ndm:
     def messages(
         self, value: list[Union[Oem, Cdm, Opm, Omm, Ocm, Rdm, Tdm, Ndm]]
     ) -> None: ...
-    def to_file(self, path, format):
+    def to_file(self, path, format, validate=True):
         """
         Write to file.
 
@@ -4193,15 +4427,29 @@ class Ndm:
             Output file path.
         format : str
             Output format ('kvn' or 'xml').
+        validate : bool, optional
+            Whether to validate the message before writing (default: True).
         """
         ...
 
-    def to_str(self, format):
+    def to_str(self, format, validate=True):
         """
         Serialize to a string.
         """
         ...
 
+    def validate(self, strict=True):
+        """
+        Validate the combined message against CCSDS rules.
+
+        Parameters
+        ----------
+        strict : bool, optional
+            If True (default), raises ValueError on the first error found.
+            If False, returns a list of validation error messages (or None if valid).
+        """
+        ...
+
 class ObjectDescription:
     def __getstate__(self, /):
         """
@@ -4297,6 +4545,15 @@ class Ocm:
     @header.setter
     def header(self, value: OdmHeader) -> None: ...
     @property
+    def id(self) -> Optional[str]:
+        """
+        The message identifier.
+        """
+        ...
+
+    @id.setter
+    def id(self, value: Optional[str]) -> None: ...
+    @property
     def segment(self) -> OcmSegment:
         """
         The OCM data segment.
@@ -4305,7 +4562,7 @@ class Ocm:
 
     @segment.setter
     def segment(self, value: OcmSegment) -> None: ...
-    def to_file(self, path, format):
+    def to_file(self, path, format, validate=True):
         """
         Write to file.
 
@@ -4315,10 +4572,12 @@ class Ocm:
             Output file path.
         format : str
             Output format ('kvn' or 'xml').
+        validate : bool, optional
+            Whether to validate the message before writing (default: True).
         """
         ...
 
-    def to_str(self, format):
+    def to_str(self, format, validate=True):
         """
         Serialize to string.
 
@@ -4326,6 +4585,8 @@ class Ocm:
         ----------
         format : str
             Output format ('kvn' or 'xml').
+        validate : bool, optional
+            Whether to validate the message before writing (default: True).
 
         Returns
         -------
@@ -4334,6 +4595,28 @@ class Ocm:
         """
         ...
 
+    def validate(self, strict=True):
+        """
+        Validate the message against CCSDS rules.
+
+        Parameters
+        ----------
+        strict : bool, optional
+            If True (default), raises ValueError on the first error found.
+            If False, returns a list of validation error messages (or None if valid).
+        """
+        ...
+
+    @property
+    def version(self) -> str:
+        """
+        The message version.
+        """
+        ...
+
+    @version.setter
+    def version(self, value: str) -> None: ...
+
 class OcmCovarianceMatrix:
     """
     OCM Covariance Matrix.
@@ -7839,17 +8122,17 @@ class OdParameters:
         Comments.
     """
     def __init__(
-        time_lastob_start,
-        time_lastob_end,
-        recommended_od_span,
-        actual_od_span,
-        obs_available,
-        obs_used,
-        tracks_available,
-        tracks_used,
-        residuals_accepted,
-        weighted_rms,
-        comment,
+        time_lastob_start=None,
+        time_lastob_end=None,
+        recommended_od_span=None,
+        actual_od_span=None,
+        obs_available=None,
+        obs_used=None,
+        tracks_available=None,
+        tracks_used=None,
+        residuals_accepted=None,
+        weighted_rms=None,
+        comment=...,
     ) -> None: ...
     def __getstate__(self, /):
         """
@@ -7990,7 +8273,7 @@ class OdmHeader:
         Comments.
     """
     def __init__(
-        creation_date, originator, classification, message_id, comment
+        creation_date, originator, classification=None, message_id=None, comment=None
     ) -> None: ...
     def __getstate__(self, /):
         """
@@ -8011,9 +8294,17 @@ class OdmHeader:
     @classification.setter
     def classification(self, value: Optional[str]) -> None: ...
     @property
-    def comment(self): ...
+    def comment(self) -> list[str]:
+        """
+        Comments (allowed in the ODM Header only immediately after the ODM version number).
+        (See 7.8 for formatting rules.)
+
+        Examples: This is a comment
+        """
+        ...
+
     @comment.setter
-    def comment(self, value: object) -> None: ...
+    def comment(self, value: list[str]) -> None: ...
     @property
     def creation_date(self) -> str:
         """
@@ -8129,6 +8420,15 @@ class Oem:
     @header.setter
     def header(self, value: OdmHeader) -> None: ...
     @property
+    def id(self) -> Optional[str]:
+        """
+        The message identifier.
+        """
+        ...
+
+    @id.setter
+    def id(self, value: Optional[str]) -> None: ...
+    @property
     def segments(self) -> list[OemSegment]:
         """
         The list of data segments.
@@ -8137,7 +8437,7 @@ class Oem:
 
     @segments.setter
     def segments(self, value: list[OemSegment]) -> None: ...
-    def to_file(self, path, format):
+    def to_file(self, path, format, validate=True):
         """
         Write to file.
 
@@ -8147,10 +8447,20 @@ class Oem:
             Output file path.
         format : str
             Output format ('kvn' or 'xml').
+        Write to file.
+
+        Parameters
+        ----------
+        path : str
+            Output file path.
+        format : str
+            Output format ('kvn' or 'xml').
+        validate : bool, optional
+            Whether to validate the message before writing (default: True).
         """
         ...
 
-    def to_str(self, format):
+    def to_str(self, format, validate=True):
         """
         Serialize to string.
 
@@ -8163,9 +8473,44 @@ class Oem:
         -------
         str
             The serialized string.
+        Serialize to string.
+
+        Parameters
+        ----------
+        format : str
+            Output format ('kvn' or 'xml').
+        validate : bool, optional
+            Whether to validate the message before writing (default: True).
+
+        Returns
+        -------
+        str
+            The serialized string.
+        """
+        ...
+
+    def validate(self, strict=True):
+        """
+        Validate the message against CCSDS rules.
+
+        Parameters
+        ----------
+        strict : bool, optional
+            If True (default), raises ValueError on the first error found.
+            If False, returns a list of validation error messages (or None if valid).
+        """
+        ...
+
+    @property
+    def version(self) -> str:
+        """
+        The message version.
         """
         ...
 
+    @version.setter
+    def version(self, value: str) -> None: ...
+
 class OemCovarianceMatrix:
     """
     OEM Covariance Matrix.
@@ -8178,7 +8523,8 @@ class OemCovarianceMatrix:
     epoch : str
         Epoch of the covariance matrix (ISO 8601).
         values : numpy.ndarray
-        Flat NumPy array of length 21 containing the covariance values.
+        NumPy array of shape (21,) containing the lower-triangular values, or (6,6) for
+        a full symmetric matrix.
     cov_ref_frame : str, optional
         Reference frame for the covariance matrix.
     comment : list[str], optional
@@ -8513,7 +8859,7 @@ class OemData:
         comments : list[str], optional
         Comments.
     """
-    def __init__(state_vectors, comments) -> None: ...
+    def __init__(state_vectors, covariance_matrix=None, comments=None) -> None: ...
     def __getstate__(self, /):
         """
         Helper for pickle.
@@ -8546,19 +8892,43 @@ class OemData:
     @covariance_matrix.setter
     def covariance_matrix(self, value: list[OemCovarianceMatrix]) -> None: ...
     @property
-    def covariance_matrix_numpy(self) -> tuple[list[str], numpy.ndarray]:
+    def covariance_matrix_epochs(self) -> list[str]:
         """
-        Get covariance matrices as a tuple associated with a NumPy array.
+        Epochs for covariance matrices (ISO 8601).
+        """
+        ...
 
-        Returns:
-            tuple[list[str], np.ndarray]: (Epochs, 2D Array of size Nx21).
+    @covariance_matrix_epochs.setter
+    def covariance_matrix_epochs(self, value: list[str]) -> None: ...
+    @property
+    def covariance_matrix_numpy(self) -> numpy.ndarray:
+        """
+        Get covariance matrices as a NumPy array.
+
+        Use `covariance_matrix_epochs` for the corresponding epochs.
+
+        The returned array is a 3D tensor of shape (N, 6, 6), where N is the number of covariance
+        matrices. Each 6x6 matrix is symmetric and constructed from the lower-triangular CCSDS data.
+
+        Indices: 0=X, 1=Y, 2=Z, 3=X_DOT, 4=Y_DOT, 5=Z_DOT
         """
         ...
 
     @covariance_matrix_numpy.setter
-    def covariance_matrix_numpy(
-        self, value: tuple[list[str], numpy.ndarray]
-    ) -> None: ...
+    def covariance_matrix_numpy(self, value: numpy.ndarray) -> None: ...
+    @staticmethod
+    def from_numpy(
+        state_vector_epochs,
+        state_vector_numpy,
+        covariance_matrix_epochs=None,
+        covariance_matrix_numpy=None,
+        cov_ref_frames=None,
+        cov_comments=None,
+        comments=None,
+    ):
+        """ """
+        ...
+
     @property
     def state_vector(self) -> list[StateVectorAcc]:
         """
@@ -8574,31 +8944,42 @@ class OemData:
     @state_vector.setter
     def state_vector(self, value: list[StateVectorAcc]) -> None: ...
     @property
-    def state_vector_numpy(self) -> tuple[list[str], numpy.ndarray]:
+    def state_vector_epochs(self) -> list[str]:
+        """
+        Epochs for state vectors (ISO 8601).
         """
-        State vectors as a tuple of epochs and a NumPy array.
+        ...
 
-        This method allows for efficient zero-copy access to state vector data
-        compatible with scientific Python libraries.
+    @state_vector_epochs.setter
+    def state_vector_epochs(self, value: list[str]) -> None: ...
+    @property
+    def state_vector_numpy(self) -> numpy.ndarray:
+        """
+        State vectors as a NumPy array.
+
+        Use `state_vector_epochs` for the corresponding epochs.
 
         Returns
         -------
-        tuple[list[str], numpy.ndarray]
-            A tuple containing:
-            - List of epoch strings (ISO 8601 format).
-            - 2D NumPy array of shape (N, 6) or (N, 9):
-              - N x 6: [X, Y, Z, X_DOT, Y_DOT, Z_DOT] if no accelerations.
-              - N x 9: [X, Y, Z, X_DOT, Y_DOT, Z_DOT, X_DDOT, Y_DDOT, Z_DDOT] if accelerations present.
+        numpy.ndarray
+            2D array of shape (N, 6) or (N, 9):
+            - N x 6: [X, Y, Z, X_DOT, Y_DOT, Z_DOT] if no accelerations.
+            - N x 9: [X, Y, Z, X_DOT, Y_DOT, Z_DOT, X_DDOT, Y_DDOT, Z_DDOT] if accelerations present.
 
-            Units:
-            - Position: km
-            - Velocity: km/s
-            - Acceleration: km/s²
+        Units:
+        - Position: km
+        - Velocity: km/s
+        - Acceleration: km/s²
         """
         ...
 
     @state_vector_numpy.setter
-    def state_vector_numpy(self, value: tuple[list[str], numpy.ndarray]) -> None: ...
+    def state_vector_numpy(self, value: numpy.ndarray) -> None: ...
+    def validate(self):
+        """
+        Validate the data section against CCSDS rules.
+        """
+        ...
 
 class OemMetadata:
     """
@@ -8834,6 +9215,11 @@ class OemMetadata:
 
     @useable_stop_time.setter
     def useable_stop_time(self, value: Optional[str]) -> None: ...
+    def validate(self):
+        """
+        Validate the metadata against CCSDS rules.
+        """
+        ...
 
 class OemSegment:
     """
@@ -8875,6 +9261,11 @@ class OemSegment:
 
     @metadata.setter
     def metadata(self, value: OemMetadata) -> None: ...
+    def validate(self):
+        """
+        Validate the segment against CCSDS rules.
+        """
+        ...
 
 class Omm:
     """
@@ -8946,6 +9337,15 @@ class Omm:
     @header.setter
     def header(self, value: OdmHeader) -> None: ...
     @property
+    def id(self) -> Optional[str]:
+        """
+        The message identifier.
+        """
+        ...
+
+    @id.setter
+    def id(self, value: Optional[str]) -> None: ...
+    @property
     def segment(self) -> OmmSegment:
         """
         The data segment.
@@ -8954,7 +9354,7 @@ class Omm:
 
     @segment.setter
     def segment(self, value: OmmSegment) -> None: ...
-    def to_file(self, path, format):
+    def to_file(self, path, format, validate=True):
         """
         Write to file.
 
@@ -8964,10 +9364,12 @@ class Omm:
             Output file path.
         format : str
             Output format ('kvn' or 'xml').
+        validate : bool, optional
+            Whether to validate the message before writing (default: True).
         """
         ...
 
-    def to_str(self, format):
+    def to_str(self, format, validate=True):
         """
         Serialize to string.
 
@@ -8976,6 +9378,8 @@ class Omm:
         format : str
             Output format ('kvn' or 'xml').
             (Mandatory)
+        validate : bool, optional
+            Whether to validate the message before writing (default: True).
 
         Returns
         -------
@@ -8984,11 +9388,33 @@ class Omm:
         """
         ...
 
+    def validate(self, strict=True):
+        """
+        Validate the message against CCSDS rules.
+
+        Parameters
+        ----------
+        strict : bool, optional
+            If True (default), raises ValueError on the first error found.
+            If False, returns a list of validation error messages (or None if valid).
+        """
+        ...
+
+    @property
+    def version(self) -> str:
+        """
+        The message version.
+        """
+        ...
+
+    @version.setter
+    def version(self, value: str) -> None: ...
+
 class OmmData:
     """
     OMM Data section.
     """
-    def __init__(mean_elements, comments) -> None: ...
+    def __init__(mean_elements, comments=None) -> None: ...
     def __getstate__(self, /):
         """
         Helper for pickle.
@@ -9307,6 +9733,15 @@ class Opm:
     @header.setter
     def header(self, value: OdmHeader) -> None: ...
     @property
+    def id(self) -> Optional[str]:
+        """
+        The message identifier.
+        """
+        ...
+
+    @id.setter
+    def id(self, value: Optional[str]) -> None: ...
+    @property
     def segment(self) -> OpmSegment:
         """
         The data segment.
@@ -9315,7 +9750,7 @@ class Opm:
 
     @segment.setter
     def segment(self, value: OpmSegment) -> None: ...
-    def to_file(self, path, format):
+    def to_file(self, path, format, validate=True):
         """
         Write to file.
 
@@ -9325,10 +9760,12 @@ class Opm:
             Output file path.
         format : str
             Output format ('kvn' or 'xml').
+        validate : bool, optional
+            Whether to validate the message before writing (default: True).
         """
         ...
 
-    def to_str(self, format):
+    def to_str(self, format, validate=True):
         """
         Serialize to string.
 
@@ -9336,6 +9773,8 @@ class Opm:
         ----------
         format : str
             Output format ('kvn' or 'xml').
+        validate : bool, optional
+            Whether to validate the message before writing (default: True).
 
         Returns
         -------
@@ -9344,6 +9783,28 @@ class Opm:
         """
         ...
 
+    def validate(self, strict=True):
+        """
+        Validate the message against CCSDS rules.
+
+        Parameters
+        ----------
+        strict : bool, optional
+            If True (default), raises ValueError on the first error found.
+            If False, returns a list of validation error messages (or None if valid).
+        """
+        ...
+
+    @property
+    def version(self) -> str:
+        """
+        The message version.
+        """
+        ...
+
+    @version.setter
+    def version(self, value: str) -> None: ...
+
 class OpmCovarianceMatrix:
     """
     Position/Velocity Covariance Matrix (6x6 Lower Triangular Form. None or all parameters of the
@@ -9405,29 +9866,29 @@ class OpmCovarianceMatrix:
         ... (see Parameters for full list of attributes with units)
     """
     def __init__(
-        cx_x,
-        cy_x,
-        cy_y,
-        cz_x,
-        cz_y,
-        cz_z,
-        cx_dot_x,
-        cx_dot_y,
-        cx_dot_z,
-        cy_dot_x,
-        cy_dot_y,
-        cy_dot_z,
-        cz_dot_x,
-        cz_dot_y,
-        cz_dot_z,
-        cx_dot_x_dot,
-        cy_dot_x_dot,
-        cy_dot_y_dot,
-        cz_dot_x_dot,
-        cz_dot_y_dot,
-        cz_dot_z_dot,
-        cov_ref_frame,
-        comments,
+        cx_x=None,
+        cy_x=None,
+        cy_y=None,
+        cz_x=None,
+        cz_y=None,
+        cz_z=None,
+        cx_dot_x=None,
+        cx_dot_y=None,
+        cx_dot_z=None,
+        cy_dot_x=None,
+        cy_dot_y=None,
+        cy_dot_z=None,
+        cz_dot_x=None,
+        cz_dot_y=None,
+        cz_dot_z=None,
+        cx_dot_x_dot=None,
+        cy_dot_x_dot=None,
+        cy_dot_y_dot=None,
+        cz_dot_x_dot=None,
+        cz_dot_y_dot=None,
+        cz_dot_z_dot=None,
+        cov_ref_frame=None,
+        comments=None,
     ) -> None: ...
     def __getstate__(self, /):
         """
@@ -9695,7 +10156,7 @@ class OpmData:
     state_vector : StateVector
         State vector.
     """
-    def __init__(state_vector, comment) -> None: ...
+    def __init__(state_vector, comment=None) -> None: ...
     def __getstate__(self, /):
         """
         Helper for pickle.
@@ -10131,6 +10592,15 @@ class Rdm:
     @header.setter
     def header(self, value: RdmHeader) -> None: ...
     @property
+    def id(self) -> Optional[str]:
+        """
+        The message identifier.
+        """
+        ...
+
+    @id.setter
+    def id(self, value: Optional[str]) -> None: ...
+    @property
     def segment(self) -> RdmSegment:
         """
         The RDM Body consists of a single segment.
@@ -10139,7 +10609,7 @@ class Rdm:
 
     @segment.setter
     def segment(self, value: RdmSegment) -> None: ...
-    def to_file(self, path, format):
+    def to_file(self, path, format, validate=True):
         """
         Write to a file.
 
@@ -10149,6 +10619,8 @@ class Rdm:
             Output file path.
         format : str
             Format ('kvn' or 'xml').
+        validate : bool, optional
+            Whether to validate the message before writing (default: True).
         """
         ...
 
@@ -10163,7 +10635,7 @@ class Rdm:
         """
         ...
 
-    def to_str(self, format):
+    def to_str(self, format, validate=True):
         """
         Serialize to string (generic).
 
@@ -10171,6 +10643,8 @@ class Rdm:
         ----------
         format : str
             Format ('kvn' or 'xml').
+        validate : bool, optional
+            Whether to validate the message before writing (default: True).
 
         Returns
         -------
@@ -10190,6 +10664,28 @@ class Rdm:
         """
         ...
 
+    def validate(self, strict=True):
+        """
+        Validate the message against CCSDS rules.
+
+        Parameters
+        ----------
+        strict : bool, optional
+            If True (default), raises ValueError on the first error found.
+            If False, returns a list of validation error messages (or None if valid).
+        """
+        ...
+
+    @property
+    def version(self) -> str:
+        """
+        The message version.
+        """
+        ...
+
+    @version.setter
+    def version(self, value: str) -> None: ...
+
 class RdmData:
     """
     The RDM Data section.
@@ -11106,15 +11602,6 @@ class RelativeMetadataData:
     @miss_distance.setter
     def miss_distance(self, value: float) -> None: ...
     @property
-    def relative_position(self) -> Optional[list[float]]:
-        """
-        Relative position [R, T, N].
-        """
-        ...
-
-    @relative_position.setter
-    def relative_position(self, value: Optional[list[float]]) -> None: ...
-    @property
     def relative_speed(self) -> Optional[float]:
         """
         The norm of the relative velocity vector. It indicates how fast the two objects are
@@ -11127,14 +11614,14 @@ class RelativeMetadataData:
     @relative_speed.setter
     def relative_speed(self, value: Optional[float]) -> None: ...
     @property
-    def relative_velocity(self) -> Optional[list[float]]:
+    def relative_state_vector(self) -> Optional[RelativeStateVector]:
         """
-        Relative velocity [R, T, N].
+        Relative state vector [R, T, N, VR, VT, VN] (combined position and velocity).
         """
         ...
 
-    @relative_velocity.setter
-    def relative_velocity(self, value: Optional[list[float]]) -> None: ...
+    @relative_state_vector.setter
+    def relative_state_vector(self, value: Optional[RelativeStateVector]) -> None: ...
     @property
     def screen_entry_time(self) -> Optional[str]:
         """
@@ -11241,6 +11728,115 @@ class RelativeMetadataData:
     @tca.setter
     def tca(self, value: str) -> None: ...
 
+class RelativeStateVector:
+    """
+    Relative State Vector containing relative position and velocity.
+
+    Parameters
+    ----------
+    relative_position_r : float
+        Relative position R component. Units: m.
+    relative_position_t : float
+        Relative position T component. Units: m.
+    relative_position_n : float
+        Relative position N component. Units: m.
+    relative_velocity_r : float
+        Relative velocity R component. Units: m/s.
+    relative_velocity_t : float
+        Relative velocity T component. Units: m/s.
+    relative_velocity_n : float
+        Relative velocity N component. Units: m/s.
+    """
+    def __init__(
+        relative_position_r,
+        relative_position_t,
+        relative_position_n,
+        relative_velocity_r,
+        relative_velocity_t,
+        relative_velocity_n,
+    ) -> None: ...
+    def __getstate__(self, /):
+        """
+        Helper for pickle.
+        """
+        ...
+
+    @property
+    def relative_position_n(self) -> float:
+        """
+        Relative position N component.
+
+        Units: m
+        """
+        ...
+
+    @relative_position_n.setter
+    def relative_position_n(self, value: float) -> None: ...
+    @property
+    def relative_position_r(self) -> float:
+        """
+        Relative position R component.
+
+        Units: m
+        """
+        ...
+
+    @relative_position_r.setter
+    def relative_position_r(self, value: float) -> None: ...
+    @property
+    def relative_position_t(self) -> float:
+        """
+        Relative position T component.
+
+        Units: m
+        """
+        ...
+
+    @relative_position_t.setter
+    def relative_position_t(self, value: float) -> None: ...
+    @property
+    def relative_velocity_n(self) -> float:
+        """
+        Relative velocity N component.
+
+        Units: m/s
+        """
+        ...
+
+    @relative_velocity_n.setter
+    def relative_velocity_n(self, value: float) -> None: ...
+    @property
+    def relative_velocity_r(self) -> float:
+        """
+        Relative velocity R component.
+
+        Units: m/s
+        """
+        ...
+
+    @relative_velocity_r.setter
+    def relative_velocity_r(self, value: float) -> None: ...
+    @property
+    def relative_velocity_t(self) -> float:
+        """
+        Relative velocity T component.
+
+        Units: m/s
+        """
+        ...
+
+    @relative_velocity_t.setter
+    def relative_velocity_t(self, value: float) -> None: ...
+    def to_numpy(self) -> numpy.ndarray:
+        """
+        Return the relative state vector as a NumPy array.
+
+        Returns:
+            numpy.ndarray: 1D array of shape (6,) containing [R, T, N, VR, VT, VN].
+            Units: [m, m, m, m/s, m/s, m/s]
+        """
+        ...
+
 class ScreenVolumeFrameType:
     def __getstate__(self, /):
         """
@@ -11276,7 +11872,11 @@ class SpacecraftParameters:
         Drag coefficient.
     """
     def __init__(
-        mass, solar_rad_area, solar_rad_coeff, drag_area, drag_coeff
+        mass=None,
+        solar_rad_area=None,
+        solar_rad_coeff=None,
+        drag_area=None,
+        drag_coeff=None,
     ) -> None: ...
     def __getstate__(self, /):
         """
@@ -11548,7 +12148,7 @@ class StateVector:
     z_dot : float
         Velocity vector Z-component (km/s).
     """
-    def __init__(epoch, x, y, z, x_dot, y_dot, z_dot, comments) -> None: ...
+    def __init__(epoch, x, y, z, x_dot, y_dot, z_dot, comments=None) -> None: ...
     def __getstate__(self, /):
         """
         Helper for pickle.
@@ -11668,7 +12268,7 @@ class StateVectorAcc:
         Acceleration vector Z-component (km/s²).
     """
     def __init__(
-        epoch, x, y, z, x_dot, y_dot, z_dot, x_ddot, y_ddot, z_ddot
+        epoch, x, y, z, x_dot, y_dot, z_dot, x_ddot=None, y_ddot=None, z_ddot=None
     ) -> None: ...
     def __getstate__(self, /):
         """
@@ -11890,6 +12490,15 @@ class Tdm:
     @header.setter
     def header(self, value: TdmHeader) -> None: ...
     @property
+    def id(self) -> Optional[str]:
+        """
+        The message identifier.
+        """
+        ...
+
+    @id.setter
+    def id(self, value: Optional[str]) -> None: ...
+    @property
     def segments(self) -> list[TdmSegment]:
         """
         Shortcut to access segments directly from the body.
@@ -11898,7 +12507,7 @@ class Tdm:
 
     @segments.setter
     def segments(self, value: list[TdmSegment]) -> None: ...
-    def to_file(self, path, format):
+    def to_file(self, path, format, validate=True):
         """
         Write to file.
 
@@ -11908,10 +12517,12 @@ class Tdm:
             Output file path.
         format : str
             Output format ('kvn' or 'xml').
+        validate : bool, optional
+            Whether to validate the message before writing (default: True).
         """
         ...
 
-    def to_str(self, format):
+    def to_str(self, format, validate=True):
         """
         Serialize to string.
 
@@ -11919,6 +12530,8 @@ class Tdm:
         ----------
         format : str
             Output format ('kvn' or 'xml').
+        validate : bool, optional
+            Whether to validate the message before writing (default: True).
 
         Returns
         -------
@@ -11927,6 +12540,28 @@ class Tdm:
         """
         ...
 
+    def validate(self, strict=True):
+        """
+        Validate the message against CCSDS rules.
+
+        Parameters
+        ----------
+        strict : bool, optional
+            If True (default), raises ValueError on the first error found.
+            If False, returns a list of validation error messages (or None if valid).
+        """
+        ...
+
+    @property
+    def version(self) -> str:
+        """
+        The message version.
+        """
+        ...
+
+    @version.setter
+    def version(self, value: str) -> None: ...
+
 class TdmBody:
     """
     The TDM Body consists of one or more TDM Segments.
@@ -11968,7 +12603,7 @@ class TdmData:
         Comments in the data section.
         (Optional)
     """
-    def __init__(*, observations=None, comment=None) -> None: ...
+    def __init__(observations=None, comment=None) -> None: ...
     def __getstate__(self, /):
         """
         Helper for pickle.