1ROTCONVERTER(1)              Generic Mapping Tools             ROTCONVERTER(1)
2
3
4

NAME

6       rotconverter - Manipulate finite and stage rotations
7

SYNOPSIS

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

DESCRIPTION

13       rotconverter reads one or more plate motion models  (rotations)  stored
14       in  the  given  files.  If more than one plate motion model is given we
15       will add or subtract them in the order they  were  listed.   The  minus
16       sign  means  we  should first transpose the rotation and then add it to
17       the previous rotation.  The input files must all be of  the  same  type
18       (stage  poles  or  finite  rotations) which may differ from the desired
19       output format; see -F.  If a file cannot be opened we will  attempt  to
20       decode  the  file  name as a single rotation whose parameters are sepa‐
21       rated by slashes.
22            No space between the option flag  and  the  associated  arguments.
23       Use upper case for the option flags and lower case for modifiers.
24
25       rotX   Name  of  a  file  with  a plate motion model.  Separate several
26              files with desired operator (+ or -).  The very first  file  may
27              also  have  a leading minus to imply a transpose.  If any of the
28              specified rotation models cannot be opened as a  file,  we  will
29              try  to decode the file name as lon/lat/tstart[/tstop]/angle for
30              a single rotation given on the command line.  The tstop argument
31              is required for stage poles only.  For a finite rotation without
32              any time information, give lon/lat/angle only.
33

OPTIONS

35       -C     Write out a column header record indentifying the  various  col‐
36              umns  [Default is no header record].  Append a to indicate open‐
37              ing angles and t to indicate opening rates [Default].
38
39       -D     Report longitudes use the -180/+180 range [Default is 0/360].
40
41       -F     Specify both the input and output format for rotations.  The  in
42              and  out  flags  must be either f or s for finite or stage rota‐
43              tions, respectively.  Note that both must be specified if -F  is
44              set  [Default  is  -Fff  (both input and output are finite rota‐
45              tions)].
46
47       -N     Place all output  poles  in  the  northern  hemisphere  [Default
48              reports positive rotation angles].
49
50       -S     Place  all  output  poles  in  the  southern hemisphere [Default
51              reports positive rotation angles].
52
53       -T     Transpose the final result, i.e., change the sign of  the  rota‐
54              tion angles.
55
56       -V     Verbose   option:   Report  statistics  of  extracted  rotations
57              [Default is silent].
58

EXAMPLES

60       To convert the finite rotations in the file model_finite.APM  to  stage
61       poles, run
62
63       rotconverter model_finite.APM -Ffs > model_stages.APM
64
65       To  obtain  Nazca  motion  relative  to  Pacific hotspots by adding the
66       motion of Nazca relative to a fixed Pacific to the Pacific-Hotspot ref‐
67       erence model DC85_stages.d, and report the result as finite reconstruc‐
68       tion poles in the northern hemisphere, try
69
70       rotconverter   DC85_stages.APM   +   Pac_Naz_stages.RPM   -N   -Fsf   >
71       Naz_HS_finite.APM
72
73       To  add  the  final  rotations  ROT(150.1, 70.5, -20.3) and ROT (145.0,
74       40.0, 11.4),  try
75
76       rotconverter 150.1/70.5/-20.3 + 145/40/11.4
77
78       which prints out 157.32, -80.44, 11.97.
79

SEE ALSO

81       backtracker(1), hotspotter(1), originator(1)
82
83
84
85GMT 4.3.1                         15 May 2008                  ROTCONVERTER(1)
Impressum