--- title: "POST /udl/sensorcalibration" method: POST path: "/udl/sensorcalibration" tags: ["Sensor"] --- # POST /udl/sensorcalibration `POST /udl/sensorcalibration` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/sensorcalibration` - Auth: none declared Service operation to take a single SensorCalibration 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 body - SensorCalibrationIngest: The Sensor Calibration service records data about a sensor's overall accuracy and is used to adjust sensor settings to achieve and maintain that accuracy in reported sensor observations. Calibration occurs periodically when needed to maintain sensor accuracy or on-demand to adjust a sensor for a specific reading. - `id` string: Unique identifier of the record, auto-generated by the system if not provided on create operations. - `classificationMarking` string, required: Classification marking of the data in IC/CAPCO Portion-marked format. - `idSensor` string, required: Unique identifier of the sensor to which this calibration data applies. 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. - `senType` string: The sensor type (MECHANICAL, OPTICAL, PHASED ARRAY, RF). - `calType` string: The basis of calibration values contained in this record (COMPUTED, OPERATIONAL). - `calTrackMode` string: Specifies that the calibration data are from INTRA_TRACK or INTER_TRACK residuals. - `duration` number, double: Duration of the sensor calibration data which produced these values, measured in days. - `startTime` string, date-time, required: Calibration data span start time in ISO 8601 UTC format with millisecond precision. - `endTime` string, date-time: Calibration data span end time in ISO 8601 UTC format with millisecond precision. If provided, the endTime must be greater than or equal to the startTime in the SensorCalibration record. - `ecr` number[]: Three element array, expressing the sensor location in Earth Centered Rotating (ECR) coordinates, in kilometers. The array element order is [x, y, z]. - `numObs` integer: The total number of observables available over the calibration span. - `numTracks` integer: The total number of tracks available over the calibration span. - `numTimeObs` integer: The number of observables used in determining the time calibration values. - `timeBias` number, double: Sensor time bias, in seconds. - `timeBiasSigma` number, double: The standard deviation of the time residuals, in seconds, used to determine the sensor time bias. - `numRangeObs` integer: The number of observables used in determining the range calibration values. - `numRangeRateObs` integer: The number of observables used in determining the range rate calibration values. - `rangeBias` number, double: Sensor range bias, in kilometers. - `rangeRateBias` number, double: Sensor range rate bias, in kilometers per second. - `rangeAccelBias` number, double: Sensor range rate acceleration bias, in kilometers per second squared. - `rangeSigma` number, double: The standard deviation of the range residuals, in kilometers, used to determine the sensor range bias. - `rangeRateSigma` number, double: The standard deviation of the range rate residuals, in kilometers per second, used to determine the sensor range rate bias. - `rangeRms` number, double: The root mean square of the range residuals, in kilometers, used to determine the sensor range bias. - `rangeRateRms` number, double: The root mean square of the range rate residuals, in kilometers per second, used to determine the sensor range rate bias. - `rangeAccelSigma` number, double: The standard deviation of the range acceleration residuals, in kilometers per second squared, used to determine the sensor range acceleration bias. - `calAngleRef` string: Specifies the calibration reference angle set for this calibration data set. Azimuth and Elevation (AZEL) or Right Ascension and Declination (RADEC). - `numAzRaObs` integer: The number of observables used in determining the azimuth or right-ascension calibration values. - `azRaRms` number, double: The root mean square of the azimuth/right-ascension residuals, in degrees, used to determine the sensor azimuth/right-ascension bias. - `azRaBias` number, double: Sensor azimuth/right-ascension bias, in degrees. - `azRaSigma` number, double: The standard deviation of the azimuth/right ascension residuals, in degrees, used to determine the sensor azimuth/right-ascension bias. - `azRaRateBias` number, double: Sensor azimuth/right-ascension rate bias, in degrees per second. - `azRaAccelBias` number, double: Sensor azimuth/right-ascension acceleration bias, in degrees per second squared. - `azRaRateSigma` number, double: The standard deviation of the azimuth/right ascension rate residuals, in degrees, used to determine the sensor azimuth/right-ascension rate bias. - `azRaAccelSigma` number, double: The standard deviation of the azimuth/right ascension acceleration residuals, in degrees, used to determine the sensor azimuth/right-ascension acceleration bias. - `numElDecObs` integer: The number of observables used in determining the elevation or declination calibration values. - `elDecRms` number, double: The root mean square of the elevation/declination residuals, in degrees, used to determine the sensor elevation/declination bias. - `elDecBias` number, double: Sensor elevation/declination bias, in degrees. - `elDecSigma` number, double: The standard deviation of the elevation/declination residuals, in degrees, used to determine the sensor elevation/declination bias. - `elDecRateBias` number, double: Sensor elevation/declination rate bias, in degrees per second. - `elDecAccelBias` number, double: Sensor elevation/declination acceleration bias, in degrees per second squared. - `elDecRateSigma` number, double: The standard deviation of the elevation/declination rate residuals, in degrees, used to determine the sensor elevation/declination rate bias. - `elDecAccelSigma` number, double: The standard deviation of the elevation/declination acceleration residuals, in degrees, used to determine the sensor elevation/declination acceleration bias. - `numPhotoObs` integer: The number of observables used in determining the photometric calibration values. - `photoBias` number, double: The sensor photometric observation magnitude bias, in visual magnitude. - `photoSigma` number, double: The standard deviation of the magnitude residuals, in visual magnitude, used to determine the photometric bias. - `numRcsObs` integer: The number of observables used in determining the radar cross section (RCS) calibration values. - `rcsBias` number, double: The sensor radar cross section (RCS) observation bias, in square meters. - `rcsSigma` number, double: The standard deviation of the radar cross section residuals, in square meters, used to determine the radar cross section bias. - `refType` string: The reference type used in the calibration. - `refTargets` string[]: Array of the catalog IDs of the reference targets used in the calibration. - `confidenceNoiseBias` number, double: The confidence noise bias of the duration span. - `createdAt` string, date-time: Time the row was created in the database, auto-populated by the system. - `createdBy` string: Application user who created the row in the database, auto-populated by the system. - `sourceDL` string: 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. - `source` string, required: Source of the data. - `origin` string: 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. - `origNetwork` string: The originating source network on which this record was created, auto-populated by the system. - `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. ## Response `201` Success ## Other responses - `400`: Bad Request - `401`: Invalid/Missing User Credentials - `403`: User Is Not Authorized - `405`: Method Not Allowed - `415`: MediaType Unsupported - `429`: Rate of Requests Exceeds Allowed Limit - `500`: Internal Server Error ## Changes > 12 revisions in range; 1 could not be searched. - **2025-09-26** `45631f9bb3f0`: 1 breaking - the `origNetwork` request property's minLength was increased from `0` to `1` - **2025-05-29** `4e1cbc17e814`: 6 warning, 6 info - removed the request property `azRaBiasRate` - removed the request property `azRaMean` - removed the request property `azRaSigmaRate` - removed the request property `elDecBiasRate` - …8 more - **2025-04-16** `75f764c843a9`: 1 info - endpoint added [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/sensorcalibration/post.md) --- [API](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api.md) - [All operations](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/revisions/bd17bc53681e?raw)