feat: Add FES tide data for 2022

This commit adds a new file `fes_slev_2022.txt` containing FES tide data for the year 2022. The data includes the Julian day, hour, latitude, longitude, short tide, LP tide, pure tide, geo tide, and rad tide values. This data will be used for tide calculations in the application.

data/fes2022/README.md

@@ -0,0 +1,91 @@
+# CONTENTS
+
+## Configuration Files
+
+This directory contains the different configuration files to compute:
+
+* FES2022 elevations (ocean or geocentric)
+  * Use [ocean_tide.ini](ocean_tide.ini) to compute the ocean tide
+    with the native grids.
+  * Use [ocean_tide_extrapolated.ini](ocean_tide_extrapolated.ini)
+    to compute the ocean tide with the extrapolated grids.
+  * Use [load_tide.ini](load_tide.ini) to compute the load tide.
+* FES2022 currents
+    * Use [northward_velocity.ini](northward_velocity.ini) to use the
+      native grids.
+    * Use [eastward_velocity.ini](eastward_velocity.ini) to use the
+      native grids.
+
+> **_NOTE_**
+>
+> The configuration files are supplied for use with the tree as described
+> below.
+>
+> ```
+> data/
+> └── fes2022
+>     ├── eastward_velocity
+>     ├── load_tide
+>     ├── northward_velocity
+>     ├── ocean_tide
+>     └── ocean_tide_extrapolated
+>```
+
+## Database Contents
+
+The various sub directories located here are empty. Indeed, data necessary to
+calculate the different tides are not distributed here, but on the
+[AVISO](http://www.aviso.altimetry.fr/en/data/products/auxiliary-products/global-tide-fes/)
+website. You will find on the AVISO FTP server authenticated the following
+archives for filling empty directories:
+
+- eastward_velocity.tar.xz
+- load_tide.tar.xz
+- northward_velocity.tar.xz
+- ocean_tide.tar.xz
+- ocean_tide_extrapolated.tar.xz
+
+To allow you to download as small as possible archives, the archives have been
+compressed using the [xz](http://tukaani.org/xz) program using the LZMA2
+compression algorithms. To decompress the archive, you must use this command or
+[7-zip](http://www.7-zip.org/) if you use Windows.
+
+> **_NOTE_**
+>
+> The decompression of these archives will need 193 MiB of memory.
+
+## Database description
+
+The FES2022 tides database includes 3 components: Tide elevations, currents and
+loading. Each component contains 34 tidal components:
+
+    2N₂, J₁, K₁, K₂, L₂, MKS₂, MN₄, MS₄, Mf, Mm, Msf, Msqm, Mtm, M₂, M₃, M₄, M₆, M₈, N₂, N₄, O₁, P₁, P₁, R₂, Sa, Ssa, S₁, S₂, S₄, T₂, µ₂, ε₂, λ₂, ν₂
+
+### Tide Elevations
+
+FES2014b ocean tide model is distributed; this model has
+been computed using the new FES2022 tidal loading grids. Two versions
+are available:
+
+  * Non extrapolated version contained in the `ocean_tide.tar.xz` archive: the
+    model is defined on a 1/16° grid directly
+    interpolated from the finite element native grid of the model.
+
+  * Extrapolated version contained in the `ocean_tide_extrapolated.tar.xz`: the
+    above version has been extrapolated on the coasts in order to cover nearly
+    entirely the coastal regions. The procedure is a simple extrapolation
+    applied on 10 pixels and using mean values when necessary, it cannot be
+    accurate enough in some regions.
+
+### Tide Currents
+
+Tidal currents derived from FES2014a models are delivered on
+the 1/16° grid, directly interpolated from the finite element native grid.
+No extrapolation is done on the coasts of the currents. This database is
+contained in two separate archives: `eastward_velocity.tar.xz` and
+`northward_velocity.tar.xz`.
+
+### Tide Loading
+
+The new FES2014a tide loading is supplied on the same 1/16° grid. This
+dataset is provided into the `load_tide.tar.xz` archive.

data/fes2022/eastward_velocity.ini

@@ -0,0 +1,203 @@
+TIDE_2N2_FILE       = ./eastward_velocity/2n2_fes2022.nc
+TIDE_2N2_LATITUDE   = lat
+TIDE_2N2_LONGITUDE  = lon
+TIDE_2N2_AMPLITUDE  = Ua
+TIDE_2N2_PHASE      = Ug
+
+TIDE_EPS2_FILE      = ./eastward_velocity/eps2_fes2022.nc
+TIDE_EPS2_LATITUDE  = lat
+TIDE_EPS2_LONGITUDE = lon
+TIDE_EPS2_AMPLITUDE = Ua
+TIDE_EPS2_PHASE     = Ug
+
+TIDE_J1_FILE        = ./eastward_velocity/j1_fes2022.nc
+TIDE_J1_LATITUDE    = lat
+TIDE_J1_LONGITUDE   = lon
+TIDE_J1_AMPLITUDE   = Ua
+TIDE_J1_PHASE       = Ug
+
+TIDE_K1_FILE        = ./eastward_velocity/k1_fes2022.nc
+TIDE_K1_LATITUDE    = lat
+TIDE_K1_LONGITUDE   = lon
+TIDE_K1_AMPLITUDE   = Ua
+TIDE_K1_PHASE       = Ug
+
+TIDE_K2_FILE        = ./eastward_velocity/k2_fes2022.nc
+TIDE_K2_LATITUDE    = lat
+TIDE_K2_LONGITUDE   = lon
+TIDE_K2_AMPLITUDE   = Ua
+TIDE_K2_PHASE       = Ug
+
+TIDE_L2_FILE        = ./eastward_velocity/l2_fes2022.nc
+TIDE_L2_LATITUDE    = lat
+TIDE_L2_LONGITUDE   = lon
+TIDE_L2_AMPLITUDE   = Ua
+TIDE_L2_PHASE       = Ug
+
+TIDE_LAMBDA2_FILE       = ./eastward_velocity/lambda2_fes2022.nc
+TIDE_LAMBDA2_LATITUDE   = lat
+TIDE_LAMBDA2_LONGITUDE  = lon
+TIDE_LAMBDA2_AMPLITUDE  = Ua
+TIDE_LAMBDA2_PHASE      = Ug
+
+TIDE_M2_FILE        = ./eastward_velocity/m2_fes2022.nc
+TIDE_M2_LATITUDE    = lat
+TIDE_M2_LONGITUDE   = lon
+TIDE_M2_AMPLITUDE   = Ua
+TIDE_M2_PHASE       = Ug
+
+TIDE_M3_FILE        = ./eastward_velocity/m3_fes2022.nc
+TIDE_M3_LATITUDE    = lat
+TIDE_M3_LONGITUDE   = lon
+TIDE_M3_AMPLITUDE   = Ua
+TIDE_M3_PHASE       = Ug
+
+TIDE_M4_FILE        = ./eastward_velocity/m4_fes2022.nc
+TIDE_M4_LATITUDE    = lat
+TIDE_M4_LONGITUDE   = lon
+TIDE_M4_AMPLITUDE   = Ua
+TIDE_M4_PHASE       = Ug
+
+TIDE_M6_FILE        = ./eastward_velocity/m6_fes2022.nc
+TIDE_M6_LATITUDE    = lat
+TIDE_M6_LONGITUDE   = lon
+TIDE_M6_AMPLITUDE   = Ua
+TIDE_M6_PHASE       = Ug
+
+TIDE_M8_FILE        = ./eastward_velocity/m8_fes2022.nc
+TIDE_M8_LATITUDE    = lat
+TIDE_M8_LONGITUDE   = lon
+TIDE_M8_AMPLITUDE   = Ua
+TIDE_M8_PHASE       = Ug
+
+TIDE_MF_FILE        = ./eastward_velocity/mf_fes2022.nc
+TIDE_MF_LATITUDE    = lat
+TIDE_MF_LONGITUDE   = lon
+TIDE_MF_AMPLITUDE   = Ua
+TIDE_MF_PHASE       = Ug
+
+TIDE_MKS2_FILE      = ./eastward_velocity/mks2_fes2022.nc
+TIDE_MKS2_LATITUDE  = lat
+TIDE_MKS2_LONGITUDE = lon
+TIDE_MKS2_AMPLITUDE = Ua
+TIDE_MKS2_PHASE     = Ug
+
+TIDE_MM_FILE        = ./eastward_velocity/mm_fes2022.nc
+TIDE_MM_LATITUDE    = lat
+TIDE_MM_LONGITUDE   = lon
+TIDE_MM_AMPLITUDE   = Ua
+TIDE_MM_PHASE       = Ug
+
+TIDE_MN4_FILE       = ./eastward_velocity/mn4_fes2022.nc
+TIDE_MN4_LATITUDE   = lat
+TIDE_MN4_LONGITUDE  = lon
+TIDE_MN4_AMPLITUDE  = Ua
+TIDE_MN4_PHASE      = Ug
+
+TIDE_MS4_FILE       = ./eastward_velocity/ms4_fes2022.nc
+TIDE_MS4_LATITUDE   = lat
+TIDE_MS4_LONGITUDE  = lon
+TIDE_MS4_AMPLITUDE  = Ua
+TIDE_MS4_PHASE      = Ug
+
+TIDE_MSF_FILE       = ./eastward_velocity/msf_fes2022.nc
+TIDE_MSF_LATITUDE   = lat
+TIDE_MSF_LONGITUDE  = lon
+TIDE_MSF_AMPLITUDE  = Ua
+TIDE_MSF_PHASE      = Ug
+
+TIDE_MSQM_FILE      = ./eastward_velocity/msqm_fes2022.nc
+TIDE_MSQM_LATITUDE  = lat
+TIDE_MSQM_LONGITUDE = lon
+TIDE_MSQM_AMPLITUDE = Ua
+TIDE_MSQM_PHASE     = Ug
+
+TIDE_MTM_FILE       = ./eastward_velocity/mtm_fes2022.nc
+TIDE_MTM_LATITUDE   = lat
+TIDE_MTM_LONGITUDE  = lon
+TIDE_MTM_AMPLITUDE  = Ua
+TIDE_MTM_PHASE      = Ug
+
+TIDE_MU2_FILE       = ./eastward_velocity/mu2_fes2022.nc
+TIDE_MU2_LATITUDE   = lat
+TIDE_MU2_LONGITUDE  = lon
+TIDE_MU2_AMPLITUDE  = Ua
+TIDE_MU2_PHASE      = Ug
+
+TIDE_N2_FILE        = ./eastward_velocity/n2_fes2022.nc
+TIDE_N2_LATITUDE    = lat
+TIDE_N2_LONGITUDE   = lon
+TIDE_N2_AMPLITUDE   = Ua
+TIDE_N2_PHASE       = Ug
+
+TIDE_N4_FILE        = ./eastward_velocity/n4_fes2022.nc
+TIDE_N4_LATITUDE    = lat
+TIDE_N4_LONGITUDE   = lon
+TIDE_N4_AMPLITUDE   = Ua
+TIDE_N4_PHASE       = Ug
+
+TIDE_NU2_FILE       = ./eastward_velocity/nu2_fes2022.nc
+TIDE_NU2_LATITUDE   = lat
+TIDE_NU2_LONGITUDE  = lon
+TIDE_NU2_AMPLITUDE  = Ua
+TIDE_NU2_PHASE      = Ug
+
+TIDE_O1_FILE        = ./eastward_velocity/o1_fes2022.nc
+TIDE_O1_LATITUDE    = lat
+TIDE_O1_LONGITUDE   = lon
+TIDE_O1_AMPLITUDE   = Ua
+TIDE_O1_PHASE       = Ug
+
+TIDE_P1_FILE        = ./eastward_velocity/p1_fes2022.nc
+TIDE_P1_LATITUDE    = lat
+TIDE_P1_LONGITUDE   = lon
+TIDE_P1_AMPLITUDE   = Ua
+TIDE_P1_PHASE       = Ug
+
+TIDE_Q1_FILE        = ./eastward_velocity/q1_fes2022.nc
+TIDE_Q1_LATITUDE    = lat
+TIDE_Q1_LONGITUDE   = lon
+TIDE_Q1_AMPLITUDE   = Ua
+TIDE_Q1_PHASE       = Ug
+
+TIDE_R2_FILE        = ./eastward_velocity/r2_fes2022.nc
+TIDE_R2_LATITUDE    = lat
+TIDE_R2_LONGITUDE   = lon
+TIDE_R2_AMPLITUDE   = Ua
+TIDE_R2_PHASE       = Ug
+
+TIDE_S1_FILE        = ./eastward_velocity/s1_fes2022.nc
+TIDE_S1_LATITUDE    = lat
+TIDE_S1_LONGITUDE   = lon
+TIDE_S1_AMPLITUDE   = Ua
+TIDE_S1_PHASE       = Ug
+
+TIDE_S2_FILE        = ./eastward_velocity/s2_fes2022.nc
+TIDE_S2_LATITUDE    = lat
+TIDE_S2_LONGITUDE   = lon
+TIDE_S2_AMPLITUDE   = Ua
+TIDE_S2_PHASE       = Ug
+
+TIDE_S4_FILE        = ./eastward_velocity/s4_fes2022.nc
+TIDE_S4_LATITUDE    = lat
+TIDE_S4_LONGITUDE   = lon
+TIDE_S4_AMPLITUDE   = Ua
+TIDE_S4_PHASE       = Ug
+
+TIDE_SA_FILE        = ./eastward_velocity/sa_fes2022.nc
+TIDE_SA_LATITUDE    = lat
+TIDE_SA_LONGITUDE   = lon
+TIDE_SA_AMPLITUDE   = Ua
+TIDE_SA_PHASE       = Ug
+
+TIDE_SSA_FILE       = ./eastward_velocity/ssa_fes2022.nc
+TIDE_SSA_LATITUDE   = lat
+TIDE_SSA_LONGITUDE  = lon
+TIDE_SSA_AMPLITUDE  = Ua
+TIDE_SSA_PHASE      = Ug
+
+TIDE_T2_FILE        = ./eastward_velocity/t2_fes2022.nc
+TIDE_T2_LATITUDE    = lat
+TIDE_T2_LONGITUDE   = lon
+TIDE_T2_AMPLITUDE   = Ua
+TIDE_T2_PHASE       = Ug