--- title: "GET /udl/gnssrawif/tuple" method: GET path: "/udl/gnssrawif/tuple" tags: ["Observation"] --- # GET /udl/gnssrawif/tuple `GET /udl/gnssrawif/tuple` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/gnssrawif/tuple` - Auth: none declared Service operation to dynamically query data and only return specified columns/fields. Requested columns are specified by the 'columns' query parameter and should be a comma separated list of valid fields for the specified data type. classificationMarking is always returned. See the queryhelp operation (`/udl//queryhelp`) for more details on valid/required query parameter information. An example URI: /udl/elset/tuple?columns=satNo,period&epoch=>now-5 hours would return the satNo and period of elsets with an epoch greater than 5 hours ago. ## Query parameters - `columns` string, required - `startTime` string, date-time, required - `firstResult` integer - `maxResults` integer ## Response `200` OK - GNSSRawIFFull[] - `id` string: Unique identifier of the record, auto-generated by the system. - `classificationMarking` string, required: Classification marking of the data in IC/CAPCO Portion-marked format. - `idOnOrbit` string: Unique identifier of the primary satellite on-orbit object. - `satNo` integer: Satellite/catalog number of the target on-orbit object. - `origObjectId` string: Optional identifier provided by the data source to indicate the target object of this record. This may be an internal identifier and not necessarily map to a valid satellite number. - `eventId` string: Optional source-provided identifier for this collection event. This field can be used to associate records related to the same event. - `esId` string: Unique identifier of the parent Ephemeris Set, if this data is correlated with an Ephemeris. If reporting for a spacecraft with multiple onboard GNSS receivers, this ID may be associated with multiple GNSS Raw IF records if each receiver is synced to the ephemeris points. - `receiver` string: The number or ID of the GNSS receiver associated with this data. If reporting for multiple receivers a separate record should be generated for each. If null, it is assumed to indicate that only one receiver is present, or reported. - `boresight` number[]: Unit vector of the outward facing direction of the receiver boresight in a body-fixed coordinate system. - `quat` number[]: The quaternion describing the rotation of the body-fixed frame used for this system into the local geodetic frame, at the sample start time (startTime). The array element order convention is scalar component first, followed by the three vector components. For a vector u in the body-fixed frame, the corresponding vector u' in the geodetic frame should satisfy u' = quq*, where q is this quaternion. The quaternion should be normalized to 1. - `startIndex` integer: The index of the sample within the associated binary file that corresponds to the startTime indicated in this record. This is especially useful on high sample-rate sensors when some samples are less than one microsecond before the value of startTime. This index is 0-based. If null, the startIndex is assumed to be 0. - `startTime` string, date-time, required: Start time of the data contained in the associated binary file, in ISO 8601 UTC format with microsecond precision. - `endTime` string, date-time, required: End time of the data contained in the associated binary file, in ISO 8601 UTC format with microsecond precision. - `startLat` number, double: WGS-84 spacecraft latitude sub-point at start time (startTime), represented as -90 to 90 degrees (negative values south of equator). - `startLon` number, double: WGS-84 spacecraft longitude sub-point at start time (startTime), represented as -180 to 180 degrees (negative values west of Prime Meridian). - `startAlt` number, double: Spacecraft altitude at start time (startTime), expressed in kilometers above WGS-84 ellipsoid. - `endLat` number, double: WGS-84 spacecraft latitude sub-point at end time (endTime), represented as -90 to 90 degrees (negative values south of equator). - `endLon` number, double: WGS-84 spacecraft longitude sub-point at end time (endTime), represented as -180 to 180 degrees (negative values west of Prime Meridian). - `endAlt` number, double: Spacecraft altitude at end time (endTime), expressed in kilometers above WGS-84 ellipsoid. - `centerFreq` number[], required: The center frequency, in MHz, of the observation bands. More than one band may be reported in each binary file, so this is an array of the center frequency of each band (including an array of length 1 if only one band is present). - `ifFreq` number[]: The center frequency, in MHz, after downconversion to intermediate frequency. If provided, this array should have the same length as centerFreqs. - `sampleRate` integer[]: The number of samples taken per second. - `postFourier` string[]: After converting the raw data in the file, to generate (frequency-space) spectra some sets require an additional transformation or correction based on details of the hardware that recorded it. This field marks any such transformations. Currently supported options are NONE (no correction) and MIRRORED (frequency axis is flipped around the corresponding value of ifFreq). If null, it is assumed that NONE applies to all frequency bands. - `sampleType` string: The sample type associated with the IF data. REAL for data with only an I-component or COMPLEX for data with both I & Q components. - `bitDepth` integer: The number of bits in each datum, for example 2 for 2-bit integers or 8 for 8-bit integers. - `diffCodeBias` number[]: Differential Code Biases (DCBs) are the systematic errors, or biases, between two GNSS code observations at the same or different frequencies. If applicable, this field should contain an array of DBC with length equal to the number of frequencies in the binary file. The reference frequency should show DCB equal to 0. If null, it is assumed that there is no DCB (all values are 0). - `dataRate` number, double: The amount of data generated per unit time, expressed in Megabytes/minute. - `setId` string: User-defined ID of a set or sequence of records/files. Used to associate a set of related raw IF records. - `setLength` integer: The number of raw IF records/files in a set. - `sequenceID` integer: The sequence number of a raw IF record/file within a set. Sequence number should start at 1. If null, then it is assumed that the order of records within a raw IF set is not relevant. - `fileName` string, required: The file name of the Raw IF Binary file. The files should be in the Hierarchical Data Format (HDF5). - `srcTyps` string[]: Array of UDL record types (GNSSSET) associated with this GNSSRawIF record. See the associated 'srcIds' array for the record UUIDs, positionally corresponding to the record types in this array. The 'srcTyps' and 'srcIds' arrays must match in size. - `srcIds` string[]: Array of UUIDs of the UDL data records associated with this GNSSRawIF record. See the associated 'srcTyps' array for the specific types of data, positionally corresponding to the UUIDs in this array. The 'srcTyps' and 'srcIds' arrays must match in size. See the corresponding srcTyps array element for the data type of the UUID and use the appropriate API operation to retrieve that object (e.g. /udl/gnssobservationset/{uuid}). - `fileSize` integer: The binary file size, in bytes, auto-populated by the system. The maximum file size for this service is 5,000,000 Bytes (5 MB). Files exceeding the maximum size will be rejected. - `tags` string[]: 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. - `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. - `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. - `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. - `origNetwork` string: The originating source network on which this record was created, auto-populated by the system. ## Other responses - `400`: Bad Request - `401`: Invalid/Missing User Credentials - `403`: User Is Not Authorized - `405`: Method Not Allowed - `406`: MediaType Not Accepted by Request Headers - `429`: Rate of Requests Exceeds Allowed Limit - `500`: Internal Server Error ## Changes > 12 revisions in range; 1 could not be searched. - **2026-03-25** `173e4aff893f`: 2 breaking - the `items/boresight` response property's minItems was decreased from `3` to `0` for the response status `200` - the `items/quat` response property's minItems was decreased from `4` to `0` for the response status `200` - **2025-05-29** `4e1cbc17e814`: 2 info - added the new optional `query` request parameter `firstResult` - added the new optional `query` request parameter `maxResults` - **2025-04-16** `75f764c843a9`: 2 info - api operation id `findAllTuples_52` removed and replaced with `` - the endpoint scheme security `BasicAuth` was removed from the API [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/gnssrawif/tuple/get.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)