PSROSE
Section: Misc. Reference Manual Pages (l)
Updated: DATE
Index
Return to Main Contents
#ifdef SI
#define UNIT cm
#define LEN_1 7.5
#define SCALE_1 -S7.5
#define LEN_2 5
#define SCALE_2 -S5
#else
#define UNIT inch
#define LEN_1 3
#define SCALE_1 -S3
#define LEN_2 2
#define SCALE_2 -S2
#endif
NAME
psrose - Plot (length, azimuth) as windrose diagram or polar histogram (sector or rose diagram).
SYNOPSIS
psrose <file> [ -Asector_width[r] ]
[ -Btickinfo ] [ -C[mode-file] ] [ -Eazimuth/elevation ] [ -Fred/green/blue ] [ -Gfill ]
[ -H ] [ -I ] [ -K ] [ -M[parameters ] [ -O ] [ -P ]
[ -Rr0/r1/az_0/az_1 ] [ -Sradial_scale[n] ] [ -U[/dx/dy/][label] ]
[ -V ] [ -Wpen ] [ -Xx-shift ]
[ -Yy-shift ] [ -Zscale ] [ -ccopies ] [ -: ]
DESCRIPTION
psrose reads (length,azimuth) pairs from file [or standard input] and
generates PostScript code that will plot a windrose diagram. Optionally (with -A), polar histograms
may be drawn (sector diagram or rose diagram). Options include full circle and half circle plots.
The PostScript code is written to standard output.
- file
-
Name of data file. If no file is given, psrose will read standard input.
OPTIONS
No space between the option flag and the associated arguments.
- -A
-
Gives the sector width in degrees for sector and rose diagram. [Default 0 means windrose diagram]. Append r to draw
rose diagram instead of sector diagram.
#include "explain_-b.txt"
Remember that "x" here is radial distance and
"y" is azimuth. The ylabel may be used to plot a figure caption.
- -C
-
Plot vectors showing the principal directions given in the modes file. If no file is
given, compute and plot mean direction.
- -E
-
Sets the viewpoint's azimuth and elevation [180/90]
- -G
-
Selects color (r/g/b, each 0-255) for sector infill [Default is black(0/0/0)].
#include "explain_-H.txt"
- -I
-
Inquire. Computes statistics needed to specify useful -R. No plot is generated.
#include "explain_-K.txt"
- -M
-
Specify new arrow attributes tailwidth/headlength/headwidth/r/g/b to change
the appearance of arrows (Only if -C is set).
#include "explain_-O.txt"
#include "explain_-P.txt"
- -R
-
Specifies the 'region' of interest in (r,azimuth) space. r0 is 0, r1 is max length in units. For azimuth, specify
-90/90 for half circle plot or 0/360 for full circle.
- -S
-
Specifies radius of circle in UNIT. Append n to normalize input radii to go from 0 to 1.
#include "explain_-U.txt"
#include "explain_-V.txt"
- -W
-
Set pen attributes for sector outline or rose plot. [Default is no outline].
#include "explain_-XY.txt"
- -Z
-
Multiply the data radii by scale. E.g., use -Z0.001 to convert your data from m to km [Default is no scaling].
#include "explain_-c.txt"
- -:
-
Input file has (azimuth,radius) pairs rather than the expected (radius,azimuth).
EXAMPLES
To plot a half circle rose diagram of the data in the file fault_segments.az_r (containing
pairs of (azimuth, length in meters), using a 10 degree bin sector width,
on a circle of radius = LEN_1 UNIT, grid going out to radius = 150 km in steps of 25 km with a 30 degree
sector interval, radial direction annotated every 50 km, using a light blue shading (200/240/255) outlined
by a solid red pen (width = 3), draw the mean azimuth, and shown in Portrait orientation, try:
psrose fault_segments.az_r -R0/150/-90/90 -B50g25:"Fault length":/g30:."Rose diagram":
SCALE_1 -A10r -G200/240/255 -W3/255/0/0 -Z0.001 -C -P -: | lpr
To plot a full circle wind rose diagram of the data in the file lines.r_az, on a circle of radius = LEN_2 UNIT,
grid going out to radius = 500 units in steps of 100 with a 45 degree sector interval, using a solid pen (width = 2),
and shown in landscape [Default] orientation with UNIX timestamp and command line plotted, try:
psrose lines.az_r -R0/500/0/360 SCALE_2 -Bg100/g45:."Windrose diagram": -W2 -Uc | lpr
BUGS
No default radial scale and grid settings for polar histograms. User must run psrose -I to find max length in
binned data set.
SEE ALSO
gmt, gmtdefaults, pshistogram
#include "refs.i"
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- EXAMPLES
-
- BUGS
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 07:11:32 GMT, January 07, 2025