# INIFOR - Mesoscale Interface for Initializing and Forcing PALM-4U (v1.3.0) 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 meso-scale model COSMO. ## COMPILATION 1. 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) 2. Run `make` ## USAGE 1. Customize `./namelist` (number or grid points and spacings, end_time) 2. Run `current_version/trunk/SCRIPTS/inifor -path -date ` ## AVAILABLE NAMELIST PARAMETERS INIFOR mirrors a subset of the PALM-4U's Fortran namelists `inipar` and `d3par` and supports the following parameters: ### inipar nx, ny, nz - number of PALM-4U grid points in x, y, and z direction dx, dy, dz(10) - PALM-4U grid spacings in x, y, and z direction [m] dz_stretch_level - height above which the grid will be stretched [m] dz_stretch_factor - factor by which the grid will be stretched dz_max - maximum vertical grid spacing [m] dz_stretch_level_start(9) - array of height levels above which the grid is to be stretched vertically [m] dz_stretch_level_end(9) - array of height levels until which the grid is to be stretched vertically [m] longitude, latitude - geographical coordinates of the PALM-4U origin [deg] ### d3par end_time - 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 / ## AVAILABLE COMMAND-LINE PARAMETERS -d, --date, -date : Start date of the simulation in the form YYYYMMDD of YYYYMMDDHH. If no hours (HH) are given, INIFOR assumes that the simulation starts at O UTC on that day. Default: 20130721 -i, --init-mode, -mode : 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'. Default: volume -l, --hhl-file, -hhl : Location of the netCDF file containing the vertical COSMO-DE grid levels, specifically the heights of half levels (hhl, i.e. vertical cell faces). Default: /hhl.nc -n, --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. Default: ./namelist -o, --output : Name of the INIFOR output file, i.e. the PALM-4U dynamic driver. Default: ./palm-4u-input.nc -p, --path, -path : Scenario path, i.e. the path of the meteorological input data. Default: ./ -r, --surface-pressure, -p0 : Surface pressure at z=0 in the PALM-4U domain [Pa]. Default: 1e5 -s, --soil-file, -soil : Location of the netCDF file containing the COSMO-DE soil type map. Default: /soil.nc -t, --static-driver, -static : Location of the netCDF file containing the static driver file for the case to be simulated with PALM-4U. Optional parameter. Default: None -u, --geostrophic-u, -ug : Specifies the geostrophic wind in x direction [m/s]. Default: 0 -v, --geostrophic-v, -vg : Specifies the geostrophic wind in y direction [m/s]. Default: 0 --version: Output version number and exit. -z, --elevation, -z0 : Specifies the elevation of the PALM-4U domain above sea level [m]. Default: 35 ## ADDITIONAL COMMAND-LINE OPTIONS --flow-prefix : Set the file prefix of flow input files. Default: laf --radiation-prefix : Set the file prefix of radiation input files. Default: laf --soil-prefix : Set the file prefix of soil input files. Default: laf --soilmoisture-prefix : Set the file prefix of soil moisture input files. Default: laf