Summary
MAPL3 now ships a field dictionary (geos_field_dictionary.yaml) that is
installed to $INSTALL_PREFIX/etc/ during cmake --install. At runtime,
MAPL3 looks for field_dictionary.yaml in the experiment run directory
(current working directory). If the file is absent, MAPL3 silently skips
dictionary lookups in PERMISSIVE mode (the default), so existing experiments
continue to work unchanged.
However, to actually benefit from dictionary-driven metadata (canonical
long_names, units, and default regrid methods for conserved fields), the
dictionary must be present in the run directory.
Required Change
During experiment setup (e.g., in the gcm_setup script or equivalent),
copy or symlink the installed dictionary into the run directory:
# In gcm_setup or lenkf.j / run script setup section:
ln -sf $INSTALL_PREFIX/etc/geos_field_dictionary.yaml $EXPDIR/field_dictionary.yaml
Or as a copy if symlinks are not appropriate for the file system:
cp $INSTALL_PREFIX/etc/geos_field_dictionary.yaml $EXPDIR/field_dictionary.yaml
Context
Acceptance Criteria
Summary
MAPL3 now ships a field dictionary (
geos_field_dictionary.yaml) that isinstalled to
$INSTALL_PREFIX/etc/duringcmake --install. At runtime,MAPL3 looks for
field_dictionary.yamlin the experiment run directory(current working directory). If the file is absent, MAPL3 silently skips
dictionary lookups in PERMISSIVE mode (the default), so existing experiments
continue to work unchanged.
However, to actually benefit from dictionary-driven metadata (canonical
long_names, units, and default regrid methods for conserved fields), the
dictionary must be present in the run directory.
Required Change
During experiment setup (e.g., in the
gcm_setupscript or equivalent),copy or symlink the installed dictionary into the run directory:
Or as a copy if symlinks are not appropriate for the file system:
Context
CMakeLists.txttoetc/geos_field_dictionary.yamllong_nameandunitsdefaults and to set default regrid methods forconserved fields (mixing ratios, mass fractions, etc.)
strictvalidation mode once allcomponent specs have been updated
Acceptance Criteria
gcm_setup(or equivalent) copies/linksgeos_field_dictionary.yamlinto the run directory as
field_dictionary.yamldefaults — it does not change values already specified in component specs)