= Setup a new configuration

[[PageOutline(2)]]

Last edition: '''[[Wikinfo(changed_ts)]]''' by '''[[Wikinfo(changed_by)]]'''

== Starting from an existing one

To create and compile a new configuration starting from a reference configuration (ORCA_LIM3 in the following example)[[BR]]
{{{
makenemo –n ORCA_LIM3_MYCONFIG -r ORCA_LIM3
}}}
[[BR]]
To create and compile a new configuration starting from a reference configuration (ORCA_LIM3 in the following example) and add (''add_key'') or remove (''del_key'') key:[[BR]]
{{{
makenemo –n ORCA2_LIM3_MYCONFIG -r ORCA2_LIM3 del_key "key_iomput" (and answer)
}}}
[[BR]]

== Use of SIREN for a regional configuration

This software called SIREN, allows you to set up regional configuration of NEMO.[[BR]]

The software is written in FORTRAN95 and available in the NEMOGCM/TOOLS directory of nemo_v3_6_STABLE (since revision 6468).[[BR]]
 
SIREN allows you to create your own regional configuration embedded in a wider one.[[BR]]

Actually SIREN is a set of programs to create the input files you need to run a NEMO regional configuration.[[BR]]
    
As demonstrator for a first start, a set of GLORYS files (global reanalysis on ORCA025 grid), as well as examples of namelists are available [http://prodn.idris.fr/thredds/catalog/ipsl_public/rron463/catalog.html?dataset=DatasetScanipsl_public/rron463/INPUT_SIREN.tar here].[[BR]]

SIREN documentation: [/doxygen/index.html# here]. [[BR]]

Forum : Please post your questions or comments regarding the use of SIREN in the NEMO configuration manager forum [/discussion/forum/2 here].[[BR]]



== Others Pre-processing utilities

[[PageOutline(3, , inline, unnumbered)]]

=== AGRIF nesting tool
[/wiki/Users/SetupNewConfiguration/AGRIF-nesting-tool How to create ] the grid coordinates, the surface forcing and the initial conditions required by each child model.

=== Data interpolation with [http://www.mpimet.mpg.de/fileadmin/software/cdo/ cdo]
The aim is to remap from/to a regular geographic grid to/from an other curvilinear grid, especially the ORCA one. see [/wiki/Users/SetupNewConfiguration/cdo-interpolation here].

=== Data compression
For netdcf files: [/wiki/Users/SetupNewConfiguration/Data-utilities-with-netcdf example] for COREII forcing files.

=== Weight creation for online interpolation
See [/wiki/Users/SetupNewConfiguration/Weight-creator here] and [/wiki/Users/SetupNewConfiguration/cdo-interpolation here].

=== Bathymetry
[/wiki/Users/SetupNewConfiguration/OPABAT OPABAT] is a group of Fortran and IDL routines which allows to build a bathymetry on the grid of the dynamical oceanic part, OPA.

=== Data interpolation
The aim is to remap from a regular geographic grid to an other curvilinear grid, especially the ORCA one. It will be provide by [http://sosie.sourceforge.net/ SOSIE]

=== Setting up MPP configuration tool
This Fortran based tool provides to the user information to choose the best domain decomposition. The proposed solution will be the one with an optimized number of processos in suppressing eventual useless land processors.
* Documentation: [attachment:wiki:Users/SetupNewConfiguration:mpp_nc.pdf mpp_nc.pdf]
* Tar file     : [attachment:wiki:Users/SetupNewConfiguration:mpp_prep-1.0.tar.gz mpp_prep-1.0.tar.gz]

=== Conversion of restart files
This Fortran based tool performs light changes on restart files (NetCDF or DIMG format) to ensure their compatibility with the new IOM package in the standard version of NEMO i.e. since the tag nemo_v2 and later: [attachment:wiki:Users/SetupNewConfiguration:Chge_Rst_files.tar Chge_Rst_files.tar]

=== ORCA grids generator
This Fortran based tool allows to generate an ORCA grid type: [attachment:wiki:Users/SetupNewConfiguration:gridgen_CECILL.tar gridgen_CECILL.tar]