BLbluestaq
Solar/Geomagnetic and Radiation Belt

POST /udl/sgi

Changed on

Service operation to take a single SGI record as a POST body and ingest into the database. 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/udl/sgi
  • 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.

effectiveDatestring date-time required

ISO8601 UTC Time the data was received and processed from the source. Typically a source provides data for a date window with each transmission including past, present, and future predicted values.

sgiDatestring date-time required

ISO8601 UTC Time of the index value. This could be a past, current, or future predicted value. Note: sgiDate defines the start time of the time window for this data record.

typestring

The type of data contained in this record (e.g. HASDM, JBH09, K-Index, PSD-dB, RBI, RFI-SFU, etc).

state'I' | 'N' | 'P'

State indicating Issued (I), Nowcast (N), or Predicted (P) values for this record.

stationNamestring

The name/location of the station that collected the geomagnetic data for this record.

idSensorstring

Unique identifier of the reporting sensor.

origSensorIdstring

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

modeinteger

The transmitted DCA mode of the record (1-3).

precedence'O' | 'P' | 'R' | 'Y' | 'Z'

The precedence of data in this record (O = Immediate, P = Priority, R = Routine, Y = Emergency, Z = Flash).

coeffDegreeinteger[]

Array containing the degree of the temperature coefficients. The coeffDegree and coeffOrder arrays must be the same length.

coeffOrderinteger[]

Array containing the order of the temperature coefficients. The coeffDegree and coeffOrder arrays must be the same length.

ctcenumber[]

Array containing the cosine spherical-harmonic coefficients for Exospheric temperature (DTC) difference. Each array element corresponds to the positional index of the coeffDegree and coeffOrder arrays.

stcenumber[]

Array containing the sine spherical-harmonic coefficients for Exospheric temperature (DTC) difference. Each array element corresponds to the positional index of the coeffDegree and coeffOrder arrays.

ctcinumber[]

Array containing the cosine spherical-harmonic coefficients for Inflection temperature (DTX) difference. Each array element corresponds to the positional index of the coeffDegree and coeffOrder arrays.

stcinumber[]

Array containing the sine spherical harmonic coefficients for Inflection temperature (DTX) difference. Each array element corresponds to the positional index of the coeffDegree and coeffOrder arrays.

e10number double

Extreme Ultraviolet (EUV) proxy, E10.7, in x10-22 Watts per meter squared per Hertz, is the integrated solar EUV energy flux at the top of atmosphere and normalized to solar flux units.

e54number double

E54 (E10-Bar), in x10-22 Watts per meter squared per Hertz, uses the past 54-days E10 values to determine the E10 average.

s10number double

Daily S10.7 index for >200 km heating of O by solar chromosphere. 28.4-30.4 nm emissions in x10-22 Watts per meter squared per Hertz.

s54number double

54 day S10.7 index for >200 km heating of O by solar chromosphere. 28.4-30.4 nm emissions in x10-22 Watts per meter squared per Hertz.

m10number double

Daily M10.7 index for 100-110 km heating of O2 by solar photosphere. 160 nm SRC emissions in x10-22 Watts per meter squared per Hertz.

m54number double

54 day M10.7 index for 100-110 km heating of O2 by solar photosphere. 160 nm SRC emissions in x10-22 Watts per meter squared per Hertz.

y10number double

Daily Y10.7 index for 85-90 km heating of N2, O2, H2O, NO by solar coronal. 0.1-0.8 nm and Lya 121 nm emissions in x10-22 Watts per meter squared per Hertz.

y54number double

54 day Y10.7 index for 85-90 km heating of N2, O2, H2O, NO by solar coronal. 0.1-0.8 nm and Lya 121 nm emissions in x10-22 Watts per meter squared per Hertz.

f10number double

Daily solar 10.7 cm radio flux in x10-22 Watts per meter squared per Hertz.

f54number double

54 day solar 10.7 cm radio flux in x10-22 Watts per meter squared per Hertz.

f81number double

81 day solar 10.7 cm radio flux in x10-22 Watts per meter squared per Hertz.

f10Highnumber double

Daily F10.7 index - high range, in x10-22 Watts per meter squared per Hertz. This field usually applies to forecast values, based on the consensus of the Solar Cycle 24 Prediction Panel.

f10Lownumber double

Daily F10.7 index - low range, in x10-22 Watts per meter squared per Hertz. This field usually applies to forecast values, based on the consensus of the Solar Cycle 24 Prediction Panel.

sunspotNumnumber double

Daily sunspot number.

sunspotNumHighnumber double

Daily sunspot number - high range. This field usually applies to forecast values, based on the consensus of the Solar Cycle 24 Prediction Panel.

sunspotNumLownumber double

Daily sunspot number - low range. This field usually applies to forecast values, based on the consensus of the Solar Cycle 24 Prediction Panel.

apnumber double

Ap is the planetary geomagnetic 2 nT index (00-21 UT) for the timespan specified in apDuration. If apDuration is null, a 3 hour duration should be assumed.

apDurationinteger

The time, in hours, for which the Ap index value is valid. If null, a span of 3 hours is assumed.

kIndexinteger

The maximum measured K-Index at the associated station during the kpDuration timespan. The K-Index is a unitless measure (0 - 9) of the deviation in the Earth's magnetic field from normal at the station geographic location, with 0 indicating the absence of geomagnetic disturbance, and 9 indicating the most significant disturbance. If kpDuration is null, a 3 hour duration should be assumed.

kpnumber double

The Planetary K-index (Kp) over the kpDuration timespan. The Kp-Index is the average K-Index for the entire Earth, utilizing a unitless scale (0-9, in incremenets of 1/3), with 0 indicating the absence of geomagnetic disturbance, and 9 indicating the most significant disturbance. If kpDuration is null, a 3 hour duration should be assumed.

kpDurationinteger

The time, in hours, over which the K, Kp, and/or gamma index values are measured. If null, a span of 3 hours is assumed.

gammainteger

The maximum measured gamma deflection during the kpDuration timespan. If kpDuration is null, a 3 hour duration should be assumed.

dstnumber double

Disturbance Storm Time geomagnetic index in nT.

dtcnumber double

delta exospheric temperature correction in units of K.

rbRegionCodeinteger

Region code for the associated radiation belt index. This is the code associated with the corresponding radiation belt location. See the provider card for reference to specific region code definitions.

rbIndexnumber double

The value of the radiation belt index. This is the ratio of current intensity of a radiation belt to long-term average value. It's long-term average should be close to 1. Depending on the type of belt sensor, this ratio may measure Flux (number of particles / (cm^2 sec energy solid-angle)), dose rate (rad per second), or relative counts of particles per time (counts per second). The index value may also be normalized, the normalization value typically represents an average of the sensor measurements taken within a region over a given time interval. See the normFactor field for the specific normalization factor, if provided.

normFactornumber double

The normalization factor that has already been applied to the index value prior to record ingest. Typically used to normalize the index value to a particular interval. Units of the normalization factor may vary depending on the provider of this data (REACH, POES, CEASE3, etc.).

rbDurationinteger

The timespan over which the associated radiation belt index is factored. If rbDuration is null, a 24 hour duration should be assumed. Note: rbDuration defines the length of the time window for this data record. The time window start time is defined by sgiDate, and the time window end time is defined by sgiDate plus rbDuration.

analyzerAttenuationnumber double

Signal analyzer's input attenuation level, in decibels. Attenuation is a setting on the hardware that measures the power of a signal.

observedBaselineinteger[]

Observed baseline values of the frequencies specified in the frequencies field, in solar flux units. The baseline values will be used to help detect abnormal readings from the sun that might indicate a flare or other solar activity.

frequenciesnumber[]

Array of individual power spectral density (PSD) frequencies of the signal, in megahertz. This array should correspond with the same-sized array of powers.

powersnumber[]

Array of individual power spectral density (PSD) powers of the signal, in watts. This array should correspond with the same-sized array of frequencies.

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.

transactionIdstring

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

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.

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.

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.

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.

Example request

{
  "id": "SGI-ID",
  "classificationMarking": "U",
  "effectiveDate": "2018-01-01T16:00:00.123Z",
  "sgiDate": "2018-01-01T16:00:00.123Z",
  "type": "JBH09",
  "state": "I",
  "stationName": "Boulder",
  "idSensor": "57c96c97-e076-48af-a068-73ee2cb37e65",
  "origSensorId": "ORIGSENSOR-ID",
  "mode": 1,
  "precedence": "R",
  "coeffDegree": [
    1,
    2,
    3
  ],
  "coeffOrder": [
    1,
    2,
    3
  ],
  "ctce": [
    1.23,
    342.3,
    1.32
  ],
  "stce": [
    1.23,
    342.3,
    1.32
  ],
  "ctci": [
    1.23,
    342.3,
    1.32
  ],
  "stci": [
    1.23,
    342.3,
    1.32
  ],
  "e10": 1.23,
  "e54": 1.23,
  "s10": 1.23,
  "s54": 1.23,
  "m10": 1.23,
  "m54": 1.23,
  "y10": 1.23,
  "y54": 1.23,
  "f10": 1.23,
  "f54": 1.23,
  "f81": 1.23,
  "f10High": 187.5,
  "f10Low": 185.5,
  "sunspotNum": 151.1,
  "sunspotNumHigh": 152.1,
  "sunspotNumLow": 150.1,
  "ap": 1.23,
  "apDuration": 3,
  "kIndex": 1,
  "kp": 4.66,
  "kpDuration": 3,
  "gamma": 25,
  "dst": 1.23,
  "dtc": 1.23,
  "rbRegionCode": 2,
  "rbIndex": 1.02947164506,
  "normFactor": 2.12679e-7,
  "rbDuration": 24,
  "analyzerAttenuation": 5.1,
  "observedBaseline": [
    15,
    32,
    25,
    134,
    0,
    6,
    19,
    8
  ],
  "frequencies": [
    25,
    25.125,
    25.25,
    25.375,
    25.5,
    25.625,
    25.75,
    25.875
  ],
  "powers": [
    67.1,
    65.2,
    68.1,
    74.3,
    68.1,
    96.4,
    97.3,
    68.1
  ],
  "rawFileURI": "rawFileURI",
  "transactionId": "TRANSACTION-ID",
  "tags": [
    "PROVIDER_TAG1",
    "PROVIDER_TAG2"
  ],
  "source": "Bluestaq",
  "origin": "THIRD_PARTY_DATASOURCE",
  "origNetwork": "OPS1",
  "dataMode": "TEST",
  "createdAt": "2018-01-01T16:00:00.123Z",
  "createdBy": "some.user"
}

Response

Success

Changes

  • 75f764c843a9Revision changes
    • info

      api operation id create_100 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

Some revisions have not been checked yet.