1ROTCONVERTER(1) Generic Mapping Tools ROTCONVERTER(1)
2
6 rotconverter - Manipulate finite and stage rotations
7
9 rotconverter [ +|- ] rotA [ +|- rotB ] [ +|- rotC ] ... [ -C[a|t]] [
10 -D ] [ -E[fact] ] [ -Fin/out ] [ -N ] [ -S ] [ -T ] [ -V ]
11
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 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 single finite rotation
32 without any time information, give lon/lat/angle only.
33
35 -C Write out a column header record identifying the various columns
36 [Default is no header record]. Append a to indicate opening
37 angles and t to indicate opening rates [Default].
38 -D Report longitudes use the -180/+180 range [Default is 0/360].
40 -E Scale opening angles by fact on output. Requires stage pole
42 output (see -F).
43 -F Specify both the input and output format for rotations. The in
45 and out flags must be either f or s for finite or stage rota‐
46 tions, respectively. Note that both must be specified if -F is
47 set [Default is -Fff (both input and output are finite rota‐
48 tions)].
49 -N Place all output poles in the northern hemisphere [Default
51 reports positive rotation angles].
52 -S Place all output poles in the southern hemisphere [Default
54 reports positive rotation angles].
55 -T Transpose the final result, i.e., change the sign of the rota‐
57 tion angles.
58 -V Selects verbose mode, which will send progress reports to stderr
60 [Default runs "silently"]. Report statistics of extracted rota‐
61 tions.
62
64 To convert the finite rotations in the file model_finite.APM to stage
65 poles, run
66 rotconverter model_finite.APM -Ffs > model_stages.APM
68 To obtain Nazca motion relative to Pacific hotspots by adding the
70 motion of Nazca relative to a fixed Pacific to the Pacific-Hotspot ref‐
71 erence model DC85_stages.d, and report the result as finite reconstruc‐
72 tion poles in the northern hemisphere, try
73 rotconverter DC85_stages.APM + Pac_Naz_stages.RPM -N -Fsf >
75 Naz_HS_finite.APM
76 To add the final rotations ROT(150.1, 70.5, -20.3) and ROT (145.0,
78 40.0, 11.4), try
79 rotconverter 150.1/70.5/-20.3 + 145/40/11.4
81 which prints out 157.32, -80.44, 11.97.
83 To make stage rotations suitable for generating flowlines (fracture
85 zones) from a model of relative plate motions PL1-PL2.RPM, assuming
86 symmetric spreading,, try
87 rotconverter PL1-PL2.RPM -E -Ffs > PL1-PL2_half.RPM
89 rotconverter - PL1-PL2.RPM -E -Ffs > PL2-PL1_half.RPM
90
92 backtracker(1), grdrotater(1), grdspotter(1), hotspotter(1), origina‐
93 tor(1)
94GMT 4.5.6 10 Mar 2011 ROTCONVERTER(1)