<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta http-equiv="X-UA-Compatible" content="IE=Edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>rotsmoother — GMT 5.4.4 documentation</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
<link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<script type="text/javascript" id="documentation_options" data-url_root="../../" src="../../_static/documentation_options.js"></script>
<script type="text/javascript" src="../../_static/jquery.js"></script>
<script type="text/javascript" src="../../_static/underscore.js"></script>
<script type="text/javascript" src="../../_static/doctools.js"></script>
<script type="text/javascript" src="../../../../_static/searchtools.js"></script>
<script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
<link rel="index" title="Index" href="../../genindex.html" />
<link rel="search" title="Search" href="../../search.html" />
<link rel="next" title="x2sys_binlist" href="../x2sys/x2sys_binlist.html" />
<link rel="prev" title="rotconverter" href="rotconverter.html" />
</head><body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../../genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="../x2sys/x2sys_binlist.html" title="x2sys_binlist"
accesskey="N">next</a> </li>
<li class="right" >
<a href="rotconverter.html" title="rotconverter"
accesskey="P">previous</a> </li>
<li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
<li class="nav-item nav-item-0"><a href="../../index.html">GMT 5.4.4 documentation</a> »</li>
<li class="nav-item nav-item-1"><a href="../../man_pages.html" accesskey="U">Man Pages</a> »</li>
<li class="right">
<form class="search" accept-charset="UTF-8" action="search.html" method="get">
<div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
<label for="q">
<a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
</label>
<input accesskey="f" class="small" id="q" name="q" size="20" type="text">
<input type="hidden" name="check_keywords" value="yes">
<input type="hidden" name="area" value="default">
</form></li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="rotsmoother">
<span id="index-0"></span><h1>rotsmoother<a class="headerlink" href="#rotsmoother" title="Permalink to this headline">¶</a></h1>
<p>rotsmoother - Get mean rotations and covariance matrices from set of finite rotation</p>
<div class="section" id="synopsis">
<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
<p><strong>rotsmoother</strong> [ <em>rottable</em> ]
[ <a class="reference internal" href="#a"><span> <strong>-A</strong></span></a></strong> ]
[ <a class="reference internal" href="#c"><span> <strong>-C</strong></span></a></strong> ]
[ <a class="reference internal" href="#n"><span> <strong>-N</strong></span></a></strong> ]
[ <a class="reference internal" href="#s"><span> <strong>-S</strong></span></a></strong> ]
[ <a class="reference internal" href="#t"><span> <strong>-T</strong></span></a></strong><em>ages</em> ]
[ <a class="reference internal" href="#v"><span> <strong>-V</strong></span></a></strong>[<em>level</em>] ]
[ <a class="reference internal" href="#w"><span> <strong>-W</strong></span></a></strong> ]
[ <a class="reference internal" href="#z"><span> <strong>-Z</strong></span></a></strong> ]
[ <strong>-b</strong><a class="reference internal" href="../../gmt.html#bi-full"><span class="std std-ref">binary</span></a> ]
[ <strong>-d</strong><a class="reference internal" href="../../gmt.html#d-full"><span class="std std-ref">nodata</span></a> ]
[ <strong>-e</strong><a class="reference internal" href="../../gmt.html#e-full"><span class="std std-ref">regexp</span></a> ]
[ <strong>-h</strong><a class="reference internal" href="../../gmt.html#h-full"><span class="std std-ref">headers</span></a> ]
[ <strong>-i</strong><a class="reference internal" href="../../gmt.html#icols-full"><span class="std std-ref">flags</span></a> ]
[ <strong>-o</strong><a class="reference internal" href="../../gmt.html#ocols-full"><span class="std std-ref">flags</span></a> ]
[ <strong>-s</strong><a class="reference internal" href="../../gmt.html#s-full"><span class="std std-ref">flags</span></a> ]
[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
</div>
<div class="section" id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
<p><strong>rotsmoother</strong> reads a table of total reconstructions and computes mean
rotations (and optionally covariance matrices) for sub-groups of rotations
based on rotation age.</p>
</div>
<div class="section" id="required-arguments">
<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
<dl class="docutils">
<dt><em>rottable</em></dt>
<dd>Name of a rotation table containing (lon, lat, time, angle, [weight]) values.</dd>
</dl>
</div>
<div class="section" id="optional-arguments">
<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
<dl class="docutils" id="a">
<dt><strong>-A</strong></dt>
<dd>Use opening angles as a proxy for time. Suitable when no time can be assigned to the
rotations. In this case, input is expected to contain <em>lon lat angle</em> [<em>weight</em>] records
and <strong>-T</strong> settings refer to angles instead of time.
[Default expects <em>lon lat time angle</em> [<em>weight</em>] and <strong>-T</strong> refers to time].</dd>
</dl>
<dl class="docutils" id="c">
<dt><strong>-C</strong></dt>
<dd>Compute covariance matrix for each mean rotation. This is done by converting each
finite rotation to a quaternion, determining the mean quaternion (rotation) and
the consider all rotations as perturbation to the mean rotation. From these
perturbations we determine the covariance matrix.</dd>
</dl>
<dl class="docutils" id="n">
<dt><strong>-N</strong></dt>
<dd>Ensure all poles are in northern hemisphere [Default ensures positive opening angles].</dd>
</dl>
<dl class="docutils" id="s">
<dt><strong>-S</strong></dt>
<dd>Ensure all poles are in southern hemisphere [Default ensures positive opening angles].</dd>
</dl>
<dl class="docutils" id="t">
<dt><strong>-T</strong><em>ages</em></dt>
<dd>Sets the desired groups of times. For a single time append
the desired time. For an equidistant range of reconstruction times
give <strong>-T</strong><em>start</em>/<em>stop</em>/<em>inc</em> or <strong>-T</strong><em>start</em>/<em>stop</em>/<em>npoints</em><strong>+</strong>.
For an non-equidistant set of reconstruction times please pass them
via the first column in a file, e.g., <strong>-T</strong><em>agefile</em>. The times indicate
read or generated becomes the bin-boundaries and we output the average time of
all rotations inside each bin.</dd>
</dl>
<span class="target" id="v"></span><dl class="docutils">
<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><span class="std std-ref">(more ...)</span></a></dt>
<dd>Select verbosity level [c]. </dd>
</dl>
<dl class="docutils" id="w">
<dt><strong>-W</strong></dt>
<dd>Expect weights in last column for a weighted mean rotation [no weights].</dd>
</dl>
<dl class="docutils" id="z">
<dt><strong>-Z</strong></dt>
<dd>Report negative opening angles [positive].</dd>
</dl>
<dl class="docutils">
<dt><strong>-bi</strong>[<em>ncols</em>][<strong>t</strong>] <a class="reference internal" href="../../gmt.html#bi-full"><span class="std std-ref">(more ...)</span></a></dt>
<dd>Select native binary input. [Default is 2 input columns].</dd>
</dl>
<dl class="docutils">
<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="../../gmt.html#bo-full"><span class="std std-ref">(more ...)</span></a></dt>
<dd>Select native binary output. [Default is same as input].</dd>
</dl>
<dl class="docutils">
<dt><strong>-d</strong>[<strong>i</strong>|<strong>o</strong>]<em>nodata</em> <a class="reference internal" href="../../gmt.html#d-full"><span class="std std-ref">(more ...)</span></a></dt>
<dd>Replace input columns that equal <em>nodata</em> with NaN and do the reverse on output. </dd>
</dl>
<dl class="docutils">
<dt><strong>-e</strong>[<strong>~</strong>]<em>"pattern"</em> <strong>|</strong> <strong>-e</strong>[<strong>~</strong>]/<em>regexp</em>/[<strong>i</strong>] <a class="reference internal" href="../../gmt.html#e-full"><span class="std std-ref">(more ...)</span></a></dt>
<dd>Only accept data records that match the given pattern. </dd>
</dl>
<dl class="docutils">
<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="../../gmt.html#h-full"><span class="std std-ref">(more ...)</span></a></dt>
<dd>Skip or produce header record(s). </dd>
</dl>
<dl class="docutils">
<dt><strong>-i</strong><em>cols</em>[<strong>+l</strong>][<strong>+s</strong><em>scale</em>][<strong>+o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="../../gmt.html#icols-full"><span class="std std-ref">(more ...)</span></a></dt>
<dd>Select input columns and transformations (0 is first column).</dd>
</dl>
<dl class="docutils">
<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="../../gmt.html#ocols-full"><span class="std std-ref">(more ...)</span></a></dt>
<dd>Select output columns (0 is first column).</dd>
</dl>
<dl class="docutils">
<dt><strong>-s</strong>[<em>cols</em>][<strong>a</strong>|<strong>r</strong>] <a class="reference internal" href="../../gmt.html#s-full"><span class="std std-ref">(more ...)</span></a></dt>
<dd>Set handling of NaN records.</dd>
</dl>
<dl class="docutils">
<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="../../gmt.html#colon-full"><span class="std std-ref">(more ...)</span></a></dt>
<dd>Swap 1st and 2nd column on input and/or output.</dd>
</dl>
<dl class="docutils">
<dt><strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+c</strong>][<strong>+t</strong><em>threshold</em>] <a class="reference internal" href="../../gmt.html#n-full"><span class="std std-ref">(more ...)</span></a></dt>
<dd>Select interpolation mode for grids.</dd>
</dl>
<dl class="docutils">
<dt><strong>-^</strong> or just <strong>-</strong></dt>
<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows just use <strong>-</strong>).</dd>
<dt><strong>-+</strong> or just <strong>+</strong></dt>
<dd>Print an extensive usage (help) message, including the explanation of
any module-specific option (but not the GMT common options), then exits.</dd>
<dt><strong>-?</strong> or no arguments</dt>
<dd>Print a complete usage (help) message, including the explanation of all options, then exits.</dd>
</dl>
</div>
<div class="section" id="consequences-of-grid-resampling">
<h2>Consequences of grid resampling<a class="headerlink" href="#consequences-of-grid-resampling" title="Permalink to this headline">¶</a></h2>
<p>Resample or sampling of grids will use various algorithms (see <strong>-n</strong>) that may lead
to possible distortions or unexpected results in the resampled values.
One expected effect of resampling with splines is the tendency for the new
resampled values to slightly exceed the global min/max limits of the original
grid. If this is unacceptable, you can impose clipping of the resampled values
values so they do not exceed the input min/max values by adding <strong>+c</strong> to
your <strong>-n</strong> option.</p>
</div>
<div class="section" id="geodetic-versus-geocentric-coordiinates">
<h2>Geodetic versus Geocentric Coordiinates<a class="headerlink" href="#geodetic-versus-geocentric-coordiinates" title="Permalink to this headline">¶</a></h2>
<p>All spherical rotations are applied to geocentric coordinates.
This means that incoming data points and grids are considered
to represent geodetic coordinates and must first
be converted to geocentric coordinates. Rotations are then applied, and the
final reconstructed points are converted back to geodetic
coordinates. This default behavior can be bypassed if the
ellipsoid setting <a class="reference internal" href="../../gmt.conf.html#projection-parameters"><span class="std std-ref">PROJ_ELLIPSOID</span></a>
is changed to Sphere.</p>
</div>
<div class="section" id="examples">
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
<p>To smooth rotation groups in increments of 3 Myr and ensure northern hemisphere poles, try</p>
<blockquote>
<div><div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">gmt</span> <span class="n">rotsmoother</span> <span class="n">rotations</span><span class="o">.</span><span class="n">txt</span> <span class="o">-</span><span class="n">N</span> <span class="o">-</span><span class="n">V</span> <span class="o">></span> <span class="n">rot_means</span><span class="o">.</span><span class="n">txt</span>
</pre></div>
</div>
</div></blockquote>
</div>
<div class="section" id="see-also">
<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
<p><a class="reference internal" href="backtracker.html"><span class="doc">backtracker</span></a>,
<a class="reference internal" href="gmtpmodeler.html"><span class="doc">gmtpmodeler</span></a>,
<a class="reference internal" href="grdpmodeler.html"><span class="doc">grdpmodeler</span></a>,
<a class="reference internal" href="grdspotter.html"><span class="doc">grdspotter</span></a>,
<a class="reference internal" href="hotspotter.html"><span class="doc">hotspotter</span></a>,
<a class="reference internal" href="originator.html"><span class="doc">originator</span></a>,
<a class="reference internal" href="rotconverter.html"><span class="doc">rotconverter</span></a></p>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h3><a href="../../index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">rotsmoother</a><ul>
<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
<li><a class="reference internal" href="#description">Description</a></li>
<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
<li><a class="reference internal" href="#consequences-of-grid-resampling">Consequences of grid resampling</a></li>
<li><a class="reference internal" href="#geodetic-versus-geocentric-coordiinates">Geodetic versus Geocentric Coordiinates</a></li>
<li><a class="reference internal" href="#examples">Examples</a></li>
<li><a class="reference internal" href="#see-also">See Also</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="rotconverter.html"
title="previous chapter">rotconverter</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="../x2sys/x2sys_binlist.html"
title="next chapter">x2sys_binlist</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../../_sources/supplements/spotter/rotsmoother.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../../genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="../x2sys/x2sys_binlist.html" title="x2sys_binlist"
>next</a> </li>
<li class="right" >
<a href="rotconverter.html" title="rotconverter"
>previous</a> </li>
<li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
<li class="nav-item nav-item-0"><a href="../../index.html">GMT 5.4.4 documentation</a> »</li>
<li class="nav-item nav-item-1"><a href="../../man_pages.html" >Man Pages</a> »</li>
<li class="right">
<form class="search" accept-charset="UTF-8" action="search.html" method="get">
<div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
<label for="q">
<a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
</label>
<input accesskey="f" class="small" id="q" name="q" size="20" type="text">
<input type="hidden" name="check_keywords" value="yes">
<input type="hidden" name="area" value="default">
</form></li>
</ul>
</div>
<div class="footer">
© Copyright 2018, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
Last updated on Jun 28, 2018.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.7.5.
<br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
</div>
</body>
</html>
distrib
>
Mageia
>
7
>
i586
>
media
>
core-release
>
by-pkgid
>
b59462524770eba87e49a9d6e0278eb3
>
files
>
1393
