*--------------------------------------------------------------------------
*
* Configuration file for interpolate_update.f90.
* Common version for Hera, PSL Mac, and Linux.
*
* 2014-apr-24	Original test version.
* 2014-jul-18	Release version for Zeus.  5 predictors, new PM2.5 site list.
*
* 2016-feb-11	Path configuration for Theia.  Target = PM2.5.
*
* 2017-jul-07	New PM2.5 version, 9 predictors.  Common for Theia and PSD.
*		Updates for new CMAQ 5.02 data.  Simplify data paths.
*		Switch from CSDSF radiation, to RGRND, surface solar radiation.
*		New site list, PM2.5 11 months.
*		Remove ozone.  PM2.5 and ozone interp files need to be
*		  separate, for now, for bias correction run efficiency.
* 2017-jul-07	New separate ozone version, 8 predictors.
*		New site list, ozone 11 months.
*
* 2019-apr-25	PSD test version for 72-hour ozone forecasts.
*		Adapt to CMAQ v5.1.0 intermediate files.
*
* 2019-may-17	Change config file format to support derived variables.
*		Add optional derived variables to var table, using keywords.
*		Add save/nosave column to var table.
* 2019-nov-11	Release version for Hera.  Update site list only.
*
* 2022-apr-11	Change substring code for forecast cycle from HH to CC, to
*		  be distinct from new code FF for specific forecast hour.
*		Add parameter for number of forecast hours.
*		Read U and V winds directly, rather than derived.
* 2022-apr-19	Change from hard coded derivatives, to formula expressions.
*
* 2022-may-27	Version for Online-CMAQ.
*		Reduce to 7 predictor variables for ozone.  NOY is missing.
*		Derive NOX = NO + NO2.
* 2022-jun-01	Switch to original grid coordinate file.
*
* 2022-jul-25	Version for AQMv7.
* 2022-dec-02	Switch from 73 to 72 forecast hours, for new Online-CMAQ.
*
* 2023-apr-09	AQMv7.  Change parameter to "site list" for consistency.
*
* Blank lines and asterisk in column 1 are comment lines.
* Tables are free format, space delimited.
* Blank line terminates each table.  Don't use blank lines within tables.
* Most names are case sensitive.
*
* General rules for paths and path templates:
*
* Paths may begin with an environment variable, e.g. $DATA/...
* Both relative and absolute paths are supported.
* Template codes YYYY, MM, DD, CC, and FF will be replaced with date
*   and time strings within the usage context.  HH is obsolete.
* Multiple substitutions within each template are supported.
*
* Code CC  is replaced by the current forecast cycle, such as 06 or 12.
* Code FF  is replaced by 2-digit forecast hours.
* Code FFF is replaced by 3-digit forecast hours.
*
* Reader codes connect the file templates to specific reader subroutines.
* See read_gridded_vars.f90 for currently supported reader codes.
*
*--------------------------------------------------------------------------

site list            = data/site-lists.interp/sites.valid.ozone.20240610.12z.list
grid coordinate file = data/coords/aqm.t12z.chem_sfc.f000.nc
interp file template = out/ozone/YYYY/forecasts.interp.YYYYMMDD.CCz.nc

number of forecast hours = 72

File table:
*
* Column 1 = File type name.
* Column 2 = Read subroutine selector.
* Column 3 = Filename template for gridded input files, including paths.
*
* Version for GFS-CMAQ.
* aqm.2     reader.aqm      data/bcdata.YYYYMM/grid/YYYYMMDD/aqm.tCCz.O3_pm25.ncf
* met.1     reader.met      data/bcdata.YYYYMM/grid/YYYYMMDD/sfc_met_n_PBL.tCCz.ncf
*
* Version for AQMv7.
chem.file   reader.hourly   data/bcdata.YYYYMM/grid/CCz/YYYYMMDD/aqm.tCCz.chem_sfc.fFFF.nc
met.file    reader.hourly   data/bcdata.YYYYMM/grid/CCz/YYYYMMDD/aqm.tCCz.met_sfc.fFFF.nc

*-----------------------------

Var table:
*
* The var table specifies all file input variables for interpolation.
* Derived variables, calcuated on the fly, are also included.
* Variables may be listed in any desired order, including derived vars.
*
* Column 1  = Actual var name within input file.  Case sensitive.
* Column 2  = File type name, must match file type above, col. 1 of file table.
*             Or else "derived" for derived variables.
* Column 3  = "save" to write to interpolated output file; normal analog vars.
*             "nosave" to not write; vars only for derived var calculations.
* Column 4+ = Comments.
*
* File variables.
*
o3         chem.file   save    Ozone concentration, ppb
no         chem.file   nosave  NO  concentration, ppmv
no2        chem.file   nosave  NO2 concentration, ppmv
*
*NOX         --         --     (NOX missing from the current input data set)
*NOY         --         --     (NOY missing from the current input data set)
*
dswrf      met.file    save    instantaneous surface downward shortwave flux, W/m**2
hpbl       met.file    save    surface planetary boundary layer height, m
tmp2m      met.file    save    2m temperature, K
ugrd10m    met.file    save    10 meter u wind, m/s
vgrd10m    met.file    save    10 meter v wind, m/s
*
* Derived variables.
*
NOX        derived     save    NOX concentration, ppmv

*-----------------------------
*
Calculation of derived variables:
*
NOX = no + no2

* In formulas, all referenced input and output variables must also
* be included in the var table above.  Blank line ends formulas.
* Currently available calculations are:
*
*    x = u_vector (speed, direction)
*    x = v_vector (speed, direction)
*    x = a + b + c ...

* End of config file.