eSWua Web-Service API documentation (V. 1.1.3)



INDEX




INTRODUCTION

The eSWua RESTful Web service is based on the PHP-CRUD-API project (https://github.com/mevdschee/php-crud-api).

DATA FROMAT: The data are exposed in the JSON interchange format.

DATA POLICY: All the data available through the different services are distributed under the Creative Commons Attribution 4.0 International (CC BY 4.0). Please refer to the "collection info and data policy" page for more information about the eSWua data collections. Always remeber to cite the data with the provided DOI.

DATA DOWNLOAD LIMIT: The downloads are limited to a certain number of records at once. The maximum timespan for a single query depends on the specific data-colletion and on the number of the fields/parameters included. When a query requires more than 1 minutes the web-service will stop the execution and the request will fail; to avoid this kind of issue we suggest you to not exceed 12 hours timespan for each single request.

OTHER USEFUL INFORMATION: Use the tools available on the website to check the data availaibilty, the network/instruments description and for other relevant informations.


GNSS SCINTILLATION DATA

Please always remember to cite this data as:

Upper atmosphere physics and radiopropagation Working Group; Cesaroni, C.; De Franceschi, G.; Marcocci, C.; Pica, E.; Romano, V.; Spogli, L. Electronic Space Weather Upper Atmosphere Database (eSWua) - GNSS Scintillation Data, Version 1.0. Istituto Nazionale di Geofisica e Vulcanologia (INGV) August 1, 2020. https://doi.org/10.13127/ESWUA/GNSS.

Please note that the collection consists of data and instrumnets which could be property of the INGV as well as of other Institutions which share and distribute their data through the eSWua system; in the latter case we kindly ask you to also acknowledge the Institution owner of the data. The list of the instruments and related owning Institutions is available here


The list of all the GNSS Scintillation station (and related informations) of the eSWua network are accessible at the following web-service endpoint:

http://ws-eswua.rm.ingv.it/scintillation.php/records/wsstation


Each station has its own endpoint to access the data stored into the eSWUa database. The following table lists all the stations/instruments and web-service endpoints. The last column reports an example of web-service call to access the data.

A B C D E F
1
STATION CODE INSTRUMENT AVAILABLE DATA UPDATE RATE WEB SERVICE ENDPOINT EXAMPLE
2
btn0s Novatel GSV4004 LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wsbtn0s?size=1&order=dt,desc
3
dmc0p Septentrio PolaRx5S LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wsdmc0p?size=1&order=dt,desc
3
dmc1p Septentrio PolaRx5S LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wsdmc1p?size=1&order=dt,desc
3
dmc2p Septentrio PolaRx5S LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wsdmc2p?size=1&order=dt,desc
4
dmc0s Novatel GSV4004 LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wsdmc0s?size=1&order=dt,desc
5
dmc1s Novatel GSV4004 LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wsdmc1s?size=1&order=dt,desc
6
dmc2s Novatel GSV4004 LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wsdmc2s?size=1&order=dt,desc
7
han0p Septentrio PolaRxS LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wshan0p?size=1&order=dt,desc
8
kil0n Novatel GPStation-6 LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wskil0n?size=1&order=dt,desc
9
lam0p Septentrio PolaRx5S LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wslam0p?size=1&order=dt,desc
10
lam0s Novatel GSV4004 LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wslam0s?size=1&order=dt,desc
11
lyb0p Septentrio PolaRx5S LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wslyb0p?size=1&order=dt,desc
12
lyb0s Novatel GSV4004 LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wslyb0s?size=1&order=dt,desc
13
mzs0p Septentrio PolaRxS LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wsmzs0p?size=1&order=dt,desc
14
nic0p Septentrio PolaRx5S LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wsnic0p?size=1&order=dt,desc
15
nya0s Novatel GSV4004 LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wsnya0s?size=1&order=dt,desc
16
nya0p Septentrio PolaRx5S LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wsnya0p?size=1&order=dt,desc
17
nya1p Septentrio PolaRx5S LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wsnya1p?size=1&order=dt,desc
18
nya1s Novatel GSV4004 LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wsnya1s?size=1&order=dt,desc
19
san0p Septentrio PolaRxS LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wssan0p?size=1&order=dt,desc
20
sao0p Septentrio PolaRxS LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wssao0p?size=1&order=dt,desc
21
thu0p Septentrio PolaRx5S LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wsthu0p?size=1&order=dt,desc
22
ush0p Septentrio PolaRx5S LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wsush0p?size=1&order=dt,desc
23
tuc0p Septentrio PolaRx5S LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wstuc0p?size=1&order=dt,desc
24
hel0p Septentrio PolaRx5S LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wshel0p?size=1&order=dt,desc
24
klu0p Septentrio PolaRx5S LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wsklu0p?size=1&order=dt,desc
24
mal0p Septentrio PolaRx5S LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wsmal0p?size=1&order=dt,desc
24
sab0p Septentrio PolaRx5S LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wssab0p?size=1&order=dt,desc
24
seu0p Septentrio PolaRx5S LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wsseu0p?size=1&order=dt,desc
24
cha0p Septentrio PolaRx5S LEVEL-I Time-resolution: 1 min - Data update every 15 min http://ws-eswua.rm.ingv.it/scintillation.php/records/wscha0p?size=1&order=dt,desc

The following table lists all the parameter (FIELD NAME) that could be retrieved for each pertinent instrument (RELATED TO INSTRUMENT):

A B C D E
1
FIELD NAME DESCRIPTION MEASUREMENT UNIT RELATED TO INSTRUMENTS ELABORATION LEVEL
2
2ndlocktime Lock time on the second frequency used for the TEC computation seconds Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 LEVEL-I
3
averagel1 Average Sig1 C/N0 over the last minute dB-Hz Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
4
avg_c_n0_l2c Average Sig2 C/N0 over the last minute dB-Hz Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
5
avg_c_n0_l5 Average Sig3 C/N0 over the last minute dB-Hz Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
6
avgccd_l2c AvgCCD on Sig2, average of code/carrier divergence meters Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
7
avgccd_l5 AvgCCD on Sig3, average of code/carrier divergence meters Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
8
avgccdl1 AvgCCD on Sig1, average of code/carrier divergence meters Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
9
avgcn2freqtec Averaged C/N0 of second frequency used for the TEC computation dB-Hz Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 LEVEL-I
10
azimuth Azimuth of the SV degrees Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
11
chanstatus Channel status - NovAtel GSV4004 LEVEL-I
12
correctionS4_L2C Correction to total S4 on Sig2 (thermal noise component only) - Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
13
corrections4_l5 Correction to total S4 on Sig3 (thermal noise component only) - Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
14
corrections4l1 Correction to total S4 on Sig1 (thermal noise component only) - Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
15
dt measurement time UTC timestamp Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 -
16
dtec0 dTEC from TOW - 15s to TOW TECu Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
17
dtec0_2c dTEC from TOW - 15s to TOW TECu NovAtel GPStation-6 LEVEL-I
18
dtec30_15 dTEC from TOW - 30s to TOW - 15s TECu Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
19
dtec30_15_2c dTEC from TOW - 30s to TOW - 15s TECu NovAtel GPStation-6 LEVEL-I
20
dtec45_30 dTEC from TOW - 45s to TOW - 30s TECu Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
21
dtec45_30_2c dTEC from TOW - 45s to TOW - 30s TECu NovAtel GPStation-6 LEVEL-I
22
dtec60_45 dTEC from TOW - 60s to TOW - 45s TECu Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
23
dtec60_45_2c dTEC from TOW - 60s to TOW - 45s TECu NovAtel GPStation-6 LEVEL-I
24
elevation Elevation of the SV degrees Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
25
ipp_lat Latitude of the Ionospheric Pierce Point at 350 km degrees Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I (evaluated from azimuth and elevation)
26
ipp_lon Longitude of the Ionospheric Pierce Point at 350 km degrees Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I (evaluated from azimuth and elevation
27
locktime_l2c Sig2 lock time seconds Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
28
locktime_l5 Sig3 lock time seconds Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
29
locktimel1 Sig1 lock time seconds Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
30
p_l2c p on Sig2, phase spectral slope in the 0.1 to 25Hz range - Septentrio PolaRx5S/PolaRxS LEVEL-I
31
p_l5 p on Sig3, phase spectral slope in the 0.1 to 25Hz range - Septentrio PolaRx5S/PolaRxS LEVEL-I
32
phi01_l2c Phi01 on Sig2, 1-second phase sigma radians Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
33
phi01_l5 Phi01 on Sig3, 1-second phase sigma radians Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
34
phi01l1 Phi01 on Sig1, 1-second phase sigma radians Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
35
phi03_l2c Phi03 on Sig2, 3-second phase sigma radians Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
36
phi03_l5 Phi03 on Sig3, 3-second phase sigma radians Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
37
phi03l1 Phi03 on Sig1, 3-second phase sigma radians Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
38
phi10_l2c Phi10 on Sig2, 10-second phase sigma radians Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
39
phi10_l5 Phi10 on Sig3, 10-second phase sigma radians Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
40
phi10l1 Phi10 on Sig1, 10-second phase sigma radians Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
41
phi30_l2c Phi30 on Sig2, 30-second phase sigma radians Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
42
phi30_l5 Phi30 on Sig3, 30-second phase sigma radians Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
43
phi30l1 Phi30 on Sig1, 30-second phase sigma radians Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
44
phi60_l1_vert Verticalized sigmaphi index on the first frequency rads Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I (evaluated from phi60l1slant, elevation)
45
phi60_l2_vert Verticalized sigmaphi index on the second frequency rads Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I (evaluated from phi60_l2c, elevation)
46
phi60_l2c Phi60 on Sig2, 60-second phase sigma radians Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
47
phi60_l5 Phi60 on Sig3, 60-second phase sigma radians Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
48
phi60_l5_vert Verticalized sigmaphi index on the third frequency rads Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I (evaluated from phi60_l5, elevation)
49
phi60l1slant Phi60 on Sig1, 60-second phase sigma radians Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
50
pl1 p on Sig1, spectral slope of detrended phase in the 0.1 to 25Hz range - Septentrio PolaRx5S/PolaRxS LEVEL-I
51
PRN Satellite constellation and number (G: GPS; R: Glonass; S: SBAS block1; E: GALILEO; C:Beidou; Q: QZSS; I: IRNSS) - Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
52
rxstate Value of the RxState field of the ReceiverStatus SBF block - Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 LEVEL-I
53
s4_l1_slant Slant s4 index on the first frequency - Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I (evaluated from totalS4L1, correctionS4L1)
54
s4_l1_vert Verticalized s4 index on the first frequency - Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I (evaluated from totalS4L1, correctionS4L1, pl1, elevation)
55
s4_l2_slant Slant s4 index on the second frequency - Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I (evaluated from totalS4_L2C, correctionS4_L2C)
56
s4_l2_vert Vertical s4 index on the second frequency - Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I (evaluated from totalS4_L2C, correctionS4_L2C, p_l2c, elevation)
57
s4_l5_slant Slant s4 index on the third frequency - Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I (evaluated from totalS4_L5, correctionS4_L5)
58
si_l1_29 SI Index on Sig1:(10*log10(Pmax)-10*log10(Pmin))/(10*log10(Pmax)+10*log10(Pmin)) - Septentrio PolaRx5S/PolaRxS LEVEL-I
59
si_l1_30 SI Index on Sig1, numerator only: 10*log10(Pmax)-10*log10(Pmin) dB Septentrio PolaRx5S/PolaRxS LEVEL-I
60
si_l2c_43 SI Index on Sig2 - Septentrio PolaRx5S/PolaRxS LEVEL-I
61
si_l2c_44 SI Index on Sig2, numerator only: 10*log10(Pmax)-10*log10(Pmin) dB Septentrio PolaRx5S/PolaRxS LEVEL-I
62
si_l5_57 SI Index on Sig3 - Septentrio PolaRx5S/PolaRxS LEVEL-I
63
si_l5_58 SI Index on Sig3, numerator only: 10*log10(Pmax)-10*log10(Pmin) dB Septentrio PolaRx5S/PolaRxS LEVEL-I
64
sigmaccd_l2c SigmaCCD on Sig2, standard deviation of code/carrier divergence meters Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
65
sigmaccd_l5 SigmaCCD on Sig3, standard deviation of code/carrier divergence meters Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
66
sigmaccdl1 SigmaCCD on Sig1, standard deviation of code/carrier divergence meters Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
67
stec Slant Total Electron Content TECu Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I (evaluated from tec0, tec15, tec30, tec45, elevation)
68
svid SV number - Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
69
t_l1 T on Sig1, phase power spectral density at 1 Hz rad^2/Hz Septentrio PolaRx5S/PolaRxS LEVEL-I
70
t_l2c T on Sig2, phase power spectral density at 1 Hz rad^2/Hz Septentrio PolaRx5S/PolaRxS LEVEL-I
71
t_l5 T on Sig3, phase power spectral density at 1 Hz rad^2/Hz Septentrio PolaRx5S/PolaRxS LEVEL-I
72
tec0 TEC at TOW TECu Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
73
tec0_2c TEC at TOW TECu NovAtel GPStation-6 LEVEL-I
74
tec15 TEC at TOW - 15 seconds TECu Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
75
tec15_2c TEC at TOW - 15 seconds TECu NovAtel GPStation-6 LEVEL-I
76
tec30 TEC at TOW - 30 seconds TECu Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
77
tec30_2c TEC at TOW - 30 seconds TECu NovAtel GPStation-6 LEVEL-I
78
tec45 TEC at TOW - 45 seconds TECu Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
79
tec45_2c TEC at TOW - 45 seconds TECu NovAtel GPStation-6 LEVEL-I
80
totals4_l2c Total S4 on Sig2 - Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
81
totals4_l5 Total S4 on Sig3 - Septentrio PolaRx5S/PolaRxS NovAtel GPStation-6 LEVEL-I
82
totals4l1 Total S4 on Sig1 - Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I
83
vtec Vertical Total Electron Content TECu Septentrio PolaRx5S/PolaRxS NovAtel GSV4004 NovAtel GPStation-6 LEVEL-I (evaluated from tec0, tec15, tec30, tec45, elevation)


HF SYSTEM DATA

Please always remember to cite this data as:

CITATION FOR THE RAW IONOGRAMS AND AUTOSCALED PARAMETERS:

Upper atmosphere physics and radiopropagation Working Group; Marcocci, C.; Pezzopane, M.; Pica, E.; Romano, V.; Sabbagh, D.; Scotto, C.; Zuccheretti, E. Electronic Space Weather Upper Atmosphere Database (eSWua) - HF Data, Version 1.0. Istituto Nazionale di Geofisica e Vulcanologia (INGV) August 1, 2020. https://doi.org/10.13127/ESWUA/HF.

Please note that the collection consists of data and instruments which could be property of the INGV as well as of other Institutions which share and distribute their data through the eSWua system; in the latter case we kindly ask you to also acknowledge the Institution owner of the data. The list of the instruments and related owning Institutions is available here.


CITATION FOR MANUALLY VALIDATED DATA:

Upper atmosphere physics and radiopropagation Working Group, Cossari, A., Fontana, G., Marcocci, C., Pau, S., Pezzopane, M., Pica, E., & Zuccheretti, E. (2020). Electronic Space Weather upper atmosphere database (eSWua) - HF validated data (1.0). Istituto Nazionale di Geofisica e Vulcanologia (INGV). https://doi.org/10.13127/ESWUA/HFVALIDATED.


The list of all the Ionosondes (and related informations) of the eSWua network are accessible at the following web-service endpoint:

http://ws-eswua.rm.ingv.it/ais.php/records/wsstation


Each ionosonde has its own endpoints (1 for each "level of elaboration") to access the data stored into the eSWua database.

The following table lists all the Ionosondes and web-service endpoints. The last column reports an example of web-service call to access the data. The endpoint "STATION_CODE"_auto contain the autoscaled value and the reconstructed traces, the endpoint "STATION_CODE"_rdf contain the raw ionograms, the endpoint "STATION_CODE"_rev contain the manually validated parameters:

A B C D E F
1
STATION CODE INSTRUMENT AVAILABLE DATA UPDATE RATE WEB SERVICE ENDPOINT EXAMPLE
2
rm041 AIS-INGV Ionosonde LEVEL-I (Autoscaled parameters) Soundings performed each 15 minutes, 24/7 (if station is active) http://ws-eswua.rm.ingv.it/ais.php/records/wsrm041_auto?filter=dt,eq,2022-07-15%2012:00:00
3
LEVEL-0 (Raw ionograms) http://ws-eswua.rm.ingv.it/ais.php/records/rm041_rdf?filter=dt,eq,2022-07-15%2012:00:00
4
LEVEL-II (Manually validated parameters) http://ws-eswua.rm.ingv.it/ais.php/records/rm041_rev?filter=dt,eq,2021-05-15%2012:00:00
5
gm037 AIS-INGV Ionosonde LEVEL-I (Autoscaled parameters) Soundings performed each 15 minutes, 24/7 (if station is active) http://ws-eswua.rm.ingv.it/ais.php/records/wsgm037_auto?filter=dt,eq,2022-07-15%2012:00:00
6
LEVEL-0 (Raw ionograms) http://ws-eswua.rm.ingv.it/ais.php/records/gm037_rdf?filter=dt,eq,2022-07-15%2012:00:00
7
LEVEL-II (Manually validated parameters) http://ws-eswua.rm.ingv.it/ais.php/records/gm037_rev?filter=dt,eq,2018-05-15%2012:00:00
8
tuj2o AIS-INGV Ionosonde LEVEL-I (Autoscaled parameters) Soundings performed each 10 minutes, 24/7 (if station is active) http://ws-eswua.rm.ingv.it/ais.php/records/wstuj2o_auto?filter=dt,eq,2022-06-15%2012:00:00
9
LEVEL-0 (Raw ionograms) http://ws-eswua.rm.ingv.it/ais.php/records/tuj2o_rdf?filter=dt,eq,2022-06-15%2012:00:00
10
bbj3r AIS-INGV Ionosonde LEVEL-I (Autoscaled parameters) Soundings performed each 10 minutes, 24/7 (if station is active) http://ws-eswua.rm.ingv.it/ais.php/records/wsbbj3r_auto?filter=dt,eq,2022-07-15%2012:00:00
11
LEVEL-0 (Raw ionograms) http://ws-eswua.rm.ingv.it/ais.php/records/bbj3r_rdf?filter=dt,eq,2022-07-15%2012:00:00
12
ro041 DPS-4 LEVEL-I (Autoscaled parameters) Soundings performed each 15 minutes, 24/7 (if station is active) http://ws-eswua.rm.ingv.it/ais.php/records/wsro041_auto?filter=dt,eq,2022-07-15%2012:00:00

The following table lists all the HF product (map) web-service endpoints (1 for each products) with an example of web-service call to access the data.

PRODUCT:

Nowcasting of MUF(3000)F2 over Europe

CODE:

ncmv0

WEB-SERVICE ENDPOINT (EXAMPLE):

http://ws-eswua.rm.ingv.it/ais.php/records/ncmv0?filter=dt,eq,2022-09-07%2014:00

PRODUCT DESCRIPTION:

The near real-time maps of MUF(3000) are estimated every 15 minutes from real-time ionosonde data recorded at several stations over Europe. Such measurements are integrated into the International Reference Ionosphere (IRI) background model, which is upgraded starting from the relative deviations at the stations. Kriging techniques are then applied for spatial interpolation. The considered ionosonde stations are the following:
Pruhonice (50.0, 14.60)
Rome (41.8, 12.5)
Gibilmanna (37.9, 14.0)
Niocosia (35.14,33.48)
Dourbes (50.1, 4.60)
Warsaw (52.21, 21.06)

THRESHOLDS:

Please refer to the produtc 'Nowcasting of MUF(3000)F2 ratio over Europe'.

SPATIAL ASPECT:

Coverage: Europe 12W-45.5E ;32N-72.5N
Resolution: 0.5 degree x 0.5 degree.

TIME ASPECT:

Update Rate: 15 min
Latency: 2 min
Integration Time: n/a
Predicted Time: n/a

PRODUCT:

Nowcasting of MUF(3000)F2 ratio over Europe

CODE:

ncmr0

WEB-SERVICE ENDPOINT (EXAMPLE):

http://ws-eswua.rm.ingv.it/ais.php/records/ncmr0?filter=dt,eq,2022-09-07%2014:00

PRODUCT DESCRIPTION:

This product is the ratio between the nowcasted MUF(3000) derived from real-time ionosonde data and the background. The background is the MUF monthly median derived from the International Reference Ionosphere Model (IRI). The considered ionosonde stations are the following:
Pruhonice (50.0, 14.60)
Rome (41.8, 12.5)
Gibilmanna (37.9, 14.0)
Niocosia (35.14,33.48)
Dourbes (50.1, 4.60)
Warsaw (52.21, 21.06)

THRESHOLDS:

Quiet:
MUF(3000)F2 ratio > 0.7

(no MUF depression or MUF depression < 30% from the modelled median value)

Moderate ionospheric disturbance:
0.5 < MUF(3000)F2 ratio <= 0.7

(30% < MUF depression < 50% from the modelled median value)

Severe ionospheric disturbance:
MUF(3000)F2 ratio <= 0.5

(MUF depression > 50% from the modelled median value);

SPATIAL ASPECT:

Coverage: Europe 12W-45.5E ;32N-72.5N
Resolution: 0.5 degree x 0.5 degree.

TIME ASPECT:

Update Rate: 15 min
Latency: 2 min
Integration Time: n/a
Predicted Time: n/a

PRODUCT:

Short Term Forecasting of MUF(3000)F2 over Europe

CODE:

fcmv0

WEB-SERVICE ENDPOINT (EXAMPLE):

http://ws-eswua.rm.ingv.it/ais.php/records/fcmv0?filter=dt_valid,eq,2022-09-07%2014:00&order=dt,desc

PRODUCT DESCRIPTION:

Result from EUROMAP, a model to forecast Maximum Usable Frequency (MUF) at a distance=3000km over Europe. The input driving parameter are 3h ap indices, converted in ap(τ), effective ionospheric T index, and real-time foF2 observations. The method includes local (for each station) regression storm models to describe strong negative disturbances under ap(τ)>30 and training over previous 28-day models to describe foF2 variations under ap(τ)≤ 30. Index T is used to specify the background level.

THRESHOLDS:

Please refer to the produtc 'Short Term Forecasting of MUF(3000)F2 ratio over Europe'.

SPATIAL ASPECT:

Coverage: Europe 40W-100E ;20N-80N
Resolution: 2.5 degree x 2.5 degree.

TIME ASPECT:

Update Rate: 60 min
Latency: 15 min
Integration Time: n/a
Predicted Time: 1-24 hr

PRODUCT:

Short Term Forecasting of MUF(3000)F2 ratio over Europe

CODE:

fcmr0

WEB-SERVICE ENDPOINT (EXAMPLE):

http://ws-eswua.rm.ingv.it/ais.php/records/fcmr0?filter=dt_valid,eq,2022-09-08%2014:00&order=dt,desc

PRODUCT DESCRIPTION:

This product is the ratio between the forecasted MUF(3000) derived from EUROMAP model and the background. The background is the MUF monthly median derived from the International Reference Ionosphere Model (IRI). The input driving parameter for IRI is the R12 index while for EUROMAP are 3h ap indices, converted in ap(τ), effective ionospheric T index, and real-time foF2 observations.

THRESHOLDS:

Quiet:
MUF(3000)F2 ratio > 0.7

(no MUF depression or MUF depression < 30% from the modelled median value)

Moderate ionospheric disturbance:
0.5 < MUF(3000)F2 ratio <= 0.7

(30% < MUF depression < 50% from the modelled median value)

Severe ionospheric disturbance:
MUF(3000)F2 ratio <= 0.5

(MUF depression > 50% from the modelled median value);

SPATIAL ASPECT:

Coverage: Europe 40W-100E ;20N-80N
Resolution: 2.5 degree x 2.5 degree.

TIME ASPECT:

Update Rate: 60 min
Latency: 15 min
Integration Time: n/a
Predicted Time: 1-24 hr

The following table lists all the parameter (FIELD NAME) that could be retrieved for each instrument (RELATED TO INSTRUMENT/ ELABORATION LEVEL).

A B C D E F
1
FIELD NAME DESCRIPTION MEASUREMENT UNIT TYPE
RELATED TO INSTRUMENTS
ELABORATION LEVEL
2
aip_b0 B0 - Thickness parameter (Adaptive Ionospheric Profiler, AIP) km single value AIS-INGV Ionosonde LEVEL-I (Autoscaled)
3
aip_b1 Shape parameter (Adaptive Ionospheric Profiler, AIP) - single value AIS-INGV Ionosonde LEVEL-I (Autoscaled)
4
aip_d1 Shape parameter (Adaptive Ionospheric Profiler, AIP) - single value AIS-INGV Ionosonde LEVEL-I (Autoscaled)
5
aip_deln_ve E valley depth (Adaptive Ionospheric Profiler, AIP) m^-3 single value AIS-INGV Ionosonde LEVEL-I (Autoscaled)
6
aip_ewidth E valley width (Adaptive Ionospheric Profiler, AIP) km single value AIS-INGV Ionosonde LEVEL-I (Autoscaled)
7
aip_foe Critical frequency of the E-layer(Adaptive Ionospheric Profiler, AIP) MHz single value AIS-INGV Ionosonde LEVEL-I (Autoscaled)
8
aip_fof1 Critical frequency of the F1-layer (Adaptive Ionospheric Profiler, AIP) MHz single value AIS-INGV Ionosonde LEVEL-I (Autoscaled)
9
aip_fof2 Critical frequency of the F2-layer (Adaptive Ionospheric Profiler, AIP) MHz single value AIS-INGV Ionosonde LEVEL-I (Autoscaled)
10
aip_h_ve Height of the E valley point (Adaptive Ionospheric Profiler, AIP) km single value AIS-INGV Ionosonde LEVEL-I (Autoscaled)
11
aip_hme Height of the maximum electron density of the E layer (Adaptive Ionospheric Profiler, AIP) km single value AIS-INGV Ionosonde LEVEL-I (Autoscaled)
12
aip_hmf1 Height of the maximum electron density of the F1 layer (Adaptive Ionospheric Profiler, AIP) km single value AIS-INGV Ionosonde LEVEL-I (Autoscaled)
13
aip_hmf2 Height of the maximum electron density of F2 layer (Adaptive Ionospheric Profiler, AIP) km single value AIS-INGV Ionosonde LEVEL-I (Autoscaled)
14
aip_yme Parabolic E layer semi-thickness (Adaptive Ionospheric Profiler, AIP) km single value AIS-INGV Ionosonde LEVEL-I (Autoscaled)
15
att_ext internal receiver attenuation - single value AIS-INGV Ionosonde LEVEL-0 (Raw)
16
att_int external receiver attenuation - single value AIS-INGV Ionosonde LEVEL-0 (Raw)
17
comment_man - single value AIS-INGV Ionosonde LEVEL-0 (Raw)
18
dsp_ver - single value AIS-INGV Ionosonde LEVEL-0 (Raw)
19
dt measurement time/generation time UTC timestamp single value AIS-INGV Ionosonde, DPS-4, HF maps -
19
dt_valid In case of HF map it report the timestamp to which the data refer timestamp single value HF MAPS -
20
fbes fbEs - blanketing frequency of Es layer MHz single value AIS-INGV Ionosonde LEVEL-II (Validated)
21
fbes_qual / fbes_desc Qualitative/Descriptive letters for the previous parameter (see TABLE 1) - character AIS-INGV Ionosonde LEVEL-II (Validated)
22
fmin The minimum frequency reflected by the ionosphere MHz single value AIS-INGV Ionosonde LEVEL-II (Validated)
23
fmin_qual / fmin_desc Qualitative/Descriptive letters for the previous parameter (see TABLE 1) - character AIS-INGV Ionosonde LEVEL-II (Validated)
24
foe foE - Critical frequency of the E-layer MHz single value AIS-INGV Ionosonde, DPS-4 LEVEL-I (Autoscaled) / LEVEL-II (Validated)
25
foe_qual / foe_desc Qualitative/Descriptive letters for the previous parameter (see TABLE 1) - character AIS-INGV Ionosonde LEVEL-II (Validated)
26
foes foEs - Critical frequency of the Sporadic E-layer MHz single value AIS-INGV Ionosonde, DPS-4 LEVEL-I (Autoscaled) / LEVEL-II (Validated)
27
foes_qual / foes_desc Qualitative/Descriptive letters for the previous parameter (see TABLE 1) - character AIS-INGV Ionosonde LEVEL-II (Validated)
28
fof1 foF1 - Critical frequency of the F1-layer MHz single value AIS-INGV Ionosonde, DPS-4 LEVEL-I (Autoscaled) / LEVEL-II (Validated)
29
fof1_qual / fof1_desc Qualitative/Descriptive letters for the previous parameter (see TABLE 1) - character AIS-INGV Ionosonde LEVEL-II (Validated)
30
fof2 foF2 - Critical frequency of the F2-layer MHz single value AIS-INGV Ionosonde, DPS-4 LEVEL-I (Autoscaled) / LEVEL-II (Validated)
30
fof2_med_27_days 27 days median of the foF2 MHz single value AIS-INGV Ionosonde, DPS-4 LEVEL-I (Autoscaled)
31
fof2_qual / fof2_desc Qualitative/Descriptive letters for the previous parameter (see TABLE 1) - character AIS-INGV Ionosonde LEVEL-II (Validated)
32
freq_end End frequency of the sounding MHz single value AIS-INGV Ionosonde LEVEL-0 (Raw)
33
freq_gyro Gyrofrequency MHz single value AIS-INGV Ionosonde LEVEL-0 (Raw)
34
freq_start Starting frequency of the sounding MHz single value AIS-INGV Ionosonde LEVEL-0 (Raw)
35
freq_step Frequency step of the sounding MHz single value AIS-INGV Ionosonde LEVEL-0 (Raw)
36
ftes Maximum frequency reflected by the sporadic-E layer MHz single value AIS-INGV Ionosonde LEVEL-I (Autoscaled)
37
fxi fxI : Maximum frequency of F-trace MHz single value AIS-INGV Ionosonde, DPS-4 LEVEL-I (Autoscaled) / LEVEL-II (Validated)
38
fxi_qual / fxi_desc Qualitative/Descriptive letters for the previous parameter (see TABLE 1) - character AIS-INGV Ionosonde LEVEL-II (Validated)
39
h_e h'E - Minimum virtual height of E-layer km single value AIS-INGV Ionosonde, DPS-4 LEVEL-I (Autoscaled) / LEVEL-II (Validated)
40
h_e_qual / h_e_desc Qualitative/Descriptive letters for the previous parameter (see TABLE 1) - character AIS-INGV Ionosonde LEVEL-II (Validated)
41
h_es h'Es - Minimum virtual height of Sporadic E-layer km single value AIS-INGV Ionosonde, DPS-4 LEVEL-I (Autoscaled) / LEVEL-II (Validated)
42
h_es_qual / h_es_desc Qualitative/Descriptive letters for the previous parameter (see TABLE 1) - character AIS-INGV Ionosonde LEVEL-II (Validated)
43
h_f h'F - Minimum virtual height of F-layer km single value AIS-INGV Ionosonde, DPS-4 LEVEL-I (Autoscaled) / LEVEL-II (Validated)
44
h_f_qual / h_f_desc Qualitative/Descriptive letters for the previous parameter (see TABLE 1) - character AIS-INGV Ionosonde LEVEL-II (Validated)
45
h_f2 h'F2 - Minimum virtual height of F2-layer km single value AIS-INGV Ionosonde, DPS-4 LEVEL-I (Autoscaled) / LEVEL-II (Validated)
46
h_f2_qual / h_f2_desc Qualitative/Descriptive letters for the previous parameter (see TABLE 1) - character AIS-INGV Ionosonde LEVEL-II (Validated)
47
height_end Max height of the sounding km single value AIS-INGV Ionosonde LEVEL-0 (Raw)
48
height_start Min height of the sounding km single value AIS-INGV Ionosonde LEVEL-0 (Raw)
49
height_step Height step of the sounding km single value AIS-INGV Ionosonde LEVEL-0 (Raw)
50
high high portion of word for filtering echoe - single value AIS-INGV Ionosonde LEVEL-0 (Raw)
51
int_n integrations of the received signal - single value AIS-INGV Ionosonde LEVEL-0 (Raw)
52
ionogram Raw ionogram - points matrix (heights / frequencies coordinates with echo amplitude values) AIS-INGV Ionosonde LEVEL-0 (Raw)
2
jfile HF maps MHz or adimensional (for ratio maps) points matrix (latitudes / longitudes coordinates with values) HF maps
53
low low portion of word for filtering echoe - single value AIS-INGV Ionosonde LEVEL-0 (Raw)
54
m3000f2 Propagation factor defined as the ratio of the maximum usable frequency, reflecting on the F2 layer, at a distance of 3000 km to the F2 layer critical frequency, foF2 - single value AIS-INGV Ionosonde, DPS-4 LEVEL-I (Autoscaled) / LEVEL-II (Validated)
55
m3000f2_qual / m3000f2_desc Qualitative/Descriptive letters for the previous parameter (see TABLE 1) - character AIS-INGV Ionosonde LEVEL-II (Validated)
56
mag_inclination Magnetic inclination degrees single value AIS-INGV Ionosonde LEVEL-0 (Raw)
57
math_ampli Mathematical amplification for correlation process - single value AIS-INGV Ionosonde LEVEL-0 (Raw)
58
profile Electron density profile - trace points (height-frequency coordinates) AIS-INGV Ionosonde, DPS-4 LEVEL-I (Autoscaled)
59
muf3000f1 Maximum Usable Frequency, reflecting on the F1 layer, for a 3000 km range circuit MHz single value AIS-INGV Ionosonde LEVEL-II (Validated)
60
muf3000f1_qual / muf3000f1_desc Qualitative/Descriptive letters for the previous parameter (see TABLE 1) - character AIS-INGV Ionosonde LEVEL-II (Validated)
61
muf3000f2 Maximum Usable Frequency, reflecting on the F2 layer, for a 3000 km range circuit MHz single value AIS-INGV Ionosonde, DPS-4 LEVEL-I (Autoscaled) / LEVEL-II (Validated)
62
muf3000f2_qual / muf3000f2_desc Qualitative/Descriptive letters for the previous parameter (see TABLE 1) - character AIS-INGV Ionosonde LEVEL-II (Validated)
63
tec Total Electron Content TECu single value DPS-4 LEVEL-I (Autoscaled)
64
tec_bottom Total Electron Content (bottom) TECu single value AIS-INGV Ionosonde LEVEL-I (Autoscaled)
65
tec_top Total Electron Content (top) TECu single value AIS-INGV Ionosonde LEVEL-I (Autoscaled)
66
trace_e Reconstructed E-layer - trace points (heights / frequencies coordinates) DPS-4 LEVEL-I (Autoscaled)
67
trace_es Reconstructed Es-layer - trace points (heights / frequencies coordinates) DPS-4 LEVEL-I (Autoscaled)
68
trace_f1 Reconstructed F1-layer - trace points (heights / frequencies coordinates) DPS-4 LEVEL-I (Autoscaled)
69
trace_f2 Reconstructed F2-layer - trace points (heights / frequencies coordinates) DPS-4 LEVEL-I (Autoscaled)
70
trace Reconstructed trace - trace points (heights / frequencies coordinates) AIS-INGV Ionosonde LEVEL-I (Autoscaled)
71
type_es Description of the Es layer (see TABLE 2) - alphanumeric AIS-INGV Ionosonde LEVEL-II (Validated)
72
73
74
TABLE 1: Qualifying and descriptive letters for the LEVEL-II (manually validated) data
75
Letter Type Description
76
A qualifying letters smaller than (used only for fbEs in case of total blanketing)
77
descriptive letters measurement influenced by or impossible because of the presence of a lower layer, for example Ex
78
B descriptive letters measurement influenced by or impossible because of absorption near the minimum frequency
79
C descriptive letters measurement influenced by or impossible because of a non-ionospheric reason
80
D qualifying letters greater than
81
descriptive letters measurement influenced by or impossible because of the upper limit of the frequency range
82
E qualifying letters smaller than
83
descriptive letters measurement influenced by or impossible because of lower limit of the frequency range
84
F descriptive letters measurement influenced by or impossible because of the presence of diffuse echoes
85
G descriptive letters measurement influenced by or impossible because of the ionization density of the reflective layer is insufficient to allow this measurement with precision.
86
H descriptive letters measurement influenced by or impossible because of the presence of stratifications
87
I qualifying letters interpolated value (the missing value is replaced by the interpolated value)
88
J qualifying letters ordinary component deducted from the extraordinary component
89
L descriptive letters measurement influenced by or impossible because of the trace does not have sufficiently sharp cusps between the layers
90
M qualifying letters uncertain interpretation (used when it is not possible to distinguish between the ordinary and extraordinary rays)
91
N descriptive letters the conditions are such that the measurement cannot be interpreted
92
O qualifying letters extraordinary component deducted from the ordinary component
93
descriptive letters the measurement refers to the ordinary component
94
Q descriptive letters presence of spread range or oblique spread
95
R descriptive letters measurement influenced by or impossible because of absorption in the vicinity of critical frequency
96
S descriptive letters measurement influenced by or impossible because of atmospheric disturbances or interference
97
T descriptive letters value determined by a sequence of observations being the measurement incompatible with the others or uncertain
98
U qualifying letters uncertain value (numerical value imprecise because there are conditions that make it difficult to scale the ionogram)
99
V descriptive letters forked trace which may influence the measurement
100
W descriptive letters measurement influenced by or impossible because the echo is beyond the upper height limit of the ionogram
101
X descriptive letters the measurement refers to the extraordinary component
102
Y descriptive letters lacuna phenomena or the presence of a strongly tilted layer
103
Z qualifying letters characteristic of the ordinary component deduced from the third magnetoionic component
104
descriptive letters presence of a third magnetoionic component
105
106
107
TABLE 2: Descriptions of the Es layer
108
Letter Description
109
C type of Es which presents a rather symmetrical cusp at a frequency equal to or lower than foE
110
F indicates a type of flat Es whose height does not change with frequency. It should only be used at night
111
L indicates a type of flat Es whose height does not change with frequency and is equal to or less than a E layer present in the ionogram. Typically used during the day
112
H describes an Es with a strongly discontinuous trace and with a height greater than the E layer one


GNSS TEC DATA

Please always remember to cite this data as:

Upper atmosphere physics and radiopropagation Working Group; Cesaroni, C.; Marcocci, C.; Pica, E.; Spogli, L. Electronic Space Weather Upper Atmosphere Database (eSWua) - Total Electron Content (TEC) Data, Version 1.0. Istituto Nazionale di Geofisica e Vulcanologia (INGV) August 1, 2020. https://doi.org/10.13127/ESWUA/TEC.


The following table lists all the GNSS TEC data web-service endpoints (1 for each products) with an example of web-service call to access the data.

PRODUCT:

Nowcasting of TEC over the mediterranean area

CODE:

nc_med

WEB-SERVICE ENDPOINT (EXAMPLE):

http://ws-eswua.rm.ingv.it/tecdb.php/records/wsnc_med?filter=dt,eq,2022-07-15%2014:30:00

PRODUCT DESCRIPTION:

Based on the real-time GNSS data from the RING network broadcasted via NTRIP, ionospheric vTEC maps are estimated every 10 minutes on 0.1 deg x 0.1 deg grid. The vTEC estimated at the ionospheric piercing point are interpolated using locally (weighted) regression scatter plot smoothing (LOWESS). No ionospheric input model is ingested to better highlight the ionospheric irregularities.

THRESHOLDS:

Quiet: sTEC < 125 TECu
Moderate: sTEC >= 125 TECu
Severe: sTEC >=175 TECu

SPATIAL ASPECT:

Coverage: Mediterranean 5E-20E ;35N-48N
Resolution: 0.1 degree x 0.1 degree.

TIME ASPECT:

Update Rate: 10 min
Latency: 1 min
Integration Time: 1 min
Predicted Time: n/a

PRODUCT:

Short-term forecasting of TEC over the mediterranean area

CODE:

sf_med

WEB-SERVICE ENDPOINT (EXAMPLE):

http://ws-eswua.rm.ingv.it/tecdb.php/records/wssf_med?filter=dt,eq,2022-07-15%2014:30:00

PRODUCT DESCRIPTION:

Based on nowcasting TEC maps over Mediterranean area provided by INGV, forecasting vTEC maps over Mediterranean area are estimated 30 minutes in advance every 10 minutes on 0.1 deg x0.1 deg grid. Forecasting is based on linear trend for each grid point calculated considered vTEC values of the hour.

THRESHOLDS:

Quiet: sTEC < 125 TECu
Moderate: sTEC >= 125 TECu
Severe: sTEC >=175 TECu

SPATIAL ASPECT:

Coverage: Mediterranean 5E-20E ;35N-48N
Resolution: 0.1 degree x 0.1 degree.

TIME ASPECT:

Update Rate: 10 min
Latency: <2 min
Integration Time: 1 hr
Predicted Time: 30 min

PRODUCT:

Nowcasting of TEC over Europe

CODE:

nc_eu

WEB-SERVICE ENDPOINT (EXAMPLE):

http://ws-eswua.rm.ingv.it/tecdb.php/records/wsnc_eu?filter=dt,eq,2022-07-15%2014:30:00

PRODUCT DESCRIPTION:

Based on the real-time GNSS data from the EUREF network broadcasted via NTRIP, ionospheric VTEC maps gradients (East direction) are estimated every 5 minutes on 0.5 deg x0.5 deg grid. The VTEC estimated at the ionospheric piercing point are interpolated using Locally (weighted) regression scatter plot smoothing (LOWESS). No ionospheric input model is ingested to better highlight the ionospheric irregularities. Starting from vTEC maps, gradients are estimated evaluating the first derivative of the vTEC along N-S and E-W geographical directions.

THRESHOLDS:

Quiet: sTEC < 125 TECu
Moderate: sTEC >= 125 TECu
Severe: sTEC >=175 TECu

SPATIAL ASPECT:

Coverage: European 10W-45E ;30N-75N
Resolution: 0.5 degree x 0.5 degree.

TIME ASPECT:

Update Rate: 5 min
Latency: <2 min
Integration Time: 1 min
Predicted Time: n/a

PRODUCT:

Global nowcasting of TEC

CODE:

nc_gl

WEB-SERVICE ENDPOINT (EXAMPLE):

http://ws-eswua.rm.ingv.it/tecdb.php/records/wsnc_gl?filter=dt,eq,2022-07-15%2014:30:00

PRODUCT DESCRIPTION:

TEC Global nowcasting is based on data from IGS stations ingested into NeQuick2 model. In particular, differences between measured and modelled TEC are computed at each IPP in order to create a global map representing the differences among actual and modelled TEC distribution. Such map is added to the map calculated by running NeQuick2 in order to obtain the TEC nowcasting.

THRESHOLDS:

Quiet: sTEC < 125 TECu
Moderate: sTEC >= 125 TECu
Severe: sTEC >=175 TECu

SPATIAL ASPECT:

Coverage: Global 180W-180E ;87.5S-87.5N
Resolution: 2.5 degree x 2.5 degree.

TIME ASPECT:

Update Rate: 15 min
Latency: 10 min
Integration Time: 15 min
Predicted Time: n/a

PRODUCT:

24-hr forecasting global TEC

CODE:

ltf_gl

WEB-SERVICE ENDPOINT (EXAMPLE):

http://ws-eswua.rm.ingv.it/tecdb.php/records/wsltf_gl?filter=dt,eq,2022-07-15%2014:00:00

PRODUCT DESCRIPTION:

Based on auto regressive neural network with external input (forecasted Kp from NOAA) and ingestion of IGS GIM maps on NeQuick2 model, vTEC at a global level is estimated 24 hours in advance every 2 hours on a grid 2.5deg X 5 deg (lat x long).

For details please refer to Cesaroni, C., Spogli, L., Aragon-Angel, A., Fiocca, M., Dear, V., De Franceschi, G., & Romano, V. (2020). Neural network based model for global Total Electron Content forecasting. Journal of Space Weather and Space Climate.

THRESHOLDS:

Quiet: sTEC < 125 TECu
Moderate: sTEC >= 125 TECu
Severe: sTEC >=175 TECu

SPATIAL ASPECT:

Coverage: Global 180W-180E ;87.5S-87.5N
Resolution: 2.5 degree x 2.5 degree.

TIME ASPECT:

Update Rate: 2 h
Latency: 10 min
Integration Time: 1 y
Predicted Time: 24 h

The following table lists all the parameter (FIELD NAME) that could be retrieved for each endpoint (RELATED TO DATA).

A B C D E F
1
FIELD NAME DESCRIPTION MEASUREMENT UNIT TYPE RELATED TO DATA ELABORATION LEVEL
2
jfile TEC maps TECu points matrix (latitudes / longitudes coordinates with TEC values) nc_med, sf_med, nc_eu, nc_gl, ltf_gl LEVEL-I
3
dt measurement time UTC timestamp single value nc_med, sf_med, nc_eu, nc_gl, ltf_gl LEVEL-I
4
f_horizon forecasting horizon hours single value ltf_gl LEVEL-I
5
r12_eff effective R12 (to be used in NeQuick2 model) adimnsional single value ltf_gl LEVEL-I
6
refresh_rate TEC value UPDATE RATE min single value nc_med, sf_med, nc_eu, nc_gl, ltf_gl LEVEL-I
7
rgec_mean mean Residual Global Electron Content TECu single value ltf_gl LEVEL-I
8
rgec_std standard deviation Residual Global Electron Content TECu single value ltf_gl LEVEL-I
9
tec_mean mean TEC over area TECu single value nc_med, sf_med, nc_eu, nc_gl, ltf_gl LEVEL-I
10
tec_std TEC standard deviation TECu single value nc_med, sf_med, nc_eu, nc_gl, ltf_gl LEVEL-I
10
tec_med_27_days 27 days median of the tec_mean TECu single value nc_med, sf_med, nc_eu, nc_gl, ltf_gl LEVEL-I


WEB-SERVICE BASIC RULES

The following instructions contains examples referred to the GNSS SCINTILLATION stations endpoint; the same rules apply to the other data collections (HF SYSTEM and GNSS TEC) by changing the web service endpoint and the requested fields.


ACCESS TO SINGLE/MULTIPLE FIELD OF A TABLE

By default all the fields of an endpoint are selected. With the include string you can select specific fields, separeted by a comma. Multiple fields should be comma separated. An asterisk (*) may be used as a wildcard to indicate all fields. Similar to include you can use the exclude string to remove certain fields.

Example1: http://ws-eswua.rm.ingv.it/scintillation.php/records/wsstation?include=code
returns the field code (station code) for all the records of the station list endpoint.

Example2: http://ws-eswua.rm.ingv.it/scintillation.php/records/wsstation?include=lat,lon
returns the lat (latitude) and lon (longitude) field for all the records of the station list endpoint.


ORDERING THE RESULTS

With the order string you can sort the results. By default the sort is in ascending order, but by specifying desc this can be reversed:

Example1: http://ws-eswua.rm.ingv.it/scintillation.php/records/wsstation?include=code,id&order=code
the station list (id and code field) will be order by code

Example2: http://ws-eswua.rm.ingv.it/scintillation.php/records/wsstation?include=code,id&order=id,desc
the station list (id and code field) will be order (descending) by id


APPLY FILTERS AND MULTIPLE CONDITIONS TO THE REQUESTS

Filters provide advanced search functionality. The supported filters are the following:

You can negate all filters by prepending a "n" character (i.e. "eq" becomes "neq").


Example1: http://ws-eswua.rm.ingv.it/scintillation.php/records/wsstation?filter=code,eq,dmc0p
returns only the station where the code is equal to dmc0p

Example2: http://ws-eswua.rm.ingv.it/scintillation.php/records/wsdmc0p?filter=dt,bt,2019-10-16 02:45:00,2019-10-16 03:00:00&order=dt
It returns all the fields for the endpoint of the station dmc0p for the time period between 2019-10-16 02:45:00 and 2019-10-16 03:00:00 ordered by time.

Example3: http://ws-eswua.rm.ingv.it/scintillation.php/records/wslyb0p?filter=dt,bt,2019-10-16 02:45:00,2019-10-16 03:00:00&order=dt&include=svid
It returns only the field svid for the endpoint of the station lyb0p for the time period between 2019-10-16 02:45:00 and 2019-10-16 03:00:00 ordered by time


If you want to apply multiple filters and conditions as an AND operator you need to use the & concatenator.


Example: http://ws-eswua.rm.ingv.it/scintillation.php/records/wsstation?filter=area,eq,ANTARCTIC&filter=code,sw,dmc
returns the stations located in the ANTARCTIC area wich names starts with the string dmc


If you want to apply the same filter multiple times as an OR operator you need to enumerate the filters.


Example: http://ws-eswua.rm.ingv.it/scintillation.php/records/wsstation?filter1=area,eq,ANTARCTIC&filter2=area,eq,ARCTIC
returns the stations located in the ANTARCTIC or the ARCTIC area


IMPORTANT NOTE

The FIELD NAME dt is the TIMESTAMP of each record and has the following format (for all the data collection): YY-MM-DD hh-mm-ss.

Note that the blank space in the dt field between DD and hh must to be substituted with a %20 in the web-service call.


Example: if the chosen dt is: 2019-10-16 02:45:00 the string must be included as 2019-10-16%2002:45:00. (note that some code editor software automatically generate the substitution during "get" requests)



EXAMPLES AND CODE

You can use the eSWua download tool to understand how the web-service http calls should be arranged. By choosing the data-collection and applying the several filters you will be redirected to a page where (beside the direct download of the data) both the html string for the web-service request and a pre-formatted code in Python language will be generated.


In the following there are other two basic example of MATLAB and Python code.

MATLAB Example

%% Matlab code for retrieve all the fields/parameters from the last temporal record recorded in the database clc close all clear all %retrieve the scintillation stations/instruments list stations=''.http://ws-eswua.rm.ingv.it/scintillation.php/records.'/wsstation'; station_list=cell2mat(struct2cell(webread(stations))); %%Matlab structure with the stations/instruments list %% retrieve the complete set of parameters in the last available time instant station='lyb0p'; %change the station code for retrieve the parameters from other stations %identification of the last available record time_limit=sprintf(''.http://ws-eswua.rm.ingv.it/scintillation.php/records.'/ws%s?include=dt&order=dt,desc&size=1',station); time=webread(time_limit); %last available temporal instant %retireve the parameters parameter_link=sprintf(''.http://ws-eswua.rm.ingv.it/scintillation.php/records.'/ws%s?filter=dt,eq,%s&order=dt',station,time.records.dt); parameter_list=webread(parameter_link); parameter=cell2mat(struct2cell(parameter_list)); %Matlab structure with all the parameters for the chosen instrument

Python Example

### Python code for retrieve all the fields/parameters from the last temporal record recorded in the database import json import urllib.request #retrieve the scintillation stations/instruments list url=''.http://ws-eswua.rm.ingv.it/scintillation.php/records.'/wsstation' webURL=urllib.request.urlopen(url) station_list=json.loads(webURL.read()) # station_list is a dictionary with the stations/instruments list #Retrieve the complete set of parameters in the last available time instant #### station='lyb0p' #change the station code for retrieve the parameters from other stations #identification of the last available record url = ''.http://ws-eswua.rm.ingv.it/scintillation.php/records.'/ws{}?include=dt&order=dt,desc&size=1'.format(station) webURL=urllib.request.urlopen(url) data=json.loads(webURL.read()) time=data["records"][0]["dt"] #last available record #retireve the parameters time=time.replace(" ","%20") #blank spaces needs substitution with "%20" url=''.http://ws-eswua.rm.ingv.it/scintillation.php/records.'/ws{}?filter=dt,eq,{}&order=time'.format(station,time) webURL=urllib.request.urlopen(url) parameter=json.loads(webURL.read()) # parameter is a dictionary with the stations/instruments list print(parameter) #print of the parameters


LIST OF RETURNED ERRORS

The following errors may be reported:

Error / HTTPresponse code / Message:
1000 / 404 Not found / Route not found
1001 / 404 Not found / Table not found
1002 / 422 Unprocessable entity / Argument count mismatch
1003 / 404 Not found / Record not found
1004 / 403 Forbidden / Origin is forbidden
1005 / 404 Not found / Column not found
1006 / 409 Conflict / Table already exists
1007 / 409 Conflict / Column already exists
1008 / 422 Unprocessable entity / Cannot read HTTP message
1009 / 409 Conflict / Duplicate key exception
1010 / 409 Conflict / Data integrity violation
1011 / 401 Unauthorized / Authentication required
1012 / 403 Forbidden / Authentication failed
1013 / 422 Unprocessable entity / Input validation failed
1014 / 403 Forbidden / Operation forbidden
1015 / 405 Method not allowed / Operation not supported
1016 / 403 Forbidden / Temporary or permanently blocked
1017 / 403 Forbidden / Bad or missing XSRF token
1018 / 403 Forbidden / Only AJAX requests allowed
1019 / 403 Forbidden / Pagination Forbidden
9999 / 500 Internal server error / Unknown error



CONTACT

For any problem,information or request contact us at eswua@ingv.it