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