BLbluestaq
Onorbit

POST /udl/manifoldelset

Changed on

Service operation to take a single ManifoldElset as a POST body and ingest into the database. A ManifoldElset represents theoretical Keplarian orbital elements belonging to an object of interest's manifold describing a possible/theoretical orbit for an object of interest for tasking purposes. A specific role is required to perform this service operation. Please contact the UDL team for assistance.

Request

  • Base URL
    https://unifieddatalibrary.com
  • URL
    https://unifieddatalibrary.com/udl/manifoldelset
  • Auth
    none declared

Request body

idstring

Unique identifier of the record, auto-generated by the system.

idManifoldstring required

Identifier of the parent Manifold record.

classificationMarkingstring required

Classification marking of the data in IC/CAPCO Portion-marked format.

tmpSatNointeger required

A placeholder satellite number and not a true NORAD catalog number.

epochstring date-time required

Elset epoch time in ISO 8601 UTC format, with microsecond precision.

meanMotionnumber double

The constant angular speed required for the body to complete one circular orbit in the same amount of time as the actual elliptical orbit with variable speed. Measured in revolutions per day.

eccentricitynumber double

The orbital eccentricity of an astronomical object is a parameter that determines the amount by which its orbit around another body deviates from a perfect circle. A value of 0 is a circular orbit, values between 0 and 1 form an elliptic orbit, 1 is a parabolic escape orbit, and greater than 1 is a hyperbolic escape orbit.

inclinationnumber double

The angle between the equator and the orbit when looking from the center of the Earth. If the orbit went exactly around the equator from left to right, then the inclination would be 0. The inclination ranges from 0 to 180 degrees.

raannumber double

Right ascension of the ascending node, or RAAN is the angle as measured in degrees eastwards (or, as seen from the north, counterclockwise) from the First Point of Aries to the ascending node, which is where the orbit crosses the equator when traveling north.

argOfPerigeenumber double

The argument of perigee is the angle in degrees formed between the perigee and the ascending node. If the perigee would occur at the ascending node, the argument of perigee would be 0.

meanAnomalynumber double

Where the satellite is in its orbital path. The mean anomaly ranges from 0 to 360 degrees. The mean anomaly is referenced to the perigee. If the satellite were at the perigee, the mean anomaly would be 0.

revNointeger

The current revolution number. The value is incremented when a satellite crosses the equator on an ascending pass.

bStarnumber double

The drag term for SGP4 orbital model, used for calculating decay constants for altitude, eccentricity etc, measured in inverse earth radii.

meanMotionDotnumber double

1st derivative of the mean motion with respect to time. Units are revolutions per day squared.

meanMotionDDotnumber double

2nd derivative of the mean motion with respect to time. Units are revolutions per day cubed.

semiMajorAxisnumber double

The sum of the periapsis and apoapsis distances divided by two. For circular orbits, the semimajor axis is the distance between the centers of the bodies, not the distance of the bodies from the center of mass.

periodnumber double

Period of the orbit equal to inverse of mean motion.

apogeenumber double

The Orbit point furthest from the center of the earth in kilometers.

perigeenumber double

The orbit point nearest to the center of the earth in kilometers.

line1string

Read only derived/generated line1 of a legacy TLE (two line element set) format, ignored on create/edit operations.

line2string

Read only derived/generated line2 of a legacy TLE (two line element set) format, ignored on create/edit operations.

createdAtstring date-time

Time the row was created in the database, auto-populated by the system.

createdBystring

Application user who created the row in the database, auto-populated by the system.

sourcestring required

Source of the data.

originstring

Originating system or organization which produced the data, if different from the source. The origin may be different than the source if the source was a mediating system which forwarded the data on behalf of the origin system. If null, the source may be assumed to be the origin.

dataMode'REAL' | 'TEST' | 'SIMULATED' | 'EXERCISE' required

Indicator of whether the data is REAL, TEST, EXERCISE, or SIMULATED data:

REAL: Data collected or produced that pertains to real-world objects, events, and analysis.

TEST: Specific datasets used to evaluate compliance with specifications and requirements, and for validating technical, functional, and performance characteristics.

EXERCISE: Data pertaining to a government or military exercise. The data may include both real and simulated data.

SIMULATED: Synthetic data generated by a model to mimic real-world datasets.

origNetworkstring

The originating source network on which this record was created, auto-populated by the system.

Example request

{
  "id": "MANIFOLDELSET-ID",
  "idManifold": "REF-MANIFOLD-ID",
  "classificationMarking": "U",
  "tmpSatNo": 10,
  "epoch": "2021-01-01T01:01:01.123456Z",
  "meanMotion": 10.23,
  "eccentricity": 0.5,
  "inclination": 90.23,
  "raan": 10.23,
  "argOfPerigee": 10.23,
  "meanAnomaly": 10.23,
  "revNo": 123,
  "bStar": 10.23,
  "meanMotionDot": 10.23,
  "meanMotionDDot": 10.23,
  "semiMajorAxis": 10.23,
  "period": 10.23,
  "apogee": 10.23,
  "perigee": 10.23,
  "createdAt": "2018-01-01T16:00:00.123Z",
  "createdBy": "some.user",
  "source": "Bluestaq",
  "origin": "THIRD_PARTY_DATASOURCE",
  "dataMode": "TEST",
  "origNetwork": "OPS1"
}

Response

Success

Changes

  • 45631f9bb3f0Revision changes
    • breaking

      the request property's minLength was increased from 0 to 1

  • 75f764c843a9Revision changes
    • info

      api operation id create_66 removed and replaced with

    • info

      the endpoint scheme security BasicAuth was removed from the API

Some revisions have not been checked yet.