New URL for NEMO forge!   http://forge.nemo-ocean.eu

Since March 2022 along with NEMO 4.2 release, the code development moved to a self-hosted GitLab.
This present forge is now archived and remained online for history.
ticket/0859/Review (diff) – NEMO

Changes between Version 1 and Version 2 of ticket/0859/Review


Ignore:
Timestamp:
2011-10-10T17:03:53+02:00 (13 years ago)
Author:
acc
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • ticket/0859/Review

    v1 v2  
    2727'''namelist''' 
    2828 
    29   changes are largely in place but at least one new variable is incorrectly named: ln_ascii exists in the namelists but exists as `ln_flo_ascii`     in the code. This discrepancy calls into question the level of testing since the presence of an undeclared namelist variable should cause a runtime error. Probably last minute style changes were made after testing? 
     29  changes are largely in place but at least one new variable is incorrectly named: ln_ascii exists in the namelists but exists as `ln_flo_ascii`          in the code. This discrepancy calls into question the level of testing since the presence of an undeclared namelist variable should cause a runtime error. Probably last minute style changes were made after testing? 
    3030 
    3131'''iodef.xml''' changes have been made but only to the GYRE and ORCA2_LIM configurations. Changes should be made in all cases. 
     
    4545'''flodom.F90''' 
    4646 
    47   Observation: We need a new code convention for namelist variables that have replaced parameters. jpnfl, jpnewflo and jpnrstflo are not parameters and therefore shouldn't start with jp. However, the same can be said of jpni, jpnj jpnij etc. so this is not the time to impose a change. To be discussed at the developer's meeting?  
    48   naming convention for contained subroutines? Should they all start with flo_?: flo_add_new_floats, flo_add_new_ariane_floats, flo_findmesh, flo_dstnce  
    49   Policy on allocatable vs automatic?. add_new_floats assumes automatic arrays: iimfl, ijmfl, ikmfl etc. should these be allocatable, allocated on first call and saved?  
    50   constants should have the _wp precision appended (e.g. constants in dstnce)  
     47  Observation: We need a new code convention for namelist variables that have replaced parameters. jpnfl, jpnewflo and jpnrstflo are not parameters and therefore shouldn't start with jp. However, the same can be said of jpni, jpnj jpnij etc. so this is not the time to impose a change. To be discussed at the developer's meeting?. 
     48 
     49  naming convention for contained subroutines? Should they all start with flo_?: flo_add_new_floats, flo_add_new_ariane_floats, flo_findmesh, flo_dstnce  
     50 
     51  Policy on allocatable vs automatic?. add_new_floats assumes automatic arrays: iimfl, ijmfl, ikmfl etc. should these be allocatable, allocated on first call and saved?. 
     52 
     53  constants should have the _wp precision appended (e.g. constants in dstnce)  
     54 
    5155  minor: #    else at line 446 needs aligning correctly 
    5256 
     
    5761  automatic vs allocatable again. iproc is automatic. iproc is also a bad choice of name (used in lib_mpp and OBS to hold processor number). Perhaps iperproc would be better? blabla.. comments at the top need to be replaced with something meaningful 
    5862 
    59 '''[wiki:TexFiles/Chapters/Chap Chap]_DIA.tex''' 
     63'''CHAP_DIA.tex''' 
    6064 
    61   Finally, the documentation is inadequate. Several of the new namelist variables are not described and this is a missed opportunity to expand this section beyond the original, placeholder paragraph.  The relationship between jpnfl and jpnewflo is not explained and the logical of ln_ascii (or rather ln_flo_ascii)  appears to be inverted. One would expect ln_flo_ascii (T) to provide ascii output and (F) to be the new (default) netcdf option. Check comments and use of ln_flo_ascii in documentation and code. 
     65  Finally, the documentation is inadequate. Several of the new namelist variables are not described and this is a missed opportunity to expand this section beyond the original, placeholder paragraph.  The relationship between jpnfl and jpnewflo is not explained and the logic of ln_ascii (or rather ln_flo_ascii)  appears to be inverted. One would expect ln_flo_ascii (T) to provide ascii output and (F) to be the new (default) netcdf option. Check comments and use of ln_flo_ascii in documentation and code. 
    6266 
    6367=== Code Review ===