Changeset 7695 for branches/2016/dev_merge_2016/NEMOGCM/TOOLS/DOMAINcfg/README

Timestamp:

2017-02-17T16:54:43+01:00 (7 years ago)

Author:

flavoni

Message:

update README for DOMAINcfg tool

File:

• branches/2016/dev_merge_2016/NEMOGCM/TOOLS/DOMAINcfg/README (modified) (4 diffs)

branches/2016/dev_merge_2016/NEMOGCM/TOOLS/DOMAINcfg/README

@@ -13 +13 @@
 = HOW TO RUN
 ================================
-just run :
+and just run according your architecture :
 :::::::::::::::::::::::::::::::::::::::::::::::::
-./make_domain_cfg.exe
+run in mpi mode with just 1 proc; example for IBM
+poe ./make_domain_cfg.exe -proc 1
 :::::::::::::::::::::::::::::::::::::::::::::::::
 NOTA: it can be run in multiproc mode, but in output there will be domain_cfg_00xx.nc files
@@ -28 +29 @@
    DOMAINcfg tool is working with revision 703 of xios)
 
-1) copy in DOMAINcfg  directory namelist_cfg all settings (that you had in 3.6_stable) of the configuration for which you want prepare domain_cfg.nc file
-IMPORTANT : keep the namelist_ref committed inchanged. 
+ VERY IMPORTANT : keep the namelist_ref committed inchanged!!!
+1) in DOMAINcfg directory: 
+   
+   - open namelist_cfg 
+   - copy "namcfg" block from your 3.6_stable namelist 
+   - copy "domzgr" block (and namzgr_sco block if ln_sco = .true.) from your 3.6_stable namelist
+   - copy "namdom" block from your 3.6_stable namelist
+   - copy ln_e3_dep from namelist_ref into namelist_cfg in "namcfg" block and set the value you want :
 
-NEW OPTION ln_e3_dep in the namelist_ref:
-till nemo_v3.6_stable e3 were done like an analytical derivative of depth function
-now  e3=dk[depth] in discret sens
-
-If you want to create same e3[tuvw] like 3.6 you've to use "ln_e3_dep=.false."
-
- ln_e3_dep   = .true.    ! =T : e3=dk[depth] in discret sens.
+   ln_e3_dep   = .true.    ! =T : e3=dk[depth] in discret sens.
    !                       !      ===>>> will become the only possibility in v4.0
    !                       ! =F : e3 analytical derivative of depth function
@@ -43 +44 @@
    !
 
-2) copy in DOMAINcfg directory same input files (of related configuration) required in v3.6_stable.
+Use ln_e3_dep=.false. : To create same e3[tuvw] like 3.6 (e3 were done like an analytical derivative of depth function)
+
+Use ln_e3_dep=.true.  : To create e3=dk[depth] in discret sens
+
+3) copy in DOMAINcfg directory same input files (of related configuration) required in v3.6_stable.
 
 DOMAINcfg package is EXACTLY what does exist in NEMO version 3.6 to define a model domain (both domain related namelist and initialization).
@@ -72 +77 @@
             field_def.xml
             iodef.xml
+
+4) verify that bathymetry created here (variable "bottom_level" in domain_cfg.nc) and your old bathymetry (variable "mbathy" in mesh_mask.nc) are the same if ln_e3_dep=F: 
+ncks -v bottom_level domain_cfg.nc new.nc
+ncks -v mbathy mesh_mask.nc old.nc
+ncrename -v mbathy,bottom_level old.nc
+ncdiff new.nc old.nc test_diff.nc
+
+Nota bene: if ln_e3_dep=T is used, it is ok to have few differences as long as it does not affect the boundaries (in a closed domain)
+