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 ] [ -Gfill ] [
       -H[nrec] ] [ -I ] [ -K ] [ -M[parameters ] [ -O ] [ -P ] [ -Rr0/r1/az_0/az_1 ] [ -Sradial_scale[n] ] [ -T
       ] [ -U[/dx/dy/][label] ] [ -V ] [ -Wpen ] [ -Xx-shift ] [ -Yy-shift ] [ -Zscale ] [ -ccopies ] [ -:  ]  [
       -bi[s][n] ]

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 ASCII [or binary, see -b] 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.

       -B     Sets map boundary tickmark intervals. See psbasemap for details.  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 shade or color for sector infill [Default is no fill].  Specify the shade (0-255) or color
              (r/g/b, each in 0-255).

       -H     Input file(s) has Header record(s). Number of header  records  can  be  changed  by  editing  your
              .gmtdefaults file. If used, GMT default is 1 header record.

       -I     Inquire. Computes statistics needed to specify useful -R. No plot is generated.

       -K     More PostScript code will be appended later [Default terminates the plot system].

       -M     Specify  new  arrow  attributes  tailwidth/headlength/headwidth/r/g/b  to change the appearance of
              arrows (Only if -C is set). [Default is 0.075c/0.3c/0.25c/0/0/0 (or 0.03i/0.12i/0.1i/0/0/0)].

       -bo    Selects binary output. Append s for single precision [Default is double].

       -P     Selects Portrait plotting mode [GMT Default is Landscape, see gmtdefaults to change this].

       -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. Append n to normalize input radii to go from 0 to 1.

       -T     Specifies  that  the  input  data is orientation data (has a 180 degree ambiguity) instead of true
              0-360 degree directions [Default].

       -U     Draw Unix System time stamp on plot. User may specify where the lower left  corner  of  the  stamp
              should  fall  on  the page relative to lower left corner of plot. Optionally, append a label, or c
              (which will plot the command string.). The GMT parameters UNIX_TIME and UNIX_TIME_POS  can  affect
              the appearance; see the gmtdefaults man page for details.

       -V     Selects verbose mode, which will send progress reports to stderr [Default runs "silently"].

       -W     Set pen attributes for sector outline or rose plot. [Default is no outline].

       -X -Y  Shift  origin  of  plot by (x-shift,y-shift).  Prepend a for absolute coordinates; the default (r)
              will reset plot origin.

       -Z     Multiply the data radii by scale. E.g., use -Z0.001 to convert your data from m to km [Default  is
              no scaling].

       -c     Specifies the number of plot copies. [Default is 1]

       -:     Input file has (azimuth,radius) pairs rather than the expected (radius,azimuth).

       -bi    Selects  binary input. Append s for single precision [Default is double].  Append n for the number
              of columns in the binary file(s).  [Default is 2 input columns].

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 = 3 inch, 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 = 0.75
       points), 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":  -S3i  -A10r
       -G200/240/255 -W0.75p/255/0/0 -Z0.001 -C -P -T -: | lpr

       To plot a full circle wind rose diagram of the data in the file lines.r_az, on a circle of radius = 5 cm,
       grid going out to radius = 500 units in steps of 100 with a 45 degree sector interval, using a solid  pen
       (width  =  0.5  point), and shown in landscape [Default] orientation with UNIX timestamp and command line
       plotted, try:

       psrose lines.az_r -R0/500/0/360 -S5c -Bg100/g45:."Windrose diagram": -W0.5p -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(1gmt), gmtdefaults(1gmt), pshistogram(1gmt)

                                                   1 Jan 2004                                          PSROSE(l)