From 0cfc9422bc8ad6095e39667cb38b5f02a9a8f919 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Benno=20Pu=CC=88tz?= <puetz@psych.mpg.de>
Date: Thu, 6 Aug 2020 04:16:18 +0200
Subject: [PATCH] update
---
docs/404.html | 2 +-
docs/authors.html | 2 +-
docs/index.html | 4 +-
docs/pkgdown.yml | 2 +-
docs/reference/ColorShadeRamp.html | 2 +-
docs/reference/between.html | 2 +-
docs/reference/col.rep.html | 15 +-
docs/reference/colmat2lutfile.html | 193 +++++++++++++++++++++
docs/reference/color.shades.html | 2 +-
docs/reference/concat.tbl.list.html | 2 +-
docs/reference/cutshades.html | 2 +-
docs/reference/default.cuts.html | 168 +++++++++++++++++++
docs/reference/default.hcl.html | 2 +-
docs/reference/default.lab.html | 2 +-
docs/reference/default.rgb.html | 2 +-
docs/reference/dend.with.cuts.html | 12 +-
docs/reference/dummy.tree.html | 9 +-
docs/reference/expand.colmat.html | 175 ++++++++++++++++++++
docs/reference/grapes-and-grapes.html | 2 +-
docs/reference/hri.plot-1.png | Bin 0 -> 44795 bytes
docs/reference/hri.plot-2.png | Bin 0 -> 60813 bytes
docs/reference/hri.plot.html | 183 ++++++++++++++++++++
docs/reference/hue.range.colors.html | 2 +-
docs/reference/hue.range.init.html | 184 ++++++++++++++++++++
docs/reference/hue.range.lines.html | 2 +-
docs/reference/hue.range.split.html | 8 +-
docs/reference/index.html | 38 ++++-
docs/reference/init.blank.plot.html | 2 +-
docs/reference/init.huerange.plot.html | 2 +-
docs/reference/mat2list.html | 2 +-
docs/reference/rainbow_lab.html | 2 +-
docs/reference/rainbow_lab_ramp.html | 2 +-
docs/reference/randomize.cutree.html | 2 +-
docs/reference/read.tree.html | 2 +-
docs/reference/readlut.html | 2 +-
docs/reference/reidx.cut.html | 2 +-
docs/reference/show.brain.lut.html | 9 +-
docs/reference/show.colmat.html | 2 +-
docs/reference/show.cut.html | 2 +-
docs/reference/show.hue.range.html | 6 +-
docs/reference/show.lut.html | 2 +-
docs/reference/show.shades.html | 2 +-
docs/reference/show.sub.tables.html | 2 +-
docs/reference/subtables.html | 221 +++++++++++++++++++++++++
docs/reference/tbl2mat.html | 2 +-
docs/reference/tree.ranges.html | 2 +-
docs/reference/tree.ranges.plot.html | 2 +-
docs/reference/treeluts.html | 20 ++-
docs/reference/vec2hsv.html | 7 +-
docs/reference/vec2rgb.html | 2 +-
docs/reference/vlevels.html | 6 +-
docs/reference/writelut.html | 2 +-
52 files changed, 1253 insertions(+), 71 deletions(-)
create mode 100644 docs/reference/colmat2lutfile.html
create mode 100644 docs/reference/default.cuts.html
create mode 100644 docs/reference/expand.colmat.html
create mode 100644 docs/reference/hri.plot-1.png
create mode 100644 docs/reference/hri.plot-2.png
create mode 100644 docs/reference/hri.plot.html
create mode 100644 docs/reference/hue.range.init.html
create mode 100644 docs/reference/subtables.html
diff --git a/docs/404.html b/docs/404.html
index c80986e..3bcab9a 100644
--- a/docs/404.html
+++ b/docs/404.html
@@ -71,7 +71,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/authors.html b/docs/authors.html
index fa1d642..2986e69 100644
--- a/docs/authors.html
+++ b/docs/authors.html
@@ -71,7 +71,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/index.html b/docs/index.html
index 15ad32a..3caddf9 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -33,7 +33,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
@@ -67,7 +67,7 @@
<div id="cluster-lookup-tables---cluster-luts" class="section level1">
<div class="page-header"><h1 class="hasAnchor">
<a href="#cluster-lookup-tables---cluster-luts" class="anchor"></a>Cluster Lookup Tables - cluster LUTs</h1></div>
-<p>Coloring for a cluster tree with 145 leaves and 28 levels (10 (top), 15, …, 145 clusters (bottom)): <img src="docs/reference/colortree.png" alt="colortree"></p>
+<p>Coloring for a cluster tree with 145 leaves and 28 levels (10 (top), 15, …, 145 clusters (bottom)): <img src="reference/colortree.png" alt="colortree"></p>
<div id="concepts" class="section level2">
<h2 class="hasAnchor">
<a href="#concepts" class="anchor"></a>Concepts</h2>
diff --git a/docs/pkgdown.yml b/docs/pkgdown.yml
index 691938f..49c646a 100644
--- a/docs/pkgdown.yml
+++ b/docs/pkgdown.yml
@@ -2,5 +2,5 @@ pandoc: 2.7.3
pkgdown: 1.5.1
pkgdown_sha: ~
articles: []
-last_built: 2020-08-03T09:48Z
+last_built: 2020-08-06T02:10Z
diff --git a/docs/reference/ColorShadeRamp.html b/docs/reference/ColorShadeRamp.html
index e8683b3..82103f3 100644
--- a/docs/reference/ColorShadeRamp.html
+++ b/docs/reference/ColorShadeRamp.html
@@ -73,7 +73,7 @@ for symmetry the color should be a color with full saturation" />
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/between.html b/docs/reference/between.html
index 25fbfc2..08d0d31 100644
--- a/docs/reference/between.html
+++ b/docs/reference/between.html
@@ -73,7 +73,7 @@ margins), i.e., \(low \leq x \leq high\)" />
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/col.rep.html b/docs/reference/col.rep.html
index 4134eed..f785628 100644
--- a/docs/reference/col.rep.html
+++ b/docs/reference/col.rep.html
@@ -73,7 +73,7 @@ RGB color matrix. Analog to rep which is used internally." />
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
@@ -114,7 +114,7 @@ RGB color matrix. Analog to rep which is used internally." />
RGB color matrix. Analog to <code><a href='https://rdrr.io/r/base/rep.html'>rep</a></code> which is used internally.</p>
</div>
- <pre class="usage"><span class='fu'>col.rep</span>(<span class='no'>col</span>, <span class='no'>n</span>)</pre>
+ <pre class="usage"><span class='fu'>col.rep</span>(<span class='no'>col</span>, <span class='no'>n</span>, <span class='kw'>alpha</span> <span class='kw'>=</span> <span class='fl'>FALSE</span>)</pre>
<h2 class="hasAnchor" id="arguments"><a class="anchor" href="#arguments"></a>Arguments</h2>
<table class="ref-arguments">
@@ -127,11 +127,22 @@ RGB color matrix. Analog to <code><a href='https://rdrr.io/r/base/rep.html'>rep<
<th>n</th>
<td><p>number of repetitions (should be a positive integer value)</p></td>
</tr>
+ <tr>
+ <th>alpha</th>
+ <td><p>either logical or actual alpha (in [0..255])</p></td>
+ </tr>
</table>
<h2 class="hasAnchor" id="value"><a class="anchor" href="#value"></a>Value</h2>
<p>color matrix with <code>n</code> columns of color <code>col</code></p>
+ <h2 class="hasAnchor" id="details"><a class="anchor" href="#details"></a>Details</h2>
+
+ <p>If <code>col</code> consists of more than one color, those colors are recycl
+the usual rules to reach <code>n</code> colors. In the special case where <code>n</code>
+is smaller than thenumber of colors in <code>col</code>, only the first <code>n</code>
+colors will be returned.</p>
+<p>For <code>n</code><1 an empty matrix is returned.</p>
<h2 class="hasAnchor" id="examples"><a class="anchor" href="#examples"></a>Examples</h2>
<pre class="examples"><div class='input'><span class='fu'>col.rep</span>(<span class='st'>'red'</span>, <span class='fl'>3</span>)</div><div class='output co'>#> [,1] [,2] [,3]
diff --git a/docs/reference/colmat2lutfile.html b/docs/reference/colmat2lutfile.html
new file mode 100644
index 0000000..5c60840
--- /dev/null
+++ b/docs/reference/colmat2lutfile.html
@@ -0,0 +1,193 @@
+<!-- Generated by pkgdown: do not edit by hand -->
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+<title>Write color matrix to LUT file — colmat2lutfile • clusterLUTs</title>
+
+
+<!-- jquery -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.min.js" integrity="sha256-CSXorXvZcTkaix6Yvo6HppcZGetbYMGWSFlBw8HfCJo=" crossorigin="anonymous"></script>
+<!-- Bootstrap -->
+
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/css/bootstrap.min.css" integrity="sha256-bZLfwXAP04zRMK2BjiO8iu9pf4FbLqX6zitd+tIvLhE=" crossorigin="anonymous" />
+
+<script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/js/bootstrap.min.js" integrity="sha256-nuL8/2cJ5NDSSwnKD8VqreErSWHtnEP9E7AySL+1ev4=" crossorigin="anonymous"></script>
+
+<!-- bootstrap-toc -->
+<link rel="stylesheet" href="../bootstrap-toc.css">
+<script src="../bootstrap-toc.js"></script>
+
+<!-- Font Awesome icons -->
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/all.min.css" integrity="sha256-mmgLkCYLUQbXn0B1SRqzHar6dCnv9oZFPEC1g1cwlkk=" crossorigin="anonymous" />
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/v4-shims.min.css" integrity="sha256-wZjR52fzng1pJHwx4aV2AO3yyTOXrcDW7jBpJtTwVxw=" crossorigin="anonymous" />
+
+<!-- clipboard.js -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.6/clipboard.min.js" integrity="sha256-inc5kl9MA1hkeYUt+EC3BhlIgyp/2jDIyBLS6k3UxPI=" crossorigin="anonymous"></script>
+
+<!-- headroom.js -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/headroom.min.js" integrity="sha256-AsUX4SJE1+yuDu5+mAVzJbuYNPHj/WroHuZ8Ir/CkE0=" crossorigin="anonymous"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/jQuery.headroom.min.js" integrity="sha256-ZX/yNShbjqsohH1k95liqY9Gd8uOiE1S4vZc+9KQ1K4=" crossorigin="anonymous"></script>
+
+<!-- pkgdown -->
+<link href="../pkgdown.css" rel="stylesheet">
+<script src="../pkgdown.js"></script>
+
+
+
+
+<meta property="og:title" content="Write color matrix to LUT file — colmat2lutfile" />
+<meta property="og:description" content="Companion function to writelut that sets up a correct
+lookup table." />
+
+
+
+
+<!-- mathjax -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js" integrity="sha256-nvJJv9wWKEm88qvoQl9ekL2J+k/RWIsaSScxxlsrv8k=" crossorigin="anonymous"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/config/TeX-AMS-MML_HTMLorMML.js" integrity="sha256-84DKXVJXs0/F8OTMzX4UR909+jtl4G7SPypPavF+GfA=" crossorigin="anonymous"></script>
+
+<!--[if lt IE 9]>
+<script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
+<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
+<![endif]-->
+
+
+
+ </head>
+
+ <body data-spy="scroll" data-target="#toc">
+ <div class="container template-reference-topic">
+ <header>
+ <div class="navbar navbar-default navbar-fixed-top" role="navigation">
+ <div class="container">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <span class="navbar-brand">
+ <a class="navbar-link" href="../index.html">clusterLUTs</a>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
+ </span>
+ </div>
+
+ <div id="navbar" class="navbar-collapse collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="../index.html">
+ <span class="fas fa fas fa-home fa-lg"></span>
+
+ </a>
+</li>
+<li>
+ <a href="../reference/index.html">Reference</a>
+</li>
+ </ul>
+ <ul class="nav navbar-nav navbar-right">
+
+ </ul>
+
+ </div><!--/.nav-collapse -->
+ </div><!--/.container -->
+</div><!--/.navbar -->
+
+
+
+ </header>
+
+<div class="row">
+ <div class="col-md-9 contents">
+ <div class="page-header">
+ <h1>Write color matrix to LUT file</h1>
+
+ <div class="hidden name"><code>colmat2lutfile.Rd</code></div>
+ </div>
+
+ <div class="ref-description">
+ <p>Companion function to <code><a href='writelut.html'>writelut</a></code> that sets up a correct
+lookup table.</p>
+ </div>
+
+ <pre class="usage"><span class='fu'>colmat2lutfile</span>(
+ <span class='no'>colmat</span>,
+ <span class='no'>file</span>,
+ <span class='kw'>fill</span> <span class='kw'>=</span> <span class='fl'>TRUE</span>,
+ <span class='kw'>length</span> <span class='kw'>=</span> <span class='fl'>256</span>,
+ <span class='kw'>bw</span> <span class='kw'>=</span> <span class='fl'>TRUE</span>,
+ <span class='kw'>truncate</span> <span class='kw'>=</span> <span class='fl'>FALSE</span>,
+ <span class='no'>...</span>
+)</pre>
+
+ <h2 class="hasAnchor" id="arguments"><a class="anchor" href="#arguments"></a>Arguments</h2>
+ <table class="ref-arguments">
+ <colgroup><col class="name" /><col class="desc" /></colgroup>
+ <tr>
+ <th>colmat</th>
+ <td><p>color matrix</p></td>
+ </tr>
+ <tr>
+ <th>file</th>
+ <td><p>file to write to</p></td>
+ </tr>
+ <tr>
+ <th>fill</th>
+ <td><p>whether to fill</p></td>
+ </tr>
+ <tr>
+ <th>length</th>
+ <td><p>desired length (only when <code>fill</code> is TRUE)</p></td>
+ </tr>
+ <tr>
+ <th>bw</th>
+ <td><p>add 'black' as first and 'white' as last entry?</p></td>
+ </tr>
+ <tr>
+ <th>truncate</th>
+ <td><p>truncate if too long</p></td>
+ </tr>
+ <tr>
+ <th>...</th>
+ <td><p>ignored</p></td>
+ </tr>
+ </table>
+
+ <h2 class="hasAnchor" id="value"><a class="anchor" href="#value"></a>Value</h2>
+
+ <p>color matrix that was written (possibly filled)</p>
+
+ <h2 class="hasAnchor" id="examples"><a class="anchor" href="#examples"></a>Examples</h2>
+ <pre class="examples"><div class='input'><span class='fu'>colmat2lutfile</span>(<span class='fu'><a href='rainbow_lab.html'>rainbow_lab</a></span>(<span class='fl'>6</span>), <span class='fu'><a href='https://rdrr.io/r/base/tempfile.html'>tempfile</a></span>(), <span class='kw'>fill</span> <span class='kw'>=</span> <span class='fl'>FALSE</span>)</div></pre>
+ </div>
+ <div class="col-md-3 hidden-xs hidden-sm" id="pkgdown-sidebar">
+ <nav id="toc" data-toggle="toc" class="sticky-top">
+ <h2 data-toc-skip>Contents</h2>
+ </nav>
+ </div>
+</div>
+
+
+ <footer>
+ <div class="copyright">
+ <p>Developed by Benno Pütz.</p>
+</div>
+
+<div class="pkgdown">
+ <p>Site built with <a href="https://pkgdown.r-lib.org/">pkgdown</a> 1.5.1.</p>
+</div>
+
+ </footer>
+ </div>
+
+
+
+
+ </body>
+</html>
+
+
diff --git a/docs/reference/color.shades.html b/docs/reference/color.shades.html
index 9b4e41a..d3e6173 100644
--- a/docs/reference/color.shades.html
+++ b/docs/reference/color.shades.html
@@ -74,7 +74,7 @@ shades are going scale of the way to white/black." />
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/concat.tbl.list.html b/docs/reference/concat.tbl.list.html
index f1a9e8d..6bf0c9f 100644
--- a/docs/reference/concat.tbl.list.html
+++ b/docs/reference/concat.tbl.list.html
@@ -76,7 +76,7 @@ via cbind." />
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/cutshades.html b/docs/reference/cutshades.html
index fc50903..fbea5ee 100644
--- a/docs/reference/cutshades.html
+++ b/docs/reference/cutshades.html
@@ -74,7 +74,7 @@ reorder the shading to arrange according to cluster members." />
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/default.cuts.html b/docs/reference/default.cuts.html
new file mode 100644
index 0000000..63ef722
--- /dev/null
+++ b/docs/reference/default.cuts.html
@@ -0,0 +1,168 @@
+<!-- Generated by pkgdown: do not edit by hand -->
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+<title>default cuts — default.cuts • clusterLUTs</title>
+
+
+<!-- jquery -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.min.js" integrity="sha256-CSXorXvZcTkaix6Yvo6HppcZGetbYMGWSFlBw8HfCJo=" crossorigin="anonymous"></script>
+<!-- Bootstrap -->
+
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/css/bootstrap.min.css" integrity="sha256-bZLfwXAP04zRMK2BjiO8iu9pf4FbLqX6zitd+tIvLhE=" crossorigin="anonymous" />
+
+<script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/js/bootstrap.min.js" integrity="sha256-nuL8/2cJ5NDSSwnKD8VqreErSWHtnEP9E7AySL+1ev4=" crossorigin="anonymous"></script>
+
+<!-- bootstrap-toc -->
+<link rel="stylesheet" href="../bootstrap-toc.css">
+<script src="../bootstrap-toc.js"></script>
+
+<!-- Font Awesome icons -->
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/all.min.css" integrity="sha256-mmgLkCYLUQbXn0B1SRqzHar6dCnv9oZFPEC1g1cwlkk=" crossorigin="anonymous" />
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/v4-shims.min.css" integrity="sha256-wZjR52fzng1pJHwx4aV2AO3yyTOXrcDW7jBpJtTwVxw=" crossorigin="anonymous" />
+
+<!-- clipboard.js -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.6/clipboard.min.js" integrity="sha256-inc5kl9MA1hkeYUt+EC3BhlIgyp/2jDIyBLS6k3UxPI=" crossorigin="anonymous"></script>
+
+<!-- headroom.js -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/headroom.min.js" integrity="sha256-AsUX4SJE1+yuDu5+mAVzJbuYNPHj/WroHuZ8Ir/CkE0=" crossorigin="anonymous"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/jQuery.headroom.min.js" integrity="sha256-ZX/yNShbjqsohH1k95liqY9Gd8uOiE1S4vZc+9KQ1K4=" crossorigin="anonymous"></script>
+
+<!-- pkgdown -->
+<link href="../pkgdown.css" rel="stylesheet">
+<script src="../pkgdown.js"></script>
+
+
+
+
+<meta property="og:title" content="default cuts — default.cuts" />
+<meta property="og:description" content="find suitable cuts for n leaves" />
+
+
+
+
+<!-- mathjax -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js" integrity="sha256-nvJJv9wWKEm88qvoQl9ekL2J+k/RWIsaSScxxlsrv8k=" crossorigin="anonymous"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/config/TeX-AMS-MML_HTMLorMML.js" integrity="sha256-84DKXVJXs0/F8OTMzX4UR909+jtl4G7SPypPavF+GfA=" crossorigin="anonymous"></script>
+
+<!--[if lt IE 9]>
+<script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
+<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
+<![endif]-->
+
+
+
+ </head>
+
+ <body data-spy="scroll" data-target="#toc">
+ <div class="container template-reference-topic">
+ <header>
+ <div class="navbar navbar-default navbar-fixed-top" role="navigation">
+ <div class="container">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <span class="navbar-brand">
+ <a class="navbar-link" href="../index.html">clusterLUTs</a>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
+ </span>
+ </div>
+
+ <div id="navbar" class="navbar-collapse collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="../index.html">
+ <span class="fas fa fas fa-home fa-lg"></span>
+
+ </a>
+</li>
+<li>
+ <a href="../reference/index.html">Reference</a>
+</li>
+ </ul>
+ <ul class="nav navbar-nav navbar-right">
+
+ </ul>
+
+ </div><!--/.nav-collapse -->
+ </div><!--/.container -->
+</div><!--/.navbar -->
+
+
+
+ </header>
+
+<div class="row">
+ <div class="col-md-9 contents">
+ <div class="page-header">
+ <h1>default cuts</h1>
+
+ <div class="hidden name"><code>default.cuts.Rd</code></div>
+ </div>
+
+ <div class="ref-description">
+ <p>find suitable cuts for <code>n</code> leaves</p>
+ </div>
+
+ <pre class="usage"><span class='fu'>default.cuts</span>(<span class='no'>n</span>, <span class='no'>...</span>)</pre>
+
+ <h2 class="hasAnchor" id="arguments"><a class="anchor" href="#arguments"></a>Arguments</h2>
+ <table class="ref-arguments">
+ <colgroup><col class="name" /><col class="desc" /></colgroup>
+ <tr>
+ <th>n</th>
+ <td><p>number of leaves in dendrogram</p></td>
+ </tr>
+ <tr>
+ <th>...</th>
+ <td><p>ignored</p></td>
+ </tr>
+ </table>
+
+ <h2 class="hasAnchor" id="value"><a class="anchor" href="#value"></a>Value</h2>
+
+ <p>nice cuts</p>
+ <h2 class="hasAnchor" id="details"><a class="anchor" href="#details"></a>Details</h2>
+
+ <p>Internal</p>
+<p>For a square <code>n</code> the cuts are the multiples of \(\sqrt{n}\)
+up to {n</p>
+
+ <h2 class="hasAnchor" id="examples"><a class="anchor" href="#examples"></a>Examples</h2>
+ <pre class="examples"><div class='input'><span class='fu'>default.cuts</span>(<span class='fl'>9</span>)</div><div class='output co'>#> <span class='error'>Error in default.cuts(9): could not find function "default.cuts"</span></div></pre>
+ </div>
+ <div class="col-md-3 hidden-xs hidden-sm" id="pkgdown-sidebar">
+ <nav id="toc" data-toggle="toc" class="sticky-top">
+ <h2 data-toc-skip>Contents</h2>
+ </nav>
+ </div>
+</div>
+
+
+ <footer>
+ <div class="copyright">
+ <p>Developed by Benno Pütz.</p>
+</div>
+
+<div class="pkgdown">
+ <p>Site built with <a href="https://pkgdown.r-lib.org/">pkgdown</a> 1.5.1.</p>
+</div>
+
+ </footer>
+ </div>
+
+
+
+
+ </body>
+</html>
+
+
diff --git a/docs/reference/default.hcl.html b/docs/reference/default.hcl.html
index 28534f4..7205668 100644
--- a/docs/reference/default.hcl.html
+++ b/docs/reference/default.hcl.html
@@ -72,7 +72,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/default.lab.html b/docs/reference/default.lab.html
index 5cad0aa..cb268aa 100644
--- a/docs/reference/default.lab.html
+++ b/docs/reference/default.lab.html
@@ -72,7 +72,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/default.rgb.html b/docs/reference/default.rgb.html
index 149eec1..ece7b2c 100644
--- a/docs/reference/default.rgb.html
+++ b/docs/reference/default.rgb.html
@@ -72,7 +72,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/dend.with.cuts.html b/docs/reference/dend.with.cuts.html
index b38d3c7..930cd6a 100644
--- a/docs/reference/dend.with.cuts.html
+++ b/docs/reference/dend.with.cuts.html
@@ -72,7 +72,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
@@ -112,15 +112,11 @@
<p>Mainly for debugging</p>
</div>
- <pre class="usage"><span class='fu'>dend.with.cuts</span>(<span class='no'>dt</span>, <span class='kw'>cuts</span> <span class='kw'>=</span> <span class='kw'>NULL</span>, <span class='kw'>cut.col</span> <span class='kw'>=</span> <span class='st'>"#ffa050"</span>, <span class='no'>...</span>)</pre>
+ <pre class="usage"><span class='fu'>dend.with.cuts</span>(<span class='no'>hc.or.dt</span>, <span class='kw'>cuts</span> <span class='kw'>=</span> <span class='kw'>NULL</span>, <span class='kw'>cut.col</span> <span class='kw'>=</span> <span class='st'>"#ffa050"</span>, <span class='no'>...</span>)</pre>
<h2 class="hasAnchor" id="arguments"><a class="anchor" href="#arguments"></a>Arguments</h2>
<table class="ref-arguments">
<colgroup><col class="name" /><col class="desc" /></colgroup>
- <tr>
- <th>dt</th>
- <td><p>output of <code><a href='dummy.tree.html'>dummy.tree</a></code></p></td>
- </tr>
<tr>
<th>cuts</th>
<td><p>cut levels to show (cluster numbers) (optional, see description)</p></td>
@@ -133,6 +129,10 @@
<th>...</th>
<td><p>passed to <code><a href='https://rdrr.io/r/graphics/abline.html'>abline</a></code> (<code>col</code>, <code>lty</code>, ...)</p></td>
</tr>
+ <tr>
+ <th>dt</th>
+ <td><p>output of <code><a href='dummy.tree.html'>dummy.tree</a></code></p></td>
+ </tr>
</table>
<h2 class="hasAnchor" id="value"><a class="anchor" href="#value"></a>Value</h2>
diff --git a/docs/reference/dummy.tree.html b/docs/reference/dummy.tree.html
index 795ca05..596b400 100644
--- a/docs/reference/dummy.tree.html
+++ b/docs/reference/dummy.tree.html
@@ -72,7 +72,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
@@ -112,12 +112,7 @@
<p>The number shoud be reasonably small to keep the example results clear.</p>
</div>
- <pre class="usage"><span class='fu'>dummy.tree</span>(
- <span class='kw'>n</span> <span class='kw'>=</span> <span class='fl'>9</span>,
- <span class='kw'>cuts</span> <span class='kw'>=</span> <span class='fu'><a href='https://rdrr.io/r/base/Round.html'>round</a></span>(<span class='fu'><a href='https://rdrr.io/r/base/seq.html'>seq</a></span>(<span class='fl'>0</span>, <span class='no'>n</span>, <span class='kw'>length.out</span> <span class='kw'>=</span> <span class='fu'><a href='https://rdrr.io/r/base/Round.html'>ceiling</a></span>(<span class='fu'><a href='https://rdrr.io/r/base/MathFun.html'>sqrt</a></span>(<span class='no'>n</span> + <span class='fl'>1</span>)))[-<span class='fl'>1</span>]),
- <span class='no'>...</span>,
- <span class='kw'>seed</span> <span class='kw'>=</span> <span class='fl'>1234</span>
-)</pre>
+ <pre class="usage"><span class='fu'>dummy.tree</span>(<span class='kw'>n</span> <span class='kw'>=</span> <span class='fl'>9</span>, <span class='kw'>cuts</span> <span class='kw'>=</span> <span class='fu'><a href='default.cuts.html'>default.cuts</a></span>(<span class='no'>n</span>), <span class='no'>...</span>, <span class='kw'>seed</span> <span class='kw'>=</span> <span class='fl'>1234</span>)</pre>
<h2 class="hasAnchor" id="arguments"><a class="anchor" href="#arguments"></a>Arguments</h2>
<table class="ref-arguments">
diff --git a/docs/reference/expand.colmat.html b/docs/reference/expand.colmat.html
new file mode 100644
index 0000000..3de96fc
--- /dev/null
+++ b/docs/reference/expand.colmat.html
@@ -0,0 +1,175 @@
+<!-- Generated by pkgdown: do not edit by hand -->
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+<title>expand color matrix — expand.colmat • clusterLUTs</title>
+
+
+<!-- jquery -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.min.js" integrity="sha256-CSXorXvZcTkaix6Yvo6HppcZGetbYMGWSFlBw8HfCJo=" crossorigin="anonymous"></script>
+<!-- Bootstrap -->
+
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/css/bootstrap.min.css" integrity="sha256-bZLfwXAP04zRMK2BjiO8iu9pf4FbLqX6zitd+tIvLhE=" crossorigin="anonymous" />
+
+<script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/js/bootstrap.min.js" integrity="sha256-nuL8/2cJ5NDSSwnKD8VqreErSWHtnEP9E7AySL+1ev4=" crossorigin="anonymous"></script>
+
+<!-- bootstrap-toc -->
+<link rel="stylesheet" href="../bootstrap-toc.css">
+<script src="../bootstrap-toc.js"></script>
+
+<!-- Font Awesome icons -->
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/all.min.css" integrity="sha256-mmgLkCYLUQbXn0B1SRqzHar6dCnv9oZFPEC1g1cwlkk=" crossorigin="anonymous" />
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/v4-shims.min.css" integrity="sha256-wZjR52fzng1pJHwx4aV2AO3yyTOXrcDW7jBpJtTwVxw=" crossorigin="anonymous" />
+
+<!-- clipboard.js -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.6/clipboard.min.js" integrity="sha256-inc5kl9MA1hkeYUt+EC3BhlIgyp/2jDIyBLS6k3UxPI=" crossorigin="anonymous"></script>
+
+<!-- headroom.js -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/headroom.min.js" integrity="sha256-AsUX4SJE1+yuDu5+mAVzJbuYNPHj/WroHuZ8Ir/CkE0=" crossorigin="anonymous"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/jQuery.headroom.min.js" integrity="sha256-ZX/yNShbjqsohH1k95liqY9Gd8uOiE1S4vZc+9KQ1K4=" crossorigin="anonymous"></script>
+
+<!-- pkgdown -->
+<link href="../pkgdown.css" rel="stylesheet">
+<script src="../pkgdown.js"></script>
+
+
+
+
+<meta property="og:title" content="expand color matrix — expand.colmat" />
+<meta property="og:description" content="Add entries with fill.col to reach length colors in
+color matrix." />
+
+
+
+
+<!-- mathjax -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js" integrity="sha256-nvJJv9wWKEm88qvoQl9ekL2J+k/RWIsaSScxxlsrv8k=" crossorigin="anonymous"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/config/TeX-AMS-MML_HTMLorMML.js" integrity="sha256-84DKXVJXs0/F8OTMzX4UR909+jtl4G7SPypPavF+GfA=" crossorigin="anonymous"></script>
+
+<!--[if lt IE 9]>
+<script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
+<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
+<![endif]-->
+
+
+
+ </head>
+
+ <body data-spy="scroll" data-target="#toc">
+ <div class="container template-reference-topic">
+ <header>
+ <div class="navbar navbar-default navbar-fixed-top" role="navigation">
+ <div class="container">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <span class="navbar-brand">
+ <a class="navbar-link" href="../index.html">clusterLUTs</a>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
+ </span>
+ </div>
+
+ <div id="navbar" class="navbar-collapse collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="../index.html">
+ <span class="fas fa fas fa-home fa-lg"></span>
+
+ </a>
+</li>
+<li>
+ <a href="../reference/index.html">Reference</a>
+</li>
+ </ul>
+ <ul class="nav navbar-nav navbar-right">
+
+ </ul>
+
+ </div><!--/.nav-collapse -->
+ </div><!--/.container -->
+</div><!--/.navbar -->
+
+
+
+ </header>
+
+<div class="row">
+ <div class="col-md-9 contents">
+ <div class="page-header">
+ <h1>expand color matrix</h1>
+
+ <div class="hidden name"><code>expand.colmat.Rd</code></div>
+ </div>
+
+ <div class="ref-description">
+ <p>Add entries with <code>fill.col</code> to reach <code>length</code> colors in
+color matrix.</p>
+ </div>
+
+ <pre class="usage"><span class='fu'>expand.colmat</span>(<span class='no'>cm</span>, <span class='kw'>length</span> <span class='kw'>=</span> <span class='fl'>256</span>, <span class='kw'>fill.col</span> <span class='kw'>=</span> <span class='st'>"#000000"</span>, <span class='no'>...</span>)</pre>
+
+ <h2 class="hasAnchor" id="arguments"><a class="anchor" href="#arguments"></a>Arguments</h2>
+ <table class="ref-arguments">
+ <colgroup><col class="name" /><col class="desc" /></colgroup>
+ <tr>
+ <th>cm</th>
+ <td><p>color matrix (or valid input to <code><a href='https://rdrr.io/r/grDevices/col2rgb.html'>col2rgb</a></code>)</p></td>
+ </tr>
+ <tr>
+ <th>length</th>
+ <td><p>desired number of color entries</p></td>
+ </tr>
+ <tr>
+ <th>fill.col</th>
+ <td><p>color to fill matrix with ('black')</p></td>
+ </tr>
+ <tr>
+ <th>...</th>
+ <td><p>ignored</p></td>
+ </tr>
+ </table>
+
+ <h2 class="hasAnchor" id="value"><a class="anchor" href="#value"></a>Value</h2>
+
+ <p>expanded color matrix</p>
+ <h2 class="hasAnchor" id="details"><a class="anchor" href="#details"></a>Details</h2>
+
+ <p>Should <code>cm</code> have more entries than specified by <code>length</code>,
+the input martix is returned unchanged</p>
+
+ </div>
+ <div class="col-md-3 hidden-xs hidden-sm" id="pkgdown-sidebar">
+ <nav id="toc" data-toggle="toc" class="sticky-top">
+ <h2 data-toc-skip>Contents</h2>
+ </nav>
+ </div>
+</div>
+
+
+ <footer>
+ <div class="copyright">
+ <p>Developed by Benno Pütz.</p>
+</div>
+
+<div class="pkgdown">
+ <p>Site built with <a href="https://pkgdown.r-lib.org/">pkgdown</a> 1.5.1.</p>
+</div>
+
+ </footer>
+ </div>
+
+
+
+
+ </body>
+</html>
+
+
diff --git a/docs/reference/grapes-and-grapes.html b/docs/reference/grapes-and-grapes.html
index 9ad25ff..f5f8a5f 100644
--- a/docs/reference/grapes-and-grapes.html
+++ b/docs/reference/grapes-and-grapes.html
@@ -72,7 +72,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/hri.plot-1.png b/docs/reference/hri.plot-1.png
new file mode 100644
index 0000000000000000000000000000000000000000..dcd1fc1da95f324fe522571fbc059fe4f09bb709
GIT binary patch
literal 44795
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
UoV~Ld7#J8lUHx3vIVCg!09<D$?f?J)
literal 0
HcmV?d00001
diff --git a/docs/reference/hri.plot-2.png b/docs/reference/hri.plot-2.png
new file mode 100644
index 0000000000000000000000000000000000000000..b897ac96ca9a88c1c774646345a8bb35c5c3b85a
GIT binary patch
literal 60813
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
beTWbL$>oy5k+PV9fq}u()z4*}Q$iB}J_^Mq
literal 0
HcmV?d00001
diff --git a/docs/reference/hri.plot.html b/docs/reference/hri.plot.html
new file mode 100644
index 0000000..1562140
--- /dev/null
+++ b/docs/reference/hri.plot.html
@@ -0,0 +1,183 @@
+<!-- Generated by pkgdown: do not edit by hand -->
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+<title>hue range init plot — hri.plot • clusterLUTs</title>
+
+
+<!-- jquery -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.min.js" integrity="sha256-CSXorXvZcTkaix6Yvo6HppcZGetbYMGWSFlBw8HfCJo=" crossorigin="anonymous"></script>
+<!-- Bootstrap -->
+
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/css/bootstrap.min.css" integrity="sha256-bZLfwXAP04zRMK2BjiO8iu9pf4FbLqX6zitd+tIvLhE=" crossorigin="anonymous" />
+
+<script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/js/bootstrap.min.js" integrity="sha256-nuL8/2cJ5NDSSwnKD8VqreErSWHtnEP9E7AySL+1ev4=" crossorigin="anonymous"></script>
+
+<!-- bootstrap-toc -->
+<link rel="stylesheet" href="../bootstrap-toc.css">
+<script src="../bootstrap-toc.js"></script>
+
+<!-- Font Awesome icons -->
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/all.min.css" integrity="sha256-mmgLkCYLUQbXn0B1SRqzHar6dCnv9oZFPEC1g1cwlkk=" crossorigin="anonymous" />
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/v4-shims.min.css" integrity="sha256-wZjR52fzng1pJHwx4aV2AO3yyTOXrcDW7jBpJtTwVxw=" crossorigin="anonymous" />
+
+<!-- clipboard.js -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.6/clipboard.min.js" integrity="sha256-inc5kl9MA1hkeYUt+EC3BhlIgyp/2jDIyBLS6k3UxPI=" crossorigin="anonymous"></script>
+
+<!-- headroom.js -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/headroom.min.js" integrity="sha256-AsUX4SJE1+yuDu5+mAVzJbuYNPHj/WroHuZ8Ir/CkE0=" crossorigin="anonymous"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/jQuery.headroom.min.js" integrity="sha256-ZX/yNShbjqsohH1k95liqY9Gd8uOiE1S4vZc+9KQ1K4=" crossorigin="anonymous"></script>
+
+<!-- pkgdown -->
+<link href="../pkgdown.css" rel="stylesheet">
+<script src="../pkgdown.js"></script>
+
+
+
+
+<meta property="og:title" content="hue range init plot — hri.plot" />
+<meta property="og:description" content="for internal testing" />
+
+
+
+
+<!-- mathjax -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js" integrity="sha256-nvJJv9wWKEm88qvoQl9ekL2J+k/RWIsaSScxxlsrv8k=" crossorigin="anonymous"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/config/TeX-AMS-MML_HTMLorMML.js" integrity="sha256-84DKXVJXs0/F8OTMzX4UR909+jtl4G7SPypPavF+GfA=" crossorigin="anonymous"></script>
+
+<!--[if lt IE 9]>
+<script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
+<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
+<![endif]-->
+
+
+
+ </head>
+
+ <body data-spy="scroll" data-target="#toc">
+ <div class="container template-reference-topic">
+ <header>
+ <div class="navbar navbar-default navbar-fixed-top" role="navigation">
+ <div class="container">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <span class="navbar-brand">
+ <a class="navbar-link" href="../index.html">clusterLUTs</a>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
+ </span>
+ </div>
+
+ <div id="navbar" class="navbar-collapse collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="../index.html">
+ <span class="fas fa fas fa-home fa-lg"></span>
+
+ </a>
+</li>
+<li>
+ <a href="../reference/index.html">Reference</a>
+</li>
+ </ul>
+ <ul class="nav navbar-nav navbar-right">
+
+ </ul>
+
+ </div><!--/.nav-collapse -->
+ </div><!--/.container -->
+</div><!--/.navbar -->
+
+
+
+ </header>
+
+<div class="row">
+ <div class="col-md-9 contents">
+ <div class="page-header">
+ <h1>hue range init plot</h1>
+
+ <div class="hidden name"><code>hri.plot.Rd</code></div>
+ </div>
+
+ <div class="ref-description">
+ <p>for internal testing</p>
+ </div>
+
+ <pre class="usage"><span class='fu'>hri.plot</span>(<span class='no'>hues</span>, <span class='kw'>y</span> <span class='kw'>=</span> <span class='fl'>0.5</span>, <span class='kw'>yoff</span> <span class='kw'>=</span> <span class='fl'>0.1</span>, <span class='kw'>add</span> <span class='kw'>=</span> <span class='fl'>FALSE</span>, <span class='kw'>limits</span> <span class='kw'>=</span> <span class='kw'>NULL</span>, <span class='no'>...</span>)</pre>
+
+ <h2 class="hasAnchor" id="arguments"><a class="anchor" href="#arguments"></a>Arguments</h2>
+ <table class="ref-arguments">
+ <colgroup><col class="name" /><col class="desc" /></colgroup>
+ <tr>
+ <th>hues</th>
+ <td><p>hue seeds, passed to <code><a href='hue.range.init.html'>hue.range.init</a></code></p></td>
+ </tr>
+ <tr>
+ <th>y</th>
+ <td><p>y-level to show hue range line on (0..1)</p></td>
+ </tr>
+ <tr>
+ <th>yoff</th>
+ <td><p>y-offset for start/end markers</p></td>
+ </tr>
+ <tr>
+ <th>add</th>
+ <td><p>add to existing plot?</p></td>
+ </tr>
+ <tr>
+ <th>limits</th>
+ <td><p>passed to <code><a href='hue.range.init.html'>hue.range.init</a></code></p></td>
+ </tr>
+ <tr>
+ <th>...</th>
+ <td><p>passed to <code><a href='hue.range.init.html'>hue.range.init</a></code> (<code>limits</code>, <code>symmetric</code>)</p></td>
+ </tr>
+ </table>
+
+ <h2 class="hasAnchor" id="value"><a class="anchor" href="#value"></a>Value</h2>
+
+ <p>new hue range (invisibly)</p>
+ <h2 class="hasAnchor" id="details"><a class="anchor" href="#details"></a>Details</h2>
+
+ <p>Show hue ranges created by <code><a href='hue.range.init.html'>hue.range.init</a></code>.</p>
+
+ <h2 class="hasAnchor" id="examples"><a class="anchor" href="#examples"></a>Examples</h2>
+ <pre class="examples"><div class='input'><span class='kw pkg'>clusterLUTs</span><span class='kw ns'>:::</span><span class='fu'>hri.plot</span>(<span class='fl'>1</span>:<span class='fl'>5</span>/<span class='fl'>6</span>)</div><div class='img'><img src='hri.plot-1.png' alt='' width='700' height='433' /></div><div class='input'><span class='no'>hues</span> <span class='kw'><-</span> <span class='fu'><a href='https://rdrr.io/r/base/c.html'>c</a></span>(<span class='fl'>.2</span>, <span class='fl'>.4</span>, <span class='fl'>.7</span>, <span class='fl'>5</span>/<span class='fl'>6</span>)
+<span class='kw pkg'>clusterLUTs</span><span class='kw ns'>:::</span><span class='fu'>hri.plot</span>(<span class='no'>hues</span>, <span class='kw'>yo</span> <span class='kw'>=</span> <span class='fl'>0.05</span>, <span class='kw'>y</span> <span class='kw'>=</span> <span class='fl'>0.1</span>)</div><div class='input'><span class='kw pkg'>clusterLUTs</span><span class='kw ns'>:::</span><span class='fu'>hri.plot</span>(<span class='no'>hues</span>, <span class='kw'>symm</span> <span class='kw'>=</span> <span class='fl'>TRUE</span>, <span class='kw'>yo</span> <span class='kw'>=</span> <span class='fl'>0.05</span>, <span class='kw'>y</span> <span class='kw'>=</span> <span class='fl'>0.3</span>, <span class='kw'>add</span> <span class='kw'>=</span> <span class='fl'>TRUE</span>)</div><div class='input'><span class='kw pkg'>clusterLUTs</span><span class='kw ns'>:::</span><span class='fu'>hri.plot</span>(<span class='no'>hues</span>, <span class='kw'>limits</span> <span class='kw'>=</span> <span class='fu'><a href='https://rdrr.io/r/base/c.html'>c</a></span>(<span class='fl'>.3</span>, <span class='fl'>.8</span>), <span class='kw'>yo</span> <span class='kw'>=</span> <span class='fl'>0.05</span>, <span class='kw'>y</span> <span class='kw'>=</span> <span class='fl'>0.5</span>, <span class='kw'>add</span> <span class='kw'>=</span> <span class='fl'>TRUE</span>)</div><div class='input'><span class='kw pkg'>clusterLUTs</span><span class='kw ns'>:::</span><span class='fu'>hri.plot</span>(<span class='no'>hues</span>, <span class='kw'>limits</span> <span class='kw'>=</span> <span class='fu'><a href='https://rdrr.io/r/base/c.html'>c</a></span>(<span class='fl'>.3</span>, <span class='fl'>.8</span>), <span class='kw'>symm</span> <span class='kw'>=</span> <span class='fl'>TRUE</span>, <span class='kw'>yo</span> <span class='kw'>=</span> <span class='fl'>0.05</span>, <span class='kw'>y</span> <span class='kw'>=</span> <span class='fl'>0.7</span>, <span class='kw'>add</span> <span class='kw'>=</span> <span class='fl'>TRUE</span>)</div><div class='img'><img src='hri.plot-2.png' alt='' width='700' height='433' /></div></pre>
+ </div>
+ <div class="col-md-3 hidden-xs hidden-sm" id="pkgdown-sidebar">
+ <nav id="toc" data-toggle="toc" class="sticky-top">
+ <h2 data-toc-skip>Contents</h2>
+ </nav>
+ </div>
+</div>
+
+
+ <footer>
+ <div class="copyright">
+ <p>Developed by Benno Pütz.</p>
+</div>
+
+<div class="pkgdown">
+ <p>Site built with <a href="https://pkgdown.r-lib.org/">pkgdown</a> 1.5.1.</p>
+</div>
+
+ </footer>
+ </div>
+
+
+
+
+ </body>
+</html>
+
+
diff --git a/docs/reference/hue.range.colors.html b/docs/reference/hue.range.colors.html
index fac0810..f984428 100644
--- a/docs/reference/hue.range.colors.html
+++ b/docs/reference/hue.range.colors.html
@@ -74,7 +74,7 @@ the whole matrix is divided by 255." />
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/hue.range.init.html b/docs/reference/hue.range.init.html
new file mode 100644
index 0000000..bdd1158
--- /dev/null
+++ b/docs/reference/hue.range.init.html
@@ -0,0 +1,184 @@
+<!-- Generated by pkgdown: do not edit by hand -->
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+<title>hue range initialization — hue.range.init • clusterLUTs</title>
+
+
+<!-- jquery -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.min.js" integrity="sha256-CSXorXvZcTkaix6Yvo6HppcZGetbYMGWSFlBw8HfCJo=" crossorigin="anonymous"></script>
+<!-- Bootstrap -->
+
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/css/bootstrap.min.css" integrity="sha256-bZLfwXAP04zRMK2BjiO8iu9pf4FbLqX6zitd+tIvLhE=" crossorigin="anonymous" />
+
+<script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/js/bootstrap.min.js" integrity="sha256-nuL8/2cJ5NDSSwnKD8VqreErSWHtnEP9E7AySL+1ev4=" crossorigin="anonymous"></script>
+
+<!-- bootstrap-toc -->
+<link rel="stylesheet" href="../bootstrap-toc.css">
+<script src="../bootstrap-toc.js"></script>
+
+<!-- Font Awesome icons -->
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/all.min.css" integrity="sha256-mmgLkCYLUQbXn0B1SRqzHar6dCnv9oZFPEC1g1cwlkk=" crossorigin="anonymous" />
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/v4-shims.min.css" integrity="sha256-wZjR52fzng1pJHwx4aV2AO3yyTOXrcDW7jBpJtTwVxw=" crossorigin="anonymous" />
+
+<!-- clipboard.js -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.6/clipboard.min.js" integrity="sha256-inc5kl9MA1hkeYUt+EC3BhlIgyp/2jDIyBLS6k3UxPI=" crossorigin="anonymous"></script>
+
+<!-- headroom.js -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/headroom.min.js" integrity="sha256-AsUX4SJE1+yuDu5+mAVzJbuYNPHj/WroHuZ8Ir/CkE0=" crossorigin="anonymous"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/jQuery.headroom.min.js" integrity="sha256-ZX/yNShbjqsohH1k95liqY9Gd8uOiE1S4vZc+9KQ1K4=" crossorigin="anonymous"></script>
+
+<!-- pkgdown -->
+<link href="../pkgdown.css" rel="stylesheet">
+<script src="../pkgdown.js"></script>
+
+
+
+
+<meta property="og:title" content="hue range initialization — hue.range.init" />
+<meta property="og:description" content="Initialize a hue range "seeded" by hues. It is attempted to
+allocate the range given by limits sparing a fraction of
+blank for the breaks. If symmetric is set, the hue
+ranges are centered around the seed values (except when at the
+limits) leaving more of the hue space unallocated." />
+
+
+
+
+<!-- mathjax -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js" integrity="sha256-nvJJv9wWKEm88qvoQl9ekL2J+k/RWIsaSScxxlsrv8k=" crossorigin="anonymous"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/config/TeX-AMS-MML_HTMLorMML.js" integrity="sha256-84DKXVJXs0/F8OTMzX4UR909+jtl4G7SPypPavF+GfA=" crossorigin="anonymous"></script>
+
+<!--[if lt IE 9]>
+<script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
+<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
+<![endif]-->
+
+
+
+ </head>
+
+ <body data-spy="scroll" data-target="#toc">
+ <div class="container template-reference-topic">
+ <header>
+ <div class="navbar navbar-default navbar-fixed-top" role="navigation">
+ <div class="container">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <span class="navbar-brand">
+ <a class="navbar-link" href="../index.html">clusterLUTs</a>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
+ </span>
+ </div>
+
+ <div id="navbar" class="navbar-collapse collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="../index.html">
+ <span class="fas fa fas fa-home fa-lg"></span>
+
+ </a>
+</li>
+<li>
+ <a href="../reference/index.html">Reference</a>
+</li>
+ </ul>
+ <ul class="nav navbar-nav navbar-right">
+
+ </ul>
+
+ </div><!--/.nav-collapse -->
+ </div><!--/.container -->
+</div><!--/.navbar -->
+
+
+
+ </header>
+
+<div class="row">
+ <div class="col-md-9 contents">
+ <div class="page-header">
+ <h1>hue range initialization</h1>
+
+ <div class="hidden name"><code>hue.range.init.Rd</code></div>
+ </div>
+
+ <div class="ref-description">
+ <p>Initialize a hue range "seeded" by <code>hues</code>. It is attempted to
+allocate the range given by <code>limits</code> sparing a fraction of
+<code>blank</code> for the breaks. If <code>symmetric</code> is set, the hue
+ranges are centered around the seed values (except when at the
+limits) leaving more of the hue space unallocated.</p>
+ </div>
+
+ <pre class="usage"><span class='fu'>hue.range.init</span>(<span class='kw'>hues</span> <span class='kw'>=</span> <span class='fl'>5</span>/<span class='fl'>12</span>, <span class='kw'>blank</span> <span class='kw'>=</span> <span class='fl'>0.1</span>, <span class='kw'>limits</span> <span class='kw'>=</span> <span class='kw'>NULL</span>, <span class='kw'>symmetric</span> <span class='kw'>=</span> <span class='fl'>FALSE</span>, <span class='no'>...</span>)</pre>
+
+ <h2 class="hasAnchor" id="arguments"><a class="anchor" href="#arguments"></a>Arguments</h2>
+ <table class="ref-arguments">
+ <colgroup><col class="name" /><col class="desc" /></colgroup>
+ <tr>
+ <th>hues</th>
+ <td><p>initial "centers"</p></td>
+ </tr>
+ <tr>
+ <th>blank</th>
+ <td><p>fraction of full range (given by <code>limits</code>) not to assign</p></td>
+ </tr>
+ <tr>
+ <th>limits</th>
+ <td><p>define full range of available hues</p></td>
+ </tr>
+ <tr>
+ <th>symmetric</th>
+ <td><p>range symmetric around <code>hues</code> (where possible)</p></td>
+ </tr>
+ <tr>
+ <th>...</th>
+ <td><p>ignored</p></td>
+ </tr>
+ </table>
+
+ <h2 class="hasAnchor" id="value"><a class="anchor" href="#value"></a>Value</h2>
+
+ <p>new hue range</p>
+ <h2 class="hasAnchor" id="details"><a class="anchor" href="#details"></a>Details</h2>
+
+ <p>The values in <code>hues</code> are trimmed to [0..1] and duplicates are removed.</p>
+
+ </div>
+ <div class="col-md-3 hidden-xs hidden-sm" id="pkgdown-sidebar">
+ <nav id="toc" data-toggle="toc" class="sticky-top">
+ <h2 data-toc-skip>Contents</h2>
+ </nav>
+ </div>
+</div>
+
+
+ <footer>
+ <div class="copyright">
+ <p>Developed by Benno Pütz.</p>
+</div>
+
+<div class="pkgdown">
+ <p>Site built with <a href="https://pkgdown.r-lib.org/">pkgdown</a> 1.5.1.</p>
+</div>
+
+ </footer>
+ </div>
+
+
+
+
+ </body>
+</html>
+
+
diff --git a/docs/reference/hue.range.lines.html b/docs/reference/hue.range.lines.html
index 14bf705..bdc79b1 100644
--- a/docs/reference/hue.range.lines.html
+++ b/docs/reference/hue.range.lines.html
@@ -72,7 +72,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/hue.range.split.html b/docs/reference/hue.range.split.html
index 77077bf..e87e50e 100644
--- a/docs/reference/hue.range.split.html
+++ b/docs/reference/hue.range.split.html
@@ -73,7 +73,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
@@ -114,7 +114,7 @@
2-element vector or a \(2xN\) matrix where each column defines such a range.</p>
</div>
- <pre class="usage"><span class='fu'>hue.range.split</span>(<span class='no'>hue.range</span>, <span class='no'>split.tbl</span>, <span class='kw'>blank</span> <span class='kw'>=</span> <span class='fl'>0.1</span>)</pre>
+ <pre class="usage"><span class='fu'>hue.range.split</span>(<span class='no'>hue.range</span>, <span class='no'>split.tbl</span>, <span class='kw'>blank</span> <span class='kw'>=</span> <span class='fl'>0.1</span>, <span class='no'>...</span>)</pre>
<h2 class="hasAnchor" id="arguments"><a class="anchor" href="#arguments"></a>Arguments</h2>
<table class="ref-arguments">
@@ -133,6 +133,10 @@ vectors applied to corresponding matrix colunm)</p></td>
<th>blank</th>
<td><p>which fraction of the range should be left blank</p></td>
</tr>
+ <tr>
+ <th>...</th>
+ <td><p>ignored</p></td>
+ </tr>
</table>
<h2 class="hasAnchor" id="value"><a class="anchor" href="#value"></a>Value</h2>
diff --git a/docs/reference/index.html b/docs/reference/index.html
index 64e38c2..6f43569 100644
--- a/docs/reference/index.html
+++ b/docs/reference/index.html
@@ -71,7 +71,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
@@ -145,6 +145,12 @@
<td><p>color repetition</p></td>
</tr><tr>
+ <td>
+ <p><code><a href="colmat2lutfile.html">colmat2lutfile()</a></code> </p>
+ </td>
+ <td><p>Write color matrix to LUT file</p></td>
+ </tr><tr>
+
<td>
<p><code><a href="color.shades.html">color.shades()</a></code> </p>
</td>
@@ -163,6 +169,12 @@
<td><p>prepare shades and reorder to match cut</p></td>
</tr><tr>
+ <td>
+ <p><code><a href="default.cuts.html">default.cuts()</a></code> </p>
+ </td>
+ <td><p>default cuts</p></td>
+ </tr><tr>
+
<td>
<p><code><a href="default.hcl.html">default.hcl()</a></code> </p>
</td>
@@ -193,18 +205,36 @@
<td><p>dummy tree data for examples</p></td>
</tr><tr>
+ <td>
+ <p><code><a href="expand.colmat.html">expand.colmat()</a></code> </p>
+ </td>
+ <td><p>expand color matrix</p></td>
+ </tr><tr>
+
<td>
<p><code><a href="grapes-and-grapes.html">`%&%`</a></code> </p>
</td>
<td><p>binary bitwise AND</p></td>
</tr><tr>
+ <td>
+ <p><code><a href="hri.plot.html">hri.plot()</a></code> </p>
+ </td>
+ <td><p>hue range init plot</p></td>
+ </tr><tr>
+
<td>
<p><code><a href="hue.range.colors.html">hue.range.colors()</a></code> </p>
</td>
<td><p>convert hue range matrix to corresponding colors</p></td>
</tr><tr>
+ <td>
+ <p><code><a href="hue.range.init.html">hue.range.init()</a></code> </p>
+ </td>
+ <td><p>hue range initialization</p></td>
+ </tr><tr>
+
<td>
<p><code><a href="hue.range.lines.html">hue.range.lines()</a></code> </p>
</td>
@@ -313,6 +343,12 @@
<td><p>show sub tables</p></td>
</tr><tr>
+ <td>
+ <p><code><a href="subtables.html">subtables()</a></code> </p>
+ </td>
+ <td><p>subtables</p></td>
+ </tr><tr>
+
<td>
<p><code><a href="tbl2mat.html">tbl2mat()</a></code> </p>
</td>
diff --git a/docs/reference/init.blank.plot.html b/docs/reference/init.blank.plot.html
index d42e3bc..6ca3b50 100644
--- a/docs/reference/init.blank.plot.html
+++ b/docs/reference/init.blank.plot.html
@@ -72,7 +72,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/init.huerange.plot.html b/docs/reference/init.huerange.plot.html
index 3e87ca4..b5cabd1 100644
--- a/docs/reference/init.huerange.plot.html
+++ b/docs/reference/init.huerange.plot.html
@@ -72,7 +72,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/mat2list.html b/docs/reference/mat2list.html
index f806820..6dcfae1 100644
--- a/docs/reference/mat2list.html
+++ b/docs/reference/mat2list.html
@@ -73,7 +73,7 @@ or row vectors (which == 1)." />
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/rainbow_lab.html b/docs/reference/rainbow_lab.html
index 4b718a2..12a9c4a 100644
--- a/docs/reference/rainbow_lab.html
+++ b/docs/reference/rainbow_lab.html
@@ -72,7 +72,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/rainbow_lab_ramp.html b/docs/reference/rainbow_lab_ramp.html
index f7057b2..a8383c6 100644
--- a/docs/reference/rainbow_lab_ramp.html
+++ b/docs/reference/rainbow_lab_ramp.html
@@ -73,7 +73,7 @@ between neighboring colors." />
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/randomize.cutree.html b/docs/reference/randomize.cutree.html
index edb603a..3b4a986 100644
--- a/docs/reference/randomize.cutree.html
+++ b/docs/reference/randomize.cutree.html
@@ -75,7 +75,7 @@ Matlab counterpart (or what read.tree produces of it)." />
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/read.tree.html b/docs/reference/read.tree.html
index 8188519..5cf4940 100644
--- a/docs/reference/read.tree.html
+++ b/docs/reference/read.tree.html
@@ -75,7 +75,7 @@ entries)" />
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/readlut.html b/docs/reference/readlut.html
index 43b6dd8..e22c262 100644
--- a/docs/reference/readlut.html
+++ b/docs/reference/readlut.html
@@ -73,7 +73,7 @@ return a color matrix with columns corresponding to the color entries (RGB)." />
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/reidx.cut.html b/docs/reference/reidx.cut.html
index 147cde7..2be6ae7 100644
--- a/docs/reference/reidx.cut.html
+++ b/docs/reference/reidx.cut.html
@@ -73,7 +73,7 @@ can be preserved" />
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/show.brain.lut.html b/docs/reference/show.brain.lut.html
index 680360c..e3fdacd 100644
--- a/docs/reference/show.brain.lut.html
+++ b/docs/reference/show.brain.lut.html
@@ -72,7 +72,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
@@ -114,6 +114,7 @@
<pre class="usage"><span class='fu'>show.brain.lut</span>(
<span class='no'>n</span>,
+ <span class='no'>LUTdir</span>,
<span class='kw'>lut</span> <span class='kw'>=</span> <span class='kw'>NULL</span>,
<span class='kw'>clusters</span> <span class='kw'>=</span> <span class='fu'><a href='read.tree.html'>read.tree</a></span>(),
<span class='kw'>verbose</span> <span class='kw'>=</span> <span class='fu'><a href='https://rdrr.io/r/base/options.html'>getOption</a></span>(<span class='st'>"verbose"</span>),
@@ -128,6 +129,10 @@
<th>n</th>
<td><p>number of cuts the table should have</p></td>
</tr>
+ <tr>
+ <th>LUTdir</th>
+ <td><p>directory where to look for LUT files</p></td>
+ </tr>
<tr>
<th>lut</th>
<td><p>alternative LUT, see description</p></td>
@@ -166,7 +171,7 @@ matrix (3 rows or columns) or a complete file path</p>
<h2 class="hasAnchor" id="examples"><a class="anchor" href="#examples"></a>Examples</h2>
<pre class="examples"><div class='input'><span class='kw'>if</span> (<span class='fl'>FALSE</span>) {
- <span class='fu'>show.brain.lut</span>(<span class='fl'>10</span>)
+ <span class='fu'>show.brain.lut</span>(<span class='fl'>10</span>, <span class='st'>'luts'</span>)
}</div></pre>
</div>
<div class="col-md-3 hidden-xs hidden-sm" id="pkgdown-sidebar">
diff --git a/docs/reference/show.colmat.html b/docs/reference/show.colmat.html
index 7e0dce0..64ecf05 100644
--- a/docs/reference/show.colmat.html
+++ b/docs/reference/show.colmat.html
@@ -72,7 +72,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/show.cut.html b/docs/reference/show.cut.html
index a364b16..bb0a84d 100644
--- a/docs/reference/show.cut.html
+++ b/docs/reference/show.cut.html
@@ -72,7 +72,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/show.hue.range.html b/docs/reference/show.hue.range.html
index 0c11da2..e91fba6 100644
--- a/docs/reference/show.hue.range.html
+++ b/docs/reference/show.hue.range.html
@@ -73,7 +73,7 @@ shows the unordered colors of one in a single row of rectangles." />
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
@@ -155,6 +155,10 @@ shows the unordered colors of one in a single row of rectangles.</p>
<th>v.scale</th>
<td><p>relative vertical scaling to adjust rectangles' height</p></td>
</tr>
+ <tr>
+ <th>show.idx</th>
+ <td><p>add index (if boolean) or specified values (if char, numeric)</p></td>
+ </tr>
<tr>
<th>...</th>
<td><p>ignored</p></td>
diff --git a/docs/reference/show.lut.html b/docs/reference/show.lut.html
index b67e8bd..1c2110d 100644
--- a/docs/reference/show.lut.html
+++ b/docs/reference/show.lut.html
@@ -72,7 +72,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/show.shades.html b/docs/reference/show.shades.html
index 59cde08..5a81234 100644
--- a/docs/reference/show.shades.html
+++ b/docs/reference/show.shades.html
@@ -73,7 +73,7 @@ the number of shades for each main color (and, thus, the number of main colors.)
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/show.sub.tables.html b/docs/reference/show.sub.tables.html
index 2aea067..4f26d86 100644
--- a/docs/reference/show.sub.tables.html
+++ b/docs/reference/show.sub.tables.html
@@ -74,7 +74,7 @@ They are used to trace clustering trees." />
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/subtables.html b/docs/reference/subtables.html
new file mode 100644
index 0000000..e83e81a
--- /dev/null
+++ b/docs/reference/subtables.html
@@ -0,0 +1,221 @@
+<!-- Generated by pkgdown: do not edit by hand -->
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+<title>subtables — subtables • clusterLUTs</title>
+
+
+<!-- jquery -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.min.js" integrity="sha256-CSXorXvZcTkaix6Yvo6HppcZGetbYMGWSFlBw8HfCJo=" crossorigin="anonymous"></script>
+<!-- Bootstrap -->
+
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/css/bootstrap.min.css" integrity="sha256-bZLfwXAP04zRMK2BjiO8iu9pf4FbLqX6zitd+tIvLhE=" crossorigin="anonymous" />
+
+<script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/js/bootstrap.min.js" integrity="sha256-nuL8/2cJ5NDSSwnKD8VqreErSWHtnEP9E7AySL+1ev4=" crossorigin="anonymous"></script>
+
+<!-- bootstrap-toc -->
+<link rel="stylesheet" href="../bootstrap-toc.css">
+<script src="../bootstrap-toc.js"></script>
+
+<!-- Font Awesome icons -->
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/all.min.css" integrity="sha256-mmgLkCYLUQbXn0B1SRqzHar6dCnv9oZFPEC1g1cwlkk=" crossorigin="anonymous" />
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/v4-shims.min.css" integrity="sha256-wZjR52fzng1pJHwx4aV2AO3yyTOXrcDW7jBpJtTwVxw=" crossorigin="anonymous" />
+
+<!-- clipboard.js -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.6/clipboard.min.js" integrity="sha256-inc5kl9MA1hkeYUt+EC3BhlIgyp/2jDIyBLS6k3UxPI=" crossorigin="anonymous"></script>
+
+<!-- headroom.js -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/headroom.min.js" integrity="sha256-AsUX4SJE1+yuDu5+mAVzJbuYNPHj/WroHuZ8Ir/CkE0=" crossorigin="anonymous"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/jQuery.headroom.min.js" integrity="sha256-ZX/yNShbjqsohH1k95liqY9Gd8uOiE1S4vZc+9KQ1K4=" crossorigin="anonymous"></script>
+
+<!-- pkgdown -->
+<link href="../pkgdown.css" rel="stylesheet">
+<script src="../pkgdown.js"></script>
+
+
+
+
+<meta property="og:title" content="subtables — subtables" />
+<meta property="og:description" content="accessor function to 'sub.tables' attribute of tree.ranges." />
+
+
+
+
+<!-- mathjax -->
+<script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js" integrity="sha256-nvJJv9wWKEm88qvoQl9ekL2J+k/RWIsaSScxxlsrv8k=" crossorigin="anonymous"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/config/TeX-AMS-MML_HTMLorMML.js" integrity="sha256-84DKXVJXs0/F8OTMzX4UR909+jtl4G7SPypPavF+GfA=" crossorigin="anonymous"></script>
+
+<!--[if lt IE 9]>
+<script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
+<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
+<![endif]-->
+
+
+
+ </head>
+
+ <body data-spy="scroll" data-target="#toc">
+ <div class="container template-reference-topic">
+ <header>
+ <div class="navbar navbar-default navbar-fixed-top" role="navigation">
+ <div class="container">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <span class="navbar-brand">
+ <a class="navbar-link" href="../index.html">clusterLUTs</a>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
+ </span>
+ </div>
+
+ <div id="navbar" class="navbar-collapse collapse">
+ <ul class="nav navbar-nav">
+ <li>
+ <a href="../index.html">
+ <span class="fas fa fas fa-home fa-lg"></span>
+
+ </a>
+</li>
+<li>
+ <a href="../reference/index.html">Reference</a>
+</li>
+ </ul>
+ <ul class="nav navbar-nav navbar-right">
+
+ </ul>
+
+ </div><!--/.nav-collapse -->
+ </div><!--/.container -->
+</div><!--/.navbar -->
+
+
+
+ </header>
+
+<div class="row">
+ <div class="col-md-9 contents">
+ <div class="page-header">
+ <h1>subtables</h1>
+
+ <div class="hidden name"><code>subtables.Rd</code></div>
+ </div>
+
+ <div class="ref-description">
+ <p>accessor function to 'sub.tables' attribute of <code>tree.ranges</code>.</p>
+ </div>
+
+ <pre class="usage"><span class='fu'>subtables</span>(<span class='no'>tr</span>, <span class='no'>...</span>)</pre>
+
+ <h2 class="hasAnchor" id="arguments"><a class="anchor" href="#arguments"></a>Arguments</h2>
+ <table class="ref-arguments">
+ <colgroup><col class="name" /><col class="desc" /></colgroup>
+ <tr>
+ <th>tr</th>
+ <td><p>arbitrary object</p></td>
+ </tr>
+ <tr>
+ <th>...</th>
+ <td><p>ignored</p></td>
+ </tr>
+ </table>
+
+ <h2 class="hasAnchor" id="value"><a class="anchor" href="#value"></a>Value</h2>
+
+ <p>'sub.tables' attribute of <code>tr</code>, if present, failure otherwise</p>
+ <h2 class="hasAnchor" id="details"><a class="anchor" href="#details"></a>Details</h2>
+
+ <p>Return 'sub.tables' attribute of <code>tr</code>, if present, failure otherwise.</p>
+
+ <h2 class="hasAnchor" id="examples"><a class="anchor" href="#examples"></a>Examples</h2>
+ <pre class="examples"><div class='input'><span class='fu'>subtables</span>(<span class='fu'><a href='tree.ranges.html'>tree.ranges</a></span>(<span class='fu'><a href='dummy.tree.html'>dummy.tree</a></span>()))</div><div class='output co'>#> $`3`
+#> $`3`[[1]]
+#>
+#> 1 2 3
+#> 4 1 4
+#>
+#>
+#> $`6`
+#> $`6`[[1]]
+#>
+#> 1 6
+#> 3 1
+#>
+#> $`6`[[2]]
+#>
+#> 2
+#> 1
+#>
+#> $`6`[[3]]
+#>
+#> 3 4 5
+#> 1 2 1
+#>
+#>
+#> $`9`
+#> $`9`[[1]]
+#>
+#> 1 4 6
+#> 1 1 1
+#>
+#> $`9`[[2]]
+#>
+#> 2
+#> 1
+#>
+#> $`9`[[3]]
+#>
+#> 3
+#> 1
+#>
+#> $`9`[[4]]
+#>
+#> 5 9
+#> 1 1
+#>
+#> $`9`[[5]]
+#>
+#> 7
+#> 1
+#>
+#> $`9`[[6]]
+#>
+#> 8
+#> 1
+#>
+#> </div></pre>
+ </div>
+ <div class="col-md-3 hidden-xs hidden-sm" id="pkgdown-sidebar">
+ <nav id="toc" data-toggle="toc" class="sticky-top">
+ <h2 data-toc-skip>Contents</h2>
+ </nav>
+ </div>
+</div>
+
+
+ <footer>
+ <div class="copyright">
+ <p>Developed by Benno Pütz.</p>
+</div>
+
+<div class="pkgdown">
+ <p>Site built with <a href="https://pkgdown.r-lib.org/">pkgdown</a> 1.5.1.</p>
+</div>
+
+ </footer>
+ </div>
+
+
+
+
+ </body>
+</html>
+
+
diff --git a/docs/reference/tbl2mat.html b/docs/reference/tbl2mat.html
index 070bfca..bcc4295 100644
--- a/docs/reference/tbl2mat.html
+++ b/docs/reference/tbl2mat.html
@@ -72,7 +72,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/tree.ranges.html b/docs/reference/tree.ranges.html
index a3c30fb..df45d4d 100644
--- a/docs/reference/tree.ranges.html
+++ b/docs/reference/tree.ranges.html
@@ -72,7 +72,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/tree.ranges.plot.html b/docs/reference/tree.ranges.plot.html
index b17d8b1..cb34c2f 100644
--- a/docs/reference/tree.ranges.plot.html
+++ b/docs/reference/tree.ranges.plot.html
@@ -72,7 +72,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/treeluts.html b/docs/reference/treeluts.html
index 57ffc27..09e27f9 100644
--- a/docs/reference/treeluts.html
+++ b/docs/reference/treeluts.html
@@ -40,8 +40,8 @@
<meta property="og:title" content="LUT generation for hierarchical clustering tree — treeluts" />
-<meta property="og:description" content="Main function of this package.
-clusters defines the cluster assignments per cut. The number of clusters
+<meta property="og:description" content="Main function of this package: clusters defines the cluster assignments
+per cut. The number of clusters
is taken from the unique values per column (need not be regular)." />
@@ -74,7 +74,7 @@ is taken from the unique values per column (need not be regular)." />
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
@@ -111,14 +111,14 @@ is taken from the unique values per column (need not be regular)." />
</div>
<div class="ref-description">
- <p>Main function of this package.
-<code>clusters</code> defines the cluster assignments per cut. The number of clusters
+ <p>Main function of this package: <code>clusters</code> defines the cluster assignments
+per cut. The number of clusters
is taken from the unique values per column (need not be regular).</p>
</div>
<pre class="usage"><span class='fu'>treeluts</span>(
<span class='kw'>clusters</span> <span class='kw'>=</span> <span class='fu'><a href='read.tree.html'>read.tree</a></span>(),
- <span class='kw'>outdir</span> <span class='kw'>=</span> <span class='fu'>LUTdir</span>(),
+ <span class='kw'>outdir</span> <span class='kw'>=</span> <span class='st'>"luts"</span>,
<span class='kw'>basename</span> <span class='kw'>=</span> <span class='st'>"lut"</span>,
<span class='kw'>lut.length</span> <span class='kw'>=</span> <span class='fl'>256</span>,
<span class='kw'>verbose</span> <span class='kw'>=</span> <span class='fu'><a href='https://rdrr.io/r/base/options.html'>getOption</a></span>(<span class='st'>"verbose"</span>),
@@ -156,7 +156,7 @@ is taken from the unique values per column (need not be regular).</p>
<h2 class="hasAnchor" id="value"><a class="anchor" href="#value"></a>Value</h2>
- <p>a vector with the number of color entries per LUT generated</p>
+ <p>a vector with the number of color entries per LUT generated (invisibly)</p>
<h2 class="hasAnchor" id="details"><a class="anchor" href="#details"></a>Details</h2>
@@ -165,8 +165,10 @@ is taken from the unique values per column (need not be regular).</p>
<h2 class="hasAnchor" id="examples"><a class="anchor" href="#examples"></a>Examples</h2>
<pre class="examples"><div class='input'><span class='fu'><a href='https://rdrr.io/r/base/Random.html'>set.seed</a></span>(<span class='fl'>42</span>)
-<span class='fu'>treeluts</span>(<span class='fu'><a href='https://rdrr.io/r/base/cbind.html'>cbind</a></span>(<span class='fu'><a href='https://rdrr.io/r/base/sample.html'>sample</a></span>(<span class='fl'>1</span>:<span class='fl'>5</span>,<span class='fl'>20</span>,<span class='fl'>TRUE</span>),<span class='fl'>1</span>:<span class='fl'>20</span>), <span class='fu'><a href='https://rdrr.io/r/base/tempfile.html'>tempdir</a></span>(), <span class='st'>"exmpl"</span>, <span class='kw'>verbose</span><span class='kw'>=</span><span class='fl'>TRUE</span>)</div><div class='output co'>#> /var/folders/n9/yqnj10ts5yxb142bkvkym168n7typ4/T//Rtmpiqcrxm/exmpl005.lut
-#> /var/folders/n9/yqnj10ts5yxb142bkvkym168n7typ4/T//Rtmpiqcrxm/exmpl020.lut </div></pre>
+<span class='fu'>treeluts</span>(<span class='fu'><a href='https://rdrr.io/r/base/cbind.html'>cbind</a></span>(<span class='fu'><a href='https://rdrr.io/r/base/sample.html'>sample</a></span>(<span class='fl'>1</span>:<span class='fl'>5</span>,<span class='fl'>20</span>,<span class='fl'>TRUE</span>),<span class='fl'>1</span>:<span class='fl'>20</span>), <span class='fu'><a href='https://rdrr.io/r/base/tempfile.html'>tempdir</a></span>(), <span class='st'>"exmpl"</span>, <span class='kw'>verbose</span><span class='kw'>=</span><span class='fl'>TRUE</span>)</div><div class='output co'>#> /var/folders/n9/yqnj10ts5yxb142bkvkym168n7typ4/T//RtmpThyQeo/exmpl005.lut
+#> /var/folders/n9/yqnj10ts5yxb142bkvkym168n7typ4/T//RtmpThyQeo/exmpl020.lut </div><div class='input'><span class='kw'>if</span> (<span class='fl'>FALSE</span>) {
+ <span class='fu'>treeluts</span>(<span class='kw'>outdir</span> <span class='kw'>=</span> <span class='fu'><a href='https://rdrr.io/r/base/path.expand.html'>path.expand</a></span>(<span class='st'>"~/Work/4philipp/BrainLUTs/luts"</span>), <span class='kw'>verbose</span><span class='kw'>=</span><span class='fl'>TRUE</span>)
+}</div></pre>
</div>
<div class="col-md-3 hidden-xs hidden-sm" id="pkgdown-sidebar">
<nav id="toc" data-toggle="toc" class="sticky-top">
diff --git a/docs/reference/vec2hsv.html b/docs/reference/vec2hsv.html
index a1a0b3f..4acea87 100644
--- a/docs/reference/vec2hsv.html
+++ b/docs/reference/vec2hsv.html
@@ -73,7 +73,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
@@ -131,10 +131,11 @@
<h2 class="hasAnchor" id="value"><a class="anchor" href="#value"></a>Value</h2>
- <p>an RGB vector representing the color</p>
+ <p>an RGB vector (1-column color matrix) representing the color</p>
<h2 class="hasAnchor" id="details"><a class="anchor" href="#details"></a>Details</h2>
- <p>Rather than returning a hex representaion as done in <code><a href='https://rdrr.io/r/grDevices/hsv.html'>hsv</a></code>.</p>
+ <p>Rather than returning a hex representation as done in <code><a href='https://rdrr.io/r/grDevices/hsv.html'>hsv</a></code>, a
+conversion to RGB is performed before returning.</p>
<h2 class="hasAnchor" id="examples"><a class="anchor" href="#examples"></a>Examples</h2>
<pre class="examples"><div class='input'><span class='co'># convert RGB colors to HSV and back</span>
diff --git a/docs/reference/vec2rgb.html b/docs/reference/vec2rgb.html
index b99fc72..79efa52 100644
--- a/docs/reference/vec2rgb.html
+++ b/docs/reference/vec2rgb.html
@@ -73,7 +73,7 @@
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
diff --git a/docs/reference/vlevels.html b/docs/reference/vlevels.html
index 27666cb..0ccd026 100644
--- a/docs/reference/vlevels.html
+++ b/docs/reference/vlevels.html
@@ -40,7 +40,7 @@
<meta property="og:title" content="vector levels — vlevels" />
-<meta property="og:description" content="count the number of unique entries in vector (usually an index vector with
+<meta property="og:description" content="Count the number of unique entries in vector (usually an index vector with
integer elements)" />
@@ -73,7 +73,7 @@ integer elements)" />
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
@@ -110,7 +110,7 @@ integer elements)" />
</div>
<div class="ref-description">
- <p>count the number of unique entries in vector (usually an index vector with
+ <p>Count the number of unique entries in vector (usually an index vector with
integer elements)</p>
</div>
diff --git a/docs/reference/writelut.html b/docs/reference/writelut.html
index 54d6973..a08212a 100644
--- a/docs/reference/writelut.html
+++ b/docs/reference/writelut.html
@@ -73,7 +73,7 @@ Implemented with Rcpp to allow writing bytes." />
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">clusterLUTs</a>
- <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.3.5</span>
+ <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.5.0</span>
</span>
</div>
--
GitLab