Observation

POST /udl/radarobservation

Changed on Apr 16, 2025

Service operation to take a single radar observation as a POST body and ingest into the database. This operation is not intended to be used for automated feeds into UDL. Data providers should contact the UDL team for specific role assignments and for instructions on setting up a permanent feed through an alternate mechanism.

Request

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

Request body

idstring

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

classificationMarkingstring required

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

obTimestring date-time required

Ob detection time in ISO 8601 UTC with microsecond precision.

idOnOrbitstring

Unique identifier of the target on-orbit object, if correlated.

idSensorstring

Unique identifier of the reporting sensor.

satNointeger

Satellite/Catalog number of the target on-orbit object.

taskIdstring

Optional identifier to indicate the specific tasking which produced this observation.

transactionIdstring

Optional identifier to track a commercial or marketplace transaction executed to produce this data.

trackIdstring

Optional identifier of the track to which this observation belongs.

obPositionstring

The position of this observation within a track (FENCE, FIRST, IN, LAST, SINGLE). This identifier is optional and, if null, no assumption should be made regarding whether other observations may or may not exist to compose a track.

origObjectIdstring

Optional identifier provided by observation source to indicate the target onorbit object of this observation. This may be an internal identifier and not necessarily a valid satellite number.

origSensorIdstring

Optional identifier provided by observation source to indicate the sensor identifier which produced this observation. This may be an internal identifier and not necessarily a valid sensor ID.

uctboolean

Boolean indicating this observation is part of an uncorrelated track or was unable to be correlated to a known object. This flag should only be set to true by data providers after an attempt to correlate to an on-orbit object was made and failed. If unable to correlate, the 'origObjectId' field may be populated with an internal data provider specific identifier.

azimuthnumber double

azimuth angle in degrees and topocentric frame.

azimuthMeasuredboolean

Optional flag indicating whether the azimuth value is measured (true) or computed (false). If null, consumers may consult the data provider for information regarding whether the corresponding value is computed or measured.

azimuthUncnumber double

One sigma uncertainty in the line of sight azimuth angle measurement, in degrees.

azimuthBiasnumber double

Sensor azimuth angle bias in degrees.

azimuthRatenumber double

Rate of change of the line of sight azimuth in degrees per second.

elevationnumber double

Line of sight elevation in degrees and topocentric frame.

elevationMeasuredboolean

Optional flag indicating whether the elevation value is measured (true) or computed (false). If null, consumers may consult the data provider for information regarding whether the corresponding value is computed or measured.

elevationUncnumber double

One sigma uncertainty in the line of sight elevation angle measurement, in degrees.

elevationBiasnumber double

Sensor elevation bias in degrees.

elevationRatenumber double

Rate of change of the line of sight elevation in degrees per second.

rangenumber double

Target range in km.

rangeMeasuredboolean

Optional flag indicating whether the range value is measured (true) or computed (false). If null, consumers may consult the data provider for information regarding whether the corresponding value is computed or measured.

rangeAccelnumber double

Range accelaration in km/s2.

rangeAccelUncnumber double

One sigma uncertainty in the range acceleration measurement, in kilometers/(second^2).

rangeUncnumber double

One sigma uncertainty in the range measurement, in kilometers.

rangeBiasnumber double

Sensor range bias in km.

rangeRatenumber double

Rate of change of the line of sight range in km/sec.

rangeRateMeasuredboolean

Optional flag indicating whether the rangeRate value is measured (true) or computed (false). If null, consumers may consult the data provider for information regarding whether the corresponding value is computed or measured.

rangeRateUncnumber double

One sigma uncertainty in the range rate measurement, in kilometers/second.

dopplernumber double

Corrected doppler measurement in meters per second.

dopplerUncnumber double

One sigma uncertainty in the corrected doppler measurement, in meters/second.

ranumber double

Line of sight right ascension in degrees and J2000 coordinate frame.

raMeasuredboolean

Optional flag indicating whether the ra value is measured (true) or computed (false). If null, consumers may consult the data provider for information regarding whether the corresponding value is computed or measured.

declinationnumber double

Line of sight declination angle in degrees and J2000 coordinate frame.

declinationMeasuredboolean

Optional flag indicating whether the declination value is measured (true) or computed (false). If null, consumers may consult the data provider for information regarding whether the corresponding value is computed or measured.

xnumber double

X position of target in km in J2000 coordinate frame.

ynumber double

Y position of target in km in J2000 coordinate frame.

znumber double

Z position of target in km in J2000 coordinate frame.

xvelnumber double

X velocity of target in km/sec in J2000 coordinate frame.

yvelnumber double

Y velocity of target in km/sec in J2000 coordinate frame.

zvelnumber double

Z velocity of target in km/sec in J2000 coordinate frame.

senxnumber double

Sensor x position in km at obTime (if mobile/onorbit) in the specified senReferenceFrame. If senReferenceFrame is null then J2000 should be assumed.

senynumber double

Sensor y position in km at obTime (if mobile/onorbit) in the specified senReferenceFrame. If senReferenceFrame is null then J2000 should be assumed.

senznumber double

Sensor z position in km at obTime (if mobile/onorbit) in the specified senReferenceFrame. If senReferenceFrame is null then J2000 should be assumed.

rcsnumber double

Radar cross section in meters squared for polarization principal.

rcsUncnumber double

one sigma uncertainty in principal polarization Radar Cross Section, in meters^2.

orthogonalRcsnumber double

Radar cross section in meters squared for orthogonal polarization.

orthogonalRcsUncnumber double

one sigma uncertainty in orthogonal polarization Radar Cross Section, in meters^2.

snrnumber double

Signal to noise ratio, in dB.

trackingStatestring

The beam type (or tracking state) in use at the time of collection of this observation. Values include:

INIT ACQ WITH INIT VALUES: Initial acquisition based on predefined initial values such as position, velocity, or other specific parameters.

INIT ACQ: Initial acquisition when no prior information or initial values such as position or velocity are available.

TRACKING SINGLE BEAM: Continuously tracks and monitors a single target using one specific radar beam.

TRACKING SEQUENTIAL ROVING: Sequentially tracks different targets or areas by "roving" from one sector to the next in a systematic order.

SELF ACQ WITH INIT VALUES: Autonomously acquires targets using predefined starting parameters or initial values.

SELF ACQ: Automatically detects and locks onto targets without the need for predefined initial settings.

NON-TRACKING: Non-tracking.

beamnumber double

ID of the beam that produced this observation.

timingBiasnumber double

Sensor timing bias in seconds.

rawFileURIstring

Optional URI location in the document repository of the raw file parsed by the system to produce this record. To download the raw file, prepend https://udl-hostname/scs/download?id= to this value.

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.

tagsstring[]

Optional array of provider/source specific tags for this data, where each element is no longer than 32 characters, used for implementing data owner conditional access controls to restrict access to the data. Should be left null by data providers unless conditional access controls are coordinated with the UDL team.

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.

The reference frame of the observing sensor state. If the senReferenceFrame is null it is assumed to be J2000.

descriptorstring

Optional source-provided and searchable metadata or descriptor of the data.

origNetworkstring

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

sourceDLstring

The source data library from which this record was received. This could be a remote or tactical UDL or another data library. If null, the record should be assumed to have originated from the primary Enterprise UDL.

typestring

Read only enumeration specifying the type of observation (e.g. OPTICAL, RADAR, RF, etc).

Example request

{
  "id": "RADAROBSERVATION-ID",
  "classificationMarking": "U",
  "obTime": "2018-01-01T16:00:00.123456Z",
  "idOnOrbit": "ONORBIT-ID",
  "idSensor": "SENSOR-ID",
  "satNo": 1,
  "taskId": "TASK-ID",
  "transactionId": "TRANSACTION-ID",
  "trackId": "TRACK-ID",
  "obPosition": "FIRST",
  "origObjectId": "ORIGOBJECT-ID",
  "origSensorId": "ORIGSENSOR-ID",
  "uct": true,
  "azimuth": 45.23,
  "azimuthMeasured": true,
  "azimuthUnc": 45.23,
  "azimuthBias": 45.23,
  "azimuthRate": 1.23,
  "elevation": 45.23,
  "elevationMeasured": true,
  "elevationUnc": 1.23,
  "elevationBias": 1.23,
  "elevationRate": 1.23,
  "range": 100.23,
  "rangeMeasured": true,
  "rangeAccel": 10.23,
  "rangeAccelUnc": 1.23,
  "rangeUnc": 1.23,
  "rangeBias": 1.23,
  "rangeRate": 1.23,
  "rangeRateMeasured": true,
  "rangeRateUnc": 0.5,
  "doppler": 10.23,
  "dopplerUnc": 1.23,
  "ra": 1.23,
  "raMeasured": true,
  "declination": 10.23,
  "declinationMeasured": true,
  "x": 50.23,
  "y": 50.23,
  "z": 50.23,
  "xvel": 1.23,
  "yvel": 5.23,
  "zvel": 5.23,
  "senx": 45.23,
  "seny": 40.23,
  "senz": 35.23,
  "rcs": 100.23,
  "rcsUnc": 1.23,
  "orthogonalRcs": 1.23,
  "orthogonalRcsUnc": 10.23,
  "snr": 0.5,
  "trackingState": "INIT ACQ",
  "beam": 1.23,
  "timingBias": 1.23,
  "rawFileURI": "rawFileURI",
  "source": "Bluestaq",
  "origin": "THIRD_PARTY_DATASOURCE",
  "dataMode": "TEST",
  "tags": [
    "TAG1",
    "TAG2"
  ],
  "createdAt": "2018-01-01T16:00:00.123Z",
  "createdBy": "some.user",
  "senReferenceFrame": "J2000",
  "descriptor": "descriptor",
  "origNetwork": "OPS1",
  "sourceDL": "AXE",
  "type": "RADAR"
}

Response

Success

Changes

Apr 16, 202575f764c843a9 Revision changes
- info
  api operation id create_98 removed and replaced with
- info
  the endpoint scheme security BasicAuth was removed from the API
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property

Some revisions have not been checked yet.

Operation history