<!DOCTYPE html>
<!-- Generated by pkgdown: do not edit by hand --><html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><title>Global Topographic Data (at Half-degree Resolution) — topoWorld • oce</title><script src="../deps/jquery-3.6.0/jquery-3.6.0.min.js"></script><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><link href="../deps/bootstrap-5.3.1/bootstrap.min.css" rel="stylesheet"><script src="../deps/bootstrap-5.3.1/bootstrap.bundle.min.js"></script><link href="../deps/font-awesome-6.4.2/css/all.min.css" rel="stylesheet"><link href="../deps/font-awesome-6.4.2/css/v4-shims.min.css" rel="stylesheet"><script src="../deps/headroom-0.11.0/headroom.min.js"></script><script src="../deps/headroom-0.11.0/jQuery.headroom.min.js"></script><script src="../deps/bootstrap-toc-1.0.1/bootstrap-toc.min.js"></script><script src="../deps/clipboard.js-2.0.11/clipboard.min.js"></script><script src="../deps/search-1.0.0/autocomplete.jquery.min.js"></script><script src="../deps/search-1.0.0/fuse.min.js"></script><script src="../deps/search-1.0.0/mark.min.js"></script><!-- pkgdown --><script src="../pkgdown.js"></script><meta property="og:title" content="Global Topographic Data (at Half-degree Resolution) — topoWorld"><meta name="description" content='Global topographic dataset at half-degree resolution, downloaded from
a NOAA server on May 18, 2019.  Longitude, accessible as
topoWorld[["longitude"]], ranges from -179.75 to 129.75 degrees north.
Latitude (topoWorld[["latitude"]]) ranges from -89.75 to 89.75 degrees east.
Height (topoWorld[["z"]]) is measured in metres above nominal sea level.
The coarse resolution can be a problem in plotting depth contours along with
coastlines in regions of steep topography. For example, near the southeast
corner of Newfoundland, a 200m contour will overlap a coastline drawn with
coastlineWorldFine from the ocedata package. The solution in such cases is to
download a higher-resolution topography file, perhaps using
download.topo(), and then use read.topo()
to create another topo object.  (With other data
sources, as.topo() may be helpful.)'><meta property="og:description" content='Global topographic dataset at half-degree resolution, downloaded from
a NOAA server on May 18, 2019.  Longitude, accessible as
topoWorld[["longitude"]], ranges from -179.75 to 129.75 degrees north.
Latitude (topoWorld[["latitude"]]) ranges from -89.75 to 89.75 degrees east.
Height (topoWorld[["z"]]) is measured in metres above nominal sea level.
The coarse resolution can be a problem in plotting depth contours along with
coastlines in regions of steep topography. For example, near the southeast
corner of Newfoundland, a 200m contour will overlap a coastline drawn with
coastlineWorldFine from the ocedata package. The solution in such cases is to
download a higher-resolution topography file, perhaps using
download.topo(), and then use read.topo()
to create another topo object.  (With other data
sources, as.topo() may be helpful.)'></head><body>
    <a href="#main" class="visually-hidden-focusable">Skip to contents</a>


    <nav class="navbar navbar-expand-lg fixed-top bg-light" data-bs-theme="light" aria-label="Site navigation"><div class="container">

    <a class="navbar-brand me-2" href="../index.html">oce</a>

    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.8-4</small>


    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>

    <div id="navbar" class="collapse navbar-collapse ms-3">
      <ul class="navbar-nav me-auto"><li class="active nav-item"><a class="nav-link" href="../reference/index.html">Reference</a></li>
<li class="nav-item dropdown">
  <button class="nav-link dropdown-toggle" type="button" id="dropdown-articles" data-bs-toggle="dropdown" aria-expanded="false" aria-haspopup="true">Articles</button>
  <ul class="dropdown-menu" aria-labelledby="dropdown-articles"><li><a class="dropdown-item" href="../articles/A_oce.html">1. Introduction to Oce</a></li>
    <li><a class="dropdown-item" href="../articles/B_ctd.html">2. Analysis of CTD data</a></li>
    <li><a class="dropdown-item" href="../articles/C_adp.html">3. Analysis of acoustic-Doppler data</a></li>
    <li><a class="dropdown-item" href="../articles/D_map_projections.html">4. Using map projections</a></li>
    <li><a class="dropdown-item" href="../articles/E_flags.html">5. Dealing with data-quality flags</a></li>
    <li><a class="dropdown-item" href="../articles/F_subclassing.html">6. Subclassing oce objects</a></li>
    <li><a class="dropdown-item" href="../articles/G_altering_defaults.html">7. Altering oce Defaults</a></li>
    <li><a class="dropdown-item" href="../articles/H_tides.html">8. Tidal Analysis</a></li>
  </ul></li>
<li class="nav-item"><a class="nav-link" href="../news/index.html">Changelog</a></li>
      </ul><ul class="navbar-nav"><li class="nav-item"><form class="form-inline" role="search">
 <input class="form-control" type="search" name="search-input" id="search-input" autocomplete="off" aria-label="Search site" placeholder="Search for" data-search-index="../search.json"></form></li>
<li class="nav-item"><a class="external-link nav-link" href="https://github.com/dankelley/oce/" aria-label="GitHub"><span class="fa fab fa-github fa-lg"></span></a></li>
      </ul></div>


  </div>
</nav><div class="container template-reference-topic">
<div class="row">
  <main id="main" class="col-md-9"><div class="page-header">

      <h1>Global Topographic Data (at Half-degree Resolution)</h1>
      <small class="dont-index">Source: <a href="https://github.com/dankelley/oce/blob/HEAD/R/topo.R" class="external-link"><code>R/topo.R</code></a></small>
      <div class="d-none name"><code>topoWorld.Rd</code></div>
    </div>

    <div class="ref-description section level2">
    <p>Global topographic dataset at half-degree resolution, downloaded from
a NOAA server on May 18, 2019.  Longitude, accessible as
<code>topoWorld[["longitude"]]</code>, ranges from -179.75 to 129.75 degrees north.
Latitude (<code>topoWorld[["latitude"]]</code>) ranges from -89.75 to 89.75 degrees east.
Height (<code>topoWorld[["z"]]</code>) is measured in metres above nominal sea level.</p>
<p>The coarse resolution can be a problem in plotting depth contours along with
coastlines in regions of steep topography. For example, near the southeast
corner of Newfoundland, a 200m contour will overlap a coastline drawn with
<code>coastlineWorldFine</code> from the <a href="https://CRAN.R-project.org/package=ocedata" class="external-link"><span class="pkg">ocedata</span></a> package. The solution in such cases is to
download a higher-resolution topography file, perhaps using
<code><a href="download.topo.html">download.topo()</a></code>, and then use <code><a href="read.topo.html">read.topo()</a></code>
to create another <code>topo</code> object.  (With other data
sources, <code><a href="as.topo.html">as.topo()</a></code> may be helpful.)</p>
    </div>

    <div class="section level2">
    <h2 id="ref-usage">Usage<a class="anchor" aria-label="anchor" href="#ref-usage"></a></h2>
    <div class="sourceCode"><pre class="sourceCode r"><code><span><span class="fu"><a href="https://rdrr.io/r/utils/data.html" class="external-link">data</a></span><span class="op">(</span><span class="va">topoWorld</span><span class="op">)</span></span></code></pre></div>
    </div>

    <div class="section level2">
    <h2 id="source">Source<a class="anchor" aria-label="anchor" href="#source"></a></h2>
    <p>This is created with <code><a href="read.topo.html">read.topo()</a></code>, using a file downloaded with</p><div class="sourceCode"><pre><code><span></span>
<span><span class="va">topoFile</span> <span class="op">&lt;-</span> <span class="fu"><a href="../reference/download.topo.html">download.topo</a></span><span class="op">(</span>west<span class="op">=</span><span class="op">-</span><span class="fl">180</span>, east<span class="op">=</span><span class="fl">180</span>, south<span class="op">=</span><span class="op">-</span><span class="fl">90</span>, north<span class="op">=</span><span class="fl">90</span>,</span>
<span>   resolution<span class="op">=</span><span class="fl">30</span>, destdir<span class="op">=</span><span class="st">"."</span><span class="op">)</span></span></code></pre></div>

    </div>
    <div class="section level2">
    <h2 id="historical-note">Historical note<a class="anchor" aria-label="anchor" href="#historical-note"></a></h2>


<p>From late 2009 until May 18, 2019, the <code>topoWorld</code> dataset was created
with a fairly complicated code that read a binary file downloaded from NOAA
(<samp>http://www.ngdc.noaa.gov/mgg/global/relief/ETOPO5/TOPO/ETOPO5</samp>),
decoded, decimated from 1/12th degree resolution to 1/2 degree resolution, and
passed through <code><a href="matrixShiftLongitude.html">matrixShiftLongitude()</a></code> to put longitude
between -180 and 180 degrees. The new scheme for creating the dataset,
(see “Source”) is much simpler, and also a much better model
of how users are likely to deal with topography files in the more
modern netCDF format. Note that the new version differs from the old one
in longitude and latitude being shifted by 1/4 degree,
and by a mean  elevation difference of under 10m. The old and new
versions appear identical when plotted at the global scale that is
the recommended for such a coarse topographic file.</p>
    </div>
    <div class="section level2">
    <h2 id="sample-of-usage">Sample of Usage<a class="anchor" aria-label="anchor" href="#sample-of-usage"></a></h2>


<div class="sourceCode"><pre><code><span></span>
<span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">library</a></span><span class="op">(</span><span class="va"><a href="https://dankelley.github.io/oce/">oce</a></span><span class="op">)</span></span>
<span><span class="fu"><a href="https://rdrr.io/r/utils/data.html" class="external-link">data</a></span><span class="op">(</span><span class="va">topoWorld</span><span class="op">)</span></span>
<span><span class="fu"><a href="https://rdrr.io/r/graphics/par.html" class="external-link">par</a></span><span class="op">(</span>mfrow<span class="op">=</span><span class="fu"><a href="https://rdrr.io/r/base/c.html" class="external-link">c</a></span><span class="op">(</span><span class="fl">2</span>, <span class="fl">1</span><span class="op">)</span><span class="op">)</span></span>
<span><span class="fu"><a href="https://rdrr.io/r/graphics/plot.default.html" class="external-link">plot</a></span><span class="op">(</span><span class="va">topoWorld</span>, location<span class="op">=</span><span class="cn">NULL</span><span class="op">)</span></span>
<span><span class="fu"><a href="../reference/imagep.html">imagep</a></span><span class="op">(</span><span class="va">topoWorld</span><span class="op">)</span></span></code></pre></div>

    </div>
    <div class="section level2">
    <h2 id="see-also">See also<a class="anchor" aria-label="anchor" href="#see-also"></a></h2>
    <div class="dont-index"><p>Other datasets provided with oce:
<code><a href="adp.html">adp</a></code>,
<code><a href="adv.html">adv</a></code>,
<code><a href="amsr.html">amsr</a></code>,
<code><a href="argo.html">argo</a></code>,
<code><a href="cm.html">cm</a></code>,
<code><a href="coastlineWorld.html">coastlineWorld</a></code>,
<code><a href="ctd.html">ctd</a></code>,
<code><a href="ctdRaw.html">ctdRaw</a></code>,
<code><a href="echosounder.html">echosounder</a></code>,
<code><a href="landsat.html">landsat</a></code>,
<code><a href="lisst.html">lisst</a></code>,
<code><a href="lobo.html">lobo</a></code>,
<code><a href="met.html">met</a></code>,
<code><a href="ocecolors.html">ocecolors</a></code>,
<code><a href="rsk.html">rsk</a></code>,
<code><a href="sealevel.html">sealevel</a></code>,
<code><a href="sealevelTuktoyaktuk.html">sealevelTuktoyaktuk</a></code>,
<code><a href="section.html">section</a></code>,
<code><a href="wind.html">wind</a></code>,
<code><a href="xbt.html">xbt</a></code></p>
<p>Other things related to topo data:
<code><a href="sub-sub-topo-method.html">[[,topo-method</a></code>,
<code>[[&lt;-,topo-method</code>,
<code><a href="as.topo.html">as.topo</a>()</code>,
<code><a href="download.topo.html">download.topo</a>()</code>,
<code><a href="plot-topo-method.html">plot,topo-method</a></code>,
<code><a href="read.topo.html">read.topo</a>()</code>,
<code><a href="subset-topo-method.html">subset,topo-method</a></code>,
<code><a href="summary-topo-method.html">summary,topo-method</a></code>,
<code><a href="topo-class.html">topo-class</a></code>,
<code><a href="topoInterpolate.html">topoInterpolate</a>()</code></p></div>
    </div>

  </main><aside class="col-md-3"><nav id="toc" aria-label="Table of contents"><h2>On this page</h2>
    </nav></aside></div>


    <footer><div class="pkgdown-footer-left">
  <p>Developed by Dan Kelley, Clark Richards.</p>
</div>

<div class="pkgdown-footer-right">
  <p>Site built with <a href="https://pkgdown.r-lib.org/" class="external-link">pkgdown</a> 2.1.0.9000.</p>
</div>

    </footer></div>





  </body></html>

