Merge branch 's3_dev' into 'main'

S3 dev

See merge request !14

docs/source/access/.htaccess

-#Protect Directory
-AuthName "welcome"
-AuthType Basic
-AuthUserFile ../_static/.htpasswd
-Require valid-user

docs/source/access/.htpasswd

-aspis_user:$apr1$S3.JyuR3$9.OVZ5y09bfJtavulT2kz.

docs/source/private/main.rst

@@ -7,6 +7,8 @@ Private section
 
 :download:`inaf_data_solopas_timeseries (pdf) <./inaf_data_solopas_timeseries-14_Solo_pas_description.pdf>`
 
+:download:`INGV Released Products documentation (pdf) <./INGV_Released_Products_documentation.pdf>`
+
 :download:`unical_sep_ace_spectrum (pdf) <./unical_sep_ace_spectrum-Description_SEP_ACE.pdf>`
 
 :download:`unical_sep_psp_spectrum (pdf) <./unical_sep_psp_spectrum-Description_SEP_PSP.pdf>`

docs/source/products/data/ingv_bvect_cses_tableset.rst

@@ -4,7 +4,35 @@ INGV CSES-01 on track values of vector magnetic field
 
 .. contents:: The tiny table of contents
 
-In situ time series of vector magnetic field derived from the CSES-01 satellite from 1 January 2019 to 30 September 2021. The output is a single .txt formatted file for both diurnal and nocturnal orbits, each of which has a size of about 3 GB. The sample file attached is extracted from one minute acquired by CSES-01
+Yearly data from HPM instrument onboard CSES-01 from 11 July 2018 to 31 May 2021 (based on availability of continuous data).
+
+Each file contains 6 columns: 
+
+#. UTC (ISO format); 
+
+#. Geographic Latitude (deg); 
+
+#. Geographic Longitude (deg); 
+
+#. magnetic field vector time series (Bx) with a 1 Hz sampling in NEC coordinates and units nT.
+
+#. magnetic field vector time series (By) with a 1 Hz sampling in NEC coordinates and units nT.
+
+#. magnetic field vector time series (Bz) with a 1 Hz sampling in NEC coordinates and units nT.
+
+Sub-Sub-folders:
+
+* “csv”: Yearly .csv data. 
+
+* “FIGURE”: Statistical maps of vector magnetic field (three components) in .fits format. Maps are available at two spatial resolutions: 1x1 deg^2 (high resolution) and 5x5 deg^2 (low resolution). For practical purposes use low-resolution maps. High-resolution maps are tagged, e.g., “Btot_x_DAY\_…”. Low-resolution maps are tagged, e.g., “Bx_Mean_DAY\_…”. In both cases the mean value within each bin is representative of the bin itself.
+
+* “nc”: Yearly netCDF data.
+
+* “npy”: Statistical maps of vector magnetic field (three components) in .npy format. Maps are available at two spatial resolutions: 1x1 deg^2 (high resolution) and 5x5 deg^2 (low resolution). For practical purposes use low-resolution maps. High-resolution maps are tagged, e.g., “Btot_x_DAY\_…”. Low-resolution maps are tagged, e.g., “binned_5x5_Bx…_DAY…”. Maps are available with two different values representative of each bin: the mean and the median, respectively.
+
+**References:**
+
+* `Shen, X., Zhang, X., Yuan, S. et al. The state-of-the-art of the China Seismo-Electromagnetic Satellite mission. Sci. China Technol. Sci. 61, 634–642 (2018). https://doi.org/10.1007/s11431-018-9242-0 <https://link.springer.com/article/10.1007/s11431-018-9242-0>`_
 
 **Providers**:
 

docs/source/products/data/ingv_evect_cses_tableset.rst

@@ -4,7 +4,32 @@ INGV CSES-01 on track values of vector electric field
 
 .. contents:: The tiny table of contents
 
-In situ time series of vector electric field derived from the CSES-01 satellite from 1 January 2019 to 30 September 2021. The output is a single .txt formatted file for both diurnal and nocturnal orbits, each of which has a size of about 3 GB. The sample file attached is extracted from about ten minutes acquired by CSES-01
+Yearly and orbital data from EFD instrument onboard CSES-01 from 1 January 2019 to 30 September 2021 (based on availability of continuous data).
+
+Each file contains 6 columns: 
+
+#. UTC (ISO format); 
+
+#. Geographic Latitude (deg); 
+
+#. Geographic Longitude (deg); 
+
+#. electric field vector time series (Ex) with a 0.5 Hz sampling in NEC coordinates and units mV/m.
+
+#. electric field vector time series (Ey) with a 0.5 Hz sampling in NEC coordinates and units mV/m.
+
+#. electric field vector time series (Ez) with a 0.5 Hz sampling in NEC coordinates and units mV/m.
+
+Sub-Sub-folders:
+
+* “csv”: Yearly and orbital .csv data.
+
+* “FIGURE”: Statistical maps of vector electric field (three components) in .fits format. Maps are available at two spatial resolutions: 1x1 deg^2 (high resolution) and 5x5 deg^2 (low resolution). For practical purposes use low-resolution maps. High-resolution maps are tagged, e.g., “Ex_DAY\_…”. Low-resolution maps are tagged, e.g., “Ex_Mean_DAY\_…”. In both cases the mean value within each bin is representative of the bin itself.
+
+* “npy”: Statistical maps of vector electric field (three components) in .npy format. Maps are available at two spatial resolutions: 1x1 deg^2 (high resolution) and 5x5 deg^2 (low resolution). For practical purposes use low-resolution maps. High-resolution maps are tagged, e.g., “Ex_DAY\_…”. Low-resolution maps are tagged, e.g., “binned_5x5_Ex…_DAY…”. Maps are available with two different values representative of each bin: the mean and the median, respectively.
+
+
+**References:**
 
 **Providers**:
 

docs/source/products/data/ingv_lol_swarm_image.rst

@@ -11,13 +11,13 @@ receivers through which TEC values are estimated. Level 2 (L2) TEC data contain
 
 **References:**
 
-De Michelis et al. (2022), Space Weather, 20, e2022SW003129. https://doi.org/10.1029/2022SW003129
+* `De Michelis et al. (2022), Space Weather, 20, e2022SW003129. <https://doi.org/10.1029/2022SW003129>`_
 
-Lovati et al. (2023a), Scientific Reports, 9287. https://doi.org/10.1038/s41598-023-34727-2
+* `Lovati et al. (2023a), Scientific Reports, 9287. <https://doi.org/10.1038/s41598-023-34727-2>`_
 
-Lovati et al. (2023b), Journal of Geophysical Research: Space Physics, 128, e2023JA031411. https://doi.org/10.1029/2023JA031411
+* `Lovati et al. (2023b), Journal of Geophysical Research: Space Physics, 128, e2023JA031411. <https://doi.org/10.1029/2023JA031411>`_
 
-Pezzopane et al. (2021), Remote Sensing, 13, 2209. https://doi.org/10.3390/rs13112209
+* `Pezzopane et al. (2021), Remote Sensing, 13, 2209. <https://doi.org/10.3390/rs13112209>`_
 
 **Providers**:
 

docs/source/products/data/ingv_plasma_cses_image.rst

@@ -6,6 +6,18 @@ INGV CSES-01 electron density and temperature maps
 
 Electron density and temperature maps in quasi-dipole latitude vs magnetic longitude derived from the CSES-01 satellite data acquired from 1 January 2019 to 30 September 2021. The output consists in four .jpg or .png files mapping electron density and temperature in equatorial projection in the dayside and the nightside (2 images for density, 2 for temperature). Each map has a size of about 200 kB. No sample file attached.
 
+* “FIGURE”: Statistical maps of electron density and temperature in .fits format. Maps are available at two spatial resolutions: 1x1 deg^2 (high resolution) and 5x5 deg^2 (low resolution). For practical purposes use low-resolution maps. High-resolution maps are tagged, e.g., “Ne_DAY\_…”. Low-resolution maps are tagged, e.g., “Ne_Mean_DAY\_…”. In both cases the mean value within each bin is representative of the bin itself.
+
+* “npy”: Statistical maps of electron density and temperature in .npy format. Maps are available at two spatial resolutions: 1x1 deg^2 (high resolution) and 5x5 deg^2 (low resolution). For practical purposes use low-resolution maps. High-resolution maps are tagged, e.g., “Ne_DAY\_…”. Low-resolution maps are tagged, e.g., “binned_5x5_Ne…_DAY…”. Maps are available with two different values representative of each bin: the mean and the median, respectively.
+
+References:
+
+* `Shen, X., Zhang, X., Yuan, S. et al. The state-of-the-art of the China Seismo-Electromagnetic Satellite mission. Sci. China Technol. Sci. 61, 634–642 (2018). https://doi.org/10.1007/s11431-018-9242-0 <https://link.springer.com/article/10.1007/s11431-018-9242-0>`_
+
+* `M. Pezzopane et al., "On the Best Settings to Calculate Ionospheric Irregularity Indices From the In Situ Plasma Parameters of CSES-01," in IEEE Journal of Selected Topics in Applied Earth Observations and Remote Sensing, vol. 15, pp. 4058-4071, 2022, doi: 10.1109/JSTARS.2022.3170339.  <https://ieeexplore.ieee.org/document/9763362>`_
+
+* `Pignalberi, A.; Pezzopane, M.; Coco, I.; Piersanti, M.; Giannattasio, F.; De Michelis, P.; Tozzi, R.; Consolini, G. Inter-Calibration and Statistical Validation of Topside Ionosphere Electron Density Observations Made by CSES-01 Mission. Remote Sens. 2022, 14, 4679. https://doi.org/10.3390/rs14184679 <https://www.mdpi.com/2072-4292/14/18/4679>`_
+
 **Providers**:
 
 - **CSES-01** - source:

docs/source/products/data/ingv_plasma_cses_timeseries.rst

@@ -4,7 +4,42 @@ INGV CSES-01 on track values of electron density and temperature
 
 .. contents:: The tiny table of contents
 
-In situ time series of electron density and temperature derived from the CSES-01 satellite from 1 January 2019 to 30 September 2021. The output is a single .txt formatted file for both diurnal and nocturnal orbits, each of which has a size of about 4 GB. The sample file attached is extracted from one diurnal orbit acquired by CSES-01
+Yearly and orbital data from LAP instrument onboard CSES-01 from 1 January 2019 to 30 September 2021 (based on availability of continuous data).
+
+Each file contains 5 columns: 
+
+#. UTC (ISO format); 
+
+#. Geographic Latitude (deg); 
+
+#. Geographic Longitude (deg); 
+
+#. electron density (m^-3); 
+
+#. electron temperature (K) with variable sampling (1.5 Hz and 3 Hz).
+
+Sub-Sub-folders:
+
+* “csv”: Yearly and orbital .csv data. 
+
+* “FIGURE”: Statistical maps of electron density and temperature in .fits format. Maps are available at two spatial resolutions: 1x1 deg^2 (high resolution) and 5x5 deg^2 (low resolution). For practical purposes use low-resolution maps. High-resolution maps are tagged, e.g., “Ne_DAY\_…”. Low-resolution maps are tagged, e.g., “Ne_Mean_DAY\_…”. In both cases the mean value within each bin is representative of the bin itself.
+
+* “nc”: Orbital netCDF data.
+
+* “npy”: Statistical maps of electron density and temperature in .npy format. Maps are available at two spatial resolutions: 1x1 deg^2 (high resolution) and 5x5 deg^2 (low resolution). For practical purposes use low-resolution maps. High-resolution maps are tagged, e.g., “Ne_DAY\_…”. Low-resolution maps are tagged, e.g., “binned_5x5_Ne…_DAY…”. Maps are available with two different values representative of each bin: the mean and the median, respectively.
+
+
+References:
+
+* `Shen, X., Zhang, X., Yuan, S. et al. The state-of-the-art of the China Seismo-Electromagnetic Satellite mission. Sci. China Technol. Sci. 61, 634–642 (2018). https://doi.org/10.1007/s11431-018-9242-0 <https://link.springer.com/article/10.1007/s11431-018-9242-0>`_
+
+* `M. Pezzopane et al., "On the Best Settings to Calculate Ionospheric Irregularity Indices From the In Situ Plasma Parameters of CSES-01," in IEEE Journal of Selected Topics in Applied Earth Observations and Remote Sensing, vol. 15, pp. 4058-4071, 2022, doi: 10.1109/JSTARS.2022.3170339.  <https://ieeexplore.ieee.org/document/9763362>`_
+
+* `Pignalberi, A.; Pezzopane, M.; Coco, I.; Piersanti, M.; Giannattasio, F.; De Michelis, P.; Tozzi, R.; Consolini, G. Inter-Calibration and Statistical Validation of Topside Ionosphere Electron Density Observations Made by CSES-01 Mission. Remote Sens. 2022, 14, 4679. https://doi.org/10.3390/rs14184679 <https://www.mdpi.com/2072-4292/14/18/4679>`_
+
+
+
+
 
 **Providers**:
 

docs/source/products/data/ingv_sigma_swarm_image.rst

@@ -4,7 +4,15 @@ INGV Swarm parallel electrical conductivity maps
 
 .. contents:: The tiny table of contents
 
-Maps of parallel electrical conductivity in quasi-dipole latitude vs magnetic local time coordinates derived from the Swarm constellation data acquired at 1 second cadence from 1 January 2014 to 31 December 2020. The output consists in three .jpg or .png files mapping parallel electrical conductivity in polar and equatorial projections (3 images) for each of the 3 satellites of the Swarm constellation. Each map has a size of about 300 kB.
+Parallel electrical conductivity maps from LP instruments onboard the Swarm constellation (Alpha, Bravo and Charlie satellites) obtained from data between 1 January 2014 and 31 December 2022.
+
+**References:**
+
+* `F. Giannattasio, P. De Michelis, A. Pignalberi, I. Coco, G. Consolini, M. Pezzopane, R. Tozzi, Parallel Electrical Conductivity in the Topside Ionosphere Derived From Swarm Measurements, JGR Space Physics, Volume126, Issue2 February 2021, https://doi.org/10.1029/2020JA028452 <https://doi.org/10.1029/2020JA028452>`_
+
+* `F. Giannattasio, A. Pignalberi, P. De Michelis, I. Coco, G. Consolini, M. Pezzopane, R. Tozzi, Dependence of Parallel Electrical Conductivity in the Topside Ionosphere on Solar and Geomagnetic Activity, JGR Space Physics,  Volume126, Issue6 June 2021, https://agupubs.onlinelibrary.wiley.com/doi/10.1029/2021JA029138 <https://agupubs.onlinelibrary.wiley.com/doi/10.1029/2021JA029138>`_
+
+
 
 **Providers**:
 

docs/source/products/data/ingv_te_swarm_image.rst

-=========================================
+====================================
 INGV Swarm electron temperature maps
-=========================================
+====================================
 
 .. contents:: The tiny table of contents