1ROTCONVERTER(1) GMT ROTCONVERTER(1)
2
6 rotconverter - Manipulate total reconstruction and stage rotations
7
9 rotconverter [ +|- ] rotA [ +|- rotB ] [ +|- rotC ] ... [ -A ] [ -D ]
10 [ -E[fact] ] [ -Fout ] [ -G ] [ -N ] [ -S ] [ -T ] [ -W ] [
11 -V[level] ] [ -hheaders ]
12 Note: No space is allowed between the option flag and the associated
14 arguments.
15
17 rotconverter reads one or more plate motion models (stage or total
18 reconstruction rotations) stored in the given files. If more than one
19 plate motion model is given we will add or subtract them in the order
20 they were listed. The minus sign means we should first transpose the
21 rotation and then add it to the previous rotation. If a file cannot be
22 opened we will attempt to decode the file name as a single rotation
23 whose parameters are separated by slashes.
24
26 rotX Name of a file with a plate motion model. Separate several files
27 with desired operator (+ or -). The very first file may also
28 have a leading minus operator to imply a transpose. We also rec‐
29 ognize filenames of the form A-B, where both A and B are upper‐
30 case plate abbreviations as used by GPlates, to indicate we
31 should look up the rotation between the two plates in the
32 GPlates rotation file (e.g., PAC-MBL). If any of the specified
33 rotation models cannot be opened as a file, we will try to
34 decode the file name as lon/lat/tstart[/tstop]/angle for a sin‐
35 gle rotation given on the command line. The tstop argument is
36 required for stage poles only. For a single total reconstruction
37 rotation without any time information, give lon/lat/angle only.
38
40 -A Indicate that times are actually just opening angles [times in
41 Myr].
42 -D Report longitudes use the -180/+180 range [Default is 0/360].
44 -E[fact]
46 Scale opening angles by fact on output [0.5]. Typically used to
47 get half-rates needed for flowlines. Requires stage pole output
48 (see -F).
49 -Fout Specify the output format for rotations. The out flag must be
51 either t or s for total reconstruction or stage rotations,
52 respectively. [Default is -Ft (output contains total reconstruc‐
53 tion rotations)].
54 -G Output final rotations in the Plates4 format used by GPlates
56 [Default is spotter format].
57 -N Place all output poles in the northern hemisphere [Default
59 reports positive rotation angles].
60 -S Place all output poles in the southern hemisphere [Default
62 reports positive rotation angles].
63 -T Transpose the final result, i.e., change the sign of the rota‐
65 tion angles.
66 -W Ensure all output rotations have negative opening angles
68 [Default reports positive rotation angles].
69 -V[level] (more ...)
71 Select verbosity level [c]. Report statistics of extracted rota‐
72 tions.
73 -^ or just -
75 Print a short message about the syntax of the command, then
76 exits (NOTE: on Windows just use -).
77 -+ or just +
79 Print an extensive usage (help) message, including the explana‐
80 tion of any module-specific option (but not the GMT common
81 options), then exits.
82 -? or no arguments
84 Print a complete usage (help) message, including the explanation
85 of all options, then exits.
86
88 Note that only one of -N, -S, and -W can be used at the same time.
89
91 To convert the total reconstruction rotations in the file
92 model_total_reconstruction.APM to stage poles, run
93 gmt rotconverter model_total_reconstruction.APM -Fs > model_stages.APM
95 To obtain Nazca motion relative to Pacific hotspots by adding the
97 motion of Nazca relative to a fixed Pacific to the Pacific-Hotspot ref‐
98 erence model DC85_stages.d, and report the result as total reconstruc‐
99 tion reconstruction poles in the northern hemisphere, try
100 gmt rotconverter DC85_stages.APM + Pac_Naz_stages.RPM -N -Ft > \
102 Naz_HS_total reconstruction.APM
103 To add the final rotations ROT(150.1, 70.5, -20.3) and ROT (145.0,
105 40.0, 11.4), try
106 gmt rotconverter 150.1/70.5/-20.3 + 145/40/11.4
108 which prints out 157.32, -80.44, 11.97.
110 To make stage rotations suitable for generating flowlines (fracture
112 zones) from a model of relative plate motions PL1-PL2.RPM, assuming
113 symmetric spreading, try
114 gmt rotconverter PL1-PL2.RPM -E -Fs > PL1-PL2_half.RPM
116 gmt rotconverter - PL1-PL2.RPM -E -Fs > PL2-PL1_half.RPM
117 To compute rotations for India relative to a fixed Africa using the
119 plate circuit India-Central Indian Basin-Antarctica-Africa, based on
120 the GPlates rotations database, try
121 gmt rotconverter IND-CIB CIB-ANT ANT-AFR > India_Africa.RPM
123
125 GMT distributes the EarthByte rotation model Global_Earth‐
126 Byte_230-0Ma_GK07_AREPS.rot. To use an alternate rotation file, create
127 an environmental parameters named GPLATES_ROTATIONS that points to an
128 alternate rotation file.
129
131 backtracker, grdrotater, grdspotter, gmtpmodeler, grdpmodeler, grdro‐
132 tater, hotspotter, originator
133
135 2019, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
1365.4.5 Feb 24, 2019 ROTCONVERTER(1)