manpagez: man pages & more
man rotconverter(1)
Home | html | info | man
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
© manpagez.com 2000-2021
Individual documents may contain additional copyright information.