1PSROSE(1) Generic Mapping Tools PSROSE(1)
2
6 psrose - Plot (length, azimuth) as windrose diagram or polar histogram
7 (sector or rose diagram).
8
10 psrose file [ -Asector_width[r] ] [ -B[p|s]parameters ] [ -C[mode_file]
11 ] [ -D ] [ -Eazimuth/elevation ] [ -I ] [ -Gfill ] [ -H[i][nrec] ] [ -I
12 ] [ -K ] [ -L[wlabel/elabel/slabel/nlabel] ] [ -M[parameters ] [ -O ] [
13 -P ] [ -Rr0/r1/az_0/az_1 ] [ -Sradial_scale[n] ] [ -T ] [
14 -U[just/dx/dy/][c|label] ] [ -V ] [ -Wpen ] [ -X[a|c|r][x-shift[u]] ] [
15 -Y[a|c|r][y-shift[u]] ] [ -Zscale ] [ -ccopies ] [ -:[i|o] ] [
16 -bi[s|S|d|D[ncol]|c[var1/...]] ]
17
19 psrose reads (length,azimuth) pairs from file [or standard input] and
20 generates PostScript code that will plot a windrose diagram. Option‐
21 ally (with -A), polar histograms may be drawn (sector diagram or rose
22 diagram). Options include full circle and half circle plots. The
23 PostScript code is written to standard output.
24 file Name of ASCII [or binary, see -b] data file. If no file is
26 given, psrose will read standard input.
27
29 No space between the option flag and the associated arguments.
30 -A Gives the sector width in degrees for sector and rose diagram.
32 [Default 0 means windrose diagram]. Append r to draw rose dia‐
33 gram instead of sector diagram.
34 -B Sets map boundary annotation and tickmark intervals; see the
36 psbasemap man page for all the details. Remember that "x" here
37 is radial distance and "y" is azimuth. The ylabel may be used
38 to plot a figure caption.
39 -C Plot vectors showing the principal directions given in the modes
41 file. If no file is given, compute and plot mean direction.
42 -D Shift sectors so that they are centered on the bin interval
44 (e.g., first sector is centered on 0 degrees).
45 -E Sets the viewpoint's azimuth and elevation [180/90]
47 -F Do not draw the scale length bar [Default plots scale in lower
49 right corner]
50 -G Selects shade, color or pattern for filling the sectors [Default
52 is no fill]. (See SPECIFYING FILL below).
53 -H Input file(s) has Header record(s). Number of header records
55 can be changed by editing your .gmtdefaults4 file. If used, GMT
56 default is 1 header record. Use -Hi if only input data should
57 have header records [Default will write out header records if
58 the input data have them]. Blank lines and lines starting with #
59 are always skipped.
60 -I Inquire. Computes statistics needed to specify useful -R. No
62 plot is generated.
63 -K More PostScript code will be appended later [Default terminates
65 the plot system].
66 -L Specify labels for the 0, 90, 180, and 270 degree marks. For
68 full-circle plot the default is WEST/EAST/SOUTH/NORTH and for
69 half-circle the default is 90W/90E/-/0. A - in any entry dis‐
70 ables that label. Use -L with no argument to disable all four
71 labels
72 -M Specify new arrow attributes tailwidth/headlength/head‐
74 width/r/g/b to change the appearance of arrows (Only if -C is
75 set). [Default is 0.075c/0.3c/0.25c/0/0/0 (or
76 0.03i/0.12i/0.1i/0/0/0)].
77 -O Selects Overlay plot mode [Default initializes a new plot sys‐
79 tem].
80 -P Selects Portrait plotting mode [Default is Landscape, see gmtde‐
82 faults to change this].
83 -R Specifies the 'region' of interest in (r,azimuth) space. r0 is
85 0, r1 is max length in units. For azimuth, specify -90/90 for
86 half circle plot or 0/360 for full circle.
87 -S Specifies radius of circle. Append n to normalize input radii
89 to go from 0 to 1.
90 -T Specifies that the input data is orientation data (has a 180
92 degree ambiguity) instead of true 0-360 degree directions
93 [Default].
94 -U Draw Unix System time stamp on plot. By adding just/dx/dy/, the
96 user may specify the justification of the stamp and where the
97 stamp should fall on the page relative to lower left corner of
98 the plot. For example, BL/0/0 will align the lower left corner
99 of the time stamp with the lower left corner of the plot.
100 Optionally, append a label, or c (which will plot the command
101 string.). The GMT parameters UNIX_TIME, UNIX_TIME_POS, and
102 UNIX_TIME_FORMAT can affect the appearance; see the gmtdefaults
103 man page for details. The time string will be in the locale set
104 by the environment variable TZ (generally local time).
105 -V Selects verbose mode, which will send progress reports to stderr
107 [Default runs "silently"].
108 -W Set pen attributes for sector outline or rose plot. [Default is
110 no outline]. (See SPECIFYING PENS below).
111 -X -Y Shift plot origin relative to the current origin by (x-shift,y-
113 shift) and optionally append the length unit (c, i, m, p). You
114 can prepend a to shift the origin back to the original position
115 after plotting, or prepend r [Default] to reset the current
116 origin to the new location. If -O is used then the default (x-
117 shift,y-shift) is (0,0), otherwise it is (r1i, r1i) or (r2.5c,
118 r2.5c). Alternatively, give c to align the center coordinate (x
119 or y) of the plot with the center of the page based on current
120 page size.
121 -Z Multiply the data radii by scale. E.g., use -Z0.001 to convert
123 your data from m to km [Default is no scaling].
124 -: Input file has (azimuth,radius) pairs rather than the expected
126 (radius,azimuth).
127 -bi Selects binary input. Append s for single precision [Default is
129 d (double)]. Uppercase S or D will force byte-swapping.
130 Optionally, append ncol, the number of columns in your binary
131 input file if it exceeds the columns needed by the program. Or
132 append c if the input file is netCDF. Optionally, append
133 var1/var2/... to specify the variables to be read. [Default is
134 2 input columns].
135 -c Specifies the number of plot copies. [Default is 1].
137 SPECIFYING PENS
139 pen The attributes of lines and symbol outlines as defined by pen is
140 a comma delimetered list of width, color and texture, each of
141 which is optional. width can be indicated as a measure (points,
142 centimeters, inches) or as faint, thin[ner|nest], thick[er|est],
143 fat[ter|test], or obese. color specifies a grey shade or color
144 (see SPECIFYING COLOR below). texture is a combination of
145 dashes `-' and dots `.'.
146 SPECIFYING FILL
148 fill The attribute fill specifies the solid shade or solid color (see
149 SPECIFYING COLOR below) or the pattern used for filling poly‐
150 gons. Patterns are specified as pdpi/pattern, where pattern
151 gives the number of the built-in pattern (1-90) or the name of a
152 Sun 1-, 8-, or 24-bit raster file. The dpi sets the resolution
153 of the image. For 1-bit rasters: use Pdpi/pattern for inverse
154 video, or append :Fcolor[B[color]] to specify fore- and back‐
155 ground colors (use color = - for transparency). See GMT Cook‐
156 book & Technical Reference Appendix E for information on indi‐
157 vidual patterns.
158 SPECIFYING COLOR
160 color The color of lines, areas and patterns can be specified by a
161 valid color name; by a grey shade (in the range 0-255); by a
162 decimal color code (r/g/b, each in range 0-255; h-s-v, ranges
163 0-360, 0-1, 0-1; or c/m/y/k, each in range 0-1); or by a hexa‐
164 decimal color code (#rrggbb, as used in HTML). See the gmtcol‐
165 ors manpage for more information and a full list of color names.
166
168 To plot a half circle rose diagram of the data in the file fault_seg‐
169 ments.az_r (containing pairs of (azimuth, length in meters), using a 10
170 degree bin sector width, on a circle of radius = 3 inch, grid going out
171 to radius = 150 km in steps of 25 km with a 30 degree sector interval,
172 radial direction annotated every 50 km, using a light blue shading out‐
173 lined by a solid red pen (width = 0.75 points), draw the mean azimuth,
174 and shown in Portrait orientation, use:
175 psrose fault_segments.az_r -R0/150/-90/90 -B50g25:"Fault
177 length":/g30:."Rose diagram": -S3i -A10r -Glightblue -W0.75p,red
178 -Z0.001 -C -P -T -: | lpr
179 To plot a full circle wind rose diagram of the data in the file
181 lines.r_az, on a circle of radius = 5 cm, grid going out to radius =
182 500 units in steps of 100 with a 45 degree sector interval, using a
183 solid pen (width = 0.5 point), and shown in landscape [Default] orien‐
184 tation with UNIX timestamp and command line plotted, use:
185 psrose lines.az_r -R0/500/0/360 -S5c -Bg100/g45:."Windrose diagram":
187 -W0.5p -Uc | lpr
188
190 No default radial scale and grid settings for polar histograms. User
191 must run psrose -I to find max length in binned data set.
192
194 GMT(1), gmtdefaults(1), pshistogram(1)
195GMT 4.3.1 15 May 2008 PSROSE(1)