= INIFOR - Mesoscale Interface for Initializing and Forcing PALM-4U = INIFOR provides the meteorological fields required to initialize and drive the urban-climate model PALM-4U. The required meteorological fields are interpolated from output data of the mesoscale model COSMO. == Compilation == - Customize `./Makefile` and `./tests/Makefile` (netCDF library location, compiler and parameters, use Makefile.ifort as a template if you want to use the Intel Fortran compiler) - Run `make` == Minimal Usage Example == - Customize `./namelist` (number or grid points and spacings, end_time) - Run `current_version/trunk/SCRIPTS/inifor -path -date ` == Usage == After compilation, the `inifor` binary resides in the `$PALM_BIN` path, i.e. in `/current_version/trunk/SCRIPTS/`. In order to run, INIFOR requires three kinds of inputs: 1. hourly COSMO model output, 2. a steering namelist file, and 3. command-line options. In addition, a static driver file may be supplied (see `--static-driver` option below) in order to pass the coordinates of the PALM origin to INIFOR. If no static driver is passed to INIFOR, origin coordinates are read from the namelist file. A typical `inifor` call looks like this: {{{ inifor --path /data/evaluation/20170729 --date 2017073006 \ --init-mode profile -n namelist -o dynamic_driver.nc \ --elevation 110 --input-prefix lff0_ }}} === Input data: COSMO model output === INIFOR processes COSMO model output which it requires to be stored in a set of netCDF files located in a user-specified path (see `--path` option). These are: - hhl.nc: This file provides the COSMO numerical grid. (''hhl'' abbreviates ''height of half layers'', i.e. the heights of the vertical cell boundaries.) - soil.nc: This file provides the COSMO soil map and is used to destinguish land from water cells. - `YYYYMMDDHH-.nc`: Each of these files contains COSMO model of one time step at the given time in UTC (Y..year, M..month, D..day, H..hour). - The `` distinguishes different DWD products, for instance COSMO analyses (`laf`) or forecasts (`lff`). - The `` distinguishes four kinds of COSMO model output data, namely - `flow` (atmospheric fields) - `rad` (radiation) - `soil` (soil moisture and temperature) - `soilmoisture` (precipitation and evaporation) - For example, laf2016010100-flow.nc contains the atmospheric fields of the COSMO analysis of Januray 1st, 2016 for 0:00 UTC. === Namelist parameters === INIFOR mirrors a subset of the PALM-4U's Fortran namelists `inipar` and `d3par` and supports the following parameters: ==== inipar ==== ||='''Parameter name''' =||='''Default value''' =||='''Description''' =|| || nx, ny, nz || None || Number of PALM-4U grid points in x, y, and z direction || || dx, dy, dz(10) || None || PALM-4U grid spacings in x, y, and z direction [m] || || dz_stretch_level || -9999999.9 || Height above which the grid will be stretched [m] || || dz_stretch_factor || 1.08 || Factor by which the grid will be stretched || || dz_max || 1000.0 || Maximum vertical grid spacing [m] || || dz_stretch_level_start(9) || -9999999.9 || Array of height levels above which the grid is to be stretched vertically [m] || || dz_stretch_level_end(9) || 9999999.9 || Array of height levels until which the grid is to be stretched vertically [m] || || longitude, latitude || 0.0 || Geographical coordinates of the PALM-4U origin [deg] || ==== d3par ==== ||='''Parameter name''' =||='''Default value''' =||='''Description''' =|| || end_time || 0.0 || PALM-4U simulation time. INIFOR will produce hourly forcing data from the start date (see -d command-line option) to end_time seconds thereafter. [s] || ==== Example namelist file ==== {{{ &inipar nx = 4679, ny = 3939, nz = 360 dx = 10., dy = 10., dz = 10. dz_stretch_level = 2500.0, dz_stretch_factor = 1.08, dz_max = 100.0 longitude = 13.082744, latitude = 52.325079 / &d3par end_time = 86400.0 / }}} === Command-line options === ==== INIFOR configuration ==== ||='''Option''' =||='''Default value''' =||='''Description''' =|| |----------- || --averaging-mode || level || Selects how averaged quantities (large-scale forcing terms) are computed. INIFOR supports averaging along input model levels ('level') and along constant heights ('height'). || || -a, --averaging-angle || 2.0 || Width of the averaging box in longitudal and latitudal direction in the source coordinate system (COSMO rotated-pole) [deg]. || || -d, --date || 20130721 || Start date of the simulation in the form YYYYMMDD or YYYYMMDDHH. If no hours (HH) are given, INIFOR assumes that the simulation starts at O UTC on that day. || || -i, --init-mode || volume || Set the PALM-4U initialization mode. INIFOR can provide initial conditions as either profiles or three-dimensional fields. The corresponding modes are 'profile' and 'volume'. || || -r, --surface-pressure || 1e5 || Manually set the pressure at z=0 in the PALM-4U domain [Pa]. If not given, the surface pressure is computed from the COSMO pressure field. || || -u, --geostrophic-u || 0 || Manually specify the geostrophic wind in x direction [m/s]. If not given, the geostrophic wind is computed from the COSMO pressure field. || || -v, --geostrophic-v || 0 || Manually specify the geostrophic wind in y direction [m/s]. If not given, the geostrophic wind is computed from the COSMO pressure field. || || -z, --elevation || 35 || Specifies the elevation of the PALM-4U domain above sea level [m]. || ==== I/O ==== ||='''Option''' =||='''Default value''' =||='''Description''' =|| || -l, --hhl-file || /hhl.nc || Location of the netCDF file containing the vertical COSMO-DE grid levels, specifically the heights of half levels (hhl, i.e. vertical cell faces). || || -n, --namelist || ./namelist || Location of the PALM-4U namelist file. INIFOR expects the file to contain two namelists, inipar and d3par, from which it will read grid parameters and the simulation time. || || -o, --output || ./palm-4u-input.nc || Name of the INIFOR output file, i.e. the PALM-4U dynamic driver. || || -p, --path || ./ || Scenario path, i.e. the path of the meteorological input data. || || -s, --soil-file || /soil.nc || Location of the netCDF file containing the COSMO-DE soil type map. || || -t, --static-driver || None || Location of the netCDF file containing the static driver file for the case to be simulated with PALM-4U. ==== File prefixes ==== ||='''Option''' =||='''Default value''' =||='''Description''' =|| || --input-prefix || laf || Set the file prefixes for all input files. Individual prefixes can be overwritten with the options below. || || --flow-prefix || laf || Set the file prefix of flow input files. || || --radiation-prefix || laf || Set the file prefix of radiation input files. || || --soil-prefix || laf ||Set the file prefix of soil input files. || || --soilmoisture-prefix || laf || Set the file prefix of soil moisture input files. || ==== Non-argument options ==== ||='''Option''' =||='''Description''' =|| || --debug || Enable additional terminal messages and netCDF output for debugging. || || --version || Output version number and exit. ||