<!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>Create Colors Suitable for turbidity Fields — oceColorsTurbidity • 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="Create Colors Suitable for turbidity Fields — oceColorsTurbidity"><meta name="description" content='Create a set of colors for displaying turbidity values,
based on the scheme devised by Thyng et al. (2016) and
presented in a python package by Thyng (2019).
The color specifications were transliterated from
python to R on 2015-09-29, but have not been adjusted
since, even though the python source has changed.  This
is to prevent breaking old oce code.  To get the
latest versions of these colours or other colours,
use the cmocean R package
(Thyng, Richards, and Krylov, 2019) directly, as is
illustrated (with the "matter" scheme) in Example 2.
Note that the cmocean core functions provide a way
to select between various versions of the colour schemes.
It is also worth considering the palettes provided by the
viridis package, as illustrated (with the
"inferno" scheme) in Example 3.'><meta property="og:description" content='Create a set of colors for displaying turbidity values,
based on the scheme devised by Thyng et al. (2016) and
presented in a python package by Thyng (2019).
The color specifications were transliterated from
python to R on 2015-09-29, but have not been adjusted
since, even though the python source has changed.  This
is to prevent breaking old oce code.  To get the
latest versions of these colours or other colours,
use the cmocean R package
(Thyng, Richards, and Krylov, 2019) directly, as is
illustrated (with the "matter" scheme) in Example 2.
Note that the cmocean core functions provide a way
to select between various versions of the colour schemes.
It is also worth considering the palettes provided by the
viridis package, as illustrated (with the
"inferno" scheme) in Example 3.'></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>Create Colors Suitable for turbidity Fields</h1>
      <small class="dont-index">Source: <a href="https://github.com/dankelley/oce/blob/HEAD/R/oce.R" class="external-link"><code>R/oce.R</code></a></small>
      <div class="d-none name"><code>oceColorsTurbidity.Rd</code></div>
    </div>

    <div class="ref-description section level2">
    <p>Create a set of colors for displaying turbidity values,
based on the scheme devised by Thyng et al. (2016) and
presented in a python package by Thyng (2019).
The color specifications were transliterated from
python to R on 2015-09-29, but have not been adjusted
since, even though the python source has changed.  This
is to prevent breaking old <code>oce</code> code.  To get the
latest versions of these colours or other colours,
use the <a href="https://CRAN.R-project.org/package=cmocean" class="external-link"><span class="pkg">cmocean</span></a> R package
(Thyng, Richards, and Krylov, 2019) directly, as is
illustrated (with the "matter" scheme) in Example 2.
Note that the <a href="https://CRAN.R-project.org/package=cmocean" class="external-link"><span class="pkg">cmocean</span></a> core functions provide a way
to select between various versions of the colour schemes.
It is also worth considering the palettes provided by the
<a href="https://CRAN.R-project.org/package=viridis" class="external-link"><span class="pkg">viridis</span></a> package, as illustrated (with the
"inferno" scheme) in Example 3.</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">oceColorsTurbidity</span><span class="op">(</span><span class="va">n</span><span class="op">)</span></span></code></pre></div>
    </div>

    <div class="section level2">
    <h2 id="arguments">Arguments<a class="anchor" aria-label="anchor" href="#arguments"></a></h2>


<dl><dt id="arg-n">n<a class="anchor" aria-label="anchor" href="#arg-n"></a></dt>
<dd><p>number of colors to create.</p></dd>

</dl></div>
    <div class="section level2">
    <h2 id="value">Value<a class="anchor" aria-label="anchor" href="#value"></a></h2>
    <p>A vector of color specifications.</p>
    </div>
    <div class="section level2">
    <h2 id="references">References<a class="anchor" aria-label="anchor" href="#references"></a></h2>

<ul><li><p>Thyng, Kristen, Chad Greene, Robert Hetland, Heather Zimmerle, and Steven DiMarco.
“True Colors of Oceanography: Guidelines for Effective and Accurate Colormap Selection.”
Oceanography 29, no. 3 (September 1, 2016): 9–13.
<a href="https://doi.org/10.5670/oceanog.2016.66" class="external-link">doi:10.5670/oceanog.2016.66</a></p></li>
<li><p>Thyng, Kristen. Kthyng/Cmocean. Python, 2019.
<code>https://github.com/kthyng/cmocean</code>.</p></li>
<li><p>Thyng, Kristen, Clark Richards, and Ivan Krylov.
Cmocean: Beautiful Colour Maps for Oceanography (version 0.2), 2019.
<code>https://CRAN.R-project.org/package=cmocean</code>.</p></li>
</ul><p>The following references provide information on choosing
colour schemes, that are suitable for viewers who have
colour deficiencies.</p>
<p>Light, Adam, and Patrick J. Bartlein. "The End of the Rainbow? Color
Schemes for Improved Data Graphics." <em>Eos, Transactions American Geophysical
Union</em> 85, no. 40 (2004): 385.
DOI: 10.1029/2004EO400002</p>
<p>Stephenson, David B. "Comment on 'Color Schemes for Improved Data
Graphics', by A Light and P.J. Bartlein." <em>Eos, Transactions American
Geophysical Union</em> 86, no.  20 (2005): 196.
DOI: 10.1029/2005EO200005</p>
<p>Light, Adam, and Patrick J. Bartlein. "Reply to 'Comment on Color
Schemes for Improved Data Graphics,' by A. Light and P.J.  Bartlein'."
<em>Eos, Transactions American Geophysical Union</em> 86, no. 20 (2005): 196–196.
DOI: 10.1029/2005EO200006</p>
    </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 things related to colors:
<code><a href="colormap.html">colormap</a>()</code>,
<code><a href="colormapGMT.html">colormapGMT</a>()</code>,
<code><a href="oceColors9B.html">oceColors9B</a>()</code>,
<code><a href="oceColorsCDOM.html">oceColorsCDOM</a>()</code>,
<code><a href="oceColorsChlorophyll.html">oceColorsChlorophyll</a>()</code>,
<code><a href="oceColorsClosure.html">oceColorsClosure</a>()</code>,
<code><a href="oceColorsDensity.html">oceColorsDensity</a>()</code>,
<code><a href="oceColorsFreesurface.html">oceColorsFreesurface</a>()</code>,
<code><a href="oceColorsGebco.html">oceColorsGebco</a>()</code>,
<code><a href="oceColorsJet.html">oceColorsJet</a>()</code>,
<code><a href="oceColorsOxygen.html">oceColorsOxygen</a>()</code>,
<code><a href="oceColorsPAR.html">oceColorsPAR</a>()</code>,
<code><a href="oceColorsPalette.html">oceColorsPalette</a>()</code>,
<code><a href="oceColorsPhase.html">oceColorsPhase</a>()</code>,
<code><a href="oceColorsSalinity.html">oceColorsSalinity</a>()</code>,
<code><a href="oceColorsTemperature.html">oceColorsTemperature</a>()</code>,
<code><a href="oceColorsTurbo.html">oceColorsTurbo</a>()</code>,
<code><a href="oceColorsTwo.html">oceColorsTwo</a>()</code>,
<code><a href="oceColorsVelocity.html">oceColorsVelocity</a>()</code>,
<code><a href="oceColorsViridis.html">oceColorsViridis</a>()</code>,
<code><a href="oceColorsVorticity.html">oceColorsVorticity</a>()</code>,
<code><a href="ocecolors.html">ocecolors</a></code></p></div>
    </div>
    <div class="section level2">
    <h2 id="author">Author<a class="anchor" aria-label="anchor" href="#author"></a></h2>
    <p>Krysten M. Thyng (Python version), Dan Kelley (R transliteration)</p>
    </div>

    <div class="section level2">
    <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-examples"></a></h2>
    <div class="sourceCode"><pre class="sourceCode r"><code><span class="r-in"><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="r-in"><span></span></span>
<span class="r-in"><span><span class="co"># Example 1</span></span></span>
<span class="r-in"><span><span class="fu"><a href="imagep.html">imagep</a></span><span class="op">(</span><span class="va">volcano</span>, col<span class="op">=</span><span class="fu">oceColorsTurbidity</span><span class="op">(</span><span class="fl">128</span><span class="op">)</span>,</span></span>
<span class="r-in"><span>    zlab<span class="op">=</span><span class="st">"oceColorsTurbidity"</span><span class="op">)</span></span></span>
<span class="r-plt img"><img src="oceColorsTurbidity-1.png" alt="" width="700" height="700"></span>
<span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="cn">FALSE</span><span class="op">)</span> <span class="op">{</span> <span class="co"># \dontrun{</span></span></span>
<span class="r-in"><span><span class="co"># Example 2 (requires the cmocean package)</span></span></span>
<span class="r-in"><span><span class="fu"><a href="imagep.html">imagep</a></span><span class="op">(</span><span class="va">volcano</span>, col<span class="op">=</span><span class="fu">cmocean</span><span class="fu">::</span><span class="fu"><a href="https://rdrr.io/pkg/cmocean/man/cmocean.html" class="external-link">cmocean</a></span><span class="op">(</span><span class="st">"matter"</span><span class="op">)</span>,</span></span>
<span class="r-in"><span>    zlab<span class="op">=</span><span class="st">"cmocean::cmocean(\"matter\")"</span><span class="op">)</span><span class="op">}</span> <span class="co"># }</span></span></span>
<span class="r-in"><span></span></span>
<span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="cn">FALSE</span><span class="op">)</span> <span class="op">{</span> <span class="co"># \dontrun{</span></span></span>
<span class="r-in"><span><span class="co"># Example 3 (requires the viridis package)</span></span></span>
<span class="r-in"><span><span class="fu"><a href="imagep.html">imagep</a></span><span class="op">(</span><span class="va">volcano</span>, col<span class="op">=</span><span class="fu">viridis</span><span class="fu">::</span><span class="va">inferno</span>,</span></span>
<span class="r-in"><span>    zlab<span class="op">=</span><span class="st">"viridis::inferno"</span><span class="op">)</span><span class="op">}</span> <span class="co"># }</span></span></span>
<span class="r-in"><span></span></span>
</code></pre></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>

