Changes between Version 2 and Version 3 of Doc/Tools/Mosaix


Ignore:
Timestamp:
10/11/19 10:22:15 (3 years ago)
Author:
omamce
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Doc/Tools/Mosaix

    v2 v3  
    22[[PageOutline]] 
    33 
    4 MOSAIX is a small set of fortran routines, bash scripts, python scripts and xml files allowing to generate coupling weights for IPSL Earth System Model. It is under development, and presently not used by the production runs. It aims to replace the old MOSAIC software. It uses XIOS as a library to compute weights. In the present state, it can handle ORCA, LMDZ lon/lat and DYNAMICO grids. 
     4MOSAIX is a small set of fortran routines, bash scripts, python scripts and xml files allowing to generate coupling weights for IPSL Earth System Model. It replaces the old MOSAIC software. It uses XIOS as a library to compute weights. In the present state, it can handle ORCA, LMDZ lon/lat and DYNAMICO grids. 
    55 
    6 MOSAIX can generate 2^nd^ order conservative interpolation weights. They are used in place of bilinear interpolation by OASIS-MCT. 
     6MOSAIX can generate 1^st^ and 2^nd^ order conservative interpolation weights.  
    77 
    88As MOSAIX uses XIOS, it works in parallel, using MPI distributed memory.  
     
    1010== Compatibility with MOSAIC == 
    1111 
    12 * Weights are '''not''' compatible with the weights generated by MOSAIC. The precision of the interpolation (conservation) is improved. The ocean mask interpolated on the atmosphere grid is slighlty different. 
     12* Weights are '''not''' fully compatible with the weights generated by MOSAIC. The precision of the interpolation (conservation) is improved. The ocean mask interpolated on the atmosphere grid is slighlty different. 
    1313  
    1414* '''Run-off''' : runoff weights are computed with a different algorithm, the result can be quite different. 
    1515 
    16 * '''Calving''' : In IPSLCM6, the calving was integrated for each latitude of the grid on the LMDZ grid. Weights were use to aggregate several latitudes to compute an integral over a latitudinal band.. This is not possible with DYNAMICO, and was abandon for rectilinear LMD grid. The atmosphere model must the integral over a region (presently latitudinal bands). The final result should be the same as with MOSAIC. 
     16* '''Calving''' : In IPSLCM6, the calving was integrated for each latitude of the grid on the LMDZ grid. Weights were use to aggregate several latitudes to compute an integral over a latitudinal band.. This is not possible with DYNAMICO, and was abandon for rectilinear LMD grid. The atmosphere model must send the integral over a region (presently latitudinal bands). The final result should be the same as with MOSAIC. 
    1717 
    1818== TODO == 
    1919* Creates a non-masked grid for atmosphere, to compute integrals of run-off 
    20 * Creates 2^nd^ order interpolation weights that conserve posivity. They won't be conservative. 
     20* Creates 2^nd^ order interpolation weights that preserves posivity. They won't be conservative. 
     21 
     22== Future work == 
     23* Geographical distribution of the calving for the northern hemisphere. 
    2124 
    2225== Known problems == 
    2326* ?  
    24  
    25 == Future work == 
    26 * Geographical distribution of the calving for the northern hemisphere. 
    2727 
    2828== Code availability == 
     
    3535 
    3636== Requirements == 
    37 * Fortran compiler, C++ compiler, MPI. 
     37* Fortran compiler, C++ compiler, MPI library. 
    3838* A working [[http://forge.ipsl.jussieu.fr/ioserver|XIOS]] library. Revision 1615 is known to work. 
    3939* fcm version 1.2 
     
    4949All netCDF files have a detailed header. 
    5050* Weight files {{{rmp_*}}}. Should have a rather explicit name. The name is configurable at the beginning of {{{CreateWeightsMask.bash}}}. 
    51 * Diagnostic file used for debug {{{dia_*.nc}}} for each rmp file, except for runoff and calving. Debug information are directly in weight files in this last cases. 
     51* Diagnostic file used for debug {{{dia_*.nc}}} for each rmp file, except for runoff and calving. Debug information are directly in weight files in this last case. 
    5252* Grid description file for OASIS-MCT {{{grids.nc}}}, {{{areas.nc}}} and {{{masks.nc}}}. 
    5353* A file containing the fraction of ocean in each atmosphere grid box. For instance {{{ICO40_grid_maskFrom_eORCA1.2.nc}}}. 
     
    6262* '''update_xml.py'''. Python script used to perform on the fly editing of xml files. Used by {{{CreateWeights.bash}}}. More information with {{{python update_xml.py -h}}}. 
    6363 
    64 * '''iodef_atm_to_oce.xml''' and '''iodef_oce_to_atm.xml'''.  xml files read by {{{interpol.f90}}}. These files are edited by {{{update_xml.py}}}. 
     64* '''iodef_atm_to_oce.xml''' and '''iodef_oce_to_atm.xml'''. xml files read by {{{interpol.f90}}}. These files are edited by {{{update_xml.py}}}. 
    6565 
    6666* '''MOSAIX/src/MOSAIX/interpol.f90'''. Fortran source using the XIOS library.  
     
    9595* ''tlmd''. LMD rectilinear grid at scalar (physics) point. Masked on land, with area equal to grid box surface. 
    9696* ''tico''. LMD icosahedron grid at scalar (physics) point. Masked on land, with area equal to grid box surface. 
    97 * ''olmd''. LMD rectilinear grid at scalar (physics) point. Not masked,  with areas equal to 1. 
    98 * ''oico''. LMD icosahedron grid at scalar (physics) point. Not masked,  with areas equal to 1. 
     97* ''olmd''. LMD rectilinear grid at scalar (physics) point. Not masked,  with areas set to 1. 
     98* ''oico''. LMD icosahedron grid at scalar (physics) point. Not masked,  with areas set to 1. 
    9999* ''corc''. ORCA grid at ''T'' point. Masked on land, duplicated (from periodicity) point masked, with area equal to grid box surface. 
    100100* ''oorc''. ORCA grid at ''T'' point. Masked on land, duplicated (from periodicity) point masked, with area equal 1. 
     
    136136 * File {{{field_def_lmdz.xml}}} : 
    137137 
    138  
    139138{{{#!xml 
    140139<field_definition level="1" prec="4" operation="average" freq_op="1ts" enabled=".true." default_value="9.96921e+36" domain_ref="dom_glo">