Ocean, Sea Ice and Iceberg Observations

The [oceanObservations], [seaIceObservations] and [icebergObservations] sections of a configuration file contain options used to point to the observations files and folders:

[oceanObservations]
## options related to ocean observations with which the results will be compared

# directory where ocean observations are stored
obsSubdirectory = observations/Ocean
sstSubdirectory = SST
sssSubdirectory = SSS
mldSubdirectory = MLD
ninoSubdirectory = Nino
mhtSubdirectory = MHT
meltSubdirectory = Melt
soseSubdirectory = SOSE
sshSubdirectory = SSH
argoSubdirectory = ARGO
schmidtkoSubdirectory = Schmidtko

# interpolation order for observations. Likely values are
#   'bilinear', 'neareststod' (nearest neighbor) or 'conserve'
interpolationMethod = bilinear

# The directories where observation climatologies will be stored if they need
# to be computed.  If a relative path is supplied, it is relative to the output
# base directory.  If an absolute path is supplied, this should point to
# cached climatology files on the desired comparison grid.  If cached remapped
# files are supplied, there is no need to provide cached files before
# remapping.
climatologySubdirectory = clim/obs
remappedClimSubdirectory = clim/obs/remapped

...

[seaIceObservations]
## options related to sea ice observations with which the results will be
## compared

# directory where sea ice observations are stored
obsSubdirectory = observations/SeaIce

# interpolation order for observations. Likely values are
#   'bilinear', 'neareststod' (nearest neighbor) or 'conserve'
interpolationMethod = bilinear

# The directories where observation climatologies will be stored if they need
# to be computed.  If a relative path is supplied, it is relative to the output
# base directory.  If an absolute path is supplied, this should point to
# cached climatology files on the desired comparison grid.  If cached remapped
# files are supplied, there is no need to provide cached files before
# remapping.
climatologySubdirectory = clim/obs
remappedClimSubdirectory = clim/obs/remapped

...

[icebergObservations]
## options related to iceberg observations with which the results will be
## compared

# directory where sea ice observations are stored
obsSubdirectory = observations/Icebergs
concentrationAltibergSH = Altiberg/Altiberg_1991-2017_20180308.nc

Files and Directories

The input directories are specified through a “base” subdirectory obsSubdirectory and either subdirectories or file names for each set of observations. obsSubdirectory is relative to baseDirectory in the diagnostics section, while all file paths and other subdirectories are relative to obsSubdirectory. You will typically not need to change any of these paths, since they are structured in a standard way following the E3SM public data repository (see the Quick Start Guide for more details).

The directories for storing cached datasets before and afer remapping (specified in climatologySubdirectory and remappedClimSubdirectory) may be given any relative or absoltue path, but should typically be left as the default values.

Remapping

Observational climatologies are remapped from the native grid (typically global latitude/longitude or Antarctic stereographic) to common comparison grids. The remapping can be performed with any of three methods: bilinear, neareststod (nearest neighbor) or conserve. Mapping files are created with the ESMF_RegridWeightGen tool. The default method is bilinear and these are the mapping files distributed from the E3SM public data repository. The conseve method is know to be much slower to compute and should only be used if it is necessary (e.g. because remapped data will be checked for conservation).