Adding fix for ORAS5

doc/develop/fixing_data.rst

@@ -467,6 +467,8 @@ it is CMOR-compliant), use :ref:`dataset fixes <fixing_data>`.
 This is where the actual CMORization takes place.
 For example, a ``native6`` dataset fix for ERA5 is located `here
 <https://github.com/ESMValGroup/ESMValCore/blob/main/esmvalcore/cmor/_fixes/native6/era5.py>`__,
+the ORAS5 fix is located `here
+<https://github.com/ESMValGroup/ESMValCore/blob/main/esmvalcore/cmor/_fixes/native6/oras5.py>`__,
 and the ``ICON`` fix is located `here
 <https://github.com/ESMValGroup/ESMValCore/blob/main/esmvalcore/cmor/_fixes/icon/icon.py>`__.
 

doc/quickstart/find_data.rst

@@ -242,6 +242,33 @@ For more info: http://www.gloh2o.org/
 
 Data for the version ``V220`` can be downloaded from: https://hydrology.princeton.edu/data/hylkeb/MSWEP_V220/.
 
+.. _read_native_oras5:
+
+ORAS5
+^^^^^
+
+ORAS5 data can be downloaded in netCDF from the Copernicus Climate Data Store
+`(CDS) <https://cds.climate.copernicus.eu/datasets/reanalysis-oras5?tab=download>`__.
+Place the files in the ``/Tier3/ORAS5/single_levels`` or ``/Tier3/ORAS5/all_levels``
+subdirectory (depending on whether it is 2D or 3D data) of your ``rootpath`` that you have
+configured for the ``native6`` project (assuming you are using the default DRS
+for ``native6`` described :ref:`above <read_native_obs>`).
+
+- Supported variables: ``uo``, ``vo``, ``tos``, ``sos``, ``zos``, ``mlotst``,
+  ``thetao``, ``so``, ``hfds``, ``tauuo``.
+- Tier: 3
+
+.. note:: For ORAS5 you need the grid files to read the data properly, which
+  can be downloaded `here <https://nc.uni-bremen.de/public.php/dav/files/nJBXTYbQe5diPof/?accept=zip>`__.
+  Be aware that for the variables ``uo``, and ``tauuo`` you need to use the
+  ``oras5_mesh_u.nc`` grid and for the variable ``vo`` the ``oras5_mesh_v.nc``
+  grid, respectively. For all other supported variables you need the
+  ``oras5_mesh_T.nc`` grid file.
+
+.. note:: For ORAS5 the rotated meridional and zonal velocities are available.
+  Per default ESMValCore expects that you use those. Otherwise, you need to specify
+  the ``raw_name`` of the unrotated velocities in the recipe.
+
 .. _read_native_models:
 
 Supported native models