psbarb - Plot wind barbs in 3-D
psbarb [ table ] -Jparameters -Jz|Zparameters -Rwest/east/south/north[/zmin/zmax][+r] [ -B[p|s]parameters ] [ -Ccpt ] [ -Ddx/dy[/dz] ] [ -Gfill ] [ -Iintens ] [ -K ] [ -N ] [ -O ] [ -P ] [ -Qparameters ] [ -T ] [ -U[stamp] ] [ -V[level] ] [ -W[pen][attr] ] [ -Xx_offset ] [ -Yy_offset ] [ -aflags ] [ -bibinary ] [ -dinodata ] [ -eregexp ] [ -fflags ] [ -hheaders ] [ -iflags ] [ -pflags ] [ -ttransp ] [ -:[i|o] ]
Note: No space is allowed between the option flag and the associated arguments.
psbarb reads (x, y, azimuth, speed) from files [or standard input] and generates PostScript code that will plot wind barbs at those locations on a map. If -JZ|z is set, then psbarb will interpret the third column of the input data as z-values and plot wind barbs in 3-D. If the wind barb length is not given with -Q, then psbarb will interpret the third and fourth columns of the input data as barb length and width, respectively. Select a fill with -G. If -G is set, -W will control whether the outline is drawn or not. The PostScript code is written to standard output.
-Jparameters (more ...)
Select map projection.
-Jz|Zparameters (more ...)
Set z-axis scaling; same syntax as -Jx.
-Rxmin/xmax/ymin/ymax[+r][+uunit] (more ...)
Specify the region of interest.
For perspective view p, optionally append /zmin/zmax. (more ...)
table
One or more ASCII (or binary, see -bi[ncols][type]) data table file(s) holding a number of data columns. If no tables are given then we read from standard input.
-B[p|s]parameters (more ...)
Set map boundary frame and axes attributes.
-Ccpt
Give a CPT or specify -Ccolor1,color2[,color3,...] to build a linear continuous CPT from those colors automatically. In this case colorn can be a r/g/b triplet, a color name, or an HTML hexadecimal color (e.g. #aabbcc ). Let fill color be determined by the t-value in the third (or fourth if -Jz is set) column. Additional fields are shifted over by one column (wind barb azimuth would be in 4th rather than 5th field, etc.).
-Ddx/dy[/dz]
Offset the plot symbol or line locations by the given amounts dx/dy[dz] [Default is no offset].
-Gfill
Select color or pattern for filling of symbols or polygons [Default is no fill]. Note that psbarb will search for -G and -W strings in all the segment headers and let any values thus found over-ride the command line settings.
-Iintens
Use the supplied intens value (nominally in the -1 to + 1 range) to modulate the fill color by simulating illumination [none].
-K (more ...)
Do not finalize the PostScript plot.
-N[c|r]
Do NOT clip symbols that fall outside map border [Default plots points whose coordinates are strictly inside the map border only]. The option does not apply to lines and polygons which are always clipped to the map region. For periodic (360-longitude) maps we must plot all symbols twice in case they are clipped by the repeating boundary. The -N will turn off clipping and not plot repeating symbols. Use -Nr to turn off clipping but retain the plotting of such repeating symbols, or use -Nc to retain clipping but turn off plotting of repeating symbols.
-O (more ...)
Append to existing PostScript plot.
-P (more ...)
Select “Portrait” plot orientation.
-Qparameters
Modify wind barb parameters. Append wind barb length. See WIND BARB ATTRIBUTES for specifying additional attributes.
-T
Ignore all input files, including standard input. This is the same as specifying /dev/null (or NUL for Windows users) as input file. Use this to activate only the options that are not related to plotting of lines or symbols, such as psbarb -R -J -O -T to terminate a sequence of GMT plotting commands without producing any plotting output.
-U[[just]/dx/dy/][c|label] (more ...)
Draw GMT time stamp logo on plot.
-V[level] (more ...)
Select verbosity level [c].
-W[pen][attr] (more ...)
Set pen attributes for lines or the outline of symbols [Defaults: width = default, color = black, style = solid]. If the modifier +cl is appended then the color of the line are taken from the CPT (see -C). If instead modifier +cf is appended then the color from the cpt file is applied to symbol fill. Use just +c for both effects.
-X[a|c|f|r][x-shift[u]]
-Y[a|c|f|r][y-shift[u]] (more ...)
Shift plot origin.
-acol=name[...] (more ...)
Set aspatial column associations col=name.
-bi[ncols][t] (more ...)
Select native binary input. [Default is the required number of columns given the chosen settings].
-dinodata (more ...)
Replace input columns that equal nodata with NaN.
-e[~]“pattern” | -e[~]/regexp/[i] (more ...)
Only accept data records that match the given pattern.
-f[i|o]colinfo (more ...)
Specify data types of input and/or output columns.
-h[i|o][n][+c][+d][+rremark][+rtitle] (more ...)
Skip or produce header record(s).
-icols[+l][+sscale][+ooffset][,...] (more ...)
Select input columns and transformations (0 is first column).
-p[x|y|z]azim[/elev[/zlevel]][+wlon0/lat0[/z0]][+vx0/y0] (more ...)
Select perspective view.
-t[transp] (more ...)
Set PDF transparency level in percent.
-:[i|o] (more ...)
Swap 1st and 2nd column on input and/or output.
-^ or just -
Print a short message about the syntax of the command, then exits (NOTE: on Windows just use -).
-+ or just +
Print an extensive usage (help) message, including the explanation of any module-specific option (but not the GMT common options), then exits.
-? or no arguments
Print a complete usage (help) message, including the explanation of all options, then exits.
Several modifiers may be appended to the windbarb-producing options to specify the placement of barbs, their shapes, and the justification of the wind barb. Below, left and right refers to the side of the wind barb line when viewed from the start point to the end point of the segment:
+aangle sets the angle of the wind barb [120].
+g-|fill turns off wind barb fill (if -) or sets the wind barb fill [Default fill is used, which may be no fill].
+p[-][pen] sets the wind barb pen attributes. If pen has a leading - then the outline is not drawn. [Default pen is used, and outline is drawn]
+jjust determines how the input x,y point relates to the wind barb. Choose from beginning [default], end, or center.
+s to set the wind speed which corresponds to a long barb [default 5]
+w to set the width of wind barbs
+z to input (u,v) wind components instead of (azimuth,speed)
To plot blue columns (width = 1.25 cm) at the positions listed in the file heights.xyz on a 3-D projection of the space (0-10), (0-10), (0-100), with tickmarks every 2, 2, and 10, viewing it from the southeast at 30 degree elevation, use:
gmt psbarb heights.xyz -R0/10/0/10/0/100 -Jx1.25c -Jz0.125c -So1.25c \ -Gblue -Bx2+lXLABEL -By2+lYLABEL -Bz10+lZLABEL -B+t"3-D PLOT" -p135/30 \ -Uc -W -P > heights.ps
Segment header records may contain one of more of the following options:
-Gfill
Use the new fill and turn filling on
-G-
Turn filling off
-G
Revert to default fill (none if not set on command line)
-Wpen
Use the new pen and turn outline on
-W
Revert to default pen MAP_DEFAULT_PEN (if not set on command line)
-W-
Turn outline off
-Zzval
Obtain fill via cpt lookup using z-value zval
-ZNaN
Get the NaN color from the CPT
gmt, gmt.conf, gmtcolors, grdbarb, psxyz