Provided by: gmt_4.5.11-1build1_amd64

**NAME**

rotconverter - Manipulate finite and stage rotations

**SYNOPSIS**

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

**DESCRIPTION**

rotconverterreads 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.rotXName 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 specified rotation models cannot be opened as a file, we will try to decode the file name aslon/lat/tstart[/tstop]/anglefor a single rotation given on the command line. Thetstopargument is required for stage poles only. For a single finite rotation without any time information, givelon/lat/angleonly.

**OPTIONS**

-CWrite out a column header record identifying the various columns [Default is no header record]. Appendato indicate opening angles andtto indicate opening rates [Default].-DReport longitudes use the -180/+180 range [Default is 0/360].-EScale opening angles byfacton output. Requires stage pole output (see-F).-FSpecify both the input and output format for rotations. Theinandoutflags must be eitherforsfor finite or stage rotations, respectively. Note that both must be specified if-Fis set [Default is-Fff(both input and output are finite rotations)].-NPlace all output poles in the northern hemisphere [Default reports positive rotation angles].-SPlace all output poles in the southern hemisphere [Default reports positive rotation angles].-TTranspose the final result, i.e., change the sign of the rotation angles.-VSelects verbose mode, which will send progress reports to stderr [Default runs "silently"]. Report statistics of extracted rotations.

**EXAMPLES**

To convert the finite rotations in the file model_finite.APM to stage poles, runrotconvertermodel_finite.APM-Ffs> 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 reference model DC85_stages.d, and report the result as finite reconstruction poles in the northern hemisphere, tryrotconverterDC85_stages.APM + Pac_Naz_stages.RPM-N-Fsf> Naz_HS_finite.APM To add the final rotations ROT(150.1, 70.5, -20.3) and ROT (145.0, 40.0, 11.4), tryrotconverter150.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,, tryrotconverterPL1-PL2.RPM-E-Ffs> PL1-PL2_half.RPMrotconverter- PL1-PL2.RPM-E-Ffs> PL2-PL1_half.RPM

**SEE** **ALSO**

backtracker(1),grdrotater(1),grdspotter(1),hotspotter(1),originator(1)