PSVELOMECA(l)                                                 PSVELOMECA(l)
                                6 August 1995






 NAME
      psvelomeca - Plot velocity vectors, focal mechanisms, crosses, and
      wedges on maps


 SYNOPSIS
      psvelomeca files -Jparameters -Rwest/east/south/north [ -Btickinfo ] [
      -Dsigma_scale ] [ -Fred/green/blue ] [ -Ered/green/blue ] [ -Gfill ] [
      -H ] [ -K ] [ -L ] [ -N ] [ -O ] [ -P ] [ -Ssymbol/scale/conf/font_size
      ] [ -U[/dx/dy/][label] ] [ -V ] [ -Wpen ] [ -C ] [ -Xx-shift ] [ -Yy-
      shift ] [ -: ] [ -ccopies ]


 DESCRIPTION
      psvelomeca reads data values from files [or standard input] and
      generates PostScript code that will plot focal mechanisms or velocity
      arrows on a map.  Most options are the same as for psxy, except -S The
      PostScript code is written to standard output.




 ARGUMENTS
      files List one or more file-names. If no files are given, psvelomeca
      will read standard input.  #ifdef SI #define UNIT cm #else #define
      UNIT inch #endif


      -J   Selects the map projection. Scale is UNIT/degree, 1:xxxxx. or
           width in UNIT (upper case modifier).


           CYLINDRICAL PROJECTIONS:


           -Jclon0/lat0/scale (Cassini)
           -Jmscale (Mercator)
           -Joalon0/lat0/azimuth/scale (Oblique Mercator - point and
           azimuth)
           -Joblon0/lat0/lon1/lat1/scale (Oblique Mercator - two points)
           -Joclon0/lat0/lonp/latp/scale (Oblique Mercator - point and pole)
           -Jqlon0/scale (Equidistant Cylindrical Projection (Plate Carree))
           -Jtlon0/scale (TM - Transverse Mercator)
           -Juzone/scale (UTM - Universal Transverse Mercator)
           -Jylon0/lats/scale (Basic Cylindrical Projection)


           AZIMUTHAL PROJECTIONS:


           -Jalon0/lat0/scale (Lambert).
           -Jelon0/lat0/scale (Equidistant).
           -Jglon0/lat0/scale (Orthographic).
           -Jslon0/lat0/scale (General Stereographic)


           CONIC PROJECTIONS:


           -Jblon0/lat0/lat1/lat2/scale (Albers)
           -Jllon0/lat0/lat1/lat2/scale (Lambert)








                                    - 1 -      Formatted:  September 9, 1999












 PSVELOMECA(l)                                                 PSVELOMECA(l)
                                6 August 1995






           MISCELLANEOUS PROJECTIONS:


           -Jhlon0/scale (Hammer)
           -Jilon0/scale (Sinusoidal)
           -Jklon0/scale (Eckert VI)
           -Jnlon0/scale (Robinson)
           -Jrlon0/scale (Winkel Tripel)
           -Jwlon0/scale (Mollweide)


           NON-GEOGRAPHICAL PROJECTIONS:


           -Jpscale (Linear projection for polar (theta,r) coordinates)
           -Jxx-scale[l|ppow][/y-scale[l|ppow]] (Linear, log, and power
           scaling)
           More details can be found in the psbasemap man pages.


           -R west, east, south, and north specify the Region of interest.
           To specify your boundaries in degrees and minutes [and seconds],
           use the dd:mm[:ss] format.


           -SSelects the meaning of the columns in the data file and the
           figure to be plotted.



Focal mechanisms in Aki and Richard convention.

           -Sascale. Focal mechanisms in Aki and Richard convention.  scale
           adjusts the scaling of the radius of the "beach ball", which will
           be proportional to the magnitude.  Use the -T option to render
           the beach ball transparent by drawing only the nodal planes and
           the circumference.  The color or shade of the compressive
           quadrants can be specified with the -G option.  Parameters are
           expected to be in the following columns:


      1,2  longitude, latitude of event (-: option interchanges order)


      3,4,5
           strike, dip and rake in degrees


      6    magnitude


      7,8  longitude, latitude at which to place beach ball. Entries in
           these columns are necessary with the -C option.  Using 0,0 in
           columns 8 and 9 will plot the beach ball at the latitude,
           longitude given in columns 1 and 2.  The -: option will
           interchange the order of columns (1,2) and (7,8).


      9    Text string to appear above the beach ball (optional).



Focal mechanisms in Harvard CMT convention.

           -Scscale. Focal mechanisms in Harvard CMT convention.  scale
           adjusts the scaling of the radius of the "beach ball", which will
           be proportional to the magnitude.  Use the -T option to render
           the beach ball transparent by drawing only the nodal planes and
           the circumference. The color or shade of the compressive
           quadrants can be specified with the -G option.  Parameters are
           expected to be in the following columns:


      1,2  longitude, latitude of event (-: option interchanges order)


      3-5  strike, dip, and slip of plane 1


      6,7,8
           strike, dip, and slip of plane 2


      9,10 mantissa and exponent of moment in dyne-cm


      11,12
           longititude,longitude at which to place beach ball. Entries in
           these columns are necessary with the -C option.  Using (0,0) in
           columns 11 and 12 will plot the beach ball at the latitude,
           longitude given in columns 1 and 2.  The -: option will
           interchange the order of columns (1,2) and (11,12).


      13   Text string to appear above the beach ball (optional).


Velocity ellipses in (N,E)


           -Sevelscale/confidence/fontsize.  Velocity ellipses in (N,E)
           convention.  Vscale sets the scaling of the velocity arrows.
           Confidence sets the 2-dimensional confidence limit for the
           ellipse, e.g., 0.95 for 95% confidence ellipse.  Fontsize sets
           the size of the text in points.  The ellipse will be filled with
           the color or shade specified by the -G option [default
           transparent].  The arrow and the circumference of the ellipse
           will be drawn with the pen attributes specified by the -W option.
           Parameters are expected to be in the following columns:


      1,2  longitude, latitude of station (-: option interchanges order)


      3,4  eastward, northward velocity (-: option interchanges order)


      5,6  uncertainty of eastward, northward velocities (1-sigma) (-:
           option interchanges order)


      7    correlation between eastward and northward components


      8    name of station (optional). The bug which previously wrote a
           garbage string if this argument was omitted has been fixed.



 Anisotropy bars.


           -Snbarscale.  Anisotropy bars.  Barscale sets the scaling of the
           bars Parameters are expected to be in the following columns:


      1,2  longitude, latitude of station (-: option interchanges order)


      3,4  eastward, northward components of anisotropy vector (-: option
           interchanges order)




 Focal mechanisms given with partial data


           -Spscale. Focal mechanisms given with partial data on both
           palnes.  scale adjusts the scaling of the radius of the "beach
           ball", which will be proportional to the magnitude.  Parameters
           are expected to be in the following columns


      1,2  longitude, latitude of event (-: option interchanges order)


      3,4  strike, dip of plane 1


      5    strike of plane 2


      6    must be -1/+1 for a normal/inverse fault


      7    magnitude


      8,9  latitude,longitude at which to place beach ball. Entries in these
           columns are necessary with the -C option.  Using 0,0 in columns 8
           and 9 will plot the beach ball at the latitude, longitude given
           in columns 1 and 2.  The -: option will interchange the order of
           columns (1,2) and (8,9).


      10   Text string to appear above the beach ball (optional).


Velocity ellipses in rotated convention


           -Srvelscale/confidence/fontsize.  Velocity ellipses in rotated
           convention.  Vscale sets the scaling of the velocity arrows.
           Confidence sets the 2-dimensional confidence limit for the
           ellipse, e.g., 0.95 for 95% confidence ellipse.  Fontsize sets
           the size of the text in points.  The ellipse will be filled with
           the color or shade specified by the -G option [default
           transparent].  The arrow and the circumference of the ellipse
           will be drawn with the pen attributes specified by the -W option.
           Parameters are expected to be in the following columns:


      1,2  longitude, latitude, of station (-: option interchanges order)


      3,4  eastward, northward velocity (-: option interchanges order)


      5,6  semi-major, semi-minor axes


      7    counter-clockwise angle, in degrees, from horizontal axis to
           major axis of ellipse.


      8    name of station (optional)



 Rotational wedges.


           -Swwedge_scale/wedge_mag. Rotational wedges.  Wedge_scale sets
           the size of the wedges in inches.  Values are multiplied by
           Wedge_mag before plotting.  For example, setting Wedge_mag to
           1.e7 works well for rotations of the order of 100 nanoradians/yr.
           Use -G to set the fill color or shade for the wedge, and -E to
           set the color or shade for the uncertainty.  Parameters are
           expected to be in the following columns:


      1,2  longitude, latitude, of station (-: option interchanges order)


      3    rotation in radians


      4    rotation uncertainty in radians



Strain crosses.


           -Sxcross_scale  Strain crosses.  Cross_scale sets the size of the
           cross in inches.  Parameters are expected to be in the following
           columns:


      1,2  longitude, latitude, of station (-: option interchanges order)


      3    eps1, the most extensional eigenvalue of strain tensor, with
           extension taken positive.


      4    eps2, the most compressional eigenvalue of strain tensor, with
           extension taken positive.


      5    azimuth of eps2 in degrees CW from North.


           -R west, east, south, and north specify the region of interest.
           To specify your boundaries in degrees and minutes, use the dd:mm
           format by appending 'm'.


 OPTIONS
      No space between the option flag and the associated arguments.


      -A Arrow_width/Head_length/Head_width Size of arrow in inches.
      [Default is 0.03/0.12/0.09].


      -B Sets map boundary tickmark intervals. See psbasemap for details.


      -C Offset focal mechanisms to the latitude and longitude specified in
      the last two columns of the input file.


      -D Sigma_scale can be used to rescale the uncertainties of velocities
      (-Se and -Sr) and rotations (-Sw).  Can be combined with the
      confidence  variable.


      -Ffill Sets the color or shade used for frame and annotation. [Default
      is 0/0/0 (black)]


      -Efill Sets the color or shade used for filling uncertainty wedges (-
      Sw) or velocity error ellipses (-Se or -Sr).  [If -E is not specified,
      the uncertainty regions will be transparent.]


      -Gfill Select filling of ellipses, wedges, and focal mechanisms.  By
      convention, the compressional quadrants of the focal mechanism beach
      balls are shaded.  Set the shade (0-255) or color (r/g/b) [Default is
      0/0/0].  Optionally, specify -Gpicon_size/pattern, where pattern gives
      the number of the image pattern (1-32) OR the name of a icon-format






                                    - 5 -      Formatted:  September 9, 1999












 PSVELOMECA(l)                                                 PSVELOMECA(l)
                                6 August 1995






      file.  icon_size sets the unit size in inches.  To invert black and
      white pixels, use -GP instead of -Gp.  See pspatterns for information
      on individual patterns.


      -H Input file(s) has Header record(s).


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


      -L Draw lines.  Ellipses and fault planes will have their outlines
      drawn using current pen (see -W).


      -N Do NOT skip symbols that fall outside map border [Default plots
      symbols inside border only].


      -O Selects Overlay plot mode. [Default initializes a new plot system]


      -P Selects Portrait plotting mode. [Default is Landscape]


      -T Makes the focal mechamism beach-balls (-Sa or -Sc) transparent.


      -U Draw Unix System time stamp on plot.  Append c to plot the command
      line or a text string of your choice.


      -V Verbose.  Reports the name of the current file being plotted, as
      well as number of records, and any scaling information.


      -W Set pen attributes for velocity arrows, ellipse circumference and
      fault plane edges.
       [Defaults: width = 1, color = 0/0/0, texture = solid].


      -X -Y Shift origin of plot by (x-shift,y-shift) inches  [Default is
      (1,1) for new plots, (0,0) for overlays].


      -: Toggles between (longitude,latitude) and (latitude,longitude)
      input/output.  [Default is (longitude,latitude)]


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


 EXAMPLES
      The following file should give a normal-faulting CMT mechanism:
      psvelomeca << END -Jm4 -R239/240/34/35.2 -Jm4 \
      -Sc0.4 -H1 >! test.ps
      lon     lat    str dip slip  st dip slip mant exp plon plat
      239.384 34.556 180  18  -88   0  72  -90  5.5  0   0    0
      END


      The following should make big red arrows with green ellipses, outlined
      in red.  Note that the 39% confidence scaling will give an ellipse
      which fits inside a rectangle of dimension Esig by Nsig.








                                    - 6 -      Formatted:  September 9, 1999












 PSVELOMECA(l)                                                 PSVELOMECA(l)
                                6 August 1995






      psvelomeca << END -H2 -R-10/10/-10/10 -W1/255/0/0 \
      -G0/255/0 -L -Se0.2/0.39/18 -B1g1 -Jx0.4/0.4 \
      -A0.1/0.3/0.3 -P -V  >! test.ps
        Long.   Lat.   Evel   Nvel   Esig   Nsig  CorEN SITE
        (deg)  (deg)    (mm/yr)        (mm/yr)
         0.    -8.     0.0    0.0     4.0    6.0  0.500  4x6
        -8.     5.     3.0    3.0     0.0    0.0  0.500  3x3
         0.     0.     4.0    6.0     4.0    6.0  0.500
        -5.    -5.     6.0    4.0     6.0    4.0  0.500  6x4
         5.     0.    -6.0    4.0     6.0    4.0 -0.500  -6x4
         0.    -5.     6.0   -4.0     6.0    4.0 -0.500  6x-4
      END
      The example should plot some residual rates of rotation in the Western
      Transverse Ranges, California.  The wedges will be dark gray, with
      light gray wedges to represent the 2-sigma uncertainties.


      psvelomeca <<END -Sw0.4/1.e7 -W3 -G60 -E210 -H1 -D2 -Jm2.2 \
            -R240./243./32.5/34.75 -Bf10ma60m/WeSn -P >! test.ps
       lon     lat    spin(rad/yr) spin_sigma (rad/yr)
      241.4806 34.2073  5.65E-08 1.17E-08
      241.6024 34.4468 -4.85E-08 1.85E-08
      241.0952 34.4079  4.46E-09 3.07E-08
      241.2542 34.2581  1.28E-07 1.59E-08
      242.0593 34.0773 -6.62E-08 1.74E-08
      241.0553 34.5369 -2.38E-07 4.27E-08
      241.1993 33.1894 -2.99E-10 7.64E-09
      241.1084 34.2565  2.17E-08 3.53E-08
      END




 SEE ALSO
      gmtsystem, psbasemap, psxy.


 REFERENCES
      Bomford, G., Geodesy, 4th ed., Oxford University Press, 1980.
      Aki, K. and P. Richards, Quantitative Seismolgy, Freeman, 1980.


 AUTHORS
      Genevieve Patau
      Seismology Dept.
      Institut de Physique du Globe de Paris
      (patau@sismo4.ipgp.jussieu.fr)


      Kurt Feigl
      Observatoire Midi Pyrenees
      (feigl@medoc.cnes.fr)
















  
                                  - 7 -      Formatted:  September 9, 1999