Supported data formats

For ephemerides and maneuver plans, OKAPI:Astrolabe supports the following CCSDS formats: OEM, OPM, NDM.

OEM

OEMs can be provided in either KVN or XML format, following the CCSDS standard on Orbit Data Messages.

The following conditions are imposed on uploaded OEMs:

States that are too far in the future are ignored (more than 7 days in the future for LEO, more than 30 days in the future for GEO).
The OEM needs to provide a minimum of 36 states per revolution and at least one revolution before and after TCA.
The time system needs to be UTC.

Here is an example file in KVN format:

CCSDS_OEM_VERS = 2.0
CREATION_DATE = 2024-10-01T06:43:01.084447
ORIGINATOR = OKAPI:Orbits

META_START
OBJECT_NAME = Stellar Sat
OBJECT_ID = 2147-099X
CENTER_NAME = EARTH
REF_FRAME = GCRF
TIME_SYSTEM = UTC
START_TIME = 2024-10-03T19:27:00.955427
USEABLE_START_TIME = 2024-10-03T19:27:00.955427
USEABLE_STOP_TIME = 2024-10-04T19:28:00.955427
STOP_TIME = 2024-10-04T19:28:00.955427
META_STOP

2024-10-03T19:27:00.955427 -2197.269822851982 6155.399100804355 2031.8351496921864 0.25647088355012077 2.468713263205441 -7.228695729042313
2024-10-03T19:28:00.955427 -2188.3469097888274 6226.000357920584 1813.874071715566 0.3383376231113423 2.237589005024959 -7.300685582414314
2024-10-03T19:29:00.955427 -2176.97317433036 6289.628864638501 1593.8758642859025 0.4198434860962744 2.003907212333907 -7.364490801082352

COVARIANCE_START
EPOCH = 2024-10-03T19:27:00.955427
COV_REF_FRAME = RTN
6.733121367692391
-34.57290753254313 177.60726965924005
28.260232227880568 -145.3040747226578 119.0703544154903
0.010609861726447744 -0.05454870184887603 0.04469495865180503 1.6777464278079132e-05
-0.03958038800725894 0.2034322702196834 -0.1665869863491013 -6.25341770880302e-05 0.00023313605704861415
0.011776724125991254 -0.06041196883684827 0.049290264609686954 1.8507812834921754e-05 -6.908923851404128e-05 2.0641206176627082e-05
EPOCH = 2024-10-03T19:28:00.955427
COV_REF_FRAME = RTN
6.733121367692391
-34.57290753254313 177.60726965924005
28.260232227880568 -145.3040747226578 119.0703544154903
0.010609861726447744 -0.05454870184887603 0.04469495865180503 1.6777464278079132e-05
-0.03958038800725894 0.2034322702196834 -0.1665869863491013 -6.25341770880302e-05 0.00023313605704861415
0.011776724125991254 -0.06041196883684827 0.049290264609686954 1.8507812834921754e-05 -6.908923851404128e-05 2.0641206176627082e-05
EPOCH = 2024-10-03T19:29:00.955427
COV_REF_FRAME = RTN
8.157254822900741
-40.76201222822704 203.7551081536655
31.7683241791141 -158.90174741807834 124.08684066421837
0.013245856175321896 -0.06624733717137414 0.0517216382327814 2.155961106609894e-05
-0.046738395393686266 0.2337057832713822 -0.18238216105824828 -7.60281097544885e-05 0.00026815072977193774
0.008823093292827213 -0.04401884826682767 0.03419351006011252 1.4264704856803396e-05 -5.0388369510200974e-05 9.620910324331127e-06
COVARIANCE_STOP

OPM

OPMs can be provided in either KVN or XML format, following the CCSDS standard on Orbit Data Messages.

Here is an example file in KVN format, specifying two maneuvers:

CCSDS_OPM_VERS = 3.0
COMMENT Example
CREATION_DATE = 2021-10-01T09:33:00.000
ORIGINATOR = OKAPI:Orbits
OBJECT_NAME = Stellar Sat
OBJECT_ID = 2147-099X
CENTER_NAME = EARTH
REF_FRAME = TOD
TIME_SYSTEM = UTC
COMMENT State Vector
EPOCH = 2021-10-01T00:00:00.000
X = 6655.9942 [km]
Y = -40218.5751 [km]
Z = -82.9177 [km]
X_DOT = 3.11548208 [km/s]
Y_DOT = 0.47042605 [km/s]
Z_DOT = -0.00101495 [km/s]
COMMENT Keplerian elements
SEMI_MAJOR_AXIS = 41399.5123 [km]
ECCENTRICITY = 0.020842611
INCLINATION = 0.117746 [deg]
RA_OF_ASC_NODE = 17.604721 [deg]
ARG_OF_PERICENTER = 218.242943 [deg]
TRUE_ANOMALY = 41.922339 [deg]
GM = 398600.4415 [km**3/s**2]
COMMENT Spacecraft parameters
MASS = 1913.000 [kg]
SOLAR_RAD_AREA = 10.000 [m**2]
SOLAR_RAD_COEFF = 1.300
DRAG_AREA = 10.000 [m**2]
DRAG_COEFF = 2.300
COMMENT 2 planned maneuvers
COMMENT First maneuver: AMF-3
COMMENT Non-impulsive, thrust direction fixed in inertial frame
MAN_EPOCH_IGNITION = 2021-06-03T09:00:34.1
MAN_DURATION = 132.60 [s]
MAN_DELTA_MASS = -18.418 [kg]
MAN_REF_FRAME = EME2000
MAN_DV_1 = -0.02325700 [km/s]
MAN_DV_2 = 0.01683160 [km/s]
MAN_DV_3 = -0.00893444 [km/s]
COMMENT Second maneuver: first station acquisition maneuver
COMMENT impulsive, thrust direction fixed in RTN frame
MAN_EPOCH_IGNITION = 2021-06-05T18:59:21.0
MAN_DURATION = 0.00 [s]
MAN_DELTA_MASS = -1.469 [kg]
MAN_REF_FRAME = RTN
MAN_DV_1 = 0.00101500 [km/s]
MAN_DV_2 = -0.00187300 [km/s]
MAN_DV_3 = 0.00000000 [km/s]

NDM

NDMs are expected in XML format, following the CCSDS standard XML Specification for Navigation Data Messages.

Here is an example file, combining an OEM and OPM into an NDM:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<ndm xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://sanaregistry.org/r/ndmxml/ndmxml-1.0-master.xsd">
    	
	<opm id="CCSDS_OPM_VERS" version="3.0">
	    <header> 
	        <COMMENT>Example</COMMENT>
	        <CREATION_DATE>2021-10-01T09:33:00.000</CREATION_DATE>
	        <ORIGINATOR>OKAPI:Orbits</ORIGINATOR>
	        <MESSAGE_ID>OPM 201113719185</MESSAGE_ID>
	    </header>
	    <body>
	        <segment>
	            <metadata>
	                <COMMENT>GEOCENTRIC, CARTESIAN, EARTH FIXED</COMMENT>
	                <OBJECT_NAME>Stellar Sat</OBJECT_NAME>
	                <OBJECT_ID>2147-099X</OBJECT_ID>
	                <CENTER_NAME>EARTH</CENTER_NAME>
	                <REF_FRAME>ITRF1997</REF_FRAME>
	                <TIME_SYSTEM>UTC</TIME_SYSTEM>
	            </metadata>
	            <data>
	                <stateVector>
	                    <EPOCH>2022-12-18T14:28:15.1172</EPOCH>
	                    <X>6503.514000</X>
	                    <Y>1239.647000</Y>
	                    <Z>-717.490000</Z>
	                    <X_DOT>-0.873160</X_DOT>
	                    <Y_DOT>8.740420</Y_DOT>
	                    <Z_DOT>-4.191076</Z_DOT>
	                </stateVector>
	                <spacecraftParameters> 
	                    <MASS>3000.000000</MASS> 
	                    <SOLAR_RAD_AREA>18.770000</SOLAR_RAD_AREA>
	                    <SOLAR_RAD_COEFF>1.000000</SOLAR_RAD_COEFF>
	                    <DRAG_AREA>18.770000</DRAG_AREA>
	                    <DRAG_COEFF>2.500000</DRAG_COEFF> 
	                </spacecraftParameters>
	                <covarianceMatrix>
	                    <COV_REF_FRAME>ITRF1997</COV_REF_FRAME>
	                    <CX_X>0.316</CX_X>
	                    <CY_X>0.722</CY_X>
	                    <CY_Y>0.518</CY_Y>
	                    <CZ_X>0.202</CZ_X>
	                    <CZ_Y>0.715</CZ_Y>
	                    <CZ_Z>0.002</CZ_Z>
	                    <CX_DOT_X>0.912</CX_DOT_X>
	                    <CX_DOT_Y>0.306</CX_DOT_Y>
	                    <CX_DOT_Z>0.276</CX_DOT_Z>
	                    <CX_DOT_X_DOT>0.797</CX_DOT_X_DOT>
	                    <CY_DOT_X>0.562</CY_DOT_X>
	                    <CY_DOT_Y>0.899</CY_DOT_Y>
	                    <CY_DOT_Z>0.022</CY_DOT_Z>
	                    <CY_DOT_X_DOT>0.079</CY_DOT_X_DOT>
	                    <CY_DOT_Y_DOT>0.415</CY_DOT_Y_DOT>
	                    <CZ_DOT_X>0.245</CZ_DOT_X>
	                    <CZ_DOT_Y>0.965</CZ_DOT_Y>
	                    <CZ_DOT_Z>0.950</CZ_DOT_Z>
	                    <CZ_DOT_X_DOT>0.435</CZ_DOT_X_DOT>
	                    <CZ_DOT_Y_DOT>0.621</CZ_DOT_Y_DOT>
	                    <CZ_DOT_Z_DOT>0.991</CZ_DOT_Z_DOT>
	                </covarianceMatrix>
	            </data>
	        </segment>
	    </body>
	</opm>
    	
	<oem id="CCSDS_OEM_VERS" version="3.0">
	    <header>
	        <COMMENT>Example</COMMENT>
	        <CREATION_DATE>2024-10-01T06:43:01.084447</CREATION_DATE>
	        <ORIGINATOR>OKAPI:Orbits</ORIGINATOR>
	        <MESSAGE_ID>OEM 201113719185</MESSAGE_ID>
	    </header>
	    <body>
	        <segment>
	            <metadata>
	                <OBJECT_NAME>Stellar Sat</OBJECT_NAME>
	                <OBJECT_ID>2147-099X</OBJECT_ID>
	                <CENTER_NAME>EARTH</CENTER_NAME>
	                <REF_FRAME>GCRF</REF_FRAME>
	                <TIME_SYSTEM>UTC</TIME_SYSTEM>
	                <START_TIME>2024-10-03T19:27:00.955427</START_TIME>
	                <USEABLE_START_TIME>2024-10-03T19:27:00.955427</USEABLE_START_TIME>
	                <USEABLE_STOP_TIME>2024-10-04T19:28:00.955427</USEABLE_STOP_TIME>
	                <STOP_TIME>2024-10-04T19:28:00.955427</STOP_TIME>
	            </metadata>
	            <data>
	                <COMMENT>To be used for testing purposes only.</COMMENT>
	                
	                <stateVector>
	                    <EPOCH>2024-10-03T19:27:00.955427</EPOCH>
	                    <X>-2197.9491674359842</X>
	                    <Y>6143.337662164186</Y>
	                    <Z>2050.2716898714834</Z>
	                    <X_DOT>0.25520790004329375</X_DOT>
	                    <Y_DOT>2.4905183872384256</Y_DOT>
	                    <Z_DOT>-7.226981566825387</Z_DOT>
	                </stateVector>
	                
	                <stateVector>
	                    <EPOCH>2024-10-03T19:28:00.955427</EPOCH>
	                    <X>-2189.060988364686</X>
	                    <Y>6214.591924232219</Y>
	                    <Z>1832.3491739365963</Z>
	                    <X_DOT>0.3372857194958556</X_DOT>
	                    <Y_DOT>2.259310750476463</Y_DOT>
	                    <Z_DOT>-7.299826680787485</Z_DOT>
	                </stateVector>
	                
	                <stateVector>
	                    <EPOCH>2024-10-03T19:29:00.955427</EPOCH>
	                    <X>-2177.7155937521397</X>
	                    <Y>6278.870327993773</Y>
	                    <Z>1612.3640844803888</Z>
	                    <X_DOT>0.41900660010852797</X_DOT>
	                    <Y_DOT>2.0255053111349657</Y_DOT>
	                    <Z_DOT>-7.364472571864113</Z_DOT>
	                </stateVector>
 
                    <covarianceMatrix>
	                    <EPOCH>2024-10-03T19:27:00.955427</EPOCH>
	                    <COV_REF_FRAME>RTN</COV_REF_FRAME>
	                    <CX_X>6.703641813474338</CX_X>
	                    <CY_X>-33.12126420204605</CY_X>
	                    <CY_Y>163.73054411378396</CY_Y>
	                    <CZ_X>25.144040767900535</CZ_X>
	                    <CZ_Y>-124.42850542094212</CZ_Y>
	                    <CZ_Z>94.76993829284683</CZ_Z>
	                    <CX_DOT_X>0.009328524068517235</CX_DOT_X>
	                    <CX_DOT_Y>-0.046161149301831024</CX_DOT_Y>
	                    <CX_DOT_Z>0.03515467269796972</CX_DOT_Z>
	                    <CX_DOT_X_DOT>1.3040951827614751e-05</CX_DOT_X_DOT>
	                    <CY_DOT_X>-0.03589072850426456</CY_DOT_X>
	                    <CY_DOT_Y>0.17752809530599775</CY_DOT_Y>
	                    <CY_DOT_Z>-0.13508354241914947</CY_DOT_Z>
	                    <CY_DOT_X_DOT>-5.0111003150988444e-05</CY_DOT_X_DOT>
	                    <CY_DOT_Y_DOT>0.00019262555949434298</CY_DOT_Y_DOT>
	                    <CZ_DOT_X>0.01268151601160854</CZ_DOT_X>
	                    <CZ_DOT_Y>-0.062596155659753</CZ_DOT_Y>
	                    <CZ_DOT_Z>0.04742319720620361</CZ_DOT_Z>
	                    <CZ_DOT_X_DOT>1.7595879157871655e-05</CZ_DOT_X_DOT>
	                    <CZ_DOT_Y_DOT>-6.775187440529342e-05</CZ_DOT_Y_DOT>
	                    <CZ_DOT_Z_DOT>2.403493331176489e-05</CZ_DOT_Z_DOT>
	                </covarianceMatrix>
	                
	                <covarianceMatrix>
	                    <EPOCH>2024-10-03T19:28:00.955427</EPOCH>
	                    <COV_REF_FRAME>RTN</COV_REF_FRAME>
	                    <CX_X>6.703641813474338</CX_X>
	                    <CY_X>-33.12126420204605</CY_X>
	                    <CY_Y>163.73054411378396</CY_Y>
	                    <CZ_X>25.144040767900535</CZ_X>
	                    <CZ_Y>-124.42850542094212</CZ_Y>
	                    <CZ_Z>94.76993829284683</CZ_Z>
	                    <CX_DOT_X>0.009328524068517235</CX_DOT_X>
	                    <CX_DOT_Y>-0.046161149301831024</CX_DOT_Y>
	                    <CX_DOT_Z>0.03515467269796972</CX_DOT_Z>
	                    <CX_DOT_X_DOT>1.3040951827614751e-05</CX_DOT_X_DOT>
	                    <CY_DOT_X>-0.03589072850426456</CY_DOT_X>
	                    <CY_DOT_Y>0.17752809530599775</CY_DOT_Y>
	                    <CY_DOT_Z>-0.13508354241914947</CY_DOT_Z>
	                    <CY_DOT_X_DOT>-5.0111003150988444e-05</CY_DOT_X_DOT>
	                    <CY_DOT_Y_DOT>0.00019262555949434298</CY_DOT_Y_DOT>
	                    <CZ_DOT_X>0.01268151601160854</CZ_DOT_X>
	                    <CZ_DOT_Y>-0.062596155659753</CZ_DOT_Y>
	                    <CZ_DOT_Z>0.04742319720620361</CZ_DOT_Z>
	                    <CZ_DOT_X_DOT>1.7595879157871655e-05</CZ_DOT_X_DOT>
	                    <CZ_DOT_Y_DOT>-6.775187440529342e-05</CZ_DOT_Y_DOT>
	                    <CZ_DOT_Z_DOT>2.403493331176489e-05</CZ_DOT_Z_DOT>
	                </covarianceMatrix>
	                
	                <covarianceMatrix>
	                    <EPOCH>2024-10-03T19:29:00.955427</EPOCH>
	                    <COV_REF_FRAME>RTN</COV_REF_FRAME>
	                    <CX_X>7.957208644053454</CX_X>
	                    <CY_X>-38.524321243517825</CY_X>
	                    <CY_Y>186.58164626566088</CY_Y>
	                    <CZ_X>28.117662287017737</CZ_X>
	                    <CZ_Y>-136.28895818777102</CZ_Y>
	                    <CZ_Z>99.73055133231058</CZ_Z>
	                    <CX_DOT_X>0.011669799978499054</CX_DOT_X>
	                    <CX_DOT_Y>-0.05655813593370373</CX_DOT_Y>
	                    <CX_DOT_Z>0.04137641308017924</CX_DOT_Z>
	                    <CX_DOT_X_DOT>1.7167293819460227e-05</CX_DOT_X_DOT>
	                    <CY_DOT_X>-0.04220987257446962</CY_DOT_X>
	                    <CY_DOT_Y>0.20451427989930038</CY_DOT_Y>
	                    <CY_DOT_Z>-0.14952290997076836</CY_DOT_Z>
	                    <CY_DOT_X_DOT>-6.204201018551775e-05</CY_DOT_X_DOT>
	                    <CY_DOT_Y_DOT>0.00022427290201821248</CY_DOT_Y_DOT>
	                    <CZ_DOT_X>0.00998983916901641</CZ_DOT_X>
	                    <CZ_DOT_Y>-0.04829151992626479</CZ_DOT_Y>
	                    <CZ_DOT_Z>0.035125597968622635</CZ_DOT_Z>
	                    <CZ_DOT_X_DOT>1.4585478143348454e-05</CZ_DOT_X_DOT>
	                    <CZ_DOT_Y_DOT>-5.2819810725779794e-05</CZ_DOT_Y_DOT>
	                    <CZ_DOT_Z_DOT>1.2623753223512324e-05</CZ_DOT_Z_DOT>
	                </covarianceMatrix>
                </data>
	        </segment>
	    </body>
	</oem>
</ndm>

Protocols Conjunction screening