VirES for Swarm — HAPI Server

The Heliophysics Application Programming Interface (HAPI) is a community specification of a unified interface for accessing data time-series. The VirES for Swarm acts as a HAPI server and allows access to selected datasets via the HAPI interface.

For more details about see the HAPI Specification.

HAPI clients for various programming environments can be found here.

Terms and Conditions

The access and use of Swarm products are regulated by ESA's Data Policy and subject to the acceptance of the specific Terms and Conditions.

The VirES for Swarm HAPI end-point, unlike the other VirES APIs, does not require user authentication. The datasets published via the VirES for Swarm HAPI interface are accessible freely.

Available Datasets

This section list available datasets grouped by the type and their parameters (click to expand the collapsed lists). Click a dataset name to see its HAPI JSON info response.

`SW_MODx_SC_1B`

dataset	description
`SW_FAST_MODA_SC_1B`	Swarm A S/C fast track position from the preliminary Medium Accuracy Orbit Determination (MOD). The original SP3c records have been converted to UTC and ITRF spherical coordinates.
`SW_FAST_MODB_SC_1B`	Swarm B S/C fast track position from the preliminary Medium Accuracy Orbit Determination (MOD). The original SP3c records have been converted to UTC and ITRF spherical coordinates.
`SW_FAST_MODC_SC_1B`	Swarm C S/C fast track position from the preliminary Medium Accuracy Orbit Determination (MOD). The original SP3c records have been converted to UTC and ITRF spherical coordinates.
`SW_OPER_MODA_SC_1B`	Swarm A S/C position from the preliminary Medium Accuracy Orbit Determination (MOD). The original SP3c records have been converted to UTC and ITRF spherical coordinates.
`SW_OPER_MODB_SC_1B`	Swarm B S/C position from the preliminary Medium Accuracy Orbit Determination (MOD). The original SP3c records have been converted to UTC and ITRF spherical coordinates.
`SW_OPER_MODC_SC_1B`	Swarm C S/C position from the preliminary Medium Accuracy Orbit Determination (MOD). The original SP3c records have been converted to UTC and ITRF spherical coordinates.

parameter / type	description
`Timestamp` `isotime`	Time stamp
`Latitude` `double`	Position in ITRF - Latitude
`Longitude` `double`	Position in ITRF - Longitude
`Radius` `double`	Position in ITRF - Radius

`SW_MAGx_LR_1B`

dataset	description
`SW_FAST_MAGA_LR_1B`	Swarm A vector (VFM) and scalar (ASM) magnetic field fast track measurements interpolated at 1Hz rate.
`SW_FAST_MAGB_LR_1B`	Swarm B vector (VFM) and scalar (ASM) magnetic field fast track measurements interpolated at 1Hz rate.
`SW_FAST_MAGC_LR_1B`	Swarm C vector (VFM) and scalar (ASM) magnetic field fast track measurements interpolated at 1Hz rate.
`SW_OPER_MAGA_LR_1B`	Swarm A vector (VFM) and scalar (ASM) magnetic field measurements interpolated at 1Hz rate.
`SW_OPER_MAGB_LR_1B`	Swarm B vector (VFM) and scalar (ASM) magnetic field measurements interpolated at 1Hz rate.
`SW_OPER_MAGC_LR_1B`	Swarm C vector (VFM) and scalar (ASM) magnetic field measurements interpolated at 1Hz rate.

parameter / type	description
`Timestamp` `isotime`	Time stamp
`Latitude` `double`	Position in ITRF - Latitude
`Longitude` `double`	Position in ITRF - Longitude
`Radius` `double`	Position in ITRF - Radius
`F` `double`	Magnetic field intensity
`dF_Sun` `double`	Magnetic stray field correction intensity of Sun ASM frame
`dF_AOCS` `double`	Magnetic stray field correction intensity of AOCS magneto-torquer coils
`dF_other` `double`	Magnetic stray field correction intensity of all other sources
`F_error` `double`	Error estimate on magnetic field intensity
`B_VFM[3]` `double`	Magnetic field vector, VFM frame
`B_NEC[3]` `double`	Magnetic field vector, NEC frame
`dB_Sun[3]` `double`	Magnetic stray field correction vector of Sun induced perturbation, VFM frame
`dB_AOCS[3]` `double`	Magnetic stray field correction vector of AOCS magneto-torquer coils, VFM frame
`dB_other[3]` `double`	Magnetic stray field correction vector of all other sources, VFM frame
`B_error[3]` `double`	Error estimates on magnetic field, VFM frame
`q_NEC_CRF[4]` `double`	Quaternion, transformation: NEC ← CRF
`Att_error` `double`	Error estimates on attitude information
`Flags_F` `integer`	Flags characterizing the magnetic field intensity measurement (F)
`Flags_B` `integer`	Flags characterizing the magnetic field measurement
`Flags_q` `integer`	Flags characterizing the attitude information
`Flags_Platform` `integer`	Flags characterizing the S/C platform information
`ASM_Freq_Dev` `double`	ASM frequency calibration data deviation
`SyncStatus` `integer`	Synchronization status
`B_NEC_Model[3]` `double`	CHAOS magnetic model
`F_Model` `double`	CHAOS magnetic model, field intensity
`F_res_Model` `double`	Magnetic field intensity, CHAOS magnetic model residual
`B_NEC_res_Model[3]` `double`	Magnetic field vector, NEC frame, CHAOS magnetic model residual

`SW_MAGx_HR_1B`

dataset	description
`SW_FAST_MAGA_HR_1B`	Swarm A vector (VFM) magnetic field fast track measurements at 50Hz rate.
`SW_FAST_MAGB_HR_1B`	Swarm B vector (VFM) magnetic field fast track measurements at 50Hz rate.
`SW_FAST_MAGC_HR_1B`	Swarm C vector (VFM) magnetic field fast track measurements at 50Hz rate.
`SW_OPER_MAGA_HR_1B`	Swarm A vector (VFM) magnetic field measurements at 50Hz rate.
`SW_OPER_MAGB_HR_1B`	Swarm B vector (VFM) magnetic field measurements at 50Hz rate.
`SW_OPER_MAGC_HR_1B`	Swarm C vector (VFM) magnetic field measurements at 50Hz rate.

parameter / type	description
`Timestamp` `isotime`	Time stamp
`Latitude` `double`	Position in ITRF – Latitude
`Longitude` `double`	Position in ITRF – Longitude
`Radius` `double`	Position in ITRF – Radius
`B_VFM[3]` `double`	Magnetic field vector, VFM frame
`B_NEC[3]` `double`	Magnetic field vector, NEC frame
`dB_Sun[3]` `double`	Magnetic stray field correction vector of Sun induced perturbation, VFM frame
`dB_AOCS[3]` `double`	Magnetic stray field correction vector of AOCS magneto-torquer coils, VFM frame
`dB_other[3]` `double`	Magnetic stray field correction vector of all other sources, VFM frame
`B_error[3]` `double`	Error estimates on magnetic field, VFM frame
`q_NEC_CRF[4]` `double`	Quaternion, transformation: NEC ← CRF
`Att_error` `double`	Error estimates on attitude information
`Flags_B` `integer`	Flags characterizing the magnetic field measurement
`Flags_q` `integer`	Flags characterizing the attitude information
`Flags_Platform` `integer`	Flags characterizing the S/C platform information
`SyncStatus` `integer`	Synchronization status

`CH_ME_MAG_LR_3`

dataset	description
`CH_ME_MAG_LR_3`	CHAMP vector (FGM) magnetic field measurements.

parameter / type	description
`Timestamp` `isotime`	Timestamp
`Latitude` `double`	Position in ITRF - Latitude
`Longitude` `double`	Position in ITRF - Longitude
`Radius` `double`	Position in ITRF - Radius
`F` `double`	scalar B-field in FGM-1 sensor system
`B_VFM[3]` `double`	B-vector in FGM-1 sensor system
`B_NEC[3]` `double`	B-vector in NEC system
`Flags_Position[3]` `integer`	status informations for positions; column 1 - number of gaps in interpolation interval; column 2 - flag for PDO used instead of RSO; column 3 - number of basePoints used for interpolation
`Flags_B[2]` `integer`	FGM Quality information; ### bits of byte 1 (8 7 6 5 4 3 2 1) ### 1 - adc (first sample anormal (1) or not (0)), ### 3,2 sample frequency, ### (00 - sample freq is 50 Hz, ### 01 - sample freq is 10 Hz, ### 10 - sample freq is 1 Hz, ### 11 - sample freq is illegal), ### 4 - torquer overlap flag (ok (0), no torquer overlap (1)), ### 5 - redundant flag, ### 6 - bad average distribution (ok (0), bad (1)), ### 7 - ovm frequenzy correction flag (), ### 8 - ovm not hk overlaped flag (ok (0), no overlap (1)), ### bits of byte 2 (8 7 6 5 4 3 2 1) ### 1 - L3 ovm interpolated flag (no (0), interpolated (1)), ### 2 - L3 fgm interpolated flag (no (0), interpolated (1)), ### 3 - L3 delta interpolated flag (no (0), interpolated (1)), ### 4 - L3 value not corrected (ok (0), no correction (1)), ### 5 - empty, ### 6 - FGM Burst mode (compression on (1), off (0)), ### 7 - L2 ovm gps error corrected (no (0), corrected (1)), ### 8 - L2 fgm gps error corrected (no (0), corrected (1))
`Flags_q` `integer`	star camera quality information 1st digit mode = 0: no data, ### 1st digit mode = 1: not available, ### 1st digit mode = 2: single data boom, chu2cr static, ### 1st digit mode = 3: not available, ### 1st digit mode = 4: not available, ### 1st digit mode = 5: not available, ### 1st digit mode = 6: single data boom + chu2cr dynamic, ### 1st digit mode = 7: dual data boom, ### 2nd digit filtered (0: no, 1: yes), ### 3rd digit chu2cr (0: static, 1: dynamic, 2: dual), ### 4th digit jump correction (0: no, 1: chu1/3, 2: chu2/4, 3: chu1/3 and chu2/4), ### 5th digit gaps interpolated (0: no, 1: chu1/3, 2: chu2/4, 3: chu1/3 and chu2/4)
`Mode_q` `integer`	star camera mode (from left to right): 1st A1 Camera 1 Boom; 2nd A2 Camera 2 Boom; 3rd B1 Camera 1 Body; 4rd B2 Camera 2 Body
`q_ICRF_CRF[4]` `double`	ASC quaternions for ICRF -> CRF transformation
`B_NEC_Model[3]` `double`	CHAOS magnetic model
`F_Model` `double`	CHAOS magnetic model, field intensity
`F_res_Model` `double`	scalar B-field in FGM-1 sensor system, CHAOS magnetic model residual
`B_NEC_res_Model[3]` `double`	B-vector in NEC system, CHAOS magnetic model residual

`CS_MAG`

dataset	description
`CS_OPER_MAG`	Cryosat-2 Platform magnetometer measurements

parameter / type	description
`Timestamp` `isotime`	Time stamp
`Latitude` `double`	Position in ITRF - Latitude
`Longitude` `double`	Position in ITRF - Longitude
`Radius` `double`	Position in ITRF - Radius
`B_FGM1[3]` `double`	calibrated magnetic vector from FGM1, in instrument frame
`B_FGM2[3]` `double`	calibrated magnetic vector from FGM2, in instrument frame
`B_FGM3[3]` `double`	calibrated magnetic vector from FGM3, in instrument frame
`B_NEC1[3]` `double`	calibrated and aligned magnetic vector from FGM1, in NEC (North, East, Center) frame
`B_NEC2[3]` `double`	calibrated and aligned magnetic vector from FGM2, in NEC (North, East, Center) frame
`B_NEC3[3]` `double`	calibrated and aligned magnetic vector from FGM3, in NEC (North, East, Center) frame
`B_NEC[3]` `double`	calibrated and aligned magnetic vector in NEC (North, East, Center) frame, 5 sample (i.e. 20 second) robust average of all 3 FGM
`F` `double`	magnetic field intensity determined from B_NEC
`B_mod_NEC[3]` `double`	CHAOS-6 model field (core, crust + magnetosphere), in NEC (North, East, Center) frame
`q_NEC_CRF[4]` `double`	Quaternion, transformation: NEC <- CRF
`q_error` `double`	experimental error indicator of attitude given in Quaternion q_NEC_CRF. Bad attitude if > approx 40
`B_NEC_Model[3]` `double`	CHAOS magnetic model
`F_Model` `double`	CHAOS magnetic model, field intensity
`F_res_Model` `double`	magnetic field intensity determined from B_NEC, CHAOS magnetic model residual
`B_NEC_res_Model[3]` `double`	calibrated and aligned magnetic vector in NEC (North, East, Center) frame, 5 sample (i.e. 20 second) robust average of all 3 FGM, CHAOS magnetic model residual
`B_NEC1_res_Model[3]` `double`	calibrated and aligned magnetic vector from FGM1, in NEC (North, East, Center) frame, CHAOS magnetic model residual
`B_NEC2_res_Model[3]` `double`	calibrated and aligned magnetic vector from FGM2, in NEC (North, East, Center) frame, CHAOS magnetic model residual
`B_NEC3_res_Model[3]` `double`	calibrated and aligned magnetic vector from FGM3, in NEC (North, East, Center) frame, CHAOS magnetic model residual

`GRACE_x_MAG`

dataset	description
`GRACE_A_MAG`	GRACE 1 platform magnetometer measurements
`GRACE_B_MAG`	GRACE 2 platform magnetometer measurements

parameter / type	description
`Timestamp` `isotime`	Time stamp
`Latitude` `double`	Position in ITRF - Latitude
`Longitude` `double`	Position in ITRF - Longitude
`Radius` `double`	Position in ITRF - Radius
`B_FGM[3]` `double`	calibrated magnetic vector from FGM, in instrument frame
`B_NEC_raw[3]` `double`	calibrated and aligned magnetic vector in NEC (North, East, Center) frame
`B_NEC[3]` `double`	calibrated and aligned magnetic vector in NEC (North, East, Center) frame, 11 sample (i.e. 11 second) robust average
`F` `double`	magnetic field intensity determined from B_NEC
`q_NEC_CRF[4]` `double`	Quaternion, transformation: NEC <- CRF
`q_error` `double`	experimental error indicator of attitude given in Quaternion q_NEC_CRF. Bad attitude if > approx 40
`B_NEC_Model[3]` `double`	CHAOS magnetic model
`F_Model` `double`	CHAOS magnetic model, field intensity
`F_res_Model` `double`	magnetic field intensity determined from B_NEC, CHAOS magnetic model residual
`B_NEC_res_Model[3]` `double`	calibrated and aligned magnetic vector in NEC (North, East, Center) frame, 11 sample (i.e. 11 second) robust average, CHAOS magnetic model residual

`GFx_FGM_ACAL`

dataset	description
`GF1_OPER_FGM_ACAL_CORR`	GRACE-FO 1 platform magnetometer measurements
`GF2_OPER_FGM_ACAL_CORR`	GRACE-FO 2 platform magnetometer measurements

parameter / type	description
`Timestamp` `isotime`	Time stamp
`Latitude` `double`	Position in ITRF - Latitude
`Longitude` `double`	Position in ITRF - Longitude
`Radius` `double`	Position in ITRF - Radius
`B_FGM[3]` `double`	Fluxgate magnetometer, FGM, aligned, vector-vector calibrated and corrected for satellite disturbances, FGM frame
`B_NEC[3]` `double`	Fluxgate magnetometer, FGM, aligned, vector-vector calibrated and corrected for satellite disturbances, NEC frame
`q_NEC_FGM[4]` `double`	Quaternion, transformation: NEC ... FGM
`dB_MTQ_FGM[3]` `double`	Disturbance field related to magnetorquer, FGM frame
`dB_XI_FGM[3]` `double`	Disturbance field related to 2nd order non-linearities, FGM frame
`dB_NY_FGM[3]` `double`	Disturbance field related to 3rd order non-linearities, FGM frame
`dB_BT_FGM[3]` `double`	Disturbance field related to temperature dependency of offsets, FGM frame
`dB_ST_FGM[3]` `double`	Disturbance field related to temperature dependency of scale factors, FGM frame
`dB_SA_FGM[3]` `double`	Disturbance field related to solar array currents, FGM frame
`dB_BAT_FGM[3]` `double`	Disturbance field related to battery currents, FGM frame
`B_FLAG` `integer`	Flags
`F` `double`	Magnetic field intensity calculated from B_NEC
`B_NEC_Model[3]` `double`	CHAOS magnetic model
`F_Model` `double`	CHAOS magnetic model, field intensity
`F_res_Model` `double`	Magnetic field intensity calculated from B_NEC, CHAOS magnetic model residual
`B_NEC_res_Model[3]` `double`	Fluxgate magnetometer, FGM, aligned, vector-vector calibrated and corrected for satellite disturbances, NEC frame, CHAOS magnetic model residual

`GFx_MAG_ACAL_ML`

dataset	description
`GF1_MAG_ACAL_CORR_ML`	GRACE-FO 1 platform magnetometer measurements (ML calibrated)
`GF2_MAG_ACAL_CORR_ML`	GRACE-FO 2 platform magnetometer measurements (ML calibrated)

parameter / type	description
`Timestamp` `isotime`	Time stamp
`Latitude` `double`	Position in ITRF - Latitude
`Longitude` `double`	Position in ITRF - Longitude
`Radius` `double`	Position in ITRF - Radius
`Latitude_QD` `double`	Quasi-dipole latitude
`Longitude_QD` `double`	Quasi-dipole longitude
`B_MAG[3]` `double`	Fluxgate magnetometer, FGM, aligned, vector-vector calibrated and corrected for satellite disturbances, FGM frame
`B_NEC[3]` `double`	Fluxgate magnetometer, FGM, aligned, vector-vector calibrated and corrected for satellite disturbances, NEC frame
`q_NEC_FGM[4]` `double`	Quaternion, transformation: NEC ... FGM
`B_FLAG` `integer`	Flag for FGM (Bit field:0: MTQ1 positive saturated,1: MTQ1 negative saturated,2: MTQ2 positive saturated,3: MTQ2 negative saturated,4: MTQ3 positive saturated,5: MTQ3 negative saturated)
`KP_DST_FLAG` `integer`	Flag for filtered values using KP and Dst indices (0: Geomagnetic quiet,1: Geomagnetic active: KP > 2 or \|Dst\| > 30)
`F` `double`	Magnetic field intensity calculated from B_NEC
`B_NEC_Model[3]` `double`	CHAOS magnetic model
`F_Model` `double`	CHAOS magnetic model, field intensity
`F_res_Model` `double`	Magnetic field intensity calculated from B_NEC, CHAOS magnetic model residual
`B_NEC_res_Model[3]` `double`	Fluxgate magnetometer, FGM, aligned, vector-vector calibrated and corrected for satellite disturbances, NEC frame, CHAOS magnetic model residual

`GO_MAG_ACAL`

dataset	description
`GO_MAG_ACAL_CORR`	GOCE platform magnetometer measurements

parameter / type	description
`Timestamp` `isotime`	Time stamp
`Latitude` `double`	Position in ITRF - Latitude
`Longitude` `double`	Position in ITRF - Longitude
`Radius` `double`	Position in ITRF - Radius
`B_MAG[3]` `double`	Fluxgate magnetometer, combined MAG, aligned, vector-vector calibrated and corrected for satellite disturbances, SC frame
`B_NEC[3]` `double`	Fluxgate magnetometer, combined MAG, aligned, vector-vector calibrated and corrected for satellite disturbances, NEC frame
`q_SC_NEC[4]` `double`	Quaternion, transformation: SC ... NEC
`q_MAG_SC[4]` `double`	Quaternion, transformation: MAG ... SC
`dB_MTQ_SC[3]` `double`	Disturbance field related to magnetorquer, SC frame
`dB_XI_SC[3]` `double`	Disturbance field related to 2nd order non-linearities, SC frame
`dB_NY_SC[3]` `double`	Disturbance field related to 3rd order non-linearities, SC frame
`dB_BT_SC[3]` `double`	Disturbance field related to temperature dependency of offsets, SC frame
`dB_ST_SC[3]` `double`	Disturbance field related to temperature dependency of scale factors, SC frame
`dB_SA_SC[3]` `double`	Disturbance field related to solar array currents, SC frame
`dB_BAT_SC[3]` `double`	Disturbance field related to battery currents, SC frame
`dB_HK_SC[3]` `double`	Disturbance field related to housekeeping data, SC frame
`dB_BLOCK_CORR[6]` `double`	Block correction for MAG2 and MAG3, MAG frame
`B_FLAG` `integer`	Flags
`F` `double`	Magnetic field intensity calculated from B_NEC
`B_NEC_Model[3]` `double`	CHAOS magnetic model
`F_Model` `double`	CHAOS magnetic model, field intensity
`F_res_Model` `double`	Magnetic field intensity calculated from B_NEC, CHAOS magnetic model residual
`B_NEC_res_Model[3]` `double`	Fluxgate magnetometer, combined MAG, aligned, vector-vector calibrated and corrected for satellite disturbances, NEC frame, CHAOS magnetic model residual

`GO_MAG_ACAL_ML`

dataset	description
`GO_MAG_ACAL_CORR_ML`	GOCE platform magnetometer measurements (ML calibrated)

parameter / type	description
`Timestamp` `isotime`	Time stamp
`Latitude` `double`	Position in ITRF - Latitude
`Longitude` `double`	Position in ITRF - Longitude
`Radius` `double`	Position in ITRF - Radius
`Latitude_QD` `double`	Quasi-dipole latitude
`Longitude_QD` `double`	Quasi-dipole longitude
`B_MAG[3]` `double`	Fluxgate magnetometer, combined MAG, aligned, vector-vector calibrated and corrected for satellite disturbances, SC frame
`B_NEC[3]` `double`	Fluxgate magnetometer, combined MAG, aligned, vector-vector calibrated and corrected for satellite disturbances, NEC frame
`q_FGM_NEC[4]` `double`	Quaternion, transformation: combined FGM ... NEC
`B_FLAG` `integer`	Flag for combined FGM (Bit field:0: Data correct,1: Outlier detected,2: FGM interpolation corrupted)
`MAGNETIC_ACTIVITY_FLAG` `integer`	Flag for filtered values using Hp30 and Dst indices (0: Geomagnetic quiet,1: Geomagnetic active: Hp30 > 2 or \|Dst\| > 30)
`NaN_FLAG` `integer`	Flag for filled NaN values with column mean value (0: Data complete,1: NaN values filled
`F` `double`	Magnetic field intensity calculated from B_NEC
`B_NEC_Model[3]` `double`	CHAOS magnetic model
`F_Model` `double`	CHAOS magnetic model, field intensity
`F_res_Model` `double`	Magnetic field intensity calculated from B_NEC, CHAOS magnetic model residual
`B_NEC_res_Model[3]` `double`	Fluxgate magnetometer, combined MAG, aligned, vector-vector calibrated and corrected for satellite disturbances, NEC frame, CHAOS magnetic model residual

`SW_EFIx_LP_1B`

dataset	description
`SW_FAST_EFIA_LP_1B`	Swarm A plasma fast track data from the Langmuir Probe (LP) at 2Hz rate
`SW_FAST_EFIB_LP_1B`	Swarm B plasma fast track data from the Langmuir Probe (LP) at 2Hz rate
`SW_FAST_EFIC_LP_1B`	Swarm C plasma fast track data from the Langmuir Probe (LP) at 2Hz rate
`SW_OPER_EFIA_LP_1B`	Swarm A plasma data from the Langmuir Probe (LP) at 2Hz rate
`SW_OPER_EFIB_LP_1B`	Swarm B plasma data from the Langmuir Probe (LP) at 2Hz rate
`SW_OPER_EFIC_LP_1B`	Swarm C plasma data from the Langmuir Probe (LP) at 2Hz rate

parameter / type	description
`Timestamp` `isotime`	Time stamp
`Latitude` `double`	Position in ITRF – Latitude
`Longitude` `double`	Position in ITRF – Longitude
`Radius` `double`	Position in ITRF – Radius
`U_orbit` `double`	Spacecraft velocity in the ITRF
`Ne` `double`	Plasma density (electron)
`Ne_error` `double`	Error estimate of plasma density (Ne)
`Te` `double`	Plasma electron temperature
`Te_error` `double`	Error estimate of plasma electron temperature (Te)
`Vs` `double`	Spacecraft potential
`Vs_error` `double`	Error estimate of spacecraft potential (U_pol)
`Flags_LP` `integer`	Flags indicating the source/method of LP measurements (ne, Te, Vs)
`Flags_Ne` `integer`	Flags characterizing the plasma density measurement
`Flags_Te` `integer`	Flags characterizing the electron temperature measurement
`Flags_Vs` `integer`	Flags characterizing the spacecraft potential measurement
`SyncStatus` `integer`	Synchronization status

`SW_EFIxIDM_2_`

dataset	description
`SW_PREL_EFIAIDM_2_`	Swarm A LP ion drift, density and effective mass data
`SW_PREL_EFIBIDM_2_`	Swarm B LP ion drift, density and effective mass data
`SW_PREL_EFICIDM_2_`	Swarm C LP ion drift, density and effective mass data

parameter / type	description
`Timestamp` `isotime`	Time of observation
`Latitude_GD` `double`	WGS84 geodetic latitude
`Longitude_GD` `double`	WGS84 geodetic longitude
`Height_GD` `double`	Height above WGS84 reference ellipsoid
`Radius_GC` `double`	Geocentric radius
`Latitude_QD` `double`	Quasi-dipole latitude
`MLT_QD` `double`	Magnetic local time
`V_sat_nec[3]` `double`	Satellite velocity in north, east, centre (NEC) reference frame.
`M_i_eff` `double`	Ion effective mass.
`M_i_eff_err` `double`	Ion effective mass uncertainty.
`M_i_eff_Flags` `integer`	Ion effective mass validity flag.
`M_i_eff_tbt_model` `double`	Ion effective mass from Truhlik et al. (2015) topside empirical model.
`V_i` `double`	Ion along-track drift.
`V_i_err` `double`	Ion along-track drift uncertainty.
`V_i_Flags` `integer`	Ion along-track drift validity flag.
`V_i_raw` `double`	Ion along-track drift without high-latitude detrending.
`N_i` `double`	Ion density.
`N_i_err` `double`	Ion density unertainty.
`N_i_Flags` `integer`	Ion density validity flag.
`A_fp` `double`	Modified-OML EFI faceplate area.
`R_p` `double`	Modified-OML Langmuir spherical probe radius.
`T_e` `double`	Electron temperature.
`Phi_sc` `double`	Spacecraft floating potential with respect to plasma potential far from satellite.

`SW_EFIxTIE_2_`

dataset	description
`SW_OPER_EFIATIE_2_`	Swarm A Thermal Ion Imager (TII) ion temperatures estimate
`SW_OPER_EFIBTIE_2_`	Swarm B Thermal Ion Imager (TII) ion temperatures estimate
`SW_OPER_EFICTIE_2_`	Swarm C Thermal Ion Imager (TII) ion temperatures estimate

parameter / type	description
`Timestamp` `isotime`	Time of observation
`Latitude_GD` `double`	WGS84 geodetic latitude
`Longitude_GD` `double`	WGS84 geodetic longitude
`Height_GD` `double`	Height above WGS84 reference ellipsoid
`Radius_GC` `double`	Geocentric radius
`Latitude_QD` `double`	Quasi-dipole latitude
`MLT_QD` `double`	Magnetic local time
`Tn_msis` `double`	Neutral temperature from NRLMSISE00 model
`Te_adj_LP` `double`	Corrected Swarm LP electron temperature
`Ti_meas_drift` `double`	Ion temperature estimated using Swarm TII drift at high latitudes
`Ti_model_drift` `double`	Ion temperature estimated using Weimer 2005 model drifts at high latitude
`Flag_ti_meas` `integer`	Flags characterising TII-based Ti: Bit0 = 1/0: high-latitude frictional heating included/omitted, Bit1=1/0: electron temperature from low/high-gain probe, Bit2=1/0: ion temperature data available/data value is set to NaN
`Flag_ti_model` `integer`	Flags characterising model-based Ti: Bit0 = 1/0: high-latitude frictional heating included/omitted, Bit1=1/0: electron temperature from low/high-gain probe, Bit2=1/0: ion temperature data available/data value is set to NaN

`SW_EFIx_TCTyy`

dataset	description
`SW_EXPT_EFIA_TCT02`	Swarm A Thermal Ion Imager (TII) cross track flow at 2Hz
`SW_EXPT_EFIA_TCT16`	Swarm A Thermal Ion Imager (TII) cross track flow at 16Hz
`SW_EXPT_EFIB_TCT02`	Swarm B Thermal Ion Imager (TII) cross track flow at 2Hz
`SW_EXPT_EFIB_TCT16`	Swarm B Thermal Ion Imager (TII) cross track flow at 16Hz
`SW_EXPT_EFIC_TCT02`	Swarm C Thermal Ion Imager (TII) cross track flow at 2Hz
`SW_EXPT_EFIC_TCT16`	Swarm C Thermal Ion Imager (TII) cross track flow at 16Hz

parameter / type	description
`Timestamp` `isotime`	Time stamp
`Latitude` `double`	Position in ITRF – Latitude
`Longitude` `double`	Position in ITRF – Longitude
`Radius` `double`	Position in ITRF – Radius
`Latitude_QD` `double`	Quasi-dipole latitude
`MLT_QD` `double`	Magnetic local time
`Vixh` `double`	Along-track ion drift from horizontal TII sensor in satellite-track coordinates.
`Vixh_error` `double`	Random error estimate for along-track ion drift from horizontal TII sensor in satellite-track coordinates. Negative value indicates no estimate available.
`Vixv` `double`	Along-track ion drift from vertical TII sensor in satellite-track coordinates.
`Vixv_error` `double`	Random error estimate for along-track ion drift from vertical TII sensor in satellite-track coordinates. Negative value indicates no estimate available.
`Viy` `double`	Cross-track horizontal ion drift from horizontal TII sensor in satellite-track coordinates.
`Viy_error` `double`	Random error estimate for cross-track horizontal ion drift from horizontal TII sensor in satellite-track coordinates. Negative value indicates no estimate available.
`Viz` `double`	Cross-track vertical ion drift from vertical TII sensor in satellite-track coordinates.
`Viz_error` `double`	Random error estimate for cross-track vertical ion drift from vertical TII sensor in satellite-track coordinates. Negative value indicates no estimate available.
`VsatN` `double`	Satellite velocity N component in north-east-centre coordinates.
`VsatE` `double`	Satellite velocity E component in north-east-centre coordinates.
`VsatC` `double`	Satellite velocity C component in north-east-centre coordinates.
`Ehx` `double`	Electric field x component in satellite-track coordinates, derived from -VxB with along-track ion drift from horizontal sensor.
`Ehy` `double`	Electric field y component in satellite-track coordinates, derived from -VxB with along-track ion drift from horizontal sensor.
`Ehz` `double`	Electric field z component in satellite-track coordinates, derived from -VxB with along-track ion drift from horizontal sensor.
`Evx` `double`	Electric field x component in satellite-track coordinates, derived from -VxB with along-track ion drift from vertical sensor.
`Evy` `double`	Electric field y component in satellite-track coordinates, derived from -VxB with along-track ion drift from vertical sensor.
`Evz` `double`	Electric field z component in satellite-track coordinates, derived from -VxB with along-track ion drift from vertical sensor.
`Bx` `double`	Geomagnetic field x component in satellite-track coordinates, derived from the 1 Hz product.
`By` `double`	Geomagnetic field y component in satellite-track coordinates, derived from the 1 Hz product.
`Bz` `double`	Geomagnetic field z component in satellite-track coordinates, derived from the 1 Hz product.
`Vicrx` `double`	Ion drift corotation signal x component in satellite-track coordinates. This has been removed from ion drift and electric field.
`Vicry` `double`	Ion drift corotation signal y component in satellite-track coordinates. This has been removed from ion drift and electric field.
`Vicrz` `double`	Ion drift corotation signal z component in satellite-track coordinates. This has been removed from ion drift and electric field.
`Quality_flags` `integer`	Bitwise flag for each velocity component, where a value of 1 for a particular component signifies that calibration was successful, and that the baseline 1-sigma noise level is less than or equal to 100 m/s at 2 Hz. Electric field quality can be assessed from these flags according to -vxB. Bit0 (least significant) = Vixh, bit1 = Vixv, bit2 = Viy, bit3 = Viz. Refer to the release notes for details.
`Calibration_flags` `integer`	Information about the calibration process. Refer to the release notes for details.

`SW_EEFxTMS_2F`

dataset	description
`SW_OPER_EEFATMS_2F`	Swarm A dayside equatorial electric field
`SW_OPER_EEFBTMS_2F`	Swarm B dayside equatorial electric field
`SW_OPER_EEFCTMS_2F`	Swarm C dayside equatorial electric field

parameter / type	description
`Timestamp` `isotime`	Time of satellite crossing of the magnetic equator, UTC
`Longitude` `double`	Geographic longitude of satellite crossing of the magnetic equator
`Latitude` `double`	Geographic latitude of satellite crossing of the magnetic equator
`EEF` `double`	Estimate of the equatorial electric field
`EEJ[81]` `double`	Height-integrated east current profile in QD latitude, spanning [-20:0.5:20] degrees
`RelErr` `double`	Quality indicator of EEF estimate; relative error between modeled and observed current profile
`Flags` `integer`	Flags describing data gaps and satellite identification

`SW_IBIxTMS_2F`

dataset	description
`SW_OPER_IBIATMS_2F`	Swarm A ionospheric bubble index
`SW_OPER_IBIBTMS_2F`	Swarm B ionospheric bubble index
`SW_OPER_IBICTMS_2F`	Swarm C ionospheric bubble index

parameter / type	description
`Timestamp` `isotime`	Time stamp in UTC
`Latitude` `double`	Geographic latitude
`Longitude` `double`	Geographic longitude
`Radius` `double`	Geographic radius
`Bubble_Index` `integer`	Plasma Bubble Index
`Bubble_Probability` `double`	Detection probability of the plasma bubble
`Flags_Bubble` `integer`	Flags related to the plasma bubble index
`Flags_F` `integer`	Flags_F passed through from MAGx_L1_B
`Flags_B` `integer`	Flags_B passed through from MAGx_L1_B
`Flags_q` `integer`	Flags_q passed through from MAGx_L1_B

`SW_FACxTMS_2F`

dataset	description
`SW_FAST_FACATMS_2F`	Swarm A fast track field-aligned and radial current densities using the single satellite measurements
`SW_FAST_FACBTMS_2F`	Swarm B fast track field-aligned and radial current densities using the single satellite measurements
`SW_FAST_FACCTMS_2F`	Swarm C fast track field-aligned and radial current densities using the single satellite measurements
`SW_OPER_FACATMS_2F`	Swarm A field-aligned and radial current densities using the single satellite measurements
`SW_OPER_FACBTMS_2F`	Swarm B field-aligned and radial current densities using the single satellite measurements
`SW_OPER_FACCTMS_2F`	Swarm C field-aligned and radial current densities using the single satellite measurements
`SW_OPER_FAC_TMS_2F`	Swarm field-aligned and radial current densities using the dual-satellite method

parameter / type	description
`Timestamp` `isotime`	Time, UTC
`Latitude` `double`	Position in ITRF, Latitude
`Longitude` `double`	Position in ITRF, Longitude
`Radius` `double`	Position in ITRF, Radius
`IRC` `double`	Ionospheric radial current (IRC)
`IRC_Error` `double`	uncertainty of IRC
`FAC` `double`	Field-aligned current (FAC)
`FAC_Error` `double`	uncertainty of FAC
`Flags` `integer`	Flags characterizing the product quality (processing flags)
`Flags_F` `integer`	Flags_F passed through from L1b and accumulated for quad points
`Flags_B` `integer`	Flags_B passed through from L1b and accumulated for quad points
`Flags_q` `integer`	Flags_q passed through from L1b and accumulated for quad points

`SW_TECxTMS_2F`

dataset	description
`SW_OPER_TECATMS_2F`	Swarm A ionospheric total electron content
`SW_OPER_TECBTMS_2F`	Swarm B ionospheric total electron content
`SW_OPER_TECCTMS_2F`	Swarm C ionospheric total electron content

parameter / type	description
`Timestamp` `isotime`	Time stamp in UTC
`Latitude` `double`	Geographic latitude
`Longitude` `double`	Geographic longitude
`Radius` `double`	Geographic radius
`GPS_Position[3]` `double`	X-,Y-,Z-coordinates (WGS84) of the GPS satellite
`LEO_Position[3]` `double`	X-,Y-,Z-coordinates (WGS84) of the LEO satellite
`PRN` `integer`	GPS satellite PRN
`L1` `double`	GPS L1 carrier phase observation
`L2` `double`	GPS L2 carrier phase observation
`P1` `double`	GPS P1 code phase observation
`P2` `double`	GPS P2 code phase observation
`S1` `double`	GPS signal-to-noise ratio or raw signal strength on L1
`S2` `double`	GPS signal-to-noise ratio or raw signal strength on L2
`Absolute_STEC` `double`	Absolute slant TEC
`Absolute_VTEC` `double`	Absolute vertical TEC
`Elevation_Angle` `double`	Elevation Angle
`Relative_STEC` `double`	Relative slant TEC
`Relative_STEC_RMS` `double`	Root mean square error of relative slant TEC
`DCB` `double`	GPS receiver differential code bias
`DCB_Error` `double`	Error of the GPS receiver differential code bias

`SW_IPDxIRR_2F`

dataset	description
`SW_OPER_IPDAIRR_2F`	Swarm A characteristics of the plasma density and plasma irregularities
`SW_OPER_IPDBIRR_2F`	Swarm B characteristics of the plasma density and plasma irregularities
`SW_OPER_IPDCIRR_2F`	Swarm C characteristics of the plasma density and plasma irregularities

parameter / type	description
`Timestamp` `isotime`	CDF_EPOCH of the measurement.
`Latitude` `double`	Position in ITRF - Latitude.
`Longitude` `double`	Position in ITRF - Longitude.
`Radius` `double`	Position in ITRF - Radius.
`Ne` `double`	Plasma density, directly copied from the Langmuir probe files.
`Background_Ne` `double`	Background density, as calculated from Ne using a percentile filter of 551 datapoints (2 Hz raw data) and 35 as the percentile.
`Foreground_Ne` `double`	Foreground density, as calculated from ndens using a percentile filter of 7 datapoints (2 Hz raw data) and 50 as the percentile.
`Te` `double`	Electron temperature, directly copied from the Langmuir probe files.
`PCP_flag` `integer`	The polar cap patch flag: 0 if the plasma density measurement occurred OUTSIDE a polar cap patch. 1 if the plasma density measurement occurred at one of the edges of a polar cap patch (no plasma velocity measurements are available). 2 if the plasma density measurement occurred at the LEADING edge of a polar cap patch. 3 if the plasma density measurement occurred at the TRAILING edge of a polar cap patch. 4 if the plasma density measurement occurred INSIDE a polar cap patch proper. When no ion drift data is available, the leading and trailing edges cannot be distinguished. In this case the polar cap patch flag is set to 4 throughout the patch proper and to 1 throughout both edges.
`Grad_Ne_at_100km` `double`	The electron density gradient in a running window calculated via linear regression over 27 data points for the 2 Hz electron density data.
`Grad_Ne_at_50km` `double`	The electron density gradient in a running window calculated via linear regression over 13 data points for the 2 Hz electron density data.
`Grad_Ne_at_20km` `double`	The electron density gradient in a running window calculated via linear regression over 5 data points for the 2 Hz electron density data.
`Grad_Ne_at_PCP_edge` `double`	The linear electron density gradient calculated over the edges of a patch. This variable is non-zero only at the edges of polar cap patches.
`ROD` `double`	Rate Of change of Density
`RODI10s` `double`	Rate Of change of Density Index (RODI) is the standard deviation of ROD over 10 seconds.
`RODI20s` `double`	Rate Of change of Density Index (RODI) is the standard deviation of ROD over 20 seconds.
`delta_Ne10s` `double`	Derived by subtracting Ne by its median filtered value in 10 seconds. As a result, delta_Ne10s indicates the electron density fluctuations smaller than 75 km.
`delta_Ne20s` `double`	Derived by subtracting Ne by its median filtered value in 20 seconds. As a result, delta_Ne20s indicates the electron density fluctuations smaller than 150 km.
`delta_Ne40s` `double`	Derived by subtracting Ne by its median filtered value in 40 seconds. As a result, delta_Ne40s indicates the electron density fluctuations smaller than 300 km.
`Num_GPS_satellites` `integer`	Total number of tracked GPS satellites above 20 degrees.
`mVTEC` `double`	Median of VTEC from all available GPS satellites above 30 degrees.
`mROT` `double`	Median of Rate Of change of TEC (ROT) from all available GPS satellites above 30 degrees.
`mROTI10s` `double`	Median of Rate Of change of TEC Index (ROTI) from all available GPS satellites above 30 degrees. The ROTI of each satellite is the standard deviation of ROT over 10 seconds.
`mROTI20s` `double`	Median of Rate Of change of TEC Index (ROTI) from all available GPS satellites above 30 degrees. The ROTI of each satellite is the standard deviation of ROT over 20 seconds.
`IBI_flag` `integer`	Plasma Bubble Index, copied from the level-2 Ionospheric Bubble Index product, IBIxTMS_2F.
`Ionosphere_region_flag` `integer`	0: equator, 1: mid-latitudes; 2: auroral oval; 3: polar cap.
`IPIR_index` `integer`	The numeric index for plasma fluctuations and irregularities: 0-3 low, 4-5 medium, and > 6 high level of ionosphericplasma irregularities.
`Ne_quality_flag` `integer`	Quality flag for the Ne data and the derived data from Ne, e.g., background density, foreground density etc.
`TEC_STD` `double`	STD of VTEC from all GPS satellites.

`SW_AEJxLPL_2F`

dataset	description
`SW_OPER_AEJALPL_2F`	Swarm A ionospheric sheet current densities determined by the Line Current (LC) method
`SW_OPER_AEJBLPL_2F`	Swarm B ionospheric sheet current densities determined by the Line Current (LC) method
`SW_OPER_AEJCLPL_2F`	Swarm C ionospheric sheet current densities determined by the Line Current (LC) method

parameter / type	description
`Timestamp` `isotime`	Time of observation, UTC
`Latitude` `double`	Position in ITRF - Geocentric latitude
`Longitude` `double`	Position in ITRF - Geocentric longitude
`Latitude_QD` `double`	Quasi-dipole latitude
`Longitude_QD` `double`	Quasi-dipole longitude
`MLT_QD` `double`	Magnetic local time (QD)
`J_NE[2]` `double`	North and East component of horizontal sheet current density vector in geocentric frame
`J_QD` `double`	East component of horizontal sheet current density in QD frame

`SW_AEJxLPL_2F:Quality`

dataset	description
`SW_OPER_AEJALPL_2F:Quality`	Swarm A ionospheric sheet current densities determined by the Line Current (LC) method
`SW_OPER_AEJBLPL_2F:Quality`	Swarm B ionospheric sheet current densities determined by the Line Current (LC) method
`SW_OPER_AEJCLPL_2F:Quality`	Swarm C ionospheric sheet current densities determined by the Line Current (LC) method

parameter / type	description
`Timestamp` `isotime`	Time instants of quality information (RMS_misfit and Confidence), UTC
`RMS_misfit` `double`	Root Mean Square error misfit between observations and model values for the oval crossings
`Confidence` `double`	Goodness of fit computed as 1 - (residual rms / signal rms) for the oval crossings

`SW_AEJxPBL_2F`

dataset	description
`SW_OPER_AEJAPBL_2F`	Swarm A ionospheric auroral electrojet peaks and boundaries determined by the Line Current (LC) method
`SW_OPER_AEJBPBL_2F`	Swarm B ionospheric auroral electrojet peaks and boundaries determined by the Line Current (LC) method
`SW_OPER_AEJCPBL_2F`	Swarm C ionospheric auroral electrojet peaks and boundaries determined by the Line Current (LC) method

parameter / type	description
`Timestamp` `isotime`	Time of observation, UTC
`Latitude` `double`	Geocentric latitude in ITRF
`Longitude` `double`	Geocentric longitude in ITRF
`Latitude_QD` `double`	Quasi-dipole latitude
`Longitude_QD` `double`	Quasi-dipole longitude
`MLT_QD` `double`	Magnetic local time (QD)
`Flags` `integer`	Quality indicator
`PointType` `integer`	Point Type
`J_QD` `double`	Peak eastward sheet current intensity in QD frame

`SW_AEJxLPS_2F`

dataset	description
`SW_OPER_AEJALPS_2F`	Swarm A ionospheric sheet current densities determined by the Spherical Elementary Current Systems (SECS) method
`SW_OPER_AEJBLPS_2F`	Swarm B ionospheric sheet current densities determined by the Spherical Elementary Current Systems (SECS) method
`SW_OPER_AEJCLPS_2F`	Swarm C ionospheric sheet current densities determined by the Spherical Elementary Current Systems (SECS) method

parameter / type	description
`Timestamp` `isotime`	Time of observation, UTC
`Latitude` `double`	Position in ITRF - Geocentric latitude
`Longitude` `double`	Position in ITRF - Geocentric longitude
`Latitude_QD` `double`	Quasi-dipole latitude
`Longitude_QD` `double`	Quasi-dipole longitude
`MLT_QD` `double`	Magnetic local time (QD)
`J_CF_NE[2]` `double`	North and East component of the curl-free horizontal sheet current density vector in geocentric frame
`J_DF_NE[2]` `double`	North and East component of the divergence-free horizontal sheet current density vector in geocentric frame
`J_CF_SemiQD` `double`	North component of the curl-free horizontal sheet current density in SemiQD frame
`J_DF_SemiQD` `double`	East component of the divergence-free horizontal sheet current density in SemiQD frame
`J_R` `double`	Radial ionospheric current density at 110 km altitude in SemiQD frame

`SW_AEJxLPS_2F:Quality`

dataset	description
`SW_OPER_AEJALPS_2F:Quality`	Swarm A ionospheric sheet current densities determined by the Spherical Elementary Current Systems (SECS) method
`SW_OPER_AEJBLPS_2F:Quality`	Swarm B ionospheric sheet current densities determined by the Spherical Elementary Current Systems (SECS) method
`SW_OPER_AEJCLPS_2F:Quality`	Swarm C ionospheric sheet current densities determined by the Spherical Elementary Current Systems (SECS) method

parameter / type	description
`Timestamp` `isotime`	Time instants of quality information (RMS_misfit and Confidence), UTC
`RMS_misfit` `double`	Root Mean Square error misfit between observations and model values for the oval crossing
`Confidence` `double`	Goodness of fit computed as 1 - (residual rms / signal rms) for the oval crossing

`SW_AEJxPBS_2F`

dataset	description
`SW_OPER_AEJAPBS_2F`	Swarm A ionospheric auroral electrojet peaks and boundaries determined by the Spherical Elementary Current Systems (SECS) method
`SW_OPER_AEJBPBS_2F`	Swarm B ionospheric auroral electrojet peaks and boundaries determined by the Spherical Elementary Current Systems (SECS) method
`SW_OPER_AEJCPBS_2F`	Swarm C ionospheric auroral electrojet peaks and boundaries determined by the Spherical Elementary Current Systems (SECS) method

parameter / type	description
`Timestamp` `isotime`	Time of observation, UTC
`Latitude` `double`	Geocentric latitude in ITRF
`Longitude` `double`	Geocentric longitude in ITRF
`Latitude_QD` `double`	Quasi-dipole latitude
`Longitude_QD` `double`	Quasi-dipole longitude
`MLT_QD` `double`	Magnetic local time (QD)
`Flags` `integer`	Quality indicator
`PointType` `integer`	Point Type
`J_DF_SemiQD` `double`	Peak divergence-free sheet current density in SemiQD frame

`SW_AEJxPBS_2F:GroundMagneticDisturbance`

dataset	description
`SW_OPER_AEJAPBS_2F:GroundMagneticDisturbance`	Swarm A ionospheric auroral electrojet peaks and boundaries determined by the Spherical Elementary Current Systems (SECS) method
`SW_OPER_AEJBPBS_2F:GroundMagneticDisturbance`	Swarm B ionospheric auroral electrojet peaks and boundaries determined by the Spherical Elementary Current Systems (SECS) method
`SW_OPER_AEJCPBS_2F:GroundMagneticDisturbance`	Swarm C ionospheric auroral electrojet peaks and boundaries determined by the Spherical Elementary Current Systems (SECS) method

parameter / type	description
`Timestamp` `isotime`	Time of peaks in ground magnetic field disturbance
`Latitude` `double`	Geodetic latitude of peaks in ground magnetic field disturbance
`Longitude` `double`	Geodetic longitude of peaks in ground magnetic field disturbance
`B_NE[2]` `double`	Peak value of the ground magnetic field disturbance, geodetic NE frame

`SW_AOBxFAC_2F`

dataset	description
`SW_OPER_AOBAFAC_2F`	Swarm A aurora oval boundaries determined from the Field Aligned Current (FAC) data
`SW_OPER_AOBBFAC_2F`	Swarm B aurora oval boundaries determined from the Field Aligned Current (FAC) data
`SW_OPER_AOBCFAC_2F`	Swarm C aurora oval boundaries determined from the Field Aligned Current (FAC) data

parameter / type	description
`Timestamp` `isotime`	Time of observation, UTC
`Latitude` `double`	Position in ITRF - Geocentric latitude
`Longitude` `double`	Position in ITRF - Geocentric longitude
`Radius` `double`	Position in ITRF - Geocentric radius (from the Earth center)
`Latitude_QD` `double`	Quasi-dipole latitude
`Longitude_QD` `double`	Quasi-dipole longitude
`MLT_QD` `double`	Magnetic Local Time (QD)
`Boundary_Flag` `integer`	Indicator for equatorward (=1) or poleward (=2) boundary
`Quality[2]` `double`	Quality indicator of equatorward/poleward boundary (Pa, Sigma)
`Pair_Indicator` `integer`	Indicator of equatorward/poleward boundary of auroral oval. If the auroral oval boundaries are detectable as one pair, the pair indicator represents the record of previous (-1) or next (1) equatorward/poleward boundary within one pair; otherwise, the pair indicator is set to 0

`SW_MITx_LP_2F`

dataset	description
`SW_OPER_MITA_LP_2F`	Swarm A mid-latitude ionospheric trough boundaries and minima from from Langmuir Probe (LP) data
`SW_OPER_MITB_LP_2F`	Swarm B mid-latitude ionospheric trough boundaries and minima from from Langmuir Probe (LP) data
`SW_OPER_MITC_LP_2F`	Swarm C mid-latitude ionospheric trough boundaries and minima from from Langmuir Probe (LP) data

parameter / type	description
`Timestamp` `isotime`	Time of observation, UTC
`Counter[2]` `integer`	Swarm orbit counter and quarter orbit (four per Swarm orbit) counter
`Latitude` `double`	Geocentric latitude in ITRF
`Longitude` `double`	Geocentric longitude in ITRF
`Radius` `double`	Geocentric radius in ITRF
`Latitude_QD` `double`	Quasi-dipole latitude
`Longitude_QD` `double`	Quasi-dipole longitude
`MLT_QD` `double`	Magnetic local time (QD)
`L_value` `double`	L-value
`SZA` `double`	Solar zenith angle
`Ne` `double`	LP electron density
`Te` `double`	LP electron temperature
`Depth` `double`	Depth of the MIT
`DR` `double`	Relative change in density within the MIT
`Width` `double`	Width of the MIT calculated from QD latitudes
`dL` `double`	Width of the MIT calculated from L-values
`PW_Gradient` `double`	Change in log electron density at the poleward wall of the MIT divided by QD latitude difference
`EW_Gradient` `double`	Change in log electron density at the equatorward wall of the MIT divided by QD latitude difference
`Quality[8]` `integer`	Characterizes the detection quality of the MIT as a whole

`SW_MITx_LP_2F:ID`

dataset	description
`SW_OPER_MITA_LP_2F:ID`	Swarm A mid-latitude ionospheric trough boundaries and minima from from Langmuir Probe (LP) data
`SW_OPER_MITB_LP_2F:ID`	Swarm B mid-latitude ionospheric trough boundaries and minima from from Langmuir Probe (LP) data
`SW_OPER_MITC_LP_2F:ID`	Swarm C mid-latitude ionospheric trough boundaries and minima from from Langmuir Probe (LP) data

parameter / type	description
`Timestamp` `isotime`	Time of observation, UTC
`Counter[2]` `integer`	Swarm orbit counter and quarter orbit (four per Swarm orbit) counter
`Latitude` `double`	Geocentric latitude in ITRF
`Longitude` `double`	Geocentric longitude in ITRF
`Radius` `double`	Geocentric radius in ITRF
`Latitude_QD` `double`	Quasi-dipole latitude
`Longitude_QD` `double`	Quasi-dipole longitude
`MLT_QD` `double`	Magnetic local time (QD)
`L_value` `double`	L-value
`SZA` `double`	Solar zenith angle
`Ne` `double`	LP electron density
`Te` `double`	LP electron temperature
`Position_Quality` `integer`	Indicator characterizing the detection quality of the position
`PointType` `integer`	Point Type

`SW_MITxTEC_2F`

dataset	description
`SW_OPER_MITATEC_2F`	Swarm A mid-latitude ionospheric trough boundaries and minima from from Total Electron Content (TEC) data
`SW_OPER_MITBTEC_2F`	Swarm B mid-latitude ionospheric trough boundaries and minima from from Total Electron Content (TEC) data
`SW_OPER_MITCTEC_2F`	Swarm C mid-latitude ionospheric trough boundaries and minima from from Total Electron Content (TEC) data

parameter / type	description
`Timestamp` `isotime`	Time of observation, UTC
`Counter[2]` `integer`	Swarm orbit counter and quarter orbit (four per Swarm orbit) counter
`Latitude` `double`	Geocentric latitude in ITRF
`Longitude` `double`	Geocentric longitude in ITRF
`Radius` `double`	Geocentric radius in ITRF
`Latitude_QD` `double`	Quasi-dipole latitude
`Longitude_QD` `double`	Quasi-dipole longitude
`MLT_QD` `double`	Magnetic local time (QD)
`L_value` `double`	L-value
`SZA` `double`	Solar zenith angle
`TEC` `double`	Total electron content
`Depth` `double`	Depth of the MIT
`DR` `double`	Relative change in density within the MIT
`Width` `double`	Width of the MIT calculated from QD latitudes
`dL` `double`	Width of the MIT calculated from L-values
`PW_Gradient` `double`	Change in TEC at the poleward wall of the MIT divided by QD latitude difference
`EW_Gradient` `double`	Change in TEC at the equatorward wall of the MIT divided by QD latitude difference
`Quality[8]` `integer`	Characterizes the detection quality of the MIT as a whole

`SW_MITxTEC_2F:ID`

dataset	description
`SW_OPER_MITATEC_2F:ID`	Swarm A mid-latitude ionospheric trough boundaries and minima from from Total Electron Content (TEC) data
`SW_OPER_MITBTEC_2F:ID`	Swarm B mid-latitude ionospheric trough boundaries and minima from from Total Electron Content (TEC) data
`SW_OPER_MITCTEC_2F:ID`	Swarm C mid-latitude ionospheric trough boundaries and minima from from Total Electron Content (TEC) data

parameter / type	description
`Timestamp` `isotime`	Time of observation, UTC
`Counter[2]` `integer`	Swarm orbit counter and quarter orbit (four per Swarm orbit) counter
`Latitude` `double`	Geocentric latitude in ITRF
`Longitude` `double`	Geocentric longitude in ITRF
`Radius` `double`	Geocentric radius in ITRF
`Latitude_QD` `double`	Quasi-dipole latitude
`Longitude_QD` `double`	Quasi-dipole longitude
`MLT_QD` `double`	Magnetic local time (QD)
`L_value` `double`	L-value
`SZA` `double`	Solar zenith angle
`TEC` `double`	Total electron content
`Position_Quality` `integer`	Indicator characterizing the detection quality of the position
`PointType` `integer`	Point Type

`SW_PPIxFAC_2F`

dataset	description
`SW_OPER_PPIAFAC_2F`	Swarm A equatorward boundary of Small-Scale Field Aligned Currents (SSFAC) and the associated midnight Plasma-Pause (PP) index
`SW_OPER_PPIBFAC_2F`	Swarm B equatorward boundary of Small-Scale Field Aligned Currents (SSFAC) and the associated midnight Plasma-Pause (PP) index
`SW_OPER_PPICFAC_2F`	Swarm C equatorward boundary of Small-Scale Field Aligned Currents (SSFAC) and the associated midnight Plasma-Pause (PP) index

parameter / type	description
`Timestamp` `isotime`	Time of observation, UTC
`Counter[2]` `integer`	Swarm orbit counter and quarter orbit (four per Swarm orbit) counter
`Latitude` `double`	Geocentric latitude in ITRF
`Longitude` `double`	Geocentric longitude in ITRF
`Radius` `double`	Geocentric radius in ITRF
`Latitude_QD` `double`	Quasi-dipole latitude
`Longitude_QD` `double`	Quasi-dipole longitude
`MLT_QD` `double`	Magnetic local time (QD)
`L_value` `double`	L-value
`SZA` `double`	Solar zenith angle
`dL` `double`	Width of the MIT calculated from L-values
`Sigma` `double`	Standard deviation of the linear fit of S at the boundary [RD-2]
`PPI` `double`	Midnight Plasmapause index
`Quality[7]` `integer`	Characterizes the detection quality of the MIT as a whole

`SW_PPIxFAC_2F:ID`

dataset	description
`SW_OPER_PPIAFAC_2F:ID`	Swarm A equatorward boundary of Small-Scale Field Aligned Currents (SSFAC) and the associated midnight Plasma-Pause (PP) index
`SW_OPER_PPIBFAC_2F:ID`	Swarm B equatorward boundary of Small-Scale Field Aligned Currents (SSFAC) and the associated midnight Plasma-Pause (PP) index
`SW_OPER_PPICFAC_2F:ID`	Swarm C equatorward boundary of Small-Scale Field Aligned Currents (SSFAC) and the associated midnight Plasma-Pause (PP) index

parameter / type	description
`Timestamp` `isotime`	Time of observation, UTC
`Counter[2]` `integer`	Swarm orbit counter and quarter orbit (four per Swarm orbit) counter
`Latitude` `double`	Geocentric latitude in ITRF
`Longitude` `double`	Geocentric longitude in ITRF
`Radius` `double`	Geocentric radius in ITRF
`Latitude_QD` `double`	Quasi-dipole latitude
`Longitude_QD` `double`	Quasi-dipole longitude
`MLT_QD` `double`	Magnetic local time (QD)
`L_value` `double`	L-value
`SZA` `double`	Solar zenith angle
`Position_Quality` `integer`	Indicator characterizing the detection quality of the position
`PointType` `integer`	Point Type

`SW_DNSxPOD_2_`

dataset	description
`SW_OPER_DNSAPOD_2_`	Swarm A thermosphere density observations derived from precise orbit determination data only
`SW_OPER_DNSBPOD_2_`	Swarm B thermosphere density observations derived from precise orbit determination data only
`SW_OPER_DNSCPOD_2_`	Swarm C thermosphere density observations derived from precise orbit determination data only

parameter / type	description
`Timestamp` `isotime`	Time of observation, UTC
`Latitude_GD` `double`	GRS80 geodetic latitude
`Longitude_GD` `double`	GRS80 geodetic longitude
`Height_GD` `double`	GRS80 latitude
`local_solar_time` `double`	Local solar time
`density` `double`	Mass density
`density_orbitmean` `double`	Orbit average of mass density
`validity_flag` `integer`	0 = nominal data, 1 = anomalous data

`SW_DNSxACC_2_`

dataset	description
`SW_OPER_DNSAACC_2_`	Swarm A thermosphere density observations derived from precise orbit determination data and accelerometer data
`SW_OPER_DNSBACC_2_`	Swarm B thermosphere density observations derived from precise orbit determination data and accelerometer data
`SW_OPER_DNSCACC_2_`	Swarm C thermosphere density observations derived from precise orbit determination data and accelerometer data

parameter / type	description
`Timestamp` `isotime`	Time of observation, UTC
`Latitude_GD` `double`	GRS80 geodetic latitude
`Longitude_GD` `double`	GRS80 geodetic longitude
`Height_GD` `double`	GRS80 latitude
`local_solar_time` `double`	Local solar time
`density` `double`	Mass density

`CH_DNSxACC_2_`

dataset	description
`CH_OPER_DNS_ACC_2_`	CHAMP accelerometer-derived thermosphere density observations

parameter / type	description
`Timestamp` `isotime`	Time of observation, UTC
`Latitude_GD` `double`	GRS80 geodetic latitude
`Longitude_GD` `double`	GRS80 geodetic longitude
`Height_GD` `double`	GRS80 latitude
`local_solar_time` `double`	Local solar time
`density` `double`	Mass density
`density_orbitmean` `double`	Orbit average of mass density
`validity_flag` `integer`	0 = nominal data, 1 = anomalous data
`validity_flag_orbitmean` `integer`	0 = nominal data, 1 = anomalous data

`GF_DNSxACC_2_`

dataset	description
`GF_OPER_DNS1ACC_2_`	GRACE-FO 1 accelerometer-derived thermosphere density observations

parameter / type	description
`Timestamp` `isotime`	Time of observation, UTC
`Latitude_GD` `double`	GRS80 geodetic latitude
`Longitude_GD` `double`	GRS80 geodetic longitude
`Height_GD` `double`	GRS80 latitude
`local_solar_time` `double`	Local solar time
`density` `double`	Mass density
`density_orbitmean` `double`	Orbit average of mass density
`validity_flag` `integer`	0 = nominal data, 1 = anomalous data
`validity_flag_orbitmean` `integer`	0 = nominal data, 1 = anomalous data

`GR_DNSxACC_2_`

dataset	description
`GR_OPER_DNS1ACC_2_`	GRACE 1 accelerometer-derived thermosphere density observations
`GR_OPER_DNS2ACC_2_`	GRACE 2 accelerometer-derived thermosphere density observations

parameter / type	description
`Timestamp` `isotime`	Time of observation, UTC
`Latitude_GD` `double`	GRS80 geodetic latitude
`Longitude_GD` `double`	GRS80 geodetic longitude
`Height_GD` `double`	GRS80 latitude
`local_solar_time` `double`	Local solar time
`density` `double`	Mass density
`density_orbitmean` `double`	Orbit average of mass density
`validity_flag` `integer`	0 = nominal data, 1 = anomalous data
`validity_flag_orbitmean` `integer`	0 = nominal data, 1 = anomalous data

`CH_WNDxACC_2_`

dataset	description
`CH_OPER_WND_ACC_2_`	CHAMP thermosphere crosswind at satellite locations

parameter / type	description
`Timestamp` `isotime`	Time of observation, UTC
`Latitude_GD` `double`	GRS80 geodetic latitude
`Longitude_GD` `double`	GRS80 geodetic longitude
`Height_GD` `double`	GRS80 latitude
`local_solar_time` `double`	Local solar time
`crosswind` `double`	Crosswind magnitude
`crosswind_direction[3]` `double`	Direction of crosswind in local North-East-Down frame (unit vector)
`validity_flag` `integer`	0 = nominal data, 1 = anomalous data

`GF_WNDxACC_2_`

dataset	description
`GF_OPER_WND1ACC_2_`	GRACE-FO 1 thermosphere crosswind at satellite locations

parameter / type	description
`Timestamp` `isotime`	Time of observation, UTC
`Latitude_GD` `double`	GRS80 geodetic latitude
`Longitude_GD` `double`	GRS80 geodetic longitude
`Height_GD` `double`	GRS80 latitude
`local_solar_time` `double`	Local solar time
`crosswind` `double`	Crosswind magnitude
`crosswind_direction[3]` `double`	Direction of crosswind in local North-East-Down frame (unit vector)
`validity_flag` `integer`	0 = nominal data, 1 = anomalous data

`GR_WNDxACC_2_`

dataset	description
`GR_OPER_WND1ACC_2_`	GRACE 1 thermosphere crosswind at satellite locations
`GR_OPER_WND2ACC_2_`	GRACE 2 thermosphere crosswind at satellite locations

parameter / type	description
`Timestamp` `isotime`	Time of observation, UTC
`Latitude_GD` `double`	GRS80 geodetic latitude
`Longitude_GD` `double`	GRS80 geodetic longitude
`Height_GD` `double`	GRS80 latitude
`local_solar_time` `double`	Local solar time
`crosswind` `double`	Crosswind magnitude
`crosswind_direction[3]` `double`	Direction of crosswind in local North-East-Down frame (unit vector)
`validity_flag` `integer`	0 = nominal data, 1 = anomalous data

`MM_CON_EPH_2_:crossover`

dataset	description
`MM_OPER_CON_EPH_2_:crossover`	Swarm, CHAMP, GOCE, GRACE, and GRACE-FO conjunctions.

parameter / type	description
`time_1` `isotime`	Crossover time of the first satellite (UTC)
`time_2` `isotime`	Crossover time of the second satellite (UTC)
`time_difference` `double`	Time between the first and second satellite passing over the same location
`satellite_1` `string`	ID of the first satellite (symbols: SWx - Swarm, CH - CHAMP, GO - GOCE, GRx - GRACE, GFx - GRACE-FO)
`satellite_2` `string`	ID of the second satellite (symbols: SWx - Swarm, CH - CHAMP, GO - GOCE, GRx - GRACE, GFx - GRACE-FO)
`altitude_1` `double`	Altitude of the first satellite at crossover (GRS80)
`altitude_2` `double`	Altitude of the second satellite at crossover (GRS80)
`latitude` `double`	Geodetic latitude of crossover
`longitude` `double`	Longitude of crossover
`magnetic_latitude` `double`	Magnetic latitude of crossover
`magnetic_longitude` `double`	Magnetic longitude of crossover
`local_solar_time_2` `double`	Local solar time of the first satellite at crossover
`local_solar_time_1` `double`	Local solar time of the second satellites at crossover

`MM_CON_EPH_2_:plane_alignment`

dataset	description
`MM_OPER_CON_EPH_2_:plane_alignment`	Swarm, CHAMP, GOCE, GRACE, and GRACE-FO conjunctions.

parameter / type	description
`time` `isotime`	Time of orbital plane alignment (UTC)
`satellite_1` `string`	ID of the first satellite (symbols: SWx - Swarm, CH - CHAMP, GO - GOCE, GRx - GRACE, GFx - GRACE-FO)
`satellite_2` `string`	ID of the second satellite (symbols: SWx - Swarm, CH - CHAMP, GO - GOCE, GRx - GRACE, GFx - GRACE-FO)
`altitude_1` `double`	Altitude of the first satellite
`altitude_2` `double`	Altitude of the second satellite
`ltan_1` `double`	LTAN of the first satellite
`ltan_2` `double`	LTAN of the second satellite
`ltan_rate_1` `double`	LTAN drift rate of the first satellite
`ltan_rate_2` `double`	LTAN drift rate of the second satellite

API Description

VirES server implements the version 3.0 of the HAPI Specification.

Example HAPI Queries

Data Request Limits

The time selection of one HAPI data request is currently limited to a time selection of approx. 432,000 data records (equivalent of 5 days of 1Hz MAGx_LR_1B data or 2 hours and 24 minutes of 50Hz MAGx_HR_1B data), which is the same limit as the one applied to the synchronous VirES API requests.

This number of records is converted to a time period by multiplication with the nominal cadence of the dataset (see x_maxTimeSelection in the dataset info) which is then used as the actual hard limit. For irregularly sampled datasets, the number of the actual records may slightly differ from the nominal limit.

If you need to retrieve more data than this limit, please consider splitting your large requests into smaller chunks.

Custom Extensions

The HAPI Specification allows extension of the protocol as long as these do not collide with the baseline specification and can be safely ignored by client which do not recognize them. The extension attributes are labelled by the x_ prefix.

The VirES extensions are described below...

Dataset Name and Type

The info responses contain extra x_dataset and x_datasetType for the VirES product collection (equal to the HAPI dataset name) and VirES product type. Datasets of the same x_datasetType bear the identical set of parameters.

Maximum Time Selection

The maximum time selection is included in the dataset info response as the custom x_maxTimeSelection field.

Storage Data Type

The parameters description contains additional attribute x_type publishing original storage data type of the parameter and its bit-size (int8, int16, int32, int64, uint8, uint16, uint32, uint64, float32 or float64).

In case of the time-stamps, the description defines the original time-encoding with these attributes: x_standard (UTC), x_epoch (zero-time instant, 1970-01-01T00:00:00Z), x_unit (time unit of the stored numbers, e.g. s, ms, or us) and x_type (storage data type, int64).

The string arrays contain an additional x_encoding attribute (ASCII or UTF-8).

Custom Binary Format

VirES provides an extra custom binary format x_binary. This format has the same structure and endianity as the HAPI binary format but the time, integer and floating point values are encoded in their source data type indicated by the x_type, rather than by the ISO‑8601 time string, 32‑bits signed integer and double precision float.

This binary format is a bit faster to produce, more compact than the standard binary format and it can safely represent uint32, int64, and uint64 values.

JSON Representation of Special IEEE 745 Values

The number representation in the JSON format is limited to decimal numbers (-123.456) with the optional exponential notation (-1.23456e2). JSON cannot represent the IEEE 745 special not-a-number and positive or negative infinity values which may occur in the provided time series data.

VirES for Swarm HAPI server encodes these values as strings which are parsable by the Javascript Number() and Python float() functions:

special value	JSON representation
not-a-number	`"NaN"`
positive infinity	`"Infinity"`
negative infinity	`"-Infinity"`