NAME

       rotconverter - Manipulate finite and stage rotations

SYNOPSIS

       rotconverter  [+][-]  rotA  [  [+|-  rotB  ]  [ +|- rotC ] ... [ -D ] [
       -Fin/out ] [ -H[a|t ]] [ -N ] [ -S ] [ -T ] [-V ]

DESCRIPTION

       rotconverter reads one or more plate motion models  (rotations)  stored
       in  the  given  files.  If more than one plate motion model is given we
       will add or subtract them in the order they were listed. The minus sign
       means  we  should  first  transpose the rotation and then add it to the
       previous rotation. The input files must all be of the same type  (stage
       poles  or  finite  rotations)  which may differ from the desired output
       format; see -F. If a file cannot be opened we will  attempt  to  decode
       the  file  name  as a single rotation whose parameters are separated by
       slashes.
               No space between the option flag and the associated  arguments.
       Use upper case for the option flags and lower case for modifiers.

       rotX   Name of a file with a plate motion model. Separate several files
              with desired operator (+ or -). The very  first  file  may  also
              have a leading minus to imply a transpose.  If any of the speci-
              fied rotation models cannot be opened as a file, we will try  to
              decode  the file name as lon/lat/tstart[/tstop]/angle for a sin-
              gle rotation given on the command line. The  tstop  argument  is
              required for stage poles only. For a finite rotation without any
              time information, give lon/lat/angle only.

OPTIONS

       -D     Report longitudes use the -180/+180 range [Default is 0/360].

       -F     Specify both the input and output format for rotations.  The  in
              and  out  flags  must be either f or s for finite or stage rota-
              tions, respectively. Note that both must be specified if  -F  is
              set  [Default  is  -Fff  (both input and output are finite rota-
              tions)].

       -H     Write out a  header  record  indentifying  the  various  columns
              [Default  is  no  header  record].  Append a to indicate opening
              angles and t to indicate opening rates [Default].

       -N     Place all output  poles  in  the  northern  hemisphere  [Default
              reports positive rotation angles].

       -S     Place  all  output  poles  in  the  southern hemisphere [Default
              reports positive rotation angles].

       -T     Transpose the final result, i.e., change the sign of  the  rota-
              tion angles.

       -V     Verbose   option:   Report  statistics  of  extracted  rotations
              [Default is silent].

EXAMPLES

       Naz_HS_finite.APM

       To  add  the  final  rotations  ROT(150.1, 70.5, -20.3) and ROT (145.0,
       40.0, 11.4), try

       rotconverter 150.1/70.5/-20.3 + 145/40/11.4

       which prints out 157.32, -80.44, 11.97.

SEE ALSO

       backtracker(GMTMANSECTION), hotspotter(GMTMANSECTION),  originator(GMT-
       MANSECTION)



GMT4.0                            1 Oct 2004       ROTCONVERTER(GMTMANSECTION)