From a8dfe250834b9e6e866bc0d0271131e945c91e03 Mon Sep 17 00:00:00 2001 From: gaelforget Date: Fri, 20 Jan 2017 16:48:00 -0500 Subject: [PATCH] bring up to date (almost...) --- code/EXF_OPTIONS.h | 249 ++++++++++++++++++++++++--------------------- 1 file changed, 134 insertions(+), 115 deletions(-) diff --git a/code/EXF_OPTIONS.h b/code/EXF_OPTIONS.h index b47c3fc..f1c6d80 100644 --- a/code/EXF_OPTIONS.h +++ b/code/EXF_OPTIONS.h @@ -29,137 +29,153 @@ C are specific to this package are assumed to be set in ECCO_CPPOPTIONS.h C-- Package-specific Options & Macros go here -c pkg/exf CPP options: -c -------------------- -c -c > ( EXF_VERBOSE ) < replaced with run-time, logical parameter "exf_verbose". -c -c >>> ALLOW_ATM_WIND <<< -c If defined, 10-m wind fields can be read-in from files. -c -c >>> ALLOW_ATM_TEMP <<< -c If defined, atmospheric temperature and specific -c humidity fields can be read-in from files. -c -c >>> ALLOW_DOWNWARD_RADIATION <<< -c If defined, downward long-wave and short-wave radiation -c can be read-in form files or computed from lwflux and swflux. -c -c >>> ALLOW_ZENITHANGLE <<< -c If defined, ocean albedo varies with the zenith angle, and -c incoming fluxes at the top of the atmosphere are computed -c -c >>> ALLOW_BULKFORMULAE <<< -c Allows the use of bulk formulae in order to estimate -c turbulent and radiative fluxes at the ocean surface. -c -c >>> EXF_READ_EVAP <<< -c If defined, evaporation fields are read-in, rather than -c computed from atmospheric state. -c -c >>> ALLOW_RUNOFF <<< -c If defined, river and glacier runoff can be read-in from files. -c -c >>> ATMOSPHERIC_LOADING <<< -c If defined, atmospheric pressure can be read-in from files. -c WARNING: this flag is set (define/undef) in CPP_OPTIONS.h -c and cannot be changed here (in EXF_OPTIONS) -c -c >>> ICE_AREAMASK <<< -c If defined, fractional ice-covered area MASK can be read-in from files. -c -c >>> ALLOW_CLIMSST_RELAXATION <<< -c Allow the relaxation to a monthly climatology of sea surface -c temperature, e.g. the Reynolds climatology. -c -c >>> ALLOW_CLIMSSS_RELAXATION <<< -c Allow the relaxation to a monthly climatology of sea surface -c salinity, e.g. the Levitus climatology. -c -c >>> USE_EXF_INTERPOLATION <<< -c Allows specification of arbitrary Cartesian input grids. -c -c ==================================================================== -c -c The following CPP options: -c -c ALLOW_ATM_WIND (WIND) -c ALLOW_ATM_TEMP (TEMP) -c ALLOW_DOWNWARD_RADIATION (DOWN) -c ALLOW_BULKFORMULAE (BULK) -c EXF_READ_EVAP (EVAP) -c -c permit the ocean-model forcing configurations listed in the -c table below. The first configuration is the default, -c flux-forced, ocean model. The next four are stand-alone -c configurations that use pkg/exf, open-water bulk formulae to -c compute the missing surface fluxes from atmospheric variables. -c The last four configurations can be used in conjunction with -c pkg/seaice to model ice-covered regions. The forcing fields -c in the rightmost column are defined in exf_fields. -c -c -c WIND |TEMP |DOWN |BULK |EVAP | actions -c -----|-----|-----|-----|-----|------------------------------------- -c | | | | | -c - | - | - | - | - | Read-in ustress, vstress, hflux, -c | | | | | swflux, and sflux. -c | | | | | -c def | def | def | def | - | Read-in uwind, vwind, atemp, aqh, -c | | | | | swdown, lwdown, precip, and runoff. -c | | | | | Compute ustress, vstress, hflux, -c | | | | | swflux, and sflux. -c | | | | | -c def | def | - | def | - | Read-in uwind, vwind, atemp, aqh, -c | | | | | swflux, lwflux, precip, and runoff. -c | | | | | Compute ustress, vstress, hflux, -c | | | | | and sflux. -c | | | | | -c def | - | - | def | - | Read-in uwind, vwind, hflux, -c | | | | | swflux, and sflux. -c | | | | | Compute ustress and vstress. -c | | | | | -c - | def | - | def | - | Read-in ustress, vstress, atemp, -c | | | | | aqh, swflux, lwflux, precip, and -c | | | | | runoff. Compute hflux and sflux. -c | | | | | -c def | def | - | - | def | Read-in uwind, vwind, atemp, aqh, -c | | | | | swflux, lwflux, precip, runoff, -c | | | | | and evap. -c | | | | | -c def | def | - | def | - | Read-in uwind, vwind, atemp, aqh, -c | | | | | swflux, lwflux, precip, and runoff. -c | | | | | Compute open-water ustress, vstress, -c | | | | | hflux, swflux, and evap. -c | | | | | -c def | def | def | - | def | Read-in uwind, vwind, atemp, aqh, -c | | | | | swdown, lwdown, precip, runoff, -c | | | | | and evap. -c | | | | | -c def | def | def | def | - | Read-in uwind, vwind, atemp, aqh, -c | | | | | swdown, lwdown, precip, and runoff. -c | | | | | Compute open-water ustress, vstress, -c | | | | | hflux, swflux, and evap. -c -c ==================================================================== +C pkg/exf CPP options: +C -------------------- +C +C > ( EXF_VERBOSE ) < replaced with run-time, logical parameter "exf_verbose". +C +C >>> ALLOW_ATM_WIND <<< +C If defined, 10-m wind fields can be read-in from files. +C +C >>> ALLOW_ATM_TEMP <<< +C If defined, atmospheric temperature and specific +C humidity fields can be read-in from files. +C +C >>> ALLOW_DOWNWARD_RADIATION <<< +C If defined, downward long-wave and short-wave radiation +C can be read-in form files or computed from lwflux and swflux. +C +C >>> ALLOW_ZENITHANGLE <<< +C If defined, ocean albedo varies with the zenith angle, and +C incoming fluxes at the top of the atmosphere are computed +C +C >>> ALLOW_BULKFORMULAE <<< +C Allows the use of bulk formulae in order to estimate +C turbulent and radiative fluxes at the ocean surface. +C +C >>> EXF_READ_EVAP <<< +C If defined, evaporation fields are read-in, rather than +C computed from atmospheric state. +C +C >>> ALLOW_RUNOFF <<< +C If defined, river and glacier runoff can be read-in from files. +C +C >>> ALLOW_SALTFLX <<< +C If defined, upward salt flux can be read-in from files. +C +C >>> ALLOW_RUNOFTEMP <<< +C If defined, river and glacier runoff temperature +C can be read-in from files. +C +C >>> ATMOSPHERIC_LOADING <<< +C If defined, atmospheric pressure can be read-in from files. +C WARNING: this flag is set (define/undef) in CPP_OPTIONS.h +C and cannot be changed here (in EXF_OPTIONS) +C +C >>> EXF_SEAICE_FRACTION <<< +C If defined, seaice fraction can be read-in from files (areaMaskFile) +C +C >>> ALLOW_CLIMSST_RELAXATION <<< +C Allow the relaxation to a monthly climatology of sea surface +C temperature, e.g. the Reynolds climatology. +C +C >>> ALLOW_CLIMSSS_RELAXATION <<< +C Allow the relaxation to a monthly climatology of sea surface +C salinity, e.g. the Levitus climatology. +C +C >>> USE_EXF_INTERPOLATION <<< +C Allows specification of arbitrary Cartesian input grids. +C +C >>> EXF_CALC_ATMRHO +C Calculate the local atm density as function of temp, humidity +C and pressure +C +C ==================================================================== +C +C The following CPP options: +C +C ALLOW_ATM_WIND (WIND) +C ALLOW_ATM_TEMP (TEMP) +C ALLOW_DOWNWARD_RADIATION (DOWN) +C ALLOW_BULKFORMULAE (BULK) +C EXF_READ_EVAP (EVAP) +C +C permit the ocean-model forcing configurations listed in the +C table below. The first configuration is the default, +C flux-forced, ocean model. The next four are stand-alone +C configurations that use pkg/exf, open-water bulk formulae to +C compute the missing surface fluxes from atmospheric variables. +C The last four configurations can be used in conjunction with +C pkg/seaice to model ice-covered regions. The forcing fields +C in the rightmost column are defined in exf_fields. +C +C +C WIND |TEMP |DOWN |BULK |EVAP | actions +C -----|-----|-----|-----|-----|------------------------------------- +C | | | | | +C - | - | - | - | - | Read-in ustress, vstress, hflux, +C | | | | | swflux, and sflux. +C | | | | | +C def | def | def | def | - | Read-in uwind, vwind, atemp, aqh, +C | | | | | swdown, lwdown, precip, and runoff. +C | | | | | Compute ustress, vstress, hflux, +C | | | | | swflux, and sflux. +C | | | | | +C def | def | - | def | - | Read-in uwind, vwind, atemp, aqh, +C | | | | | swflux, lwflux, precip, and runoff. +C | | | | | Compute ustress, vstress, hflux, +C | | | | | and sflux. +C | | | | | +C def | - | - | def | - | Read-in uwind, vwind, hflux, +C | | | | | swflux, and sflux. +C | | | | | Compute ustress and vstress. +C | | | | | +C - | def | - | def | - | Read-in ustress, vstress, atemp, +C | | | | | aqh, swflux, lwflux, precip, and +C | | | | | runoff. Compute hflux and sflux. +C | | | | | +C def | def | - | - | def | Read-in uwind, vwind, atemp, aqh, +C | | | | | swflux, lwflux, precip, runoff, +C | | | | | and evap. +C | | | | | +C def | def | - | def | - | Read-in uwind, vwind, atemp, aqh, +C | | | | | swflux, lwflux, precip, and runoff. +C | | | | | Compute open-water ustress, vstress, +C | | | | | hflux, swflux, and evap. +C | | | | | +C def | def | def | - | def | Read-in uwind, vwind, atemp, aqh, +C | | | | | swdown, lwdown, precip, runoff, +C | | | | | and evap. +C | | | | | +C def | def | def | def | - | Read-in uwind, vwind, atemp, aqh, +C | | | | | swdown, lwdown, precip, and runoff. +C | | | | | Compute open-water ustress, vstress, +C | | | | | hflux, swflux, and evap. +C +C ==================================================================== C Bulk formulae related flags. #define ALLOW_ATM_TEMP #define ALLOW_ATM_WIND #define ALLOW_DOWNWARD_RADIATION #define ALLOW_RUNOFF +#undef ALLOW_RUNOFTEMP +#define ALLOW_SALTFLX #if (defined (ALLOW_ATM_TEMP) || defined (ALLOW_ATM_WIND)) # define ALLOW_BULKFORMULAE # define ALLOW_BULK_LARGEYEAGER04 #endif +#if (defined (ALLOW_ATM_TEMP) && defined (ATMOSPHERIC_LOADING)) +# undef EXF_CALC_ATMRHO +#endif C Zenith Angle/Albedo related flags. #ifdef ALLOW_DOWNWARD_RADIATION # define ALLOW_ZENITHANGLE -# undef ALLOW_ZENITHANGLE_BOUNDSWDOWN +# undef ALLOW_ZENITHANGLE_BOUNDSWDOWN #endif -C Use ocean_emissivity*lwdwon in lwFlux. This flag should be define +C Use ocean_emissivity*lwdown in lwFlux. This flag should be defined C unless to reproduce old results (obtained with inconsistent old code) #ifdef ALLOW_DOWNWARD_RADIATION # define EXF_LWDOWN_WITH_EMISSIVITY @@ -169,6 +185,9 @@ C Relaxation to monthly climatologies. #define ALLOW_CLIMSST_RELAXATION #define ALLOW_CLIMSSS_RELAXATION +C Allows to read-in seaice fraction from files (areaMaskFile) +#undef EXF_SEAICE_FRACTION + C Use spatial interpolation to interpolate C forcing files from input grid to model grid. #define USE_EXF_INTERPOLATION