Changes between Version 14 and Version 15 of user/lovato/cfgrst

Timestamp:

2018-12-04T15:55:55+01:00 (5 years ago)

Author:

lovato

Comment:

--

user/lovato/cfgrst

@@ -31 +31 @@
 ====================== ===== ===== ===== ======== ======= ================================================
 
-**How to create an experiment from a reference configuration**
-
-makenemo bla bla bla
-
-
+**How to compile an experiment from a reference configuration**
+
+A user who wants to compile the ORCA2_ICE_PISCES_ reference configuration using makenemo should use the following, by selecting among available architecture file or providing a user defined one:
+
+
+.. code-block:: console
+                
+        $ ./makenemo -r 'ORCA2_ICE_PISCES' -m 'my-fortran.fcm' -j '4'
+
+A new EXP00 folder will be created within the selected reference configurations, namely ``trunk/cfgs/ORCA2_ICE_PISCES/EXP00``, where it will be necessary to uncompress the Input & Forcing Files listed in the above table.
+
+Then it will be possible to launch the execution of the model through a runscript (opportunely adapted to the user system).
 
 AGRIF_DEMO
@@ -128 +135 @@
 ----------------
 
-ORCA is the generic name given to global ocean configurations.
-Its specificity lies on the horizontal curvilinear mesh used to overcome the North Pole singularity found for
-geographical meshes.
-SI3 (Sea Ice Integrated Initiative) is a thermodynamic-dynamic sea ice model specifically designed for
-climate studies.
-A brief description of the model is given here.
-
-:underline:`Space-time domain`
-
-The horizontal resolution available through the standard configuration is ORCA2.
-It is based on a 2 degrees Mercator mesh, (i.e. variation of meridian scale factor as cosinus of the latitude).
-In the northern hemisphere the mesh has two poles so that the ratio of anisotropy is nearly one everywhere.
-The mean grid spacing is about 2/3 of the nominal value: for example it is 1.3 degrees for ORCA2.
-Other resolutions (ORCA4, ORCA05 and ORCA025) are running or under development within specific projects.
-In the coarse resolution version (i.e. ORCA2 and ORCA4) the meridional grid spacing is increased near
-the equator to improve the equatorial dynamics.
-Figures in pdf format of mesh and bathymetry can be found and downloaded here.
-The sea-ice model runs on the same grid.
-
-The vertical domain spreads from the surface to a depth of 5000m.
-There are 31 levels, with 10 levels in the top 100m.
-The vertical mesh is deduced from a mathematical function of z ([[AttachmentNum(1)]]).
-The ocean surface corresponds to the w-level k=1, and the ocean bottom to the w-level k=31.
-The last T-level (k=31) is thus always in the ground.The depths of the vertical levels and
-the associated scale factors can be viewed.
-Higher vertical resolution is used in ORCA025 and ORCA12 (see `DRAKKAR project <http://www.drakkar-ocean.eu>`_).
-
-The time step depends on the resolution. It is 1h36' for ORCA2 so that there is 15 time steps in one day.
-
-:underline:`Ocean Physics (for ORCA2)`
-
-- horizontal diffusion on momentum: the eddy viscosity coefficient depends on the geographical position.
-  It is taken as 40000 $m^2/s$, reduced in the equator regions (2000 $m^2/s$) excepted near the western boundaries.
-- isopycnal diffusion on tracers: the diffusion acts along the isopycnal surfaces (neutral surface) with
-  a eddy diffusivity coefficient of 2000 $m^2/s$.
-- Eddy induced velocity parametrization with a coefficient that depends on the growth rate of
-  baroclinic instabilities (it usually varies from 15 $m^2/s$ to 3000 $m^2/s$).
-- lateral boundary conditions : zero fluxes of heat and salt and no-slip conditions are applied through
-  lateral solid boundaries.
-- bottom boundary condition : zero fluxes of heat and salt are applied through the ocean bottom.
+ORCA2_ICE_PISCES is a reference configuration for the global ocean with a 2°x2° curvilinear horizontal mesh and 31 vertical levels, distributed using z-coordinate system and with 10 levels in the top 100m.
+ORCA is the generic name given to global ocean Mercator mesh, (i.e. variation of meridian scale factor as cosinus of the latitude), with two poles in the northern hemisphere so that the ratio of anisotropy is nearly one everywhere
+
+In this configuration, the ocean dynamical core  is coupled to  
+
+- **ICE**, namely SI3 (Sea Ice Integrated Initiative) a thermodynamic-dynamic sea ice model specifically designed for climate studies.
+- **TOP**, passive tracer transport module and `PISCES biogeochemical model`_
+
+All components share the same grid.
+
+The model is forced with CORE-II normal year atmospheric forcing and it uses the NCAR bulk formulae.
+
+**Ocean Physics configuration**
+
+- *horizontal diffusion on momentum*: the eddy viscosity coefficient depends on the geographical position. It is taken as 40000 m^2/s, reduced in the equator regions (2000 m^2/s) excepted near the western boundaries.
+- *isopycnal diffusion on tracers*: the diffusion acts along the isopycnal surfaces (neutral surface) with an eddy diffusivity coefficient of 2000 m^2/s.
+- *Eddy induced velocity parametrization* with a coefficient that depends on the growth rate of baroclinic instabilities (it usually varies from 15 m^2/s to 3000 m^2/s).
+- *lateral boundary conditions* : zero fluxes of heat and salt and no-slip conditions are applied through lateral solid boundaries.
+- *bottom boundary condition* : zero fluxes of heat and salt are applied through the ocean bottom.
   The Beckmann [19XX] simple bottom boundary layer parameterization is applied along continental slopes.
   A linear friction is applied on momentum.
-- convection: the vertical eddy viscosity and diffusivity coefficients are increased to 1 $m^2/s$ in case of
-  static instability.
-- forcings: the ocean receives heat, freshwater, and momentum fluxes from the atmosphere and/or the sea-ice.
-  The solar radiation penetrates the top meters of the ocean.
-  The downward irradiance I(z) is formulated with two extinction coefficients [Paulson and Simpson, 1977],
-  whose values correspond to a Type I water in Jerlov's classification (i.e the most transparent water)
-
-ORCA2_ICE_PISCES is a reference configuration with the following characteristics:
-
-- global ocean configuration
-- based on a tri-polar ORCA grid, with a 2° horizontal resolution
-- 31 vertical levels
-- forced with climatological surface fields
-- coupled to the sea-ice model SI3.
-- coupled to TOP passive tracer transport module and `PISCES biogeochemical model`_.
-
-:underline:`AGRIF demonstrator`
-
-| From the ``ORCA2_ICE_PISCES`` configuration, a demonstrator using AGRIF nesting can be activated.
-  It includes the global ``ORCA2_ICE_PISCES`` configuration and a nested grid in the Agulhas region.
-| To set up this configuration, after extracting NEMO:
-
-- Build your AGRIF configuration directory from ORCA2_ICE_PISCES, with the key_agrif CPP key activated:
+- *convection*: the vertical eddy viscosity and diffusivity coefficients are increased to 1 m^2/s in case of static instability.
+- *time step* is 5760sec (1h36') so that there is 15 time steps in one day.
+
+
+
+**AGRIF demonstrator**
+
+From the ORCA2_ICE_PISCES configuration, a demonstrator using AGRIF nesting can be activated that includes a nested grid in the Agulhas region.
+
+To set up this configuration, after extracting NEMO:
+
+Build your AGRIF configuration directory from ORCA2_ICE_PISCES, with the key_agrif CPP key activated:
 
 .. code-block:: console
@@ -198 +173 @@
         $ ./makenemo -r 'ORCA2_ICE_PISCES' -n 'AGRIF' add_key 'key_agrif'
 
-- Using the ``ORCA2_ICE_PISCES`` input files and namelist, AGRIF test configuration is ready to run
-
-:underline:`On-The-Fly Interpolation`
-
-| NEMO allows to use the interpolation on the fly option allowing to interpolate input data during the run.
-  If you want to use this option you need files giving informations on weights, which have been created.
-| You can find at http://prodn.idris.fr/thredds/catalog/ipsl_public/reee512/ORCA2_ONTHEFLY/WEIGHTS/catalog.html
-  2 weights files `bil_weights` for scalar field (bilinear interpolation) and `bic_weights` for
-  vector field (bicubic interpolation).
-| The data files used are `COREII forcing <http://data1.gdfl.noaa.gov/nomads/forms/mom4/COREv2>`_ extrapolated on
-  continents, ready to be used for on the fly option:
-  `COREII`_ forcing files extrapolated on continents
+By using the input files and namelists for ORCA2_ICE_PISCES, the AGRIF test configuration is ready to run.
+
 
 ORCA2_OFF_PISCES