Ignore:
Timestamp:
Oct 22, 2018 5:32:49 PM (4 years ago)
Author:
eckhard
Message:

inifor: Added computation of geostrophic winds from COSMO input

File:
1 edited

Legend:

Unmodified
Added
Removed
  • palm/trunk/UTIL/inifor/README

    r3182 r3395  
    1 # INIFOR - Mesoscale Interface for Initializing and Forcing PALM-4U (v1.3.0)
     1# INIFOR - Mesoscale Interface for Initializing and Forcing PALM-4U (v1.4.0)
    22
    33INIFOR provides the meteorological fields required to initialize and drive the
     
    1414
    1515
     16## MINIMAL USAGE EXAMPLE
     17
     181. Customize `./namelist` (number of grid points and spacings, end_time)
     192. Run `current_version/trunk/SCRIPTS/inifor --path <scenario path> --date <YYYYMMDD>`
     20
     21
    1622## USAGE
    1723
    18 1. Customize `./namelist` (number or grid points and spacings, end_time)
    19 2. Run `current_version/trunk/SCRIPTS/inifor -path <scenario path> -date <YYYYMMDD>`
     24After compilation, the `inifor` binary resides in the `$PALM_BIN` path, i.e. in
     25`<PALM path>/current_version/trunk/SCRIPTS/`.
     26
     27In order to run, INIFOR requires three kinds of inputs:
     28
     291. hourly COSMO model output,
     302. a steering namelist file, and
     313. command-line options.
     32
     33In addition, a static driver file may be supplied (see `--static-driver` option
     34below) in order to pass the coordinates of the PALM origin to INIFOR. If no
     35static driver is passed to INIFOR, origin coordinates are read from the namelist
     36file.
     37
     38A typical `inifor` call looks like this:
     39
     40    inifor --path /data/evaluation/20170729 --date 2017073006 \
     41           --init-mode profile -n namelist -o dynamic_driver.nc \
     42           --elevation 110 --input-prefix lff0
     43
     44### INPUT DATA: COSMO MODEL OUTPUT
     45
     46INIFOR processes COSMO model output which it requires to be stored in a set of
     47netCDF files located in a user-specified path (see `--path` option). These are:
     48
     49- hhl.nc: This file provides the COSMO numerical grid. (*hhl* abbreviates
     50  *height of half layers*, i.e. the heights of the vertical cell boundaries.)
     51- soil.nc: This file provides the COSMO soil map and is used to destinguish land
     52  from water cells.
     53- `<prefix>YYYYMMDDHH-<suffix>.nc`: Each of these files contains COSMO model
     54  of one time step at the given time in UTC (Y..year, M..month, D..day, H..hour).
     55    - The `<prefix>` distinguishes different DWD products, for instance COSMO
     56      analyses (`laf`) or forecasts (`lff`).
     57    - The `<suffix>` distinguishes four kinds of COSMO model output data, namely
     58        - `flow` (atmospheric fields)
     59        - `rad` (radiation)
     60        - `soil` (soil moisture and temperature)
     61        - `soilmoisture` (precipitation and evaporation)
     62    - For example, laf2016010100-flow.nc contains the atmospheric fields of the
     63      COSMO analysis of Januray 1st, 2016 for 0:00 UTC.
    2064
    2165
    22 ## AVAILABLE NAMELIST PARAMETERS
     66### AVAILABLE NAMELIST PARAMETERS
    2367
    2468INIFOR mirrors a subset of the PALM-4U's Fortran namelists `inipar` and `d3par`
     
    2670
    2771
    28 ### inipar
     72#### inipar
    2973
    3074    nx, ny, nz - number of PALM-4U grid points in x, y, and z direction
     
    3478    dz_max - maximum vertical grid spacing [m]
    3579    dz_stretch_level_start(9) - array of height levels above which the grid is
    36     to be stretched vertically [m]
     80        to be stretched vertically [m]
    3781    dz_stretch_level_end(9) - array of height levels until which the grid is to
    38     be stretched vertically [m]
     82        be stretched vertically [m]
    3983    longitude, latitude - geographical coordinates of the PALM-4U origin [deg]
    4084
    4185
    42 ### d3par
     86#### d3par
    4387
    4488    end_time - PALM-4U simulation time. INIFOR will produce hourly forcing data
     
    4791
    4892
    49 ### EXAMPLE NAMELIST FILE
     93#### EXAMPLE NAMELIST FILE
    5094
    5195    &inipar nx = 4679, ny = 3939, nz = 360
     
    59103
    60104
    61 ## AVAILABLE COMMAND-LINE PARAMETERS
     105### AVAILABLE COMMAND-LINE PARAMETERS
     106    --averaging-mode <mode>:
     107        Selects how averaged quantities (large-scale forcing terms) are computed.
     108        INIFOR supports averaging along input model levels ('level') and along
     109        constant heights ('height'). Default: level
     110
     111    -a, --averaging-angle <angle>:
     112        Width of the averaging box in longitudal and latitudal direction in the
     113        source coordinate system (COSMO rotated-pole) [deg]. Default: 2.0
    62114
    63115    -d, --date, -date <date>:
     
    65117        hours (HH) are given, INIFOR assumes that the simulation starts at O UTC
    66118        on that day. Default: 20130721
    67        
     119
    68120    -i, --init-mode, -mode <mode>:
    69121        Set the PALM-4U initialization mode. INIFOR can provide initial conditions
     
    72124
    73125    -l, --hhl-file, -hhl <netCDF file>:
    74         Location of the netCDF file containing the vertical COSMO-DE grid levels,
     126        Location of the netCDF file containing the vertical COSMO grid levels,
    75127        specifically the heights of half levels (hhl, i.e. vertical cell faces).
    76128        Default: <scenario path>/hhl.nc
     
    83135    -o, --output <output file>:
    84136        Name of the INIFOR output file, i.e. the PALM-4U dynamic driver.
    85         Default: ./palm-4u-input.nc
     137        Default: ./dynamic_driver.nc
    86138
    87139    -p, --path, -path <scenario path>:
     
    89141
    90142    -r, --surface-pressure, -p0 <pressure>:
    91         Surface pressure at z=0 in the PALM-4U domain [Pa].
    92         Default: 1e5
     143        Manually set the pressure at z=0 in the PALM-4U domain [Pa]. If not
     144        given, the surface pressure is computed from the COSMO pressure field.
    93145
    94146    -s, --soil-file, -soil <netCDF file>:
    95         Location of the netCDF file containing the COSMO-DE soil type map.
     147        Location of the netCDF file containing the COSMO soil type map.
    96148        Default: <scenario path>/soil.nc
    97149
    98150    -t, --static-driver, -static <netCDF file>:
    99         Location of the netCDF file containing the static driver file for the case
     151        Location of the netCDF file containing the static driver for the case
    100152        to be simulated with PALM-4U. Optional parameter. Default: None
    101153
    102154    -u, --geostrophic-u, -ug <velocity>:
    103         Specifies the geostrophic wind in x direction [m/s]. Default: 0
     155        Manually specify the geostrophic wind in x direction [m/s]. If not
     156        given, the geostrophic wind is computed from the COSMO pressure field.
    104157
    105158    -v, --geostrophic-v, -vg <velocity>:
    106         Specifies the geostrophic wind in y direction [m/s]. Default: 0
    107 
    108     --version:
    109         Output version number and exit.
     159        Manually specify the geostrophic wind in y direction [m/s]. If not
     160        given, the geostrophic wind is computed from the COSMO pressure field.
    110161
    111162    -z, --elevation, -z0 <height>: Specifies the elevation of the PALM-4U domain
     
    113164
    114165
    115 ## ADDITIONAL COMMAND-LINE OPTIONS
     166#### ADDITIONAL COMMAND-LINE OPTIONS
     167
     168    --input-prefix <prefix>:
     169        Set the file prefixes for all input files. Individual prefixes can be
     170        overwritten with the options below. Default: laf
    116171
    117172    --flow-prefix <prefix>:
     
    126181    --soilmoisture-prefix <prefix>:
    127182        Set the file prefix of soil moisture input files. Default: laf
     183
     184    --debug:
     185        Enable debugging messages.
     186
     187    --version:
     188        Output version number and exit.
     189
Note: See TracChangeset for help on using the changeset viewer.