BLbluestaq
TDOA/FDOA

POST /udl/diffofarrival/createBulk

Changed on

Service operation intended for initial integration only, to take a list of TDOA/FDOA records 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/diffofarrival/createBulk
  • 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.

idSensor1string

Sensor ID of the primary/1st sensor used for this measurement.

idSensor2string

Sensor ID of the secondary/2nd sensor used for this measurement.

satNointeger

Catalog number of the target on-orbit object.

taskIdstring

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

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.

origSensorId1string

Optional identifier provided by DOA source to indicate the primary/1st sensor identifier used for this measurement. This may be an internal identifier and not necessarily a valid sensor ID.

origSensorId2string

Optional identifier provided by DOA source to indicate the secondary/2nd sensor identifier used for this 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.

sensor1Delaynumber double

The signal arrival delay relative to sensor 1, in seconds.

sensor2Delaynumber double

The signal arrival delay relative to sensor 2, in seconds.

senlatnumber double

Sensor WGS84 latitude at obTime (if mobile/onorbit), in degrees. If null, can be obtained from sensor info. -90 to 90 degrees (negative values south of equator).

senlonnumber double

Sensor WGS84 longitude at obTime (if mobile/onorbit), in degrees. If null, can be obtained from sensor info. -180 to 180 degrees (negative values west of Prime Meridian).

senaltnumber double

Sensor altitude at obTime (if mobile/onorbit), in kilometers. If null, can be obtained from sensor info.

azimuth1number double

Line of sight azimuth angle for sensor 1, in degrees and topocentric frame. Azimuth ranges from 0 to 360 degrees.

elevation1number double

Line of sight elevation angle for sensor 1, in degrees and topocentric frame. Elevation ranges from -90 to 90 degrees.

sen2latnumber double

Sensor 2 WGS84 latitude at obTime (if mobile/onorbit), in degrees. If null, can be obtained from sensor info. -90 to 90 degrees (negative values south of equator).

sen2lonnumber double

Sensor 2 WGS84 longitude at obTime (if mobile/onorbit), in degrees. If null, can be obtained from sensor info. -180 to 180 degrees (negative values west of Prime Meridian).

sen2altnumber double

Sensor 2 altitude at obTime (if mobile/onorbit), in kilometers. If null, can be obtained from sensor info.

azimuth2number double

Line of sight azimuth angle for sensor 2, in degrees and topocentric frame. Azimuth ranges from 0 to 360 degrees.

elevation2number double

Line of sight elevation angle for sensor 2, in degrees and topocentric frame. Elevation ranges from -90 to 90 degrees.

frequencynumber double

Center frequency of the collect, in hertz.

bandwidthnumber double

Bandwidth of the signal, in hertz.

deltaRangenumber double

Delta range, in kilometers. Delta range calculation convention is (sensor2 - sensor1).

deltaRangeUncnumber double

One sigma uncertainty in delta range, in kilometers.

deltaRangeRatenumber double

Delta range rate, in kilometers per second. Delta range rate calculation convention is (sensor2 - sensor1).

deltaRangeRateUncnumber double

One sigma uncertainty in the delta range rate, in kilometers per second.

snrnumber double

Signal to noise ratio, in decibels.

polarityTypestring

Transponder polarization e.g. H - (Horizontally Polarized) Perpendicular to Earth's surface, V - (Vertically Polarized) Parallel to Earth's surface, L - (Left Hand Circularly Polarized) Rotating left relative to the earth's surface, R - (Right Hand Circularly Polarized) Rotating right relative to the earth's surface.

tdoanumber double

Time difference of arrival of the center frequency signal, in seconds. TDOA calculation convention is (sensor2 - sensor1).

tdoaUncnumber double

One sigma uncertainty in time difference of arrival of the center frequency signal, in seconds.

tdoaAmbinteger

The number of full signal cycles the time difference of arrival measurement could be shifted due to repeating patterns in the signal (0 = no ambiguity, +1 = one positive cycle ambiguity, -1 = one negative cycle ambiguity).

fdoanumber double

Frequency difference of arrival of the center frequency signal, in hertz. FDOA calculation convention is (sensor2 - sensor1).

fdoaUncnumber double

One sigma uncertainty in frequency difference of arrival of the center frequency signal, in hertz.

collectionModestring

Collection mode (e.g., DIRECTED_SEARCH, MANUAL, NEIGHBORHOOD_WATCH, SPOT_SEARCH, SURVEY, etc.).

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. This field should not be used unless coordinated with the UDL onboarding team.

sourcestring required

Source of the data.

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.

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.

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.

descriptorstring

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

transactionIdstring

Optional identifier to track a commercial or marketplace transaction executed to produce this 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.

Example request

[
  {
    "id": "DIFFOFARRIVAL-ID",
    "classificationMarking": "U",
    "obTime": "2018-01-01T16:00:00.123456Z",
    "idOnOrbit": "ONORBIT-ID",
    "idSensor1": "SENSOR1-ID",
    "idSensor2": "SENSOR2-ID",
    "satNo": 25544,
    "taskId": "TASK-ID",
    "origObjectId": "ORIGOBJECT-ID",
    "origSensorId1": "ORIGSENSOR1-ID",
    "origSensorId2": "ORIGSENSOR2-ID",
    "sensor1Delay": 0.000004,
    "sensor2Delay": 0.000004,
    "senlat": 45.1,
    "senlon": 120.1,
    "senalt": 783.1,
    "azimuth1": 40.9,
    "elevation1": 65.4,
    "sen2lat": 32.2,
    "sen2lon": -110.9,
    "sen2alt": 770.1,
    "azimuth2": 43.4,
    "elevation2": 65.9,
    "frequency": 2240000000,
    "bandwidth": 500000.1,
    "deltaRange": 1.7,
    "deltaRangeUnc": 0.2,
    "deltaRangeRate": 0.018,
    "deltaRangeRateUnc": 0.001,
    "snr": 18.1,
    "polarityType": "V",
    "tdoa": 0.0000136,
    "tdoaUnc": 2e-7,
    "tdoaAmb": 1,
    "fdoa": 970.8,
    "fdoaUnc": 20.1,
    "collectionMode": "SURVEY",
    "rawFileURI": "/DOA/2026/01/01/filename.txt",
    "source": "Bluestaq",
    "dataMode": "TEST",
    "tags": [
      "TAG1",
      "TAG2"
    ],
    "origin": "THIRD_PARTY_DATASOURCE",
    "createdAt": "2018-01-01T16:00:00.123Z",
    "createdBy": "some.user",
    "descriptor": "Example descriptor",
    "transactionId": "TRANSACTION-ID",
    "origNetwork": "OPS1",
    "sourceDL": "AXE"
  }
]

Response

Success

Changes

  • 173e4aff893fRevision changes
    • 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 /

  • 45631f9bb3f0Revision changes
    • breaking

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

Some revisions have not been checked yet.