BLbluestaq
Observation

POST /filedrop/udl-passiveradar

Changed on

Service operation to take multiple PassiveRadarObservation records as a POST body and ingest into the database. This operation is intended to be used for automated feeds into UDL. 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/filedrop/udl-passiveradar
  • 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 satellite on-orbit object. This ID can be used to obtain additional information on an OnOrbit object using the 'get by ID' operation (e.g. /udl/onorbit/{id}). For example, the OnOrbit with idOnOrbit = 25544 would be queried as /udl/onorbit/25544.

satNointeger

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

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.

idSensorstring

Unique identifier of the reporting surveillance sensor. This ID can be used to obtain additional information on a sensor using the 'get by ID' operation (e.g. /udl/sensor/{id}). For example, the sensor with idSensor = abc would be queried as /udl/sensor/abc.

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.

idRFEmitterstring

Unique identifier of the transmitter. This ID can be used to obtain additional information on an RFEmitter using the 'get by ID' operation (e.g. /udl/rfemitter/{id}). For example, the RFEmitter with idRFEmitter = abc would be queried as /udl/rfemitter/abc.

idSensorRefReceiverstring

Unique identifier of the reference receiver sensor. This ID can be used to obtain additional information on a sensor using the 'get by ID' operation (e.g. /udl/sensor/{id}). For example, the sensor with idSensor = abc would be queried as /udl/sensor/abc.

extObservationIdstring

Optional external observation identifier provided by the source.

taskIdstring

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

trackIdstring

Unique identifier of a track that represents a tracklet for this observation.

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.

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

Line of sight azimuth angle in degrees and topocentric frame.

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.

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.

delaynumber double

The time difference, in seconds, between the signal collected at the surveillance site (after being reflected from the target) and the reference site (direct path line-of-sight signal).

delayUncnumber double

One sigma uncertainty in the delay measurement, in seconds.

delayBiasnumber double

Delay bias in seconds.

bistaticRangenumber double

Target bistatic path distance in kilometers. This is the transmitter-to-target-to-surveillance site distance.

bistaticRangeUncnumber double

One sigma uncertainty in bistatic range in kilometers.

bistaticRangeBiasnumber double

Sensor bistatic range bias in kilometers.

bistaticRangeRatenumber double

Rate of change of the bistatic path, in kilometers per second.

bistaticRangeRateUncnumber double

One sigma uncertainty in rate of change of the bistatic path, in kilometers per second.

bistaticRangeAccelnumber double

Bistatic range acceleration, in kilometers per second squared.

bistaticRangeAccelUncnumber double

One sigma uncertainty in the bistatic range acceleration measurement, in kilometers per second squared.

dopplernumber double

Doppler measurement in hertz.

dopplerUncnumber double

One sigma uncertainty in the Doppler measurement in hertz.

coningnumber double

Coning angle in degrees.

coningUncnumber double

One sigma uncertainty in the coning angle measurement, in degrees.

tofnumber double

Time of flight (TOF) in seconds. This is the calculated propagation time from transmitter-to-target-to-surveillance site.

tofUncnumber double

One sigma uncertainty in time of flight in seconds.

tofBiasnumber double

The Time of Flight (TOF) bias in seconds.

accelnumber double

The target Acceleration measurement, in kilometers per second squared, for this observation.

accelUncnumber double

The target Acceleration uncertainty measurement, in kilometers per second squared, for this observation.

ranumber double

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

declinationnumber double

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

latnumber double

WGS-84 target latitude sub-point at observation time (obTime), represented as -90 to 90 degrees (negative values south of equator).

lonnumber double

WGS-84 target longitude sub-point at observation time (obTime), represented as -180 to 180 degrees (negative values west of Prime Meridian).

altnumber double

The target altitude relative to WGS-84 ellipsoid, in kilometers for this observation.

xvelnumber double

X velocity of target, in kilometers per second, in J2000 coordinate frame.

yvelnumber double

Y velocity of target, in kilometers per second, in J2000 coordinate frame.

zvelnumber double

Z velocity of target, in kilometers per second, in J2000 coordinate frame.

senReferenceFrame'J2000' | 'EFG/TDR' | 'ECR/ECEF' | 'TEME' | 'ITRF' | 'GCRF'

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

senxnumber double

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

senynumber double

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

senznumber double

Sensor z position, in kilometers, 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 squared.

orthogonalRcsnumber double

Radar cross section, in meters squared, for orthogonal polarization.

orthogonalRcsUncnumber double

One sigma uncertainty in orthogonal polarization Radar Cross Section, in meters squared.

snrnumber double

Signal to noise ratio, in decibels.

timingBiasnumber double

Sensor timing bias in seconds.

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.

transactionIdstring

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

descriptorstring

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

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.

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.

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.

typestring

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

Example request

[
  {
    "id": "bdcacfb0-3c47-4bd0-9d6c-9fa7d2c4fbb0",
    "classificationMarking": "U",
    "obTime": "2023-01-24T23:35:26.518152Z",
    "idOnOrbit": "40699",
    "satNo": 40699,
    "origObjectId": "ORIGOBJECT-ID",
    "idSensor": "OCULUSA",
    "origSensorId": "ORIGSENSOR-ID",
    "idRFEmitter": "RED_CLIFFS_3ABCRN",
    "idSensorRefReceiver": "OculusRef1",
    "extObservationId": "26892",
    "taskId": "TASK-ID",
    "trackId": "12212",
    "obPosition": "FIRST",
    "azimuth": 134.5,
    "azimuthUnc": 0.5,
    "azimuthBias": 0.123,
    "azimuthRate": 0.5,
    "elevation": 76.1,
    "elevationUnc": 0.5,
    "elevationBias": 0.123,
    "elevationRate": 0.5,
    "delay": 0.00505820232809312,
    "delayUnc": 0.0000031,
    "delayBias": 0.00000123,
    "bistaticRange": 754.8212,
    "bistaticRangeUnc": 5.1,
    "bistaticRangeBias": 2.34,
    "bistaticRangeRate": -0.30222,
    "bistaticRangeRateUnc": 0.123,
    "bistaticRangeAccel": 1.23,
    "bistaticRangeAccelUnc": 0.1,
    "doppler": -101.781641000597,
    "dopplerUnc": 0.2,
    "coning": 60.1,
    "coningUnc": 0.5,
    "tof": 0.00592856674135648,
    "tofUnc": 0.0000031,
    "tofBias": 0.00000123,
    "accel": 1.23,
    "accelUnc": 0.1,
    "ra": 1.23,
    "declination": 10.23,
    "lat": -35.1181763996856,
    "lon": 139.613567052763,
    "alt": 478.056378,
    "xvel": 1.23,
    "yvel": 3.21,
    "zvel": 3.12,
    "senReferenceFrame": "J2000",
    "senx": -4527.793,
    "seny": 3793.586,
    "senz": 3553.495,
    "rcs": 100.23,
    "rcsUnc": 1.23,
    "orthogonalRcs": 10.23,
    "orthogonalRcsUnc": 1.23,
    "snr": 17.292053,
    "timingBias": 1.23,
    "tags": [
      "TAG1",
      "TAG2"
    ],
    "transactionId": "TRANSACTION-ID",
    "descriptor": "Descriptor",
    "createdAt": "2018-01-01T16:00:00.123Z",
    "createdBy": "some.user",
    "source": "Bluestaq",
    "origin": "THIRD_PARTY_DATASOURCE",
    "origNetwork": "OPS1",
    "sourceDL": "AXE",
    "dataMode": "TEST",
    "type": "RADAR"
  }
]

Response

Accepted

Changes

  • bd17bc53681eRevision 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 non-success response with the status

  • 75f764c843a9Revision changes
    • warning

      the / request property's min was set to 0.00

    • info

      the endpoint scheme security BasicAuth was removed from the API

Some revisions have not been checked yet.