rotconverter(1) GMT rotconverter(1)
NAME
rotconverter - Manipulate total reconstruction and stage rotations
SYNOPSIS
rotconverter [ +|- ] rotA [ +|- rotB ] [ +|- rotC ] a| [ -A ] [ -D ]
[ -E[fact] ] [ -Fout ] [ -G ] [ -N ] [ -S ] [ -T ] [ -W ] [
-V[level] ] [ -hheaders ]
Note: No space is allowed between the option flag and the associated
arguments.
DESCRIPTION
rotconverter reads one or more plate motion models (stage or total
reconstruction 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. If a file cannot be
opened we will attempt to decode the file name as a single rotation
whose parameters are separated by slashes.
REQUIRED ARGUMENTS
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 operator to imply a transpose. We also rec-
ognize filenames of the form A-B, where both A and B are upper-
case plate abbreviations as used by GPlates, to indicate we
should look up the rotation between the two plates in the
GPlates rotation file (e.g., PAC-MBL). If any of the specified
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 single total reconstruction
rotation without any time information, give lon/lat/angle only.
OPTIONAL ARGUMENTS
-A Indicate that times are actually just opening angles [times in
Myr].
-D Report longitudes use the -180/+180 range [Default is 0/360].
-E[fact]
Scale opening angles by fact on output [0.5]. Typically used to
get half-rates needed for flowlines. Requires stage pole output
(see -F).
-Fout Specify the output format for rotations. The out flag must be
either t or s for total reconstruction or stage rotations,
respectively. [Default is -Ft (output contains total reconstruc-
tion rotations)].
-G Output final rotations in the Plates4 format used by GPlates
[Default is spotter format].
-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.
-W Ensure all output rotations have negative opening angles
[Default reports positive rotation angles].
-V[level] (more a|)
Select verbosity level [c]. Report statistics of extracted rota-
tions.
-^ or just -
Print a short message about the syntax of the command, then
exits (NOTE: on Windows just use -).
-+ or just +
Print an extensive usage (help) message, including the explana-
tion of any module-specific option (but not the GMT common
options), then exits.
-? or no arguments
Print a complete usage (help) message, including the explanation
of all options, then exits.
LIMITATIONS
Note that only one of -N, -S, and -W can be used at the same time.
EXAMPLES
To convert the total reconstruction rotations in the file
model_total_reconstruction.APM to stage poles, run
gmt rotconverter model_total_reconstruction.APM -Fs > model_stages.APM
To obtain Nazca motion relative to Pacific hotspots by adding the
motion of Nazca relative to a fixed Pacific to the Pacific-Hotspot ref-
erence model DC85_stages.d, and report the result as total reconstruc-
tion reconstruction poles in the northern hemisphere, try
gmt rotconverter DC85_stages.APM + Pac_Naz_stages.RPM -N -Ft > \
Naz_HS_total reconstruction.APM
To add the final rotations ROT(150.1, 70.5, -20.3) and ROT (145.0,
40.0, 11.4), try
gmt rotconverter 150.1/70.5/-20.3 + 145/40/11.4
which prints out 157.32, -80.44, 11.97.
To make stage rotations suitable for generating flowlines (fracture
zones) from a model of relative plate motions PL1-PL2.RPM, assuming
symmetric spreading, try
gmt rotconverter PL1-PL2.RPM -E -Fs > PL1-PL2_half.RPM
gmt rotconverter - PL1-PL2.RPM -E -Fs > PL2-PL1_half.RPM
To compute rotations for India relative to a fixed Africa using the
plate circuit India-Central Indian Basin-Antarctica-Africa, based on
the GPlates rotations database, try
gmt rotconverter IND-CIB CIB-ANT ANT-AFR > India_Africa.RPM
NOTES
GMT distributes the EarthByte rotation model Global_Earth-
Byte_230-0Ma_GK07_AREPS.rot. To use an alternate rotation file, create
an environmental parameters named GPLATES_ROTATIONS that points to an
alternate rotation file.
SEE ALSO
backtracker(1), grdrotater(1), grdspotter(1), gmtpmodeler(1),
grdpmodeler(1), grdrotater(1), hotspotter(1), originator(1)
COPYRIGHT
2017, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
5.4.2 Jun 24, 2017 rotconverter(1)
gmt5 5.4.2 - Generated Thu Jun 29 16:16:25 CDT 2017