Diana User Guide: Batch plotting |  Previous: File formats |  Index

Batch plotting of Diana-products

Use a separate program, bdiana, to batch plot Diana products. This is a command line program controlled by a separate input file (in addition to the normal setup file for Diana). bdiana can plot all map products in Diana, vertical cross sections, vertical profiles and wave spectrum plots. By running the program without any parameters the following help will be shown:

***************************************************
 DIANA batch version:2004-06-28
 plot products in batch
***************************************************
 Available products:
 - All standard map-products from DIANA
 - Vertical crossections
 - Vertical profiles
 - WaveSpectrum plots
 Available output-formats:
 - as PostScript (to file and printer)
 - as EPS (Encapsulated PostScript)
 - as PNG (raster-format)
***************************************************

Usage: bdiana -i {job-filename} [-s {setup-filename}] [-v] [-display xhost:display] [-example] [-use_pixmap | -use_pbuffer] [-use_doublebuffer | -use_singlebuffer] [key=value key=value]

-i                : job-control file. See example below
-s                : setupfile for diana
-v                : (verbose) for more job-output
-display          : x-server to use (default: env DISPLAY)
-example          : list example input-file and exit
-use_pixmap       : use X Pixmap/GLXPixmap as drawing medium (default)
-use_pbuffer      : use GLX v.1.3 PixelBuffers (opposed to -use_pixmap)
-use_doublebuffer : use double buffering OpenGL (default)
-use_singlebuffer : use single buffering OpenGL

special key/value pairs:
 - TIME="YYYY-MM-DD hh:mm:ss"      plot-time
    

Time control

The plot time is initially set with the command line argument TIME="YYYY-MM-DD hh:mm:ss". In addition the time can be modified in the input file with the commands settime, addhour and addminute (see documentation below)

Input file

Note that you can get a complete example of an input file by using -example in the command line. If you are trying out diana for the first time, a good idea could be too send this text to a file (bdiana -example > bdiana.input) - this is a good starting point for making your own input file.
The example file contains plot commands, various choices for output format and some examples of job control with lists and loops. All syntax is described in the comments. Here is the example:
#--------------------------------------------------------------   
# inputfile for bdiana                                            
# - '#' marks start of comment.                                   
# - you may split long lines by adding '\' at the end.           
#--------------------------------------------------------------   
                                                                  
#- Mandatory:                                                     
buffersize=1696x1200     # plotbuffer (WIDTHxHEIGHT)              
                         # For output=RASTER: size of plot.       
                         # For output=POSTSCRIPT: size of buffer  
                         #  affects output-quality. TIP: make     
                         #  sure width/height ratio = width/height
                         #  ratio of MAP-area (defined under PLOT)
                                                                  
#- Optional: values for each option below are default-values      
setupfile=diana.setup    # use a standard setup-file              
output=POSTSCRIPT        # POSTSCRIPT/EPS/PNG                 
colour=COLOUR            # GREYSCALE/COLOUR                       
filename=tmp_diana.ps    # output filename                        
keepPlotArea=NO          # YES=try to keep plotarea for several   
                         # plots                                  
                                                                  
# the following options for output=POSTSCRIPT or EPS only         
toprinter=NO             # send output to printer (postscript)    
                         # obsolete command! use PRINT_DOCUMENT instead
printer=fou3             # name of printer        (postscript)    
                         # (see PRINT_DOCUMENT command below)     
papersize=297x420,A4     # size of paper in mm,   (postscript)    
                         # papertype (A4 etc) or both.            
drawbackground=NO        # plot background colour (postscript)    
orientation=LANDSCAPE    # PORTRAIT/LANDSCAPE     (postscript)    
                         # (default here is really 'automatic'    
                         # which sets orientation according to    
                         # width/height-ratio of buffersize)      
                                                                  
#--------------------------------------------------------------   
# Product-examples:                                               
# Products are made by one or more PLOT-sections seen below,      
# inbetween two PLOT-sections you may change any of the options   
# described above.                                                
# The data-time will be set from the TIME="isotime-string"      
# commandline parameter.                                          
# Output fielname may contain data-time, format see man date    
# Example: filename=diana_%Y%M%dT%H.ps                          
#--------------------------------------------------------------   
# STANDARD MAP-PRODUCT SECTION:                                   
PLOT                     # start of plot-command for map-product  
# paste in commands from quick-menues (one line for each element) 
                                                                  
FIELD HIRLAM.00 DZ(500-850) colour=yellow linetype=solid \
 linewidth=1 line.interval=40 extreme.type=Ingen extreme.size=1 \
 extreme.radius=1 line.smooth=0 value.label=1 label.size=1  \
 field.smooth=0 grid.lines=0 undef.masking=0 undef.colour=white \
 undef.linewidth=1 undef.linetype=solid
FIELD DNMI.ANA MSLP colour=blue linetype=dash linewidth=2 \
 line.interval=1 extreme.type=Ingen extreme.size=1 \
 extreme.radius=1 line.smooth=0 value.label=1 label.size=1 \
 field.smooth=0 grid.lines=0 undef.masking=0 undef.colour=white \
 undef.linewidth=1 undef.linetype=solid
OBS plot=Synop data=Synop parameter=Vind,TTT,TdTdTd,PPPP,ppp,a,h,\
 VV,N,RRR,ww,W1,W2,Nh,Cl,Cm,Ch,vs,ds,TwTwTw,PwaHwa,Dw1Dw1,Pw1Hw1,\
 TxTn,sss,911ff,s,fxfx,Kjtegn  tempprecision=true density=1 scale=1 \
 timediff=180 colour=black font=Helvetica face=normal
OBJECTS NAME="DNMI Bakkeanalyse" types=front,symbol,area \
 timediff=60
MAP area=Norge backcolour=white map=Gshhs-AUTO contour=on \
 cont.colour=black cont.linewidth=1 cont.linetype=solid cont.zorder=1 \
 land=on land.colour=landgul land.zorder=0 latlon=off frame=off
LABEL data font=Helvetica
LABEL text="$day $date $auto UTC" tcolour=red bcolour=black \
 fcolour=white:200 polystyle=both halign=left valign=top \
 font=Helvetica fontsize=12
                                                                  
ENDPLOT                  # End of plot-command                    
#--------------------------------------------------------------   
# VERTICAL CROSSECTION SECTION:                                   
filename=vcross.ps                                                
                                                                  
# detailed options for plot                                       
#VCROSS.OPTIONS                                                   
#text=on textColour=black                                         
#frame=on frameColour=black frameLinetype=solid frameLinewidth=1  
#etc...  (see DIANA documentation or diana.log)                   
#VCROSS.OPTIONS.END                                               
                                                                  
VCROSS.PLOT              # start of vertical crossection plot     
                                                                  
VCROSS model=HIRLAM.00 field=Temp(C) colour=black linetype=solid \
 linewidth=1 line.interval=4 line.smooth=0 value.label=1 \
 label.size=1 test.contour.shading=0
VCROSS model=HIRLAM.00 field=Temp(C) colour=red linetype=solid \
 linewidth=1 line.interval=4 line.smooth=0 value.label=1 \
 label.size=1 test.contour.shading=1
                                                                  
CROSSECTION=A.(70N,30W)-(50N,30W) # name of crossection           
                                                                  
ENDPLOT                  # End of plot-command                    
#--------------------------------------------------------------   
# VERTICAL PROFILE SECTION:                                       
filename=vprof.ps                                                 
                                                                  
# detailed options for plot                                       
#VPROF.OPTIONS                                                    
#tttt=on                                                          
#tdtd=on                                                          
#etc...  (see DIANA documentation or diana.log)                   
#VPROF.OPTIONS.END                                                
                                                                  
VPROF.PLOT               # start of vertical profile plot         
                                                                  
OBSERVATION.ON           # plot observation: OBSERVATION.ON/OFF   
MODELS=HIRLAM.00,EC.12   # comma-separated list of models         
STATION=KIRKENES         # station-name                           
                                                                  
ENDPLOT                  # End of plot-command                    
#--------------------------------------------------------------   
# SPECTRUM SECTION:                                               
filename=spectrum.ps                                              
                                                                  
# detailed options for plot                                       
#SPECTRUM.OPTIONS                                                 
#freqMax=0.3                                                      
#backgroundColour=white                                           
#etc...  (see DIANA documentation or diana.log)                   
#SPECTRUM.OPTIONS.END                                             
                                                                  
SPECTRUM.PLOT            # start of spectrum plot                 
                                                                  
MODEL=WAM.50KM.00        # model                                  
STATION="60.1N 5.3W"   # station-name                           
                                                                  
ENDPLOT                  # End of plot-command                    
#--------------------------------------------------------------   
# ADDITIONAL:                                                     
#--------------------------------------------------------------   
#- You can add LOOPS with one or more variables:                  
#  LOOP [X]|[Y] = X_value1 | Y_value1 , X_value2 | Y_value2       
#   <any other input lines, all "[X]" and "[Y]" will be       
#   replaced by the values after '=' for each iteration>          
#  LOOP.END                                                       
#  The example shows a loop with two variables ([X] and [Y],      
#  separated by '|') and two iterations (separated with ',')      
#  Loops kan be nested                                            
#--------------------------------------------------------------   
#- Make a LIST for use in loops:                                  
#  LIST.stations           # A new list with name=stations        
#  OSLO                    # May contain any strings..            
#  KIRKENES                #                                      
#  LIST.END                # Marks End of list                    
#                                                                 
#  To use in a loop:                                              
#  LOOP [VAR]=@stations    # The key here is the '@' with the   
#                          # list-name.                           
#  LOOP.END                # This will loop over all list-entries 
#                                                                 
#  NOTES:                                                         
#  - To make a list with multiple variables, convenient for       
#    multiple-variable loops, just add '|'s in the list-strings.
#    Example:                                                     
#    LIST.name             # new list                             
#    OSLO | blue           # two variables for each entry         
#    KIRKENES | red        #                                      
#    LIST.END                                                     
#                                                                 
#    LOOP [POS] | [COL] = @name # Loop using two variables in list
#    LOOP.END                                                     
#  - Lists must be defined OUTSIDE all loop statements            
#--------------------------------------------------------------   
#- alternative to TIME=.. commandline option:                     
#  use settime=YYYY-MM-DD hh:mm:ss                                
#- use addhour=<value> or addminute=<value> to increment datatime 
#  (offset from TIME="" variable). Useful in loops              
#--------------------------------------------------------------   
#- "key=value" pairs given on the commandline controls variables
#  in the inputfile: Any "$key" found in the text will be       
#  substituted by "value".                                      
#--------------------------------------------------------------   
#- toggle archive mode (for observations)                         
#  archive=ON/OFF  (default=OFF)                                  
#--------------------------------------------------------------   
#- Making TRAJECTORIES                                            
#  to create and plot trajectories from any vector-field use:     
#  TRAJECTORY_OPTIONS=<options>    # see available options below  
#  TRAJECTORY=ON                   # Set this before PLOT command 
#  TRAJECTORY=OFF                  # Turn off trajectories when finished
#  Valid options:                                                 
#  latitudelongitude=<lat>,<lng>   # start position, repeat if necessary
#  field="<full fieldname>"        # Example: "HIRLAM.00 VIND10.M" 
#  colour=<colourname>             # Colour of trajectory lines   
#  line=<linewidth>                # width of trajectory lines    
#  numpos=1,5 or 9                 # number of sub-positions      
#  radius=<spreadth in km>         # if numpos>1, spreadth in km  
#  timemarker=<minutes>            # marker for each specified minute
# 
#  Example: 
#    TRAJECTORY_OPTIONS=latitudelongitude=58.0,11.0 latitudelongitude=60.0,9.0 \ 
#    latitudelongitude=66.0,0.0 field="HIRLAM.00 VIND.10M" colour=red \ 
#    linewidth=2 numpos=5 radius=50 timemarker=0 
#  specifies 3 start positions, each with 5 sub-pos., using a HIRLAM 
#  wind-field as input (must also be specified in PLOT section)      
#  Prepare for trajectories 
#    TRAJECTORY=ON  
#  followed by a series of PLOT sections where the above field must be 
#  specified, running through the desired timesteps: 
#    LOOP [HOUR]=0,3,6,9 
#    ADDHOUR=[HOUR] 
#    FILENAME=traj_[HOUR].png 
#    PLOT 
#     FIELD HIRLAM.00 VIND.10M ........ etc. 
#    ENDPLOT 
#    LOOP.END 
#  Finally, turn off trajectories with: 
#    TRAJECTORY=OFF 
#--------------------------------------------------------------   
#* PostScript output * 
#- Send current postscript-file to printer (immediate command):   
#  PRINT_DOCUMENT                         
#
#- MULTIPLE PLOTS PER PAGE                  
#  You can put several plots in one postscript page by using the 'multiple.plots'
#  and 'plotcell' commands. Start with describing the layout you want:
# 
#  MULTIPLE.PLOTS=<rows>,<columns> # set the number of rows and columns
# 
#  In the same command, you can specify the spacing between plots and 
#  the page-margin (given as percent of page width/height [0-100]): 
#  MULTIPLE.PLOTS=<rows>,<columns>,<spacing>,<margin> 
#  
#  Then, for each separate plot use the plotcell command to place plot on page:
#  PLOTCELL=<row>,<column>         # the row and column, starting with 0
#  
#  Finally, end the page with: 
#  MULTIPLE.PLOTS=OFF 
#  
#- To produce multi-page postscript files: Just make several plots 
#  to the same filename (can be combined with MULTIPLE.PLOTS). 
#  You can not mix mapplots, crossections or soundings in one file
#  
#- Use of alpha-channel blending is not supported in postscript 
#--------------------------------------------------------------   
#* Interactive batch-plotting *                  
#  To make plots on-demand, you will find this feature useful.  
#  Put this in the input-file:  
#    command_path=<some_path> 
#    wait_for_commands 
#  and bdiana will wait at the 'wait_for_commands' line, periodically
#  checking '<some_path>' for a matching filename. When found, the 
#  file(s) are read and the instructions within executed. If the line:
#    wait.end 
#  is encountered, bdiana will stop waiting for commands. 
#  The 'command_path' must specify a complete filename - optionally 
#  with wildcards. Example: '/tmp/*.txt' 
#  NB: all files found are deleted immediately after reading.  
#--------------------------------------------------------------   
#* Batch-plotting triggered by Signals *                  
#  Alternative on-demand production (developed for use in WMS) 
#  Start bdiana with the -signal commandline option. 
#  After the initial input/setup have been read, bdiana will write its 
#  pid-number to file bdiana.pid, and wait for a SIGUSR1-signal from an 
#  external process. After a signal is received, the command_path is scanned
#  for commandfile(s), and these will be processed in the same fashion as
#  in the wait_for_commands section above.
#  If a confirmative answer is required, add the command fifo=<name>, and
#  bdiana will write the single character 'r' to the named FIFO. NB: The 
#  FIFO must exist! 
#--------------------------------------------------------------        
#* Get Capabilities *                                                 
#  Developed for use in WMS                                           
#  The syntax of the TIME- and LEVEL-sections are equal to the        
#  PLOT-sections. The plot options will be ignored.                   
#  The TIME-sections give available times,                            
#  both normal and constant times.                                     
#  The LEVEL-sections give available levels.                          
#  Valid options:                                                     
#  Normal times common to all products and  all constant times:       
#  time_options = intersection                                        
#  All normal times from all products:                                
#  time_options = union           
#  Time format in outputfile                                    
#  time_format=%Y-%m-%dT%H:%M:%S                                      
#  TIME                                                               
#  FIELD HIRLAM.00 DZ(500-850) colour=yellow linetype=solid \\        
#  linewidth=1 line.interval=40 extreme.type=None extreme.size=1 \\   
#  extreme.radius=1 line.smooth=0 value.label=1 label.size=1  \\      
#  field.smooth=0 grid.lines=0 undef.masking=0 undef.colour=white \\  
#  undef.linewidth=1 undef.linetype=solid                             
#  FIELD DNMI.ANA MSLP                                                
#  OBS plot=Synop data=Synop parameter=Vind,TTT,TdTdTd,PPPP,ppp,a,h,\\
#  VV,N,RRR,ww,W1,W2,Nh,Cl,Cm,Ch,vs,ds,TwTwTw,PwaHwa,Dw1Dw1,Pw1Hw1,\\ 
#  TxTn,sss,911ff,s,fxfx,Kjtegn  tempprecision=true density=1 \\      
#  scale=1 timediff=180 colour=black font=Helvetica face=normal       
#  OBJECTS NAME=\"DNMI Bakkeanalyse\" types=front,symbol,area         
#  ENDTIME                                                            
#  LEVEL                                                              
#  FIELD HIRLAM.20KM.00 Z                                             
#  ENDLEVEL                                                           
#--------------------------------------------------------------      

    

Plot settings

Maps (Those marked with * can only be used in bdiana)
ExplanationOption w/default valueValues
Background colourbackcolour=blackAll colours
Area by namearea=AtlantAreas defined in setup file
Force area*xylimit=x1,x2,y1,y2Set new corner values
Force area*xypart=x1%,x2%,y1%,y2%Set new corner values as percent of width/height
Map namemap=Euro1maps defined in setup file
Plot contour linecontour=ONON | OFF
contour colourcont.colour=blackAll colours
contour linewidthcont.linewidth=1
contour linetypecont.linetype=solidlinetypes defined in setup file
contour zordercont.zorder=00,1,2 (lowest, Auto, Highest)
Plot filled landland=ONON | OFF
land colourland.colour=blackAll colours
land zorderland.zorder=00,1,2 (lowest, Auto, Highest)
Plot latlon linelatlon=ONON | OFF
latlon colourlatlon.colour=blackAll colours
latlon linewidthlatlon.linewidth=1
latlon linetypelatlon.linetype=solidlinetypes defined in setup file
latlon zorderlatlon.zorder=00,1,2 (lowest, Auto, Highest)
Plot frameframe=ONON | OFF
frame colourframe.colour=blackAll colours
frame linewidthframe.linewidth=1
frame linetypeframe.linetype=solidlinetypes defined in setup file
frame zorderframe.zorder=00,1,2 (lowest, Auto, Highest)

Labels (Those marked with * can only be used in bdiana)
Example Explanation
LABEL data options ask all plots for annotation string and text colour
LABEL text="some text" options simple text
LABEL anno=<...> options more complex annotations

General options (used for the whole label)
Option Explanation
tcolour text colour
bcolour border colour
fcolour fill colour
polystyle fill area and or draw border -fill/border/none/both
halign horizontal alignment - right/left/center
valign vertical alignment -top/bottom/center
xoffset ratio (offset)/(frame width)-left if center or right aligned, right if left aligned
yoffset ratio (offset)/(frame height)- down if center or top aligned, up if bottom aligned
xratio ratio (annotation width)/(frame width) -scales annotation when zooming in/out
yratio ratio (annotation height)/(frame height) -scales annotation when zooming in/out
marginratio (distance to border of label)/(frame height)
font
fontsize
facefont face
yclinewidthborder width
plotrequested if true, annotations aligned rel. to frame (not window)

Complex annotations

One LABEL may consist of many anno statements. One anno may consist of many elements and options. Each element and option are written in <...>. Syntax: anno=<..><...><...> (no space between elements/options) The elements are plotted side by side vertically.

Elements
Option SyntaxExplanation
box <box, options><..><..></box> box is recursive, and may contain other elements even box


vertical - horizontal,pstyle,fcolour,bcolour,tcolour
image <image=pic.png,options> size
text <text="Testing testing",options> Quotation marks are only needed when the text contains space, font,fontsize,face
symbol <symbol=....,options> size
table <table,options> All fieldPlots and satPlots are asked for a table, if they have, it is plotted

<table=name,options> All fieldPlots and satPlots are asked if they a table named "name", if they have, it is plotted

<table="HIRLAM.20KM.00 T.2M;255:75:75;;6 - 8;255:150:150;;4 - 6;255:215:215;;2 - 4;255:245:245;;0 - 2",options> Exactly this table plotted independent of data


title - if dropped, title from data.
title="" - no title


options:fcolour
arrow <arrow> All vector and observation plots are asked for a unit arrow length, if any, arrows are plotted

<arrow=1.3,feather=true,tcolour=red> Arrow of length 1.3 with feathers is plotted in red. Possible options: tcolour,feather
input

Fields (Those marked with * can only be used in bdiana)

      FIELD X Y  options #X:model
                         #Y:field

    

Example:

FIELD HIRLAM.20KM.00 MSLP colour=blue linetype=solid linewidth=1 

ExplanationOption w/default valueValues
colour of isolinecolour=blackcolour
line typelinetype=solidline type
line widthlinewidth=1number
line intervalline.interval=1
density of wind/vectorsdensity=0
unit (length) of vectorvector.unit=10
relative size of wind/vectorsrel.size=1
extreme typesextreme.type=NoneC/H, L/H
size of extreme labelsextreme.size=1
density of extreme labelsextreme.radius=1
value written on isolinevalue.label=1 0=no label/ 1=label
isoline smoothline.smooth=00=no smooth
field smmothfield.smooth=00=no smooth
show grid linesgrid.lines=0
show grid lines if numbers < max grid.lines.max=0
time offset rel. to main plot timehour.offset=0 hours
max time difference from main plot timehour.diff=0 hours
mask undef valuesundef.masking=00=off/1=on
mask colourundef.colour=whitecolour
mask line widthundef.linewidth=1
mask line typeundef.linetype=solidline type
size of isoline labelslabel.size=1
show zerolinezero.line=10=off/1=on
legend on/offtable=00=off/1=on
repeat coloursrepeat=00=off/1=on
palette from setup, colours or RGBApalettecolours=off palettecolours=some_palette
palettecolours=red,green,blue,white
palettecolours=255:255:255,100:100:100,200:200:200
use fill patterns defined in setuppatterns=off pattern=some_pattern
alpha shadingalpha=2550 - 255
isoline offsetbase=0number
skip isolines below minvalue=offoff,number
skip isolines above maxvalue=offoff,number
extra isolinescolour_2=offoff,colour
extra isolinesline.interval_2=1
extra isolineslinewidth_2=1
extra isolineslinetype_2=1
extra isolinesbase_2=1
extra isolinesminvalue_2=off
extra isolinesmaxvalue_2=off

Observations (Those marked with * can only be used in bdiana)
ExplanationOption w/default valueValues
plot typeplot=synop,metar,list,
data type data=synop,dribu,metar ...
parameterparameter=defined in ObsManager or ascii files
colourcolour=blackcolour
min. distance to nearest neigbourdensity=1
fontfont=Helvetica
faceface=normal
mark positionsimage=markers defined in setup
reading all obs., mixing different files moretimes=falsetrue/false
plot positions only, no parameters onlypos=falsetrue/false
name of file with priority list priority=filename
size of observationscale=1
all positions marked with x showpos=truetrue/false
temperature in integers tempprecision=false true/false
max time difference from main plot time timediff=60minutes
criteria criteria=criteria=TTT<0,blue;TTT>0,red

Geo Images (Those marked with * can only be used in bdiana)

      SAT X Y Z options #X: satellite/radar
                        #Y:file type
                        #Z:channels
    

Example:

SAT NOAA Europa 1+2+4 timediff=60 mosaic=0 cut=0.02 alphacut=0 alpha=1
ExplanationOption w/default valueValues
max time difference from main plot time timediff=60minutes
mosaic of several pictures mosaic=00/1
adjusting contrastcut=0.02
alpha shadingalpha=10-1
drop pixels with low alpha value alphacut=0 0-1
Legend on/offTable=10/1
colours to hidehide= coloours (comma separated)

Objects (Those marked with * can only be used in bdiana)
ExplanationOptions w/default valueExample
File namefile file=/opdata/diana/Bakkeanalyse/DNMI-objects/DNMI_ANAdraw.200402110900
Product namenamename="DNMI Bakkeanalyse"
Product timetimetime=200402110300
Max. time differencetimediff=60timediff=90
Front line width*frontlinewidthfrontlinewidth=4
Symbol size*fixedsymbolsizefixedsymbolsize=16
Symbol filter*symbolfiltersymbolfilter=tekster
Object typestypes=front,symbol,area,annotypes=front,symbol

Trajectories (Those marked with * can only be used in bdiana)
ExplanationOption w/default valueValues
start positionslatitudelongitude=
colourcolour=blackcolour
line typelinetype=solidline type
line widthlinewidth=1number
no. of subpositionsnumpos=11,5,9
dist. between subpositions radius=50number
time marks on the trajectory timemarker=0
trajectory computed from field field=ex: field="HIRLAM.00 VIND.10M"

Plot settings for vertical cross sections

The data part of the plot command (VCROSS ... in VCROSS.PLOT) can be found by selecting the desired plot in diana, when "Apply" is selected, Diana will print the command in your terminal windows.
Detailed settings for the rest of the diagram are set inside the tags: #VCROSS.OPTIONS and #VCROSS.OPTIONS.END or alternatively directly in the VCROSS.PLOT section. Here is a complete list of these options, including default value:

Explanation Options w/default value Values
Show data text text=on on/off
Colour of data text textColour=black colour
Show frame w/values frame=on on/off
Frame colour frameColour=black colour
Frame line type frameLinetype=solid line type
Frame line width frameLinewidth=1 number
Show extended frame ExtFrame=off on/off
Mark level LevelMarks=on on/off
Numbers on levels LevelNumbers=on on/off
Show upper level UpperLevel=on on/off
Upper level line colour upperLevelColour=black colour
Upper level line type upperLevelLinetype=solidline type
Upper level line width upperLevelLinewidth=1 number
Show lower level LowerLevel=on on/off
Lower level colour lowerLevelColour=black colour
Lower level line type lowerLevelLinetype=solidline type
Lower level line width lowerLevelLinewidth=1 number
Show other levels OtherLevels=off on/off
Other levels colour otherLevelsColour=black colour
Other levels line type otherLevelsLinetype=solidline type
Other levels line width otherLevelsLinewidth=1 number
Show surface Surface=on on/off
Surface colour surfaceColour=black colour
Surface line type surfaceLinetype=solid line type
Surface line width surfaceLinewidth=1 number
Show grid x,y XYpos=off on/off
Grid x,y colour xyposColour=black colour
Geographic positions GeoPos=on on/off
Geographic position colour geoposColour=black colour
Vertical grid lines VerticalGridLines=off on/off
Vertical grid line colour vergridColour=black colour
Vertical grid line type vergridLinetype=solid line type
Vertical grid line width vergridLinewidth=1 number
Extrapolate to fixed P extrapolateFixedLevels=offon/off
Extrapolate to sea floorextrapolateToBottom=on on/off
Show pressure vertically pressureVertical=off on/off
Fixed horiz./vert. ratio keepVerHorRatio=onon/off
Horiz./vert. ratio verHorRatio=150 number
Default vertical area stdVerticalArea=off on/off
Min. vertical area minVerticalArea=0 0-100
Max. vertical area maxVerticalArea=100 0-100
Default horizontal area stdHorizontalArea=offon/off
Min. horizontal area minHorizontalArea=0 number
Max. horizontal area maxHorizontalArea=100 number
Background colour backgroundColour=white colour

Values:

Plot settings for vertical profiles

As for vertical cross sections detailed settings for plotting vertical profiles are set inside the tags: #VPROF.OPTIONS and #VPROF.OPTIONS.END, alternatively directly in the VPROF.PLOT section. Here is a complete list of these options, including default value:

Explanation Options w/default value Values
Temperature tttt=on on/off
Dew point tdtd=on on/off
Wind wind=on on/off
Vertical wind (model) vwind=off on/off
Relative humidity relhum=off on/off
Ducting ducting=off on/off
K-index kindex=on on/off
Significant wind (dd-ff)slwind=off on/off
Datacolours dataColour=blue,red, darkGreen,black,magenta, darkGray,darkRed,darkCyan, orange,darkMagenta colour list
Data line widths dataLinewidth=3,3,3,3,3,3,3,3,3number list
Wind arrows line widthswindLinewidth=1,1,1,1,1,1,1,1,1number list
Separate wind column windseparate=on on/off
Text text=on on/off
Geographic position in textgeotext=on on/off
Limits for vertical wind (-X,X) rvwind=0.01 number hPa/s
Limits for ducting (-X,0) rducting=400number
Set number of text lines for station and timelinetext=0 0=Not set
Background colour backgroundColour=white colour
Diagram type diagramtype=0 0=Amble 1=Exner(pi) 2=Pressure 3=ln(P)
The temperature lines angle vs. the verticaltangle=45 0-360
Pressure reach min pminDiagram=100 number
Pressure reach max pmaxDiagram=1050 number
Min temp. at 1000 hPa tminDiagram=-30 (C)
Max temp. at 1000 hPa tmaxDiagram=30 (C)
Temperature limits trangeDiagram=0 0=fixed 1=fixed.max-min 2=minimum
Show pressure lines plines=on on/off
Pressure lines at flight levelsplinesfl=off on/off
Pressure lines colour pColour=black colour
Pressure line type pLinetype=solid line type
Pressure lines width 1pLinewidth1=1 number
Pressure lines width 2pLinewidth2=3 number
Show temperature linestlines=on on/off
Temperature line step tStep=5 number
Temperature line colourtColour=black colour
Temperature line type tLinetype=solid line type
Temperature line width 1tLinewidth1=1 number
Temperature line width 2tLinewidth2=3 number
Show dry adiabat dryadiabat=on on/off
Dry adiabat steps dryadiabatStep=10 number
Dry adiabat colour dryadiabatColour=black colour
Dry adiabat line type dryadiabatLinetype=solidline type
Dry adiabat line widthdryadiabatLinewidth=1number
Show wet adiabat wetadiabat=on on/off
Wet adiabat steps wetadiabatStep=5 number
Wet adiabat colour wetadiabatColour=darkRedcolour
Wet adiabat line type wetadiabatLinetype=solidline type
Wet adiabat line widthwetadiabatLinewidth=1number
Wet adiabat P min wetadiabatPmin=300 number
Wet adiabat T min wetadiabatTmin=-50 number
Show mixing ratio mixingratio=on on/off
Mixing ratio line set mixingratioSet=1 0/1/2/3
Mixing ratio colour mixingratioColour=magentacolour
Mixing ratio line typemixingratioLinetype=longdashline type
Mixing ratio line widthmixingratioLinewidth=1number
Mixing ratio P minmixingratioPmin=300 number
Mixing ratio T minmixingratioTmin=-50 number
Show numbers for P labelp=on on/off
Show numbers for T labelt=on on/off
Show numbers for mixing ratiolabelq=on on/off
Show frame frame=on on/off
Frame colour frameColour=black colour
Frame line type frameLinetype=solid line type
Frame line width frameLinewidth=2 number
Text colour textColour=black colour
Show flight levels flevels=on on/off
Flight levels colour flevelsColour=black colour
Flight levels line typeflevelsLinetype=solid line type
Flight levels line width 1flevelsLinewidth1=1 number
Flight levels line width 2flevelsLinewidth2=3 number
Show FL label labelflevels=on on/off
Relative size of vertical axisrsvaxis=1 number
Text relative size rstext=1 number
P and T numbers relative sizerslabels=1 number
Wind column width relative sizerswind=1 number
Vertical wind width relative sizersvwind=1 number
Relative humidity width relative sizersrelhum=1number
Ducting width relative sizersducting=1number
Support lines for rel.hum., vert.wind. and ducting line typerangeLinetype=solid line type
Support lines for rel.hum., vert.wind. and ducting line widthrangeLinewidth=1 numbers
Show contrails cotrails=on on/off
Contrail colour cotrailsColour=cyan colour
Contrail line typecotrailsLinetype=solid line type
Contrail line widthcotrailsLinewidth=3number
Contrail P min cotrailsPmin=100 number
Contrail P max cotrailsPmax=700 number

X-server and Xvfb

As mentioned in bdiana's help text, it needs an X-server. If bdiana is run on a machine with an active X-session it will automatically use this. On machines without X or when running without the user being logged in, a different X-server needs to be set with the -display variable (host:display-no.screen-no). A good alternative on linux machines is Xvfb (X virtual framebuffer). For example:
          # Starting Xvfb with OpenGL support
          Xvfb :5 -screen 0 1280x1024x24 -ac 
	  
Here Xvfb is started so that display-no is 5 and screen-no is 0 on the machine hosting the Xvfb framebuffer. For Xvfb to run in the background even after logging out:
          # Xvfb as a background process
          nohup Xvfb :5 -screen 0 1280x1024x24 -ac &
	  
This is how you can use Xvfb with bdiana - given the above example:
          bdiana -input "bdiana.input" -display "host":5.0
	  

 Diana User Guide: Batch plotting |  Previous: File formats |  Index