| Diana User Guide: Batch plotting | Previous: File formats | Index | ![]() |
Area (Those marked with * can only be used in bdiana)
Examples:
AREA name=Atlant
AREA name=Atlant rectangle=4.0e+06:8.0e06:4.0e+06:6.0e06
AREA proj4string="+proj=ob_tran +o_proj=eqc +lon_0=0 +o_lat_p=25
+x_0=5.14744e+06 +y_0=4.03549e+06 +a=6371000.0 +b=6371000.0"
rectangle=4.0e+06:8.0e06:4.0e+06:6.0e06
| Explanation | Option w/default value | Values |
|---|---|---|
| Area by name | name=Atlant | Area defined in setup file |
| projection* | proj4string="+proj=.." | |
| rectangle* | rectangle=x1:x2:y1:y2 | in proj coordinates |
Maps (Those marked with * can only be used in bdiana)
| Explanation | Option w/default value | Values |
|---|---|---|
| Background colour | backcolour=black | All colours |
| Force area* | xylimit=x1,x2,y1,y2 | Set new corner values |
| Force area* | xypart=x1%,x2%,y1%,y2% | Set new corner values as percent of width/height |
| Map name | map=Euro1 | maps defined in setup file |
| Plot contour line | contour=ON | ON | OFF |
| contour colour | cont.colour=black | All colours |
| contour linewidth | cont.linewidth=1 | |
| contour linetype | cont.linetype=solid | linetypes defined in setup file |
| contour zorder | cont.zorder=0 | 0,1,2 (lowest, Auto, Highest) |
| Plot filled land | land=ON | ON | OFF |
| land colour | land.colour=black | All colours |
| land zorder | land.zorder=0 | 0,1,2 (lowest, Auto, Highest) |
| Plot latlon line | latlon=ON | ON | OFF |
| latlon colour | latlon.colour=black | All colours |
| latlon linewidth | latlon.linewidth=1 | |
| latlon linetype | latlon.linetype=solid | linetypes defined in setup file |
| latlon zorder | latlon.zorder=0 | 0,1,2 (lowest, Auto, Highest) |
| Plot frame | frame=ON | ON | OFF | 2 | 3 (ON and OFF are equivalent to 1 and 0; 2 fills the frame with the background colour, 3 fills the frame with the background colour and draws a border) |
| frame colour | frame.colour=black | All colours |
| frame linewidth | frame.linewidth=1 | |
| frame linetype | frame.linetype=solid | linetypes defined in setup file |
| frame zorder | frame.zorder=0 | 0,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 |
| margin | ratio (distance to border of label)/(frame height) |
| font | |
| fontsize | |
| face | font face |
| yclinewidth | border 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 | Syntax | Explanation |
|---|---|---|
| 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
| Explanation | Option w/default value | Values |
|---|---|---|
| colour of isoline | colour=black | colour |
| line type | linetype=solid | line type |
| line width | linewidth=1 | number |
| line interval | line.interval=1 | |
| density of wind/vectors | density=0 | 1:
all arrows are plotted 0 or auto: density automaticlly adjusts to fit the zoom level Auto(2): density automaticlly adjusts to fit the zoom level, but more arrows are plotted -1: auto, but all gridpoints are used to find best density, not only current rectangle. Ensures that all tiles have same density. |
| density of wind/vectors | density.factor=1 | density.factor=2 is equivalent to density=Auto(2) |
| unit (length) of vector or size ov wind arrows | vector.unit=10 | |
| extreme types | extreme.type=None | C/H, L/H |
| size of extreme labels | extreme.size=1 | |
| density of extreme labels | extreme.radius=1 | |
| value written on isoline | value.label=1 | 0=no label/ 1=label |
| isoline smooth | line.smooth=0 | 0=no smooth |
| field smmoth | field.smooth=0 | 0=no smooth |
| show grid lines | grid.lines=0 | |
| show grid lines if numbers < max | grid.lines.max=0 | |
| time offset rel. to main plot time | hour.offset=0 | hours |
| max time difference from main plot time | hour.diff=0 | hours |
| mask undef values | undef.masking=0 | 0=off/1=on |
| mask colour | undef.colour=white | colour |
| mask line width | undef.linewidth=1 | |
| mask line type | undef.linetype=solid | line type |
| size of isoline labels | label.size=1 | |
| show zeroline | zero.line=1 | 0=off/1=on |
| legend on/off | table=0 | 0=off/1=on |
| repeat colours | repeat=0 | 0=off/1=on |
| palette from setup, colours or RGBA | palettecolours=off | palettecolours=some_palette palettecolours=red,green,blue,white palettecolours=255:255:255,100:100:100,200:200:200 |
| use fill patterns defined in setup | patterns=off | pattern=some_pattern |
| alpha shading | alpha=255 | 0 - 255 |
| isoline offset | base=0 | number |
| skip isolines below | minvalue=off | off,number |
| skip isolines above | maxvalue=off | off,number |
| extra isolines | colour_2=off | off,colour |
| extra isolines | line.interval_2=1 | |
| extra isolines | linewidth_2=1 | |
| extra isolines | linetype_2=1 | |
| extra isolines | base_2=1 | |
| extra isolines | minvalue_2=off | |
| unit | kelvin, celsius, hectopascal |
Observations (Those marked with * can only be used in bdiana)
| Explanation | Option w/default value | Values |
|---|---|---|
| plot type | plot= | synop,metar,list, |
| data type | data= | synop,dribu,metar ... |
| parameter | parameter= | defined in ObsManager or ascii files |
| colour | colour=black | colour |
| min. distance to nearest neigbour | density=1 | |
| font | font=Helvetica | |
| face | face=normal | |
| mark positions | image= | markers defined in setup |
| reading all obs., mixing different files | moretimes=false | true/false |
| plot positions only, no parameters | onlypos=false | true/false |
| name of file with priority list | priority= | filename |
| size of observation | scale=1 | |
| all positions marked with x | showpos=true | true/false |
| temperature in integers | tempprecision=false | true/false |
| max time difference from main plot time | timediff=60 | minutes |
| 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
| Explanation | Option w/default value | Values |
|---|---|---|
| max time difference from main plot time | timediff=60 | minutes |
| mosaic of several pictures | mosaic=0 | 0/1 |
| adjusting contrast | cut=0.02 | |
| alpha shading | alpha=1 | 0-1 |
| drop pixels with low alpha value | alphacut=0 | 0-1 |
| Legend on/off | Table=1 | 0/1 |
| colours to hide | hide= | coloours (comma separated) |
Objects (Those marked with * can only be used in bdiana)
| Explanation | Options w/default value | Example |
|---|---|---|
| File name | file | file=/opdata/diana/Bakkeanalyse/DNMI-objects/DNMI_ANAdraw.200402110900 |
| Product name | name | name="DNMI Bakkeanalyse" |
| Product time | time | time=200402110300 |
| Max. time difference | timediff=60 | timediff=90 |
| Front line width* | frontlinewidth | frontlinewidth=4 |
| Symbol size* | fixedsymbolsize | fixedsymbolsize=16 |
| Symbol filter* | symbolfilter | symbolfilter=tekster |
| Object types | types=front,symbol,area,anno | types=front,symbol |
Trajectories (Those marked with * can only be used in bdiana)
| Explanation | Option w/default value | Values |
|---|---|---|
| start positions | latitudelongitude= | |
| colour | colour=black | colour |
| line type | linetype=solid | line type |
| line width | linewidth=1 | number |
| no. of subpositions | numpos=1 | 1,5,9 |
| dist. between subpositions | radius=50 | number |
| time marks on the trajectory | timemarker=0 | |
| trajectory computed from field | field= | ex: field="HIRLAM.00 VIND.10M" |
| 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=solid | line 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=solid | line 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=solid | line 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=off | on/off |
| Extrapolate to sea floor | extrapolateToBottom=on | on/off |
| Show pressure vertically | pressureVertical=off | on/off |
| Fixed horiz./vert. ratio | keepVerHorRatio=on | on/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=off | on/off |
| Min. horizontal area | minHorizontalArea=0 | number |
| Max. horizontal area | maxHorizontalArea=100 | number |
| Background colour | backgroundColour=white | colour |
| 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,3 | number list |
| Wind arrows line widths | windLinewidth=1,1,1,1,1,1,1,1,1 | number list |
| Separate wind column | windseparate=on | on/off |
| Text | text=on | on/off |
| Geographic position in text | geotext=on | on/off |
| Limits for vertical wind (-X,X) | rvwind=0.01 | number hPa/s |
| Limits for ducting (-X,0) | rducting=400 | number |
| Set number of text lines for station and time | linetext=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 vertical | tangle=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 levels | plinesfl=off | on/off |
| Pressure lines colour | pColour=black | colour |
| Pressure line type | pLinetype=solid | line type |
| Pressure lines width 1 | pLinewidth1=1 | number |
| Pressure lines width 2 | pLinewidth2=3 | number |
| Show temperature lines | tlines=on | on/off |
| Temperature line step | tStep=5 | number |
| Temperature line colour | tColour=black | colour |
| Temperature line type | tLinetype=solid | line type |
| Temperature line width 1 | tLinewidth1=1 | number |
| Temperature line width 2 | tLinewidth2=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=solid | line type |
| Dry adiabat line width | dryadiabatLinewidth=1 | number |
| Show wet adiabat | wetadiabat=on | on/off |
| Wet adiabat steps | wetadiabatStep=5 | number |
| Wet adiabat colour | wetadiabatColour=darkRed | colour |
| Wet adiabat line type | wetadiabatLinetype=solid | line type |
| Wet adiabat line width | wetadiabatLinewidth=1 | number |
| 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=magenta | colour |
| Mixing ratio line type | mixingratioLinetype=longdash | line type |
| Mixing ratio line width | mixingratioLinewidth=1 | number |
| Mixing ratio P min | mixingratioPmin=300 | number |
| Mixing ratio T min | mixingratioTmin=-50 | number |
| Show numbers for P | labelp=on | on/off |
| Show numbers for T | labelt=on | on/off |
| Show numbers for mixing ratio | labelq=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 type | flevelsLinetype=solid | line type |
| Flight levels line width 1 | flevelsLinewidth1=1 | number |
| Flight levels line width 2 | flevelsLinewidth2=3 | number |
| Show FL label | labelflevels=on | on/off |
| Relative size of vertical axis | rsvaxis=1 | number |
| Text relative size | rstext=1 | number |
| P and T numbers relative size | rslabels=1 | number |
| Wind column width relative size | rswind=1 | number |
| Vertical wind width relative size | rsvwind=1 | number |
| Relative humidity width relative size | rsrelhum=1 | number |
| Ducting width relative size | rsducting=1 | number |
| Support lines for rel.hum., vert.wind. and ducting line type | rangeLinetype=solid | line type |
| Support lines for rel.hum., vert.wind. and ducting line width | rangeLinewidth=1 | numbers |
| Show contrails | cotrails=on | on/off |
| Contrail colour | cotrailsColour=cyan | colour |
| Contrail line type | cotrailsLinetype=solid | line type |
| Contrail line width | cotrailsLinewidth=3 | number |
| Contrail P min | cotrailsPmin=100 | number |
| Contrail P max | cotrailsPmax=700 | number |
# 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 | ![]() |