| 1 | Usage of PALM NCL script crosssections.ncl |
|---|
| 2 | ========================================== |
|---|
| 3 | Last change: $Id: crosssections.usage.txt 127 2007-10-23 11:05:25Z letzel $ |
|---|
| 4 | Marcus Letzel, 17 July 2007 |
|---|
| 5 | |
|---|
| 6 | Command-line syntax |
|---|
| 7 | =================== |
|---|
| 8 | ncl crosssections.ncl [parameters] |
|---|
| 9 | |
|---|
| 10 | The parameter syntax depends on their data type: |
|---|
| 11 | A) numeric data : parameter=value (for example t=0) |
|---|
| 12 | B) character string: 'parameter="string"' (for example 'var="u_xy"') |
|---|
| 13 | |
|---|
| 14 | Alphabetical parameter list |
|---|
| 15 | =========================== |
|---|
| 16 | Name Default value Meaning |
|---|
| 17 | ----------------------------------------------------------------------------- |
|---|
| 18 | cm "ncview_default" colormap |
|---|
| 19 | di "" input directory (with final /) |
|---|
| 20 | d =di output directory (with final /) |
|---|
| 21 | fi "example_xy" base name of input file (without suffix) |
|---|
| 22 | fo "" base name of output files (without suffix) |
|---|
| 23 | fill_mode "AreaFill" fill mode for mode="Fill": |
|---|
| 24 | "AreaFill", "RasterFill" or "CellFill" |
|---|
| 25 | mode "Fill" output mode ("Fill" or "Line") |
|---|
| 26 | t 0 output time step |
|---|
| 27 | var "u_xy" variable to be output |
|---|
| 28 | xs -1e+38 output x-coordinate range start (in m) |
|---|
| 29 | xe +1e+38 output x-coordinate range end (in m) |
|---|
| 30 | ys -1e+38 output y-coordinate range start (in m) |
|---|
| 31 | ye +1e+38 output y-coordinate range end (in m) |
|---|
| 32 | zs -1e+38 output z-coordinate range start (in m) |
|---|
| 33 | ze +1e+38 output z-coordinate range end (in m) |
|---|
| 34 | |
|---|
| 35 | Usage |
|---|
| 36 | ===== |
|---|
| 37 | This script draws NCL contour plots from two-dimensional cross-sections of |
|---|
| 38 | NetCDF data produced by PALM. Instantaneous or time-averaged xy-, xz-, yz- or |
|---|
| 39 | 3D-data can be used with this script. |
|---|
| 40 | |
|---|
| 41 | The sectional plane has neither a default orientation nor a default position. |
|---|
| 42 | Both must be specified together using the coordinate range parameters: |
|---|
| 43 | - For xy cross-sections specify zs and ze (with zs=za). |
|---|
| 44 | - For xz cross-sections specify ys and ye (with ys=ya). |
|---|
| 45 | - For yz cross-sections specify xs and xe (with xs=xa). |
|---|
| 46 | |
|---|
| 47 | The remaining coordinate range parameters can optionally be used to restrict |
|---|
| 48 | the output coordinate range. |
|---|
| 49 | |
|---|
| 50 | By default, only screen output is produced. Additional file output is optional |
|---|
| 51 | and requires to specify the parameter fo. This will create three files: fo.pdf, |
|---|
| 52 | fo.eps and fo.ps. |
|---|
| 53 | |
|---|
| 54 | Input and output files can optionally be preceeded by an input and output |
|---|
| 55 | directory di and d, respectively. If not specified, this scripts expects the |
|---|
| 56 | input file to reside in the current directory. |
|---|
| 57 | |
|---|
| 58 | The contours can be drawn either in "Fill" (default) or "Line" mode. |
|---|
