File: psrose.html

package info (click to toggle)
gmt-doc 3.4-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 4,756 kB
  • ctags: 1,800
  • sloc: makefile: 30
file content (186 lines) | stat: -rw-r--r-- 7,678 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
<HTML>
<HEAD>
<TITLE>psrose</TITLE>
</HEAD>
<BODY>
<H1>psrose</H1>
<HR>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
       psrose  -  Plot  (length,  azimuth) as windrose diagram or
       polar histogram (sector or rose diagram).


</PRE>
<H2>SYNOPSIS</H2><PRE>
       <B>psrose</B>  <I>file</I>  [  <B>-A</B><I>sector</I><B>_</B><I>width</I>[<B>r</B>]  ]  [  <B>-B</B><I>tickinfo</I>  ]  [
       <B>-C</B>[<I>mode-file</I>]  ]  [  <B>-E</B><I>azimuth/elevation</I>  ]  [  <B>-G</B><I>fill</I> ] [
       <B>-H</B>[<I>nrec</I>] ] [ <B>-I</B> ] [ <B>-K</B> ] [ <B>-M</B>[<I>parameters</I> ] [ <B>-O</B> ] [ <B>-P</B> ] [
       <B>-R</B><I>r0/r1/az</I><B>_</B><I>0/az</I><B>_</B><I>1</I>  ]  [  <B>-S</B><I>radial</I><B>_</B><I>scale</I>[<B>n</B>]  ]  [  <B>-T</B>  ]  [
       <B>-U</B>[<I>/dx/dy/</I>][<I>label</I>] ] [ <B>-V</B> ] [ <B>-W</B><I>pen</I> ] [ <B>-X</B><I>x-shift</I> ] [ <B>-Y</B><I>y-</I>
       <I>shift</I> ] [ <B>-Z</B><I>scale</I> ] [ <B>-c</B><I>copies</I> ] [ <B>-:</B> ] [ <B>-bi</B>[<B>s</B>][<I>n</I>] ]


</PRE>
<H2>DESCRIPTION</H2><PRE>
       <B>psrose</B> reads (length,azimuth) pairs from <I>file</I> [or standard
       input] and generates <I>PostScript</I> code that will plot a win
       drose  diagram. Optionally (with <B>-A</B>), polar histograms may
       be drawn (sector diagram or rose diagram). Options include
       full circle and half circle plots.  The <I>PostScript</I> code is
       written to standard output.

       <I>file</I>   Name of ASCII [or binary, see <B>-b</B>] data file. If  no
              file is given, psrose will read standard input.


</PRE>
<H2>OPTIONS</H2><PRE>
       No  space between the option flag and the associated argu
       ments.

       <B>-A</B>     Gives the sector width in degrees  for  sector  and
              rose  diagram.  [Default 0 means windrose diagram].
              Append <B>r</B> to draw rose  diagram  instead  of  sector
              diagram.

       <B>-B</B>     Sets map boundary tickmark intervals. See <B><A HREF="psbasemap.html">psbasemap</A></B>
              for details.  Remember that "x" here is radial dis
              tance and "y" is azimuth. The ylabel may be used to
              plot a figure caption.

       <B>-C</B>     Plot vectors showing the principal directions given
              in the <I>modes</I> file. If no file is given, compute and
              plot mean direction.

       <B>-E</B>     Sets  the   viewpoint's   azimuth   and   elevation
              [180/90]'

       <B>-G</B>     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).

       <B>-H</B>     Input  file(s)  has  Header  record(s).  Number  of
              header records can be changed by editing your .gmt
              defaults  file.  If  used,  <B><A HREF="GMT.html">GMT</A></B> default is 1 header
              record.


       <B>-K</B>     More   <I>PostScript</I>   code  will  be  appended  later
              [Default terminates the plot system].

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

       <B>-O</B>     Selects Overlay plot mode  [Default  initializes  a
              new plot system].

       <B>-P</B>     Selects  Portrait  plotting  mode  [<B><A HREF="GMT.html">GMT</A></B>  Default is
              Landscape, see gmtdefaults to change this].

       <B>-R</B>     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.

       <B>-S</B>     Specifies  radius  of circle. Append <B>n</B> to normalize
              input radii to go from 0 to 1.

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

       <B>-U</B>     Draw Unix System time stamp on plot. User may spec
              ify 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 <B>c</B> (which will
              plot  the  command  string.).  The  GMT  parameters
              UNIX_TIME  and UNIX_TIME_POS can affect the appear
              ance; see the <B><A HREF="gmtdefaults.html">gmtdefaults</A></B> man page for details.

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

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

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

       <B>-Z</B>     Multiply the data radii by <I>scale</I>. E.g., use <B>-Z</B>0.001
              to  convert  your  data from m to km [Default is no
              scaling].

       <B>-c</B>     Specifies the number of plot copies. [Default is 1]


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


</PRE>
<H2>EXAMPLES</H2><PRE>
       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 cir
       cle 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  shad
       ing  (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  <B>-R</B>0/150/-90/90 <B>-B</B>50g25:"Fault
       length":/g30:."Rose  diagram":  <B>-S</B>3<B>i</B>  <B>-A</B>10<B>r</B>  <B>-G</B>200/240/255
       <B>-W</B>0.75<B>p</B>/255/0/0 <B>-Z</B>0.001 <B>-C</B> <B>-P</B> <B>-T</B> <B>-:</B> | 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 <B>-R</B>0/500/0/360 <B>-S</B>5<B>c</B> <B>-Bg</B>100/<B>g</B>45:."Windrose
       diagram": <B>-W</B>0.5<B>p</B> <B>-Uc</B> | lpr


</PRE>
<H2>BUGS</H2><PRE>
       No  default  radial scale and grid settings for polar his
       tograms. User must run <B>psrose</B> <B>-I</B> to  find  max  length  in
       binned data set.


</PRE>
<H2>SEE ALSO</H2><PRE>
       <I>gmt</I>(l), <I><A HREF="gmtdefaults.html">gmtdefaults</A></I>(l), <I><A HREF="pshistogram.html">pshistogram</A></I>(l)














</PRE>
<HR>
<ADDRESS>
Man(1) output converted with
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
</ADDRESS>
</BODY>
</HTML>
<body bgcolor="#ffffff">