Diana User Guide: Setup file | Previous: Shortcut keys | Next: Field functions | Index | ![]() |
The setup file is organized in sections.
A section is defined by a <SSS> </SSS> pair, where SSS is the name of the section.
Example: <BASIC> ... </BASIC>
contains the 'BASIC' section.
Common structures in all sections:
KEYWORD | Turns on/off feature |
KEY=VALUE | Defines keyword with value |
KEY=V1,V2,V3 | Defines keyword with list of values |
KEY=V11:V12:V13,V21:V22 | Defines keyword with list of lists of values |
KEY=VALUE KEY=V1,V2,V3 ... | Combinations of key-defines |
Other features:
temp2006052206.rdb
may be written
tempyyyymmddHH.rdb
in order to extract the time
information. Parentheses may be skipped if none of the keys
below appear in the filename.
Time key | Description |
yyyy | Year |
yy | Year (yy>50 => 19yy, yy<50 => 20yy) |
mm | Month |
dd | Day |
HH | Year |
MM | Minute |
M | Minute (M*10) |
XX | HH=XX/2, XX=0,2...=>MM=0, XX=1,3...=>MM=30 |
Sections in use, preferably in this order:
BASIC | contains various filepaths, and definitions for the system language |
FONTS | contains definitions for the fonts used in visualisation |
LABELS | lists the default plot commands for data labels and annotations on the map |
IMAGE_GALLERY | contains file paths to static raster images and simple vector patterns used in visualisations |
COLOURS | defines available colours with name and rgba values |
PALETTES | defines available colour palettes with name and list of colour values |
FILLPATTERNS | defines available palettes of patterns |
LINETYPES | defines available line stippling patterns with name and binary representation |
PRINTING | system specific print commands |
QUICKMENUES | lists common (for all users) quick menues |
METNOFIELDFILE_PARAMETERS | Defines field parameters used in the met.no field file format |
NETCDF_PARAMETERS | NetCDF field parameters used in the NetCDF files |
FIELD_COMPUTE | defines common (for all sources) field computations |
FIELD_PLOT | defines fields for visualisation with default plot options |
FIELD_FILES | lists files or other sources for field data |
OBSERVATION_FILES | defines available observations for plotting |
OBSERVATION_PRIORITY_LISTS | defined priority lists for observation plotting |
OBSERVATION_CRITERIA | definitions of criterias for plotting observations |
IMAGE | geo images (satellite, radar) defined with file sources, available channels etc. |
TEXT_INFORMATION_FILES | list of files for the text viewer in Diana |
MAP_AREA | define available projections and standard areas |
MAP_TYPE | list of available maps |
OBJECTS | list of sources for meteorological objects (fronts, symbols etc) |
EDIT | define products for the editing tools |
VERTICAL_PROFILE_FILES | list of sources for sounding data |
VERTICAL_CROSSECTION_FILES | list of sources for vertical cross sections |
VERTICAL_CROSSECTION_PARAMETERS | available parameter definitions for vertical cross sections |
VERTICAL_CROSSECTION_COMPUTATIONS | available computed parameters for vertical cross sections |
VERTICAL_CROSSECTION_PLOTS | available visualisations of vertical cross sections |
SPECTRUM_FILES | list of sources for wave spectra visualisation |
UFFDA | met.no specific: Menu specification for interactive collocation of AVHRR training data. |
Key | Value |
docpath= | path to this documentation (default doc) |
obsPlotFilePath= | path to files describing symbol and synop plot |
qserver= | path to coserver program |
imagepath= | main path to static images |
amdarStationList= | path to list of amdar stations used in vertical profiles |
languagepaths= | path to gui language files (default lang:${QTDIR}/translations) |
setenv= | set environment variables (variable,value,overwrite) |
language= | system language to use ((default en) |
font: Family name type: Bitmap (screen fonts with postscript equivalent) | Scaleable (truetype rendered as polygons) name: X-fontdefinitions for bitmap fonts, name of fontfile for scaleable fonts face: NORMAL | ITALIC | BOLD | BOLD_ITALIC (for scaleable fonts) postscript : For bitmap fonts, postscript-equivalent name (for postscript output)
Key(s) | Meaning |
fontpath= | path to font files (default fonts) |
font=X type=bitmap name=Y postscript=Z | define new bitmap font |
font=X type=scalable name=Y | define new scalable font font |
BITMAPFONT=X | use bitmap font named X as default bitmap font |
SCALEFONT=X | use scalable font named X as default scaleable font |
METSYMBOLFONT=X | use font named X as default font containing meteorological symbols |
Key | Value |
basicpath= | main image path |
markerpath= | main path to small images used as markers on the map |
marker= | additional path to a marker |
patternpath= | path to patterns used in filled areas/fields |
NAME=R,G,B[,A]
NAME=R1:G1:B1[:A1],R2:G2:B2[:A2],...Rn:Gn:Bn[:An] # colour palette with n items NAME=RED,YELLOW,BLUE # colour palette with 3 items
NAME=P1,P2,P3 # defines a palette of 3 patterns found under patternpath # (see IMAGE_GALLERY above)
solid= 1111111111111111 # solid line dash= 1111000011110000 # half on, half off
Key | Value |
manualcommands= | is name of file with printer-specific commands (postscript) |
printcommand= | typically: lpr -h -{hash}{numcopies} -P {printer} {filename} |
{hash} | simply a '#' |
{numcopies} | will be expanded to number of paper copies |
{printer} | will be expanded to name of printer |
{filename} | will be expanded to output filename |
Key | Value |
file= | path to file containing quick menu item |
Syntax: Multilevel: param_name=param_number Surface and single level: param_name=param_number,vertical_coord,level Additinal parameters for both types: prod= produce_number grid= grid_number dtype= data_type ..... usually: 1=analysis 2=forecast 3=initialized analysis 4=parameter fields (constant during forecast) level= level_value idnum= idnum_value (level2 in met.no FieldFile descriptions)
Example:
mslp=58,2,1000 z=1 u=2 v=3
diana_name = netcdf_nameExample:
ice.concentration=sea_ice_concentration salt=sea_water_salinityConnects the name of variable used in diana with the local variable-name used in the NetCDF-files. To find the variable-names in a NetCDF-file, use 'ncdump -h
vertical_coordinate=A:B,C:DWhere A is the name appearing in the dialog, B is the "standard_name" from the Netcdf files, C is "suffix" or "prefix", and D is name of the suffix/prefix (units) Example:
vertical_coordinate=Depth:depth,suffix:mIMPORTANT NOTES
Field computation/conversion functions
Example:
tc=tc.plevel_th(th) the=the.alevel_tk_q_p(tk,q,p) dz.500-1000=subtract(z:level=500hPa,z:level=1000hPa) ff10m=vector.abs(u10m,v10m) accumprecip.12h=accum.diff.forecast.hour(accumprecip,-12,0) field3=add(field1,field2) field4=multiply(field1,9.8067)
Field plot type | Comment |
CONTOUR | isolines and/or shading between isolines |
WIND | WMO wind |
WIND_COLOUR | WMO wind coloured by any other field |
WIND_TEMP_FL | FlightLevel chart, wind and T |
VECTOR | a vector arrow |
VECTOR_COLOUR | vector arrow coloured by any other field |
DIRECTION | direction |
DIRECTION_COLOUR | direction (true north) coloured by any other field |
ALPHA_SHADE | translucency shading |
BOX_ALPHA_SHADE | translucency shading in grid boxes |
BOX_PATTERN | patterns in grid boxes |
ALARM_BOX | Alarm colour in grid boxes |
FILL_CELL | Fills each grid cell with a color according to the given 'values' and 'palettecolours' vectors |
LAYER | Prints three numbers vertically in each grid cell |
Example:
field=MSLP colour=blue linetype=solid linewidth=1 line.interval=5. plot=CONTOUR(mslp) end.field field=WIND colour=red linetype=solid linewidth=1 rel.size=1. density=AUTO plot=WIND(u,v) end.field loop [P1]=500,700,850 field=DZ([P1]-1000) colour=red linetype=solid linewidth=1 line.interval=40. plot=CONTOUR(dz.[P1]-1000) end.field loop [P1]=500,700,850,500,300 loop [P2]=1000,1000,1000,850,700 field=DZ([P1]-[P2]) colour=red linetype=solid linewidth=1 line.interval=40. plot=CONTOUR(dz.[P1]-[P2]) end.field field=ICING-SUM-COLOR bordercolour=blue rel.size=0.8 values=4,5,6,7,8,9 palettecolours=green,yellow,yellow,orange,black,black plot=FILL_CELL(icing.sum) end.field field=ICING-SUM-LAYER bordercolour=blue rel.size=0.8 label.size=1.0 plot=LAYER(icing.height, icing.bottom, icing.top) end.field
Key | Value | Comment |
Default_Filetype= | MetnoFieldFile, NetCDF, etc. | Type of field Source |
filegroup= | group name | |
archivefilegroup= | group name | Only used in archive mode |
m= | name | Model name |
t= | MetnoFieldFile, NetCDF, etc. | Type of field Source |
f= | filename | file name, ? and * allowed |
g= | 88:1234:Name | for MetnoFieldfiles: prod:grid:Name |
CLEAR_FILES | Delete all models in current file group | |
CLEAR_FILEGROUP | Delete current file group |
filegroup=HIRLAM20km m=HIRLAM.20KM.00 t=MetnoFieldFile f=/opdata/hirlam20/grdn00.dat f=/opdata/hirlam20/grdnm00.dat f=/opdata/hirlam20/grdni00.dat filegroup=HIRLAM4km m=HIRLAM.4KM.00 t=MetnoFieldFile f=/opdata/explam/grdqh00.dat m=HIRLAM.4KM.12 t=MetnoFieldFile f=/opdata/explam/grdqh12.dat filegroup=ice m=ice_sst t=NetCDF f=/disk1/tmp/iceSST.ncRedefine models:
FileGroup=HIRLAM4km m=HIRLAM.4KM.00 t=MetnoFieldFile f=/disk1/grdqh00.dat m=HIRLAM.4KM.12 t=MetnoFieldFile f=/disk1/grdqh12.datDefine new models in existing file group:
FileGroup=HIRLAM4km CLEAR_FILES m=MY_MODEL_00 t=MetnoFieldFile f=/disk1/grdqh00.dat m=MY_MODEL_12 t=MetnoFieldFile f=/disk1/grdqh12.datDelete file group:
FileGroup=HIRLAM4km CLEAR_FILEGROUP
Key | Value | Comment |
PROD= | data type : name appearing in menu | |
metnoobs= | filename | met.no observation format, filename may include time information |
bufr= | filename | bufr format, filename may include time information |
ascii= | filename | ascii format, filename may include time information |
timerange= | min,max | Files include data from time range [time-min,time+max] (minutes) |
current= | scale | Plotting arrow with feathers, not wind. Scale = one full feather. |
Example:
PROD=synop:Surf bufr=/opdata/obs_dec/rdb/syno/surf[yyyymmddHH]*.rdb timerange=-30,30
Bufr data need Bufr tables to unpack data. To specify the path
for the Bufr tables, set the environmental variable
BUFR_TABLES
Example:
export BUFR_TABLES=/usr/local/etc/emos/bufrtables/the path must end with "
/
".
name=X file=Ywhere X is the name of the priority list as shown in menues and Y is the filename.
name="Priority list", file=/metno/local/diana/etc/priList.txt
plottype = name of plot type
name = name of criterias
parameter <>= value plot/colour/colour total
Example:
plottype=Synop name=Temperature TTT>0 plot TTT>10 �red TTT>20 �red total
Criteria | Description |
TTT>0 plot | Plot the observation if TTT>0 |
TTT>10 red | Plot the parameter TTT in red if TTT>10 |
TTT>20 red total | Plot the entire observation in red if TTT>0 |
TTT plot | Plot the observation if TTT is reported |
Key | Value |
channels= | list of available channel-combinations. Example: [ day_night 2+4 4+2 .. ] |
image= | main product name. Example: [NOAA] |
sub.type= | sub product name. Example: [Europa] |
file= | filter for product files. Example: [/data/noaa[yyyymmddHHMM]meu.mitiff] |
name=X file=Y [ type=auto|text|html|xml font=auto|fixed ]
Key | Value |
name= | name as appearing in menu. mandatory |
file= | path to file. mandatory |
type= | auto means type is determined from filename extension |
font= | fixed means "courier"-type font |
name=X proj=Y grid=Z area=Awhere X is the name of the projection/area as shown in menues. To define one of the functionkeys from F5 to F8 as accelerator for an area: add any of [F5],[F6],[F7],[F8] at the end of the name.
Proj | Grid | Area | comment |
pstereographic | xp,yp,an,fi,projection-latitude | x1,x2,y1,y2 (in gridunits) | Polar Stereographic |
pstereo_60 | xp,yp,an,fi | x1,x2,y1,y2 (in gridunits) | Polar Stereographic 60 degrees north |
mercator | west,south,x_inc(km),y_inc(km),ref_lat(deg) | x1,x2,y1,y2 (in x_inc/y_inc units) | Mercator |
geographic | west,south,lon_inc(deg),lat_inc(deg) | x1,x2,y1,y2 (in lon_inc/lat_inc units) | Geographic |
spherical_rot | west,south,lon_inc(deg),lat_inc(deg),lon_eq,lat_eq | x1,x2,y1,y2 (in lon_inc/lat_inc units) | Spherical Rotated |
undefined | 0:0:0:0 | use area from field or satellite | |
undefined | 1:0:0:0 | leave area unchanged |
name=Data-area, proj=undefined, grid=0:0:0:0 name=Europa, proj=pstereo_60, grid=115:148:237:0:0:0, area=51:181:45:134 name=S.hemisphere, proj=pstereographic, grid=11851:11851:11850:180:-60:0, area=1:23701:1:23701
map=NAME file=FILEPATH type=normal|trianglesto add a single map. The types normal and triangles are met.no specific formats - the latter containing precalculated triangles for filled land areas.
To add a map with varying resolution (depending on zoom factor):
map=NAME type=normal|triangles limit=X(in km) file=FILEPATH limit=Y(in km) file=FILEPATH ... etcwhere the limit in km defines the limiting resolution for use of this particular file. A line containing a new map=X marks the end of this definition. You may also add standard plot information inside such a block (See plot settings documentation in the batch diana section). Example:
map=Gshhs-Auto type=triangles limit=10 file=/metno/local/maps/gshhs_25.map limit=2.5 file=/metno/local/maps/gshhs_5.map limit=0.5 file=/metno/local/maps/gshhs_1.map limit=0.1 file=/metno/local/maps/gshhs_0.2.map limit=0 file=/metno/local/maps/gshhs_0.1.map contour=on cont.colour=black cont.linetype=solid cont.linewidth=1 land=on land.colour=flesh
Key(s) | Value |
name=X file=Y | X=name of product as appearing in menues, Y=path to datafiles |
archive_name=X file=Y | Same as above, but only applies when Diana is in Archive mode |
product="PRODNAME" <product-specification> end.productwhere the product-specification is like this:
Key(s) | Value |
drawtools= | comma separated list of drawing tools [Analyse,Sigkart] |
save_dir= | where to save product locally [./work] |
input_dir= | where to fetch stored components |
combine_input_dir= | where to fetch stored components when combining products |
input_products= | other products to pick components from |
field= | Field-Nametag, fieldname, met.no-field-specification |
objects= | Objects-Nametag |
comments= | Comments-Nametag |
local_idents= | identies to choose from when editing locally [comma separated list] |
database_idents= | identies to choose from when editing in product database [comma separated list] |
combine_ident= | Final-ID, ID1, ID2, .. final combine-identity with list of identies to combine. You may have several of these. |
combine_borders= | name of file containing borderlines used when combining |
database= | "mysqlservername databasename portnumber" |
name_in_database= | which productname to use in database |
time_start_early= | show warning if production starts before specified time, limit given as hour:minute (-=before,+=after product) [+00:00] |
time_start_late= | show warning if production starts after specified time, limit given as hour:minute (-=before,+=after product) [+03:00] |
grid= | for field editing, specify field grid [producer,grid,nx,ny,gridtype,gridspec[6]] |
grid.minimize | possibly minimize grid to remove undefined values along border |
commandfile= | annotations to show when editing |
standard_symbolsize= | normal size of met. objects in this product [30] |
complex_symbolsize= | normal size of sigkart objects in this product [6] |
frontlinewidth= | line width of fronts in this product [8] |
arealinewidth= | line width of areas in this product [4] |
Example:
# prognostic data m=HIRLAM.20KM.00 f=/opdata/hirlam20/vp20km00.dat m=HIRLAM.20KM.12 f=/opdata/hirlam20/vp20km12.dat # observations #bufr.temp= /opdata/obs_dec/rdb/temp/temp[yyyymmddHH].rdb #bufr.pilot= /opdata/obs_dec/rdb/pilo/pilo[yyyymmddHH].rdb metnoobs.temp= /opdata/obs_dec/temp??.dat* metnoobs.amdar= /opdata/obs_dec/amte??.dat* metnoobs.pilot= /opdata/obs_dec/pilo??.dat*
Example:
m=HIRLAM.20KM.00 f=/opdata/hirlam20/vc20km00.dat m=HIRLAM.20KM.12 f=/opdata/hirlam20/vc20km12.dat
Example:
# atmospheric model parameters u=2 v=3 tk=4 q=9 rh=10 omega=13 th=18 etadot=11 w=12 turbulence=94 # ocean model parameters ucurr=302 vcurr=303 salt=307 seatemp=308 # possibly computed in program vcdata (horizontal computations in fields) vorticity=-1 divergence=-2 ug=-3 vg=-4 pv=-5
Vertical crossection
computation/conversion functions
Example:
tc=TC_FROM_TH(th) rh=RH_FROM_TH_Q(th,q) q=Q_FROM_TK_RH(tk,rh) ff_tangent=FF_TANGENTIAL(u,v) ff_normal=FF_NORMAL(u,v)
Example:
name=TH plot=CONTOUR(th) colour=blue line.interval=4. name=Temp(C) plot=CONTOUR(tc) colour=red line.interval=4. name=Vind_NSEW plot=WIND(ff_east_west,ff_north_south) colour=black name=VT+OMEGA plot=VT+OMEGA(ff_tangent,omega) colour=darkgreen vector.unit=1.
Example:
m=WAM.50KM.00 f=/opdata/wave/wamspec00.dat m=WAM.50KM.12 f=/opdata/wave/wamspec12.dat
Key(s) | Value |
mailto= | mailing address for sending UFFDA messages |
class=X desc=Y | X="name of UFFDA class", Y="description of class" |
Diana User Guide: Setup file | Previous: Shortcut keys | Next: Field functions | Index | ![]() |