From e3423ca17a7591e00b7899c2ffd304e27039098a Mon Sep 17 00:00:00 2001
From: Colin Stark <cstarknyc@gmail.com>
Date: Mon, 21 Mar 2022 17:01:53 +0900
Subject: [PATCH] Update Sphinx docs

---
 docs/modules/image.html      | 291 ++++++++++++++++++-----------------
 docs/modules/initialize.html |   2 +-
 docs/modules/parameters.html |   6 +-
 docs/modules/plot.html       |  28 +++-
 docs/modules/utils.html      |   7 +-
 docs/searchindex.js          |   2 +-
 6 files changed, 177 insertions(+), 159 deletions(-)

diff --git a/docs/modules/image.html b/docs/modules/image.html
index 7f35106..d14c4e1 100644
--- a/docs/modules/image.html
+++ b/docs/modules/image.html
@@ -74,7 +74,7 @@ <h3>Navigation</h3>
 <dl class="py method">
 <dt class="sig sig-object py" id="gmplib.image.combine_images.__init__">
 <span class="sig-name descname"><span class="pre">__init__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">out_path</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/os.html#os.PathLike" title="(in Python v3.10)"><span class="pre">os.PathLike</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">into_filename</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/os.html#os.PathLike" title="(in Python v3.10)"><span class="pre">os.PathLike</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">image_bundle</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">List</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">image_sources</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Dict</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">,</span> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">file_type</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">'jpg'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">spacing</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.10)"><span class="pre">int</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">20</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">do_align_right</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.10)"><span class="pre">bool</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span> &#x2192; <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.10)"><span class="pre">None</span></a><a class="headerlink" href="#gmplib.image.combine_images.__init__" title="Permalink to this definition">¶</a></dt>
-<dd><p>Constructor method</p>
+<dd><p>Initialize.</p>
 </dd></dl>
 
 <dl class="py method">
@@ -110,7 +110,7 @@ <h3>Navigation</h3>
 <dl class="py method">
 <dt class="sig sig-object py" id="gmplib.image.combine_images.save_combo_image">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">save_combo_image</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">out_path</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/os.html#os.PathLike" title="(in Python v3.10)"><span class="pre">os.PathLike</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">into_filename</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/os.html#os.PathLike" title="(in Python v3.10)"><span class="pre">os.PathLike</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">file_type</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a></span></em><span class="sig-paren">)</span> &#x2192; <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.10)"><span class="pre">None</span></a><a class="headerlink" href="#gmplib.image.combine_images.save_combo_image" title="Permalink to this definition">¶</a></dt>
-<dd><p>How to write combined image file (abstract method)</p>
+<dd><p>Provide a tool to write a combined image file (abstract method).</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters</dt>
 <dd class="field-odd"><ul class="simple">
@@ -127,18 +127,18 @@ <h3>Navigation</h3>
 <dl class="py class">
 <dt class="sig sig-object py" id="gmplib.image.combine_pdf_images">
 <em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">gmplib.image.</span></span><span class="sig-name descname"><span class="pre">combine_pdf_images</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">out_path</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/os.html#os.PathLike" title="(in Python v3.10)"><span class="pre">os.PathLike</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">into_filename</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/os.html#os.PathLike" title="(in Python v3.10)"><span class="pre">os.PathLike</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">image_bundle</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">List</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">image_sources</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Dict</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">,</span> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">file_type</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">'jpg'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">spacing</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.10)"><span class="pre">int</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">20</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">do_align_right</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.10)"><span class="pre">bool</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#gmplib.image.combine_pdf_images" title="Permalink to this definition">¶</a></dt>
-<dd><p>Combine PDF image files.
-Inherits from <cite>combine_images</cite>.</p>
+<dd><p>Combine PDF image files.</p>
+<p>Inherits from <cite>combine_images</cite>.</p>
 <dl class="py method">
 <dt class="sig sig-object py" id="gmplib.image.combine_pdf_images.get_images">
 <span class="sig-name descname"><span class="pre">get_images</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">image_bundle</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">List</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">image_sources</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Dict</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">,</span> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">file_type</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">spacing</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.10)"><span class="pre">float</span></a></span></em><span class="sig-paren">)</span> &#x2192; <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.10)"><span class="pre">None</span></a><a class="headerlink" href="#gmplib.image.combine_pdf_images.get_images" title="Permalink to this definition">¶</a></dt>
-<dd><p>How to read the image files.</p>
+<dd><p>Combine the image files.</p>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="gmplib.image.combine_pdf_images.save_combo_image">
 <span class="sig-name descname"><span class="pre">save_combo_image</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">out_path</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/os.html#os.PathLike" title="(in Python v3.10)"><span class="pre">os.PathLike</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">into_filename</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/os.html#os.PathLike" title="(in Python v3.10)"><span class="pre">os.PathLike</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">file_type</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a></span></em><span class="sig-paren">)</span> &#x2192; <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.10)"><span class="pre">None</span></a><a class="headerlink" href="#gmplib.image.combine_pdf_images.save_combo_image" title="Permalink to this definition">¶</a></dt>
-<dd><p>How to write the image to a file.</p>
+<dd><p>Write the image to a file.</p>
 </dd></dl>
 
 </dd></dl>
@@ -146,12 +146,12 @@ <h3>Navigation</h3>
 <dl class="py class">
 <dt class="sig sig-object py" id="gmplib.image.combine_pdf_images_horizontally">
 <em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">gmplib.image.</span></span><span class="sig-name descname"><span class="pre">combine_pdf_images_horizontally</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">out_path</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/os.html#os.PathLike" title="(in Python v3.10)"><span class="pre">os.PathLike</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">into_filename</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/os.html#os.PathLike" title="(in Python v3.10)"><span class="pre">os.PathLike</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">image_bundle</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">List</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">image_sources</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Dict</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">,</span> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">file_type</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">'jpg'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">spacing</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.10)"><span class="pre">int</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">20</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">do_align_right</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.10)"><span class="pre">bool</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#gmplib.image.combine_pdf_images_horizontally" title="Permalink to this definition">¶</a></dt>
-<dd><p>Combine PDF images in a horizontal layout.
-Inherits from <cite>combine_pdf_images</cite>.</p>
+<dd><p>Combine PDF images in a horizontal layout.</p>
+<p>Inherits from <cite>combine_pdf_images</cite>.</p>
 <dl class="py method">
 <dt class="sig sig-object py" id="gmplib.image.combine_pdf_images_horizontally.paste_images">
 <span class="sig-name descname"><span class="pre">paste_images</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">spacing</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.10)"><span class="pre">float</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">do_align_right</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.10)"><span class="pre">bool</span></a></span></em><span class="sig-paren">)</span> &#x2192; <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.10)"><span class="pre">None</span></a><a class="headerlink" href="#gmplib.image.combine_pdf_images_horizontally.paste_images" title="Permalink to this definition">¶</a></dt>
-<dd><p>How to combine the images.</p>
+<dd><p>Combine the images.</p>
 </dd></dl>
 
 </dd></dl>
@@ -159,12 +159,12 @@ <h3>Navigation</h3>
 <dl class="py class">
 <dt class="sig sig-object py" id="gmplib.image.combine_pdf_images_vertically">
 <em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">gmplib.image.</span></span><span class="sig-name descname"><span class="pre">combine_pdf_images_vertically</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">out_path</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/os.html#os.PathLike" title="(in Python v3.10)"><span class="pre">os.PathLike</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">into_filename</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/os.html#os.PathLike" title="(in Python v3.10)"><span class="pre">os.PathLike</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">image_bundle</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">List</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">image_sources</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Dict</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">,</span> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">file_type</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">'jpg'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">spacing</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.10)"><span class="pre">int</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">20</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">do_align_right</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.10)"><span class="pre">bool</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#gmplib.image.combine_pdf_images_vertically" title="Permalink to this definition">¶</a></dt>
-<dd><p>Combine PDF images in a vertical layout.
-Inherits from <cite>combine_pdf_images</cite>.</p>
+<dd><p>Combine PDF images in a vertical layout.</p>
+<p>Inherits from <cite>combine_pdf_images</cite>.</p>
 <dl class="py method">
 <dt class="sig sig-object py" id="gmplib.image.combine_pdf_images_vertically.paste_images">
 <span class="sig-name descname"><span class="pre">paste_images</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">spacing</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.10)"><span class="pre">float</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">do_align_right</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.10)"><span class="pre">bool</span></a></span></em><span class="sig-paren">)</span> &#x2192; <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.10)"><span class="pre">None</span></a><a class="headerlink" href="#gmplib.image.combine_pdf_images_vertically.paste_images" title="Permalink to this definition">¶</a></dt>
-<dd><p>How to combine the images</p>
+<dd><p>Combine the images.</p>
 </dd></dl>
 
 </dd></dl>
@@ -172,8 +172,8 @@ <h3>Navigation</h3>
 <dl class="py class">
 <dt class="sig sig-object py" id="gmplib.image.combine_raster_images">
 <em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">gmplib.image.</span></span><span class="sig-name descname"><span class="pre">combine_raster_images</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">out_path</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/os.html#os.PathLike" title="(in Python v3.10)"><span class="pre">os.PathLike</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">into_filename</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/os.html#os.PathLike" title="(in Python v3.10)"><span class="pre">os.PathLike</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">image_bundle</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">List</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">image_sources</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Dict</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">,</span> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">file_type</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">'jpg'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">spacing</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.10)"><span class="pre">int</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">20</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">do_align_right</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.10)"><span class="pre">bool</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#gmplib.image.combine_raster_images" title="Permalink to this definition">¶</a></dt>
-<dd><p>Combine raster image files.
-Inherits from <cite>combine_images</cite>.</p>
+<dd><p>Combine raster image files.</p>
+<p>Inherits from <cite>combine_images</cite>.</p>
 <dl class="py method">
 <dt class="sig sig-object py" id="gmplib.image.combine_raster_images.get_images">
 <span class="sig-name descname"><span class="pre">get_images</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">image_bundle</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">List</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">image_sources</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Dict</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">,</span> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">file_type</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">spacing</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.10)"><span class="pre">float</span></a></span></em><span class="sig-paren">)</span> &#x2192; <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.10)"><span class="pre">None</span></a><a class="headerlink" href="#gmplib.image.combine_raster_images.get_images" title="Permalink to this definition">¶</a></dt>
@@ -191,12 +191,12 @@ <h3>Navigation</h3>
 <dl class="py class">
 <dt class="sig sig-object py" id="gmplib.image.combine_raster_images_horizontally">
 <em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">gmplib.image.</span></span><span class="sig-name descname"><span class="pre">combine_raster_images_horizontally</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">out_path</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/os.html#os.PathLike" title="(in Python v3.10)"><span class="pre">os.PathLike</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">into_filename</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/os.html#os.PathLike" title="(in Python v3.10)"><span class="pre">os.PathLike</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">image_bundle</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">List</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">image_sources</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Dict</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">,</span> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">file_type</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">'jpg'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">spacing</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.10)"><span class="pre">int</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">20</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">do_align_right</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.10)"><span class="pre">bool</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#gmplib.image.combine_raster_images_horizontally" title="Permalink to this definition">¶</a></dt>
-<dd><p>Combine raster images in a horizontal layout.
-Inherits from <cite>combine_raster_images</cite>.</p>
+<dd><p>Combine raster images in a horizontal layout.</p>
+<p>Inherits from <cite>combine_raster_images</cite>.</p>
 <dl class="py method">
 <dt class="sig sig-object py" id="gmplib.image.combine_raster_images_horizontally.paste_images">
 <span class="sig-name descname"><span class="pre">paste_images</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">spacing</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.10)"><span class="pre">float</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">do_align_right</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.10)"><span class="pre">bool</span></a></span></em><span class="sig-paren">)</span> &#x2192; <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.10)"><span class="pre">None</span></a><a class="headerlink" href="#gmplib.image.combine_raster_images_horizontally.paste_images" title="Permalink to this definition">¶</a></dt>
-<dd><p>How to combine the images.</p>
+<dd><p>Combine the images.</p>
 </dd></dl>
 
 </dd></dl>
@@ -204,12 +204,12 @@ <h3>Navigation</h3>
 <dl class="py class">
 <dt class="sig sig-object py" id="gmplib.image.combine_raster_images_vertically">
 <em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">gmplib.image.</span></span><span class="sig-name descname"><span class="pre">combine_raster_images_vertically</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">out_path</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/os.html#os.PathLike" title="(in Python v3.10)"><span class="pre">os.PathLike</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">into_filename</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/os.html#os.PathLike" title="(in Python v3.10)"><span class="pre">os.PathLike</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">image_bundle</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">List</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">image_sources</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Dict</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">,</span> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">file_type</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">'jpg'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">spacing</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.10)"><span class="pre">int</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">20</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">do_align_right</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.10)"><span class="pre">bool</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#gmplib.image.combine_raster_images_vertically" title="Permalink to this definition">¶</a></dt>
-<dd><p>Combine raster images in a vertical layout.
-Inherits from <cite>combine_raster_images</cite>.</p>
+<dd><p>Combine raster images in a vertical layout.</p>
+<p>Inherits from <cite>combine_raster_images</cite>.</p>
 <dl class="py method">
 <dt class="sig sig-object py" id="gmplib.image.combine_raster_images_vertically.paste_images">
 <span class="sig-name descname"><span class="pre">paste_images</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">spacing</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.10)"><span class="pre">float</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">do_align_right</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.10)"><span class="pre">bool</span></a></span></em><span class="sig-paren">)</span> &#x2192; <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.10)"><span class="pre">None</span></a><a class="headerlink" href="#gmplib.image.combine_raster_images_vertically.paste_images" title="Permalink to this definition">¶</a></dt>
-<dd><p>How to combine the images</p>
+<dd><p>Combine the images.</p>
 </dd></dl>
 
 </dd></dl>
@@ -217,8 +217,8 @@ <h3>Navigation</h3>
 <dl class="py function">
 <dt class="sig sig-object py" id="gmplib.image.fetch_images">
 <span class="sig-prename descclassname"><span class="pre">gmplib.image.</span></span><span class="sig-name descname"><span class="pre">fetch_images</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">images</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">Dict</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">,</span> </span><span class="pre">IPython.core.display.Image</span><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">image_sources</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">Dict</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">,</span> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">image_paths</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">List</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> &#x2192; <span class="pre">Tuple</span><span class="p"><span class="pre">[</span></span><span class="pre">Dict</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">,</span> </span><span class="pre">IPython.core.display.Image</span><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">,</span> </span><span class="pre">Dict</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">,</span> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">]</span></span><a class="headerlink" href="#gmplib.image.fetch_images" title="Permalink to this definition">¶</a></dt>
-<dd><p>Imports images from a list of source directories.
-If <cite>images</cite> and <cite>image_sources</cite> are <cite>None</cite> new dictionaries are created;
+<dd><p>Import images from a list of source directories.</p>
+<p>If <cite>images</cite> and <cite>image_sources</cite> are <cite>None</cite> new dictionaries are created;
 otherwise, pre-existing such dictionaries are expected.</p>
 <p>This tool is used by the discussion notebooks to import snapshot images
 for inline display.</p>
@@ -242,7 +242,7 @@ <h3>Navigation</h3>
 <dl class="py function">
 <dt class="sig sig-object py" id="gmplib.image.resize">
 <span class="sig-prename descclassname"><span class="pre">gmplib.image.</span></span><span class="sig-name descname"><span class="pre">resize</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">image</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">IPython.core.display.Image</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">width</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.10)"><span class="pre">int</span></a><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">height</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.10)"><span class="pre">int</span></a><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> &#x2192; <span class="pre">IPython.core.display.Image</span><a class="headerlink" href="#gmplib.image.resize" title="Permalink to this definition">¶</a></dt>
-<dd><p>Modify an <code class="xref py py-mod docutils literal notranslate"><span class="pre">Image</span></code> size</p>
+<dd><p>Modify an <code class="xref py py-mod docutils literal notranslate"><span class="pre">Image</span></code> size.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Returns</dt>
 <dd class="field-odd"><p>resized image object</p>
@@ -274,6 +274,7 @@ <h2>Code<a class="headerlink" href="#code" title="Permalink to this headline">¶
 
 <span class="c1"># Library</span>
 <span class="kn">import</span> <span class="nn">warnings</span>
+
 <span class="c1"># import logging</span>
 <span class="kn">import</span> <span class="nn">os</span>
 <span class="kn">from</span> <span class="nn">os</span> <span class="kn">import</span> <span class="n">listdir</span><span class="p">,</span> <span class="n">PathLike</span>
@@ -296,15 +297,17 @@ <h2>Code<a class="headerlink" href="#code" title="Permalink to this headline">¶
 
 <span class="n">warnings</span><span class="o">.</span><span class="n">filterwarnings</span><span class="p">(</span><span class="s2">&quot;ignore&quot;</span><span class="p">)</span>
 
-<span class="n">__all__</span> <span class="o">=</span> <span class="p">[</span><span class="s1">&#39;combine_images&#39;</span><span class="p">,</span>
-           <span class="s1">&#39;combine_raster_images&#39;</span><span class="p">,</span>
-           <span class="s1">&#39;combine_pdf_images&#39;</span><span class="p">,</span>
-           <span class="s1">&#39;combine_raster_images_vertically&#39;</span><span class="p">,</span>
-           <span class="s1">&#39;combine_raster_images_horizontally&#39;</span><span class="p">,</span>
-           <span class="s1">&#39;combine_pdf_images_vertically&#39;</span><span class="p">,</span>
-           <span class="s1">&#39;combine_pdf_images_horizontally&#39;</span><span class="p">,</span>
-           <span class="s1">&#39;fetch_images&#39;</span><span class="p">,</span>
-           <span class="s1">&#39;resize&#39;</span><span class="p">]</span>
+<span class="n">__all__</span> <span class="o">=</span> <span class="p">[</span>
+    <span class="s2">&quot;combine_images&quot;</span><span class="p">,</span>
+    <span class="s2">&quot;combine_raster_images&quot;</span><span class="p">,</span>
+    <span class="s2">&quot;combine_pdf_images&quot;</span><span class="p">,</span>
+    <span class="s2">&quot;combine_raster_images_vertically&quot;</span><span class="p">,</span>
+    <span class="s2">&quot;combine_raster_images_horizontally&quot;</span><span class="p">,</span>
+    <span class="s2">&quot;combine_pdf_images_vertically&quot;</span><span class="p">,</span>
+    <span class="s2">&quot;combine_pdf_images_horizontally&quot;</span><span class="p">,</span>
+    <span class="s2">&quot;fetch_images&quot;</span><span class="p">,</span>
+    <span class="s2">&quot;resize&quot;</span><span class="p">,</span>
+<span class="p">]</span>
 
 
 <span class="k">class</span> <span class="nc">combine_images</span><span class="p">(</span><span class="n">ABC</span><span class="p">):</span>
@@ -328,19 +331,21 @@ <h2>Code<a class="headerlink" href="#code" title="Permalink to this headline">¶
 <span class="sd">            align all images along right margin</span>
 <span class="sd">    &quot;&quot;&quot;</span>
 
+    <span class="c1"># Definitions</span>
+    <span class="n">combo_image</span><span class="p">:</span> <span class="n">Image</span>
+    <span class="n">combo_page</span><span class="p">:</span> <span class="n">PdfImage</span>
+
     <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
         <span class="bp">self</span><span class="p">,</span>
         <span class="n">out_path</span><span class="p">:</span> <span class="n">PathLike</span><span class="p">,</span>
         <span class="n">into_filename</span><span class="p">:</span> <span class="n">PathLike</span><span class="p">,</span>
         <span class="n">image_bundle</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span>
         <span class="n">image_sources</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">],</span>
-        <span class="n">file_type</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s1">&#39;jpg&#39;</span><span class="p">,</span>
+        <span class="n">file_type</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;jpg&quot;</span><span class="p">,</span>
         <span class="n">spacing</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">20</span><span class="p">,</span>
-        <span class="n">do_align_right</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span>
+        <span class="n">do_align_right</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
     <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        Constructor method</span>
-<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="sd">&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">combo_image</span><span class="p">:</span> <span class="n">Image</span> <span class="o">=</span> <span class="kc">None</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">combo_page</span><span class="p">:</span> <span class="n">PdfImage</span> <span class="o">=</span> <span class="kc">None</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">get_images</span><span class="p">(</span><span class="n">image_bundle</span><span class="p">,</span> <span class="n">image_sources</span><span class="p">,</span> <span class="n">file_type</span><span class="p">,</span> <span class="n">spacing</span><span class="p">)</span>
@@ -353,7 +358,7 @@ <h2>Code<a class="headerlink" href="#code" title="Permalink to this headline">¶
         <span class="n">image_bundle</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span>
         <span class="n">image_sources</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">],</span>
         <span class="n">file_type</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
-        <span class="n">spacing</span><span class="p">:</span> <span class="nb">float</span>
+        <span class="n">spacing</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span>
     <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
         <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">        How to get image files (abstract method).</span>
@@ -370,11 +375,7 @@ <h2>Code<a class="headerlink" href="#code" title="Permalink to this headline">¶
 <span class="sd">        &quot;&quot;&quot;</span>
 
     <span class="nd">@abstractmethod</span>
-    <span class="k">def</span> <span class="nf">paste_images</span><span class="p">(</span>
-        <span class="bp">self</span><span class="p">,</span>
-        <span class="n">spacing</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span>
-        <span class="n">do_align_right</span><span class="p">:</span> <span class="nb">bool</span>
-    <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+    <span class="k">def</span> <span class="nf">paste_images</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">spacing</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span> <span class="n">do_align_right</span><span class="p">:</span> <span class="nb">bool</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
         <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">        How to combine image files (abstract method).</span>
 
@@ -387,13 +388,10 @@ <h2>Code<a class="headerlink" href="#code" title="Permalink to this headline">¶
 
     <span class="nd">@abstractmethod</span>
     <span class="k">def</span> <span class="nf">save_combo_image</span><span class="p">(</span>
-        <span class="bp">self</span><span class="p">,</span>
-        <span class="n">out_path</span><span class="p">:</span> <span class="n">PathLike</span><span class="p">,</span>
-        <span class="n">into_filename</span><span class="p">:</span> <span class="n">PathLike</span><span class="p">,</span>
-        <span class="n">file_type</span><span class="p">:</span> <span class="nb">str</span>
+        <span class="bp">self</span><span class="p">,</span> <span class="n">out_path</span><span class="p">:</span> <span class="n">PathLike</span><span class="p">,</span> <span class="n">into_filename</span><span class="p">:</span> <span class="n">PathLike</span><span class="p">,</span> <span class="n">file_type</span><span class="p">:</span> <span class="nb">str</span>
     <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
         <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        How to write combined image file (abstract method)</span>
+<span class="sd">        Provide a tool to write a combined image file (abstract method).</span>
 
 <span class="sd">        Args:</span>
 <span class="sd">            out_path:</span>
@@ -408,59 +406,63 @@ <h2>Code<a class="headerlink" href="#code" title="Permalink to this headline">¶
 <span class="k">class</span> <span class="nc">combine_raster_images</span><span class="p">(</span><span class="n">combine_images</span><span class="p">):</span>
     <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Combine raster image files.</span>
+
 <span class="sd">    Inherits from `combine_images`.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
 
-    <span class="k">def</span> <span class="nf">get_images</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span>
-                   <span class="n">image_bundle</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span>
-                   <span class="n">image_sources</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">],</span>
-                   <span class="n">file_type</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
-                   <span class="n">spacing</span><span class="p">:</span> <span class="nb">float</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        Get images from raster files.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
+    <span class="c1"># Definitions</span>
+    <span class="n">image_list</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">Image</span><span class="p">]</span>
+
+    <span class="k">def</span> <span class="nf">get_images</span><span class="p">(</span>
+        <span class="bp">self</span><span class="p">,</span>
+        <span class="n">image_bundle</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span>
+        <span class="n">image_sources</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">],</span>
+        <span class="n">file_type</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
+        <span class="n">spacing</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span>
+    <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+        <span class="sd">&quot;&quot;&quot;Get images from raster files.&quot;&quot;&quot;</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">image_list</span> <span class="o">=</span> <span class="p">[</span>
-            <span class="n">PIL</span><span class="o">.</span><span class="n">Image</span><span class="o">.</span><span class="n">open</span><span class="p">(</span><span class="n">join</span><span class="p">(</span><span class="n">image_sources</span><span class="p">[</span><span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">image_name</span><span class="si">}</span><span class="s1">.</span><span class="si">{</span><span class="n">file_type</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">],</span>
-                                <span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">image_name</span><span class="si">}</span><span class="s1">.</span><span class="si">{</span><span class="n">file_type</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">))</span>
+            <span class="n">PIL</span><span class="o">.</span><span class="n">Image</span><span class="o">.</span><span class="n">open</span><span class="p">(</span>
+                <span class="n">join</span><span class="p">(</span>
+                    <span class="n">image_sources</span><span class="p">[</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">image_name</span><span class="si">}</span><span class="s2">.</span><span class="si">{</span><span class="n">file_type</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">],</span>
+                    <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">image_name</span><span class="si">}</span><span class="s2">.</span><span class="si">{</span><span class="n">file_type</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">,</span>
+                <span class="p">)</span>
+            <span class="p">)</span>
             <span class="k">for</span> <span class="n">image_name</span> <span class="ow">in</span> <span class="n">image_bundle</span>
         <span class="p">]</span>
 
     <span class="k">def</span> <span class="nf">save_combo_image</span><span class="p">(</span>
-        <span class="bp">self</span><span class="p">,</span>
-        <span class="n">out_path</span><span class="p">:</span> <span class="n">PathLike</span><span class="p">,</span>
-        <span class="n">into_filename</span><span class="p">:</span> <span class="n">PathLike</span><span class="p">,</span>
-        <span class="n">file_type</span><span class="p">:</span> <span class="nb">str</span>
+        <span class="bp">self</span><span class="p">,</span> <span class="n">out_path</span><span class="p">:</span> <span class="n">PathLike</span><span class="p">,</span> <span class="n">into_filename</span><span class="p">:</span> <span class="n">PathLike</span><span class="p">,</span> <span class="n">file_type</span><span class="p">:</span> <span class="nb">str</span>
     <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        Write combined image to a raster file.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="sd">&quot;&quot;&quot;Write combined image to a raster file.&quot;&quot;&quot;</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">combo_image</span><span class="o">.</span><span class="n">save</span><span class="p">(</span>
-            <span class="n">join</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">out_path</span><span class="p">),</span> <span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">into_filename</span><span class="si">}</span><span class="s1">.</span><span class="si">{</span><span class="n">file_type</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">))</span>
+            <span class="n">join</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">out_path</span><span class="p">),</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">into_filename</span><span class="si">}</span><span class="s2">.</span><span class="si">{</span><span class="n">file_type</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+        <span class="p">)</span>
 
 
 <span class="k">class</span> <span class="nc">combine_raster_images_vertically</span><span class="p">(</span><span class="n">combine_raster_images</span><span class="p">):</span>
     <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Combine raster images in a vertical layout.</span>
+
 <span class="sd">    Inherits from `combine_raster_images`.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
 
-    <span class="k">def</span> <span class="nf">paste_images</span><span class="p">(</span>
-        <span class="bp">self</span><span class="p">,</span>
-        <span class="n">spacing</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span>
-        <span class="n">do_align_right</span><span class="p">:</span> <span class="nb">bool</span>
-    <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        How to combine the images</span>
-<span class="sd">        &quot;&quot;&quot;</span>
+    <span class="c1"># Definitions</span>
+    <span class="n">combo_image</span><span class="p">:</span> <span class="n">Image</span>
+
+    <span class="k">def</span> <span class="nf">paste_images</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">spacing</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span> <span class="n">do_align_right</span><span class="p">:</span> <span class="nb">bool</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+        <span class="sd">&quot;&quot;&quot;Combine the images.&quot;&quot;&quot;</span>
         <span class="n">x_size</span> <span class="o">=</span> <span class="nb">max</span><span class="p">([</span><span class="n">image</span><span class="o">.</span><span class="n">size</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="k">for</span> <span class="n">image</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">image_list</span><span class="p">])</span>
         <span class="n">y_sizes</span> <span class="o">=</span> <span class="p">[</span><span class="n">image</span><span class="o">.</span><span class="n">size</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="k">for</span> <span class="n">image</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">image_list</span><span class="p">]</span>
-        <span class="n">y_size</span> <span class="o">=</span> <span class="n">reduce</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">,</span> <span class="n">y</span><span class="p">:</span> <span class="n">x</span><span class="o">+</span><span class="n">y</span><span class="p">,</span> <span class="n">y_sizes</span><span class="p">)</span> <span class="o">+</span> \
-            <span class="n">spacing</span><span class="o">*</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">image_list</span><span class="p">)</span><span class="o">-</span><span class="mi">1</span><span class="p">)</span>
+        <span class="n">y_size</span> <span class="o">=</span> <span class="n">reduce</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">,</span> <span class="n">y</span><span class="p">:</span> <span class="n">x</span> <span class="o">+</span> <span class="n">y</span><span class="p">,</span> <span class="n">y_sizes</span><span class="p">)</span> <span class="o">+</span> <span class="n">spacing</span> <span class="o">*</span> <span class="p">(</span>
+            <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">image_list</span><span class="p">)</span> <span class="o">-</span> <span class="mi">1</span>
+        <span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">combo_image</span> <span class="o">=</span> <span class="n">PIL</span><span class="o">.</span><span class="n">Image</span><span class="o">.</span><span class="n">new</span><span class="p">(</span>
-            <span class="s1">&#39;RGB&#39;</span><span class="p">,</span> <span class="p">(</span><span class="n">x_size</span><span class="p">,</span> <span class="n">y_size</span><span class="p">),</span> <span class="p">(</span><span class="mi">255</span><span class="p">,</span> <span class="mi">255</span><span class="p">,</span> <span class="mi">255</span><span class="p">))</span>
+            <span class="s2">&quot;RGB&quot;</span><span class="p">,</span> <span class="p">(</span><span class="n">x_size</span><span class="p">,</span> <span class="n">y_size</span><span class="p">),</span> <span class="p">(</span><span class="mi">255</span><span class="p">,</span> <span class="mi">255</span><span class="p">,</span> <span class="mi">255</span><span class="p">)</span>
+        <span class="p">)</span>
         <span class="n">y_offset</span> <span class="o">=</span> <span class="mi">0</span>
         <span class="k">for</span> <span class="n">image</span><span class="p">,</span> <span class="n">y_size</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">image_list</span><span class="p">,</span> <span class="n">y_sizes</span><span class="p">):</span>
-            <span class="n">x_offset</span> <span class="o">=</span> <span class="n">x_size</span><span class="o">-</span><span class="n">image</span><span class="o">.</span><span class="n">size</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="k">if</span> <span class="n">do_align_right</span> <span class="k">else</span> <span class="mi">0</span>
+            <span class="n">x_offset</span> <span class="o">=</span> <span class="n">x_size</span> <span class="o">-</span> <span class="n">image</span><span class="o">.</span><span class="n">size</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="k">if</span> <span class="n">do_align_right</span> <span class="k">else</span> <span class="mi">0</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">combo_image</span><span class="o">.</span><span class="n">paste</span><span class="p">(</span><span class="n">image</span><span class="p">,</span> <span class="p">(</span><span class="n">x_offset</span><span class="p">,</span> <span class="n">y_offset</span><span class="p">))</span>
             <span class="n">y_offset</span> <span class="o">+=</span> <span class="n">y_size</span> <span class="o">+</span> <span class="n">spacing</span>
 
@@ -468,23 +470,23 @@ <h2>Code<a class="headerlink" href="#code" title="Permalink to this headline">¶
 <span class="k">class</span> <span class="nc">combine_raster_images_horizontally</span><span class="p">(</span><span class="n">combine_raster_images</span><span class="p">):</span>
     <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Combine raster images in a horizontal layout.</span>
+
 <span class="sd">    Inherits from `combine_raster_images`.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
 
-    <span class="k">def</span> <span class="nf">paste_images</span><span class="p">(</span>
-        <span class="bp">self</span><span class="p">,</span>
-        <span class="n">spacing</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span>
-        <span class="n">do_align_right</span><span class="p">:</span> <span class="nb">bool</span>
-    <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        How to combine the images.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
+    <span class="c1"># Definitions</span>
+    <span class="n">combo_image</span><span class="p">:</span> <span class="n">Image</span>
+
+    <span class="k">def</span> <span class="nf">paste_images</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">spacing</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span> <span class="n">do_align_right</span><span class="p">:</span> <span class="nb">bool</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+        <span class="sd">&quot;&quot;&quot;Combine the images.&quot;&quot;&quot;</span>
         <span class="n">y_size</span> <span class="o">=</span> <span class="nb">max</span><span class="p">([</span><span class="n">image</span><span class="o">.</span><span class="n">size</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="k">for</span> <span class="n">image</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">image_list</span><span class="p">])</span>
         <span class="n">x_sizes</span> <span class="o">=</span> <span class="p">[</span><span class="n">image</span><span class="o">.</span><span class="n">size</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="k">for</span> <span class="n">image</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">image_list</span><span class="p">]</span>
-        <span class="n">x_size</span> <span class="o">=</span> <span class="n">reduce</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">,</span> <span class="n">y</span><span class="p">:</span> <span class="n">x</span><span class="o">+</span><span class="n">y</span><span class="p">,</span> <span class="n">x_sizes</span><span class="p">)</span> <span class="o">+</span> \
-            <span class="n">spacing</span><span class="o">*</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">image_list</span><span class="p">)</span><span class="o">-</span><span class="mi">1</span><span class="p">)</span>
+        <span class="n">x_size</span> <span class="o">=</span> <span class="n">reduce</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">,</span> <span class="n">y</span><span class="p">:</span> <span class="n">x</span> <span class="o">+</span> <span class="n">y</span><span class="p">,</span> <span class="n">x_sizes</span><span class="p">)</span> <span class="o">+</span> <span class="n">spacing</span> <span class="o">*</span> <span class="p">(</span>
+            <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">image_list</span><span class="p">)</span> <span class="o">-</span> <span class="mi">1</span>
+        <span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">combo_image</span> <span class="o">=</span> <span class="n">PIL</span><span class="o">.</span><span class="n">Image</span><span class="o">.</span><span class="n">new</span><span class="p">(</span>
-            <span class="s1">&#39;RGB&#39;</span><span class="p">,</span> <span class="p">(</span><span class="n">x_size</span><span class="p">,</span> <span class="n">y_size</span><span class="p">),</span> <span class="p">(</span><span class="mi">255</span><span class="p">,</span> <span class="mi">255</span><span class="p">,</span> <span class="mi">255</span><span class="p">))</span>
+            <span class="s2">&quot;RGB&quot;</span><span class="p">,</span> <span class="p">(</span><span class="n">x_size</span><span class="p">,</span> <span class="n">y_size</span><span class="p">),</span> <span class="p">(</span><span class="mi">255</span><span class="p">,</span> <span class="mi">255</span><span class="p">,</span> <span class="mi">255</span><span class="p">)</span>
+        <span class="p">)</span>
         <span class="n">x_offset</span> <span class="o">=</span> <span class="mi">0</span>
         <span class="k">for</span> <span class="n">image</span><span class="p">,</span> <span class="n">x_size</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">image_list</span><span class="p">,</span> <span class="n">x_sizes</span><span class="p">):</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">combo_image</span><span class="o">.</span><span class="n">paste</span><span class="p">(</span><span class="n">image</span><span class="p">,</span> <span class="p">(</span><span class="n">x_offset</span><span class="p">,</span> <span class="mi">0</span><span class="p">))</span>
@@ -494,100 +496,100 @@ <h2>Code<a class="headerlink" href="#code" title="Permalink to this headline">¶
 <span class="k">class</span> <span class="nc">combine_pdf_images</span><span class="p">(</span><span class="n">combine_images</span><span class="p">):</span>
     <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Combine PDF image files.</span>
+
 <span class="sd">    Inherits from `combine_images`.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
 
+    <span class="c1"># Definitions</span>
+    <span class="n">page_list</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">PdfImage</span><span class="p">]</span>
+
     <span class="k">def</span> <span class="nf">get_images</span><span class="p">(</span>
         <span class="bp">self</span><span class="p">,</span>
         <span class="n">image_bundle</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span>
         <span class="n">image_sources</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">],</span>
         <span class="n">file_type</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
-        <span class="n">spacing</span><span class="p">:</span> <span class="nb">float</span>
+        <span class="n">spacing</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span>
     <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        How to read the image files.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="sd">&quot;&quot;&quot;Combine the image files.&quot;&quot;&quot;</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">page_list</span> <span class="o">=</span> <span class="p">[]</span>
         <span class="k">for</span> <span class="n">image_name</span> <span class="ow">in</span> <span class="n">image_bundle</span><span class="p">:</span>
-            <span class="n">pdf_path</span> <span class="o">=</span> <span class="n">join</span><span class="p">(</span><span class="n">image_sources</span><span class="p">[</span><span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">image_name</span><span class="si">}</span><span class="s1">.</span><span class="si">{</span><span class="n">file_type</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">],</span>
-                            <span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">image_name</span><span class="si">}</span><span class="s1">.</span><span class="si">{</span><span class="n">file_type</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span>
+            <span class="n">pdf_path</span> <span class="o">=</span> <span class="n">join</span><span class="p">(</span>
+                <span class="n">image_sources</span><span class="p">[</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">image_name</span><span class="si">}</span><span class="s2">.</span><span class="si">{</span><span class="n">file_type</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">],</span>
+                <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">image_name</span><span class="si">}</span><span class="s2">.</span><span class="si">{</span><span class="n">file_type</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">,</span>
+            <span class="p">)</span>
             <span class="c1"># The following cleaner method doesn&#39;t work because PdfFileReader</span>
             <span class="c1">#   appears to require pdf files to remain open for subsequent use</span>
             <span class="c1"># Exactly how/when they are actually closed is not at all clear</span>
             <span class="c1"># with open(pdf_path,&#39;rb&#39;) as f:</span>
             <span class="c1">#     pdf_reader = PdfFileReader(f)</span>
             <span class="c1">#     self.page_list.append(pdf_reader.getPage(0))</span>
-            <span class="n">pdf_reader</span> <span class="o">=</span> <span class="n">PdfFileReader</span><span class="p">(</span><span class="nb">open</span><span class="p">(</span><span class="n">pdf_path</span><span class="p">,</span> <span class="s1">&#39;rb&#39;</span><span class="p">))</span>
+            <span class="n">pdf_reader</span> <span class="o">=</span> <span class="n">PdfFileReader</span><span class="p">(</span><span class="nb">open</span><span class="p">(</span><span class="n">pdf_path</span><span class="p">,</span> <span class="s2">&quot;rb&quot;</span><span class="p">))</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">page_list</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">pdf_reader</span><span class="o">.</span><span class="n">getPage</span><span class="p">(</span><span class="mi">0</span><span class="p">))</span>
 
     <span class="k">def</span> <span class="nf">save_combo_image</span><span class="p">(</span>
-        <span class="bp">self</span><span class="p">,</span>
-        <span class="n">out_path</span><span class="p">:</span> <span class="n">PathLike</span><span class="p">,</span>
-        <span class="n">into_filename</span><span class="p">:</span> <span class="n">PathLike</span><span class="p">,</span>
-        <span class="n">file_type</span><span class="p">:</span> <span class="nb">str</span>
+        <span class="bp">self</span><span class="p">,</span> <span class="n">out_path</span><span class="p">:</span> <span class="n">PathLike</span><span class="p">,</span> <span class="n">into_filename</span><span class="p">:</span> <span class="n">PathLike</span><span class="p">,</span> <span class="n">file_type</span><span class="p">:</span> <span class="nb">str</span>
     <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        How to write the image to a file.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">combo_path</span> <span class="o">=</span> <span class="n">join</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">out_path</span><span class="p">),</span> <span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">into_filename</span><span class="si">}</span><span class="s1">.</span><span class="si">{</span><span class="n">file_type</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span>
+        <span class="sd">&quot;&quot;&quot;Write the image to a file.&quot;&quot;&quot;</span>
+        <span class="n">combo_path</span> <span class="o">=</span> <span class="n">join</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">out_path</span><span class="p">),</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">into_filename</span><span class="si">}</span><span class="s2">.</span><span class="si">{</span><span class="n">file_type</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
         <span class="n">writer</span> <span class="o">=</span> <span class="n">PdfFileWriter</span><span class="p">()</span>
         <span class="n">writer</span><span class="o">.</span><span class="n">addPage</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">combo_page</span><span class="p">)</span>
-        <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">combo_path</span><span class="p">,</span> <span class="s1">&#39;wb&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
+        <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">combo_path</span><span class="p">,</span> <span class="s2">&quot;wb&quot;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
             <span class="n">writer</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">f</span><span class="p">)</span>
 
 
 <span class="k">class</span> <span class="nc">combine_pdf_images_vertically</span><span class="p">(</span><span class="n">combine_pdf_images</span><span class="p">):</span>
     <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Combine PDF images in a vertical layout.</span>
+
 <span class="sd">    Inherits from `combine_pdf_images`.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
 
-    <span class="k">def</span> <span class="nf">paste_images</span><span class="p">(</span>
-        <span class="bp">self</span><span class="p">,</span>
-        <span class="n">spacing</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span>
-        <span class="n">do_align_right</span><span class="p">:</span> <span class="nb">bool</span>
-    <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        How to combine the images</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">x_size</span><span class="p">:</span> <span class="n">Decimal</span> <span class="o">=</span> <span class="nb">max</span><span class="p">([</span><span class="n">page_</span><span class="o">.</span><span class="n">mediaBox</span><span class="o">.</span><span class="n">getWidth</span><span class="p">()</span>
-                               <span class="k">for</span> <span class="n">page_</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">page_list</span><span class="p">])</span>
-        <span class="n">y_sizes</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">Decimal</span><span class="p">]</span> <span class="o">=</span> <span class="p">[</span><span class="n">page_</span><span class="o">.</span><span class="n">mediaBox</span><span class="o">.</span><span class="n">getHeight</span><span class="p">()</span>
-                                  <span class="k">for</span> <span class="n">page_</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">page_list</span><span class="p">]</span>
-        <span class="n">y_size</span><span class="p">:</span> <span class="n">Decimal</span> \
-            <span class="o">=</span> <span class="n">reduce</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">,</span> <span class="n">y</span><span class="p">:</span> <span class="n">x</span><span class="o">+</span><span class="n">y</span><span class="p">,</span> <span class="n">y_sizes</span><span class="p">)</span> \
-            <span class="o">+</span> <span class="n">Decimal</span><span class="p">(</span><span class="n">spacing</span><span class="p">)</span><span class="o">*</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">page_list</span><span class="p">)</span><span class="o">-</span><span class="mi">1</span><span class="p">)</span>
+    <span class="c1"># Definitions</span>
+    <span class="n">combo_page</span><span class="p">:</span> <span class="n">PdfImage</span>
+
+    <span class="k">def</span> <span class="nf">paste_images</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">spacing</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span> <span class="n">do_align_right</span><span class="p">:</span> <span class="nb">bool</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+        <span class="sd">&quot;&quot;&quot;Combine the images.&quot;&quot;&quot;</span>
+        <span class="n">x_size</span><span class="p">:</span> <span class="n">Decimal</span> <span class="o">=</span> <span class="nb">max</span><span class="p">(</span>
+            <span class="p">[</span><span class="n">page_</span><span class="o">.</span><span class="n">mediaBox</span><span class="o">.</span><span class="n">getWidth</span><span class="p">()</span> <span class="k">for</span> <span class="n">page_</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">page_list</span><span class="p">]</span>
+        <span class="p">)</span>
+        <span class="n">y_sizes</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">Decimal</span><span class="p">]</span> <span class="o">=</span> <span class="p">[</span>
+            <span class="n">page_</span><span class="o">.</span><span class="n">mediaBox</span><span class="o">.</span><span class="n">getHeight</span><span class="p">()</span> <span class="k">for</span> <span class="n">page_</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">page_list</span>
+        <span class="p">]</span>
+        <span class="n">y_size</span><span class="p">:</span> <span class="n">Decimal</span> <span class="o">=</span> <span class="n">reduce</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">,</span> <span class="n">y</span><span class="p">:</span> <span class="n">x</span> <span class="o">+</span> <span class="n">y</span><span class="p">,</span> <span class="n">y_sizes</span><span class="p">)</span> <span class="o">+</span> <span class="n">Decimal</span><span class="p">(</span>
+            <span class="n">spacing</span>
+        <span class="p">)</span> <span class="o">*</span> <span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">page_list</span><span class="p">)</span> <span class="o">-</span> <span class="mi">1</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">combo_page</span> <span class="o">=</span> <span class="n">PageObject</span><span class="o">.</span><span class="n">createBlankPage</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="n">x_size</span><span class="p">,</span> <span class="n">y_size</span><span class="p">)</span>
         <span class="n">y_offset</span> <span class="o">=</span> <span class="n">y_size</span>
         <span class="k">for</span> <span class="n">i_</span><span class="p">,</span> <span class="p">(</span><span class="n">page_</span><span class="p">,</span> <span class="n">y_size_</span><span class="p">)</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="nb">zip</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">page_list</span><span class="p">,</span> <span class="n">y_sizes</span><span class="p">)):</span>
             <span class="n">y_offset</span> <span class="o">-=</span> <span class="n">Decimal</span><span class="p">(</span><span class="n">y_size_</span><span class="p">)</span> <span class="o">+</span> <span class="n">Decimal</span><span class="p">(</span><span class="n">spacing</span> <span class="k">if</span> <span class="n">i_</span> <span class="o">&gt;</span> <span class="mi">0</span> <span class="k">else</span> <span class="mi">0</span><span class="p">)</span>
-            <span class="n">x_offset</span> <span class="o">=</span> <span class="p">(</span><span class="n">x_size</span><span class="o">-</span><span class="n">page_</span><span class="o">.</span><span class="n">mediaBox</span><span class="o">.</span><span class="n">getWidth</span><span class="p">()</span>
-                        <span class="k">if</span> <span class="n">do_align_right</span> <span class="k">else</span> <span class="mi">0</span><span class="p">)</span>
+            <span class="n">x_offset</span> <span class="o">=</span> <span class="p">(</span>
+                <span class="n">x_size</span> <span class="o">-</span> <span class="n">page_</span><span class="o">.</span><span class="n">mediaBox</span><span class="o">.</span><span class="n">getWidth</span><span class="p">()</span> <span class="k">if</span> <span class="n">do_align_right</span> <span class="k">else</span> <span class="mi">0</span>
+            <span class="p">)</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">combo_page</span><span class="o">.</span><span class="n">mergeTranslatedPage</span><span class="p">(</span><span class="n">page_</span><span class="p">,</span> <span class="n">x_offset</span><span class="p">,</span> <span class="n">y_offset</span><span class="p">)</span>
 
 
 <span class="k">class</span> <span class="nc">combine_pdf_images_horizontally</span><span class="p">(</span><span class="n">combine_pdf_images</span><span class="p">):</span>
     <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Combine PDF images in a horizontal layout.</span>
+
 <span class="sd">    Inherits from `combine_pdf_images`.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
 
-    <span class="k">def</span> <span class="nf">paste_images</span><span class="p">(</span>
-        <span class="bp">self</span><span class="p">,</span>
-        <span class="n">spacing</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span>
-        <span class="n">do_align_right</span><span class="p">:</span> <span class="nb">bool</span>
-    <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        How to combine the images.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">y_size</span><span class="p">:</span> <span class="n">Decimal</span> <span class="o">=</span> <span class="nb">max</span><span class="p">([</span><span class="n">page_</span><span class="o">.</span><span class="n">mediaBox</span><span class="o">.</span><span class="n">getHeight</span><span class="p">()</span>
-                               <span class="k">for</span> <span class="n">page_</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">page_list</span><span class="p">])</span>
-        <span class="n">x_sizes</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">Decimal</span><span class="p">]</span> <span class="o">=</span> <span class="p">[</span><span class="n">page_</span><span class="o">.</span><span class="n">mediaBox</span><span class="o">.</span><span class="n">getWidth</span><span class="p">()</span>
-                                  <span class="k">for</span> <span class="n">page_</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">page_list</span><span class="p">]</span>
+    <span class="c1"># Definitions</span>
+    <span class="n">combo_page</span><span class="p">:</span> <span class="n">PdfImage</span>
+
+    <span class="k">def</span> <span class="nf">paste_images</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">spacing</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span> <span class="n">do_align_right</span><span class="p">:</span> <span class="nb">bool</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+        <span class="sd">&quot;&quot;&quot;Combine the images.&quot;&quot;&quot;</span>
+        <span class="n">y_size</span><span class="p">:</span> <span class="n">Decimal</span> <span class="o">=</span> <span class="nb">max</span><span class="p">(</span>
+            <span class="p">[</span><span class="n">page_</span><span class="o">.</span><span class="n">mediaBox</span><span class="o">.</span><span class="n">getHeight</span><span class="p">()</span> <span class="k">for</span> <span class="n">page_</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">page_list</span><span class="p">]</span>
+        <span class="p">)</span>
+        <span class="n">x_sizes</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">Decimal</span><span class="p">]</span> <span class="o">=</span> <span class="p">[</span>
+            <span class="n">page_</span><span class="o">.</span><span class="n">mediaBox</span><span class="o">.</span><span class="n">getWidth</span><span class="p">()</span> <span class="k">for</span> <span class="n">page_</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">page_list</span>
+        <span class="p">]</span>
         <span class="n">x_sizes</span><span class="o">.</span><span class="n">reverse</span><span class="p">()</span>
-        <span class="n">x_size</span><span class="p">:</span> <span class="n">Decimal</span> \
-            <span class="o">=</span> <span class="n">reduce</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">,</span> <span class="n">y</span><span class="p">:</span> <span class="n">x</span><span class="o">+</span><span class="n">y</span><span class="p">,</span> <span class="n">x_sizes</span><span class="p">)</span> \
-            <span class="o">+</span> <span class="n">Decimal</span><span class="p">(</span><span class="n">spacing</span><span class="p">)</span><span class="o">*</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">page_list</span><span class="p">)</span><span class="o">-</span><span class="mi">1</span><span class="p">)</span>
+        <span class="n">x_size</span><span class="p">:</span> <span class="n">Decimal</span> <span class="o">=</span> <span class="n">reduce</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">,</span> <span class="n">y</span><span class="p">:</span> <span class="n">x</span> <span class="o">+</span> <span class="n">y</span><span class="p">,</span> <span class="n">x_sizes</span><span class="p">)</span> <span class="o">+</span> <span class="n">Decimal</span><span class="p">(</span>
+            <span class="n">spacing</span>
+        <span class="p">)</span> <span class="o">*</span> <span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">page_list</span><span class="p">)</span> <span class="o">-</span> <span class="mi">1</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">combo_page</span> <span class="o">=</span> <span class="n">PageObject</span><span class="o">.</span><span class="n">createBlankPage</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="n">x_size</span><span class="p">,</span> <span class="n">y_size</span><span class="p">)</span>
         <span class="n">x_offset</span> <span class="o">=</span> <span class="n">x_size</span>
         <span class="n">page_list</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">page_list</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span>
@@ -600,10 +602,11 @@ <h2>Code<a class="headerlink" href="#code" title="Permalink to this headline">¶
 <span class="k">def</span> <span class="nf">fetch_images</span><span class="p">(</span>
     <span class="n">images</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Image</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
     <span class="n">image_sources</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-    <span class="n">image_paths</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span>
+    <span class="n">image_paths</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Image</span><span class="p">],</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]]:</span>
     <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    Imports images from a list of source directories.</span>
+<span class="sd">    Import images from a list of source directories.</span>
+
 <span class="sd">    If `images` and `image_sources` are `None` new dictionaries are created;</span>
 <span class="sd">    otherwise, pre-existing such dictionaries are expected.</span>
 
@@ -626,21 +629,19 @@ <h2>Code<a class="headerlink" href="#code" title="Permalink to this headline">¶
             <span class="k">for</span> <span class="n">file</span> <span class="ow">in</span> <span class="n">listing</span><span class="p">:</span>
                 <span class="n">file_split</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">splitext</span><span class="p">(</span><span class="n">file</span><span class="p">)</span>
                 <span class="n">file_split</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
-                <span class="k">if</span> <span class="n">file_split</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="ow">in</span> <span class="p">[</span><span class="s1">&#39;.png&#39;</span><span class="p">,</span> <span class="s1">&#39;.jpg&#39;</span><span class="p">,</span> <span class="s1">&#39;.jpeg&#39;</span><span class="p">]:</span>
+                <span class="k">if</span> <span class="n">file_split</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="ow">in</span> <span class="p">[</span><span class="s2">&quot;.png&quot;</span><span class="p">,</span> <span class="s2">&quot;.jpg&quot;</span><span class="p">,</span> <span class="s2">&quot;.jpeg&quot;</span><span class="p">]:</span>
                     <span class="n">images</span><span class="p">[</span><span class="n">file</span><span class="p">]</span> <span class="o">=</span> <span class="n">Image</span><span class="p">(</span><span class="n">filename</span><span class="o">=</span><span class="n">join</span><span class="p">(</span><span class="n">image_path</span><span class="p">,</span> <span class="n">file</span><span class="p">))</span>
-                <span class="k">elif</span> <span class="n">file_split</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">==</span> <span class="s1">&#39;.pdf&#39;</span><span class="p">:</span>
+                <span class="k">elif</span> <span class="n">file_split</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">==</span> <span class="s2">&quot;.pdf&quot;</span><span class="p">:</span>
                     <span class="n">images</span><span class="p">[</span><span class="n">file</span><span class="p">]</span> <span class="o">=</span> <span class="n">PdfImage</span><span class="p">(</span><span class="n">filename</span><span class="o">=</span><span class="n">join</span><span class="p">(</span><span class="n">image_path</span><span class="p">,</span> <span class="n">file</span><span class="p">))</span>
             <span class="n">image_sources</span><span class="o">.</span><span class="n">update</span><span class="p">({</span><span class="n">key</span><span class="p">:</span> <span class="n">image_path</span> <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">listing</span><span class="p">})</span>
     <span class="k">return</span> <span class="p">(</span><span class="n">images</span><span class="p">,</span> <span class="n">image_sources</span><span class="p">)</span>
 
 
 <span class="k">def</span> <span class="nf">resize</span><span class="p">(</span>
-    <span class="n">image</span><span class="p">:</span> <span class="n">Image</span><span class="p">,</span>
-    <span class="n">width</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-    <span class="n">height</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>
+    <span class="n">image</span><span class="p">:</span> <span class="n">Image</span><span class="p">,</span> <span class="n">width</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">height</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Image</span><span class="p">:</span>
     <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    Modify an :mod:`Image &lt;IPython image&gt;` size</span>
+<span class="sd">    Modify an :mod:`Image &lt;IPython image&gt;` size.</span>
 
 <span class="sd">    Returns:</span>
 <span class="sd">        image: resized image object</span>
diff --git a/docs/modules/initialize.html b/docs/modules/initialize.html
index 54020ec..a76f00b 100644
--- a/docs/modules/initialize.html
+++ b/docs/modules/initialize.html
@@ -137,7 +137,7 @@ <h2>Code<a class="headerlink" href="#code" title="Permalink to this headline">¶
     <span class="k">return</span> <span class="kc">True</span>
 
 
-<span class="n">is_python</span> <span class="o">=</span> <span class="n">check_is_ipython</span><span class="p">()</span>
+<span class="n">is_python</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="n">check_is_ipython</span><span class="p">()</span>
 
 <span class="k">if</span> <span class="n">is_python</span><span class="p">:</span>
     <span class="k">try</span><span class="p">:</span>
diff --git a/docs/modules/parameters.html b/docs/modules/parameters.html
index 6566bb4..cf9ee55 100644
--- a/docs/modules/parameters.html
+++ b/docs/modules/parameters.html
@@ -97,7 +97,7 @@ <h3>Navigation</h3>
 
 <dl class="py class">
 <dt class="sig sig-object py" id="gmplib.parameters.ParametersNestedGroup">
-<em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">gmplib.parameters.</span></span><span class="sig-name descname"><span class="pre">ParametersNestedGroup</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">parent</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Any</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">group_name</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">parameters_dict</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Dict</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">evaluations</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">Dict</span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#gmplib.parameters.ParametersNestedGroup" title="Permalink to this definition">¶</a></dt>
+<em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">gmplib.parameters.</span></span><span class="sig-name descname"><span class="pre">ParametersNestedGroup</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">parent</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference internal" href="#gmplib.parameters.Parameters" title="gmplib.parameters.Parameters"><span class="pre">gmplib.parameters.Parameters</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">group_name</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">parameters_dict</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Dict</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">evaluations</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">Dict</span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#gmplib.parameters.ParametersNestedGroup" title="Permalink to this definition">¶</a></dt>
 <dd><p>Provide a job <cite>ParametersNestedGroup</cite>  sub-container.</p>
 <p>Convert items in a parameters sub-dictionary into class attributes,
 setting the attribute name to the dict item’s key and the
@@ -122,7 +122,7 @@ <h3>Navigation</h3>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="gmplib.parameters.ParametersNestedGroup.__init__">
-<span class="sig-name descname"><span class="pre">__init__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">parent</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Any</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">group_name</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">parameters_dict</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Dict</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">evaluations</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">Dict</span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> &#x2192; <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.10)"><span class="pre">None</span></a><a class="headerlink" href="#gmplib.parameters.ParametersNestedGroup.__init__" title="Permalink to this definition">¶</a></dt>
+<span class="sig-name descname"><span class="pre">__init__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">parent</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference internal" href="#gmplib.parameters.Parameters" title="gmplib.parameters.Parameters"><span class="pre">gmplib.parameters.Parameters</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">group_name</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">parameters_dict</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Dict</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">evaluations</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">Dict</span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> &#x2192; <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.10)"><span class="pre">None</span></a><a class="headerlink" href="#gmplib.parameters.ParametersNestedGroup.__init__" title="Permalink to this definition">¶</a></dt>
 <dd><p>Initialize.</p>
 </dd></dl>
 
@@ -360,7 +360,7 @@ <h2>Code<a class="headerlink" href="#code" title="Permalink to this headline">¶
 
     <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
         <span class="bp">self</span><span class="p">,</span>
-        <span class="n">parent</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+        <span class="n">parent</span><span class="p">:</span> <span class="n">Parameters</span><span class="p">,</span>
         <span class="n">group_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
         <span class="n">parameters_dict</span><span class="p">:</span> <span class="n">Dict</span><span class="p">,</span>
         <span class="n">evaluations</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
diff --git a/docs/modules/plot.html b/docs/modules/plot.html
index 0df9be3..3c831c8 100644
--- a/docs/modules/plot.html
+++ b/docs/modules/plot.html
@@ -284,7 +284,7 @@ <h2>Code<a class="headerlink" href="#code" title="Permalink to this headline">¶
 <span class="kn">import</span> <span class="nn">logging</span>
 <span class="kn">from</span> <span class="nn">itertools</span> <span class="kn">import</span> <span class="n">cycle</span>
 <span class="kn">import</span> <span class="nn">operator</span> <span class="k">as</span> <span class="nn">op</span>
-<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span><span class="p">,</span> <span class="n">Any</span><span class="p">,</span> <span class="n">Tuple</span><span class="p">,</span> <span class="n">Optional</span><span class="p">,</span> <span class="n">List</span>  <span class="c1"># ,  Callable</span>
+<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span><span class="p">,</span> <span class="n">Any</span><span class="p">,</span> <span class="n">Tuple</span><span class="p">,</span> <span class="n">Optional</span><span class="p">,</span> <span class="n">List</span><span class="p">,</span> <span class="n">Callable</span><span class="p">,</span> <span class="n">Iterable</span><span class="p">,</span> <span class="n">Sized</span>
 
 <span class="c1"># MatPlotLib</span>
 <span class="kn">import</span> <span class="nn">matplotlib</span> <span class="k">as</span> <span class="nn">mpl</span>
@@ -333,22 +333,38 @@ <h2>Code<a class="headerlink" href="#code" title="Permalink to this headline">¶
 <span class="sd">            return i^th marker</span>
 <span class="sd">    &quot;&quot;&quot;</span>
 
+    <span class="n">dpi</span><span class="p">:</span> <span class="nb">int</span>
+    <span class="n">font_size</span><span class="p">:</span> <span class="nb">int</span>
+    <span class="n">fdict</span><span class="p">:</span> <span class="n">Dict</span>
+    <span class="n">colors</span><span class="p">:</span> <span class="n">Callable</span>
+    <span class="n">n_colors</span><span class="p">:</span> <span class="nb">int</span>
+    <span class="n">color_cycle</span><span class="p">:</span> <span class="n">Callable</span>
+    <span class="n">markers</span><span class="p">:</span> <span class="n">Tuple</span>
+    <span class="n">n_markers</span><span class="p">:</span> <span class="nb">int</span>
+    <span class="n">marker_cycle</span><span class="p">:</span> <span class="n">cycle</span>
+    <span class="n">linestyle_list</span><span class="p">:</span> <span class="n">Tuple</span>
+    <span class="n">color</span><span class="p">:</span> <span class="n">Callable</span>
+    <span class="n">marker</span><span class="p">:</span> <span class="n">Callable</span>
+    <span class="n">font_family</span><span class="p">:</span> <span class="nb">str</span>
+
     <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">dpi</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">100</span><span class="p">,</span> <span class="n">font_size</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">11</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
         <span class="sd">&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">dpi</span> <span class="o">=</span> <span class="n">dpi</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">font_size</span> <span class="o">=</span> <span class="n">font_size</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">fdict</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="n">Any</span><span class="p">,</span> <span class="n">Any</span><span class="p">]</span> <span class="o">=</span> <span class="p">{}</span>
         <span class="n">prop_cycle</span> <span class="o">=</span> <span class="n">plt</span><span class="o">.</span><span class="n">rcParams</span><span class="p">[</span><span class="s2">&quot;axes.prop_cycle&quot;</span><span class="p">]</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">colors</span> <span class="o">=</span> <span class="n">prop_cycle</span><span class="o">.</span><span class="n">by_key</span><span class="p">()[</span><span class="s2">&quot;color&quot;</span><span class="p">]</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">n_colors</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">colors</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">color_cycle</span> <span class="o">=</span> <span class="n">cycle</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">colors</span><span class="p">)</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">colors</span> <span class="o">=</span> <span class="n">prop_cycle</span><span class="o">.</span><span class="n">by_key</span><span class="p">()[</span><span class="s2">&quot;color&quot;</span><span class="p">]</span>  <span class="c1"># type: ignore</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">n_colors</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">colors</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">color_cycle</span> <span class="o">=</span> <span class="n">cycle</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">colors</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">markers</span> <span class="o">=</span> <span class="p">(</span><span class="s2">&quot;o&quot;</span><span class="p">,</span> <span class="s2">&quot;s&quot;</span><span class="p">,</span> <span class="s2">&quot;v&quot;</span><span class="p">,</span> <span class="s2">&quot;p&quot;</span><span class="p">,</span> <span class="s2">&quot;*&quot;</span><span class="p">,</span> <span class="s2">&quot;D&quot;</span><span class="p">,</span> <span class="s2">&quot;X&quot;</span><span class="p">,</span> <span class="s2">&quot;^&quot;</span><span class="p">,</span> <span class="s2">&quot;h&quot;</span><span class="p">,</span> <span class="s2">&quot;P&quot;</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">n_markers</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">markers</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">marker_cycle</span> <span class="o">=</span> <span class="n">cycle</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">markers</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">linestyle_list</span> <span class="o">=</span> <span class="p">(</span><span class="s2">&quot;solid&quot;</span><span class="p">,</span> <span class="s2">&quot;dashdot&quot;</span><span class="p">,</span> <span class="s2">&quot;dashed&quot;</span><span class="p">,</span> <span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="p">(</span><span class="mi">3</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">)))</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">color</span> <span class="o">=</span> <span class="k">lambda</span> <span class="n">i_</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">colors</span><span class="p">[</span><span class="n">i_</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="n">n_colors</span><span class="p">]</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">marker</span> <span class="o">=</span> <span class="k">lambda</span> <span class="n">i_</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">markers</span><span class="p">[</span><span class="n">i_</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="n">n_markers</span><span class="p">]</span>
+        <span class="n">color_</span> <span class="o">=</span> <span class="k">lambda</span> <span class="n">i_</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">colors</span><span class="p">[</span><span class="n">i_</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="n">n_colors</span><span class="p">]</span>  <span class="c1"># type: ignore</span>
+        <span class="n">marker_</span> <span class="o">=</span> <span class="k">lambda</span> <span class="n">i_</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">markers</span><span class="p">[</span><span class="n">i_</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="n">n_markers</span><span class="p">]</span>  <span class="c1"># type: ignore</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">color</span> <span class="o">=</span> <span class="n">color_</span>  <span class="c1"># type: ignore</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">marker</span> <span class="o">=</span> <span class="n">marker_</span>  <span class="c1"># type: ignore</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">font_family</span> <span class="o">=</span> <span class="s2">&quot;Arial&quot;</span> <span class="k">if</span> <span class="s2">&quot;Arial&quot;</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_fonts</span><span class="p">()</span> <span class="k">else</span> <span class="s2">&quot;&quot;</span>
         <span class="n">mpl</span><span class="o">.</span><span class="n">rc</span><span class="p">(</span><span class="s2">&quot;font&quot;</span><span class="p">,</span> <span class="n">size</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">font_size</span><span class="p">,</span> <span class="n">family</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">font_family</span><span class="p">)</span>
 
diff --git a/docs/modules/utils.html b/docs/modules/utils.html
index 7dd93a3..0040993 100644
--- a/docs/modules/utils.html
+++ b/docs/modules/utils.html
@@ -152,7 +152,7 @@ <h3>Navigation</h3>
 
 <dl class="py function">
 <dt class="sig sig-object py" id="gmplib.utils.get_pkg_path">
-<span class="sig-prename descclassname"><span class="pre">gmplib.utils.</span></span><span class="sig-name descname"><span class="pre">get_pkg_path</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">pkg</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Any</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subpkg</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">''</span></span></em><span class="sig-paren">)</span> &#x2192; <a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><a class="headerlink" href="#gmplib.utils.get_pkg_path" title="Permalink to this definition">¶</a></dt>
+<span class="sig-prename descclassname"><span class="pre">gmplib.utils.</span></span><span class="sig-name descname"><span class="pre">get_pkg_path</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">pkg</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">modulefinder.Module</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subpkg</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">''</span></span></em><span class="sig-paren">)</span> &#x2192; <a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.10)"><span class="pre">str</span></a><a class="headerlink" href="#gmplib.utils.get_pkg_path" title="Permalink to this definition">¶</a></dt>
 <dd><p>Find the file path to a given package folder.</p>
 <p>If ‘subpkg’ is given, return the sub-package path.</p>
 <dl class="field-list simple">
@@ -243,6 +243,7 @@ <h2>Code<a class="headerlink" href="#code" title="Permalink to this headline">¶
 <span class="c1"># pylint: disable=import-error, import-outside-toplevel</span>
 
 <span class="c1"># Library</span>
+<span class="kn">from</span> <span class="nn">modulefinder</span> <span class="kn">import</span> <span class="n">Module</span>
 <span class="kn">import</span> <span class="nn">warnings</span>
 <span class="kn">import</span> <span class="nn">logging</span>
 <span class="kn">import</span> <span class="nn">os</span>
@@ -294,7 +295,7 @@ <h2>Code<a class="headerlink" href="#code" title="Permalink to this headline">¶
         <span class="sd">&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
 
 
-<span class="k">def</span> <span class="nf">get_pkg_path</span><span class="p">(</span><span class="n">pkg</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span> <span class="n">subpkg</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
+<span class="k">def</span> <span class="nf">get_pkg_path</span><span class="p">(</span><span class="n">pkg</span><span class="p">:</span> <span class="n">Module</span><span class="p">,</span> <span class="n">subpkg</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;&quot;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
     <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Find the file path to a given package folder.</span>
 
@@ -309,7 +310,7 @@ <h2>Code<a class="headerlink" href="#code" title="Permalink to this headline">¶
 <span class="sd">    Returns:</span>
 <span class="sd">        str: Path to (sub)package</span>
 <span class="sd">    &quot;&quot;&quot;</span>
-    <span class="k">return</span> <span class="n">realpath</span><span class="p">(</span><span class="n">join</span><span class="p">(</span><span class="n">pkg</span><span class="o">.</span><span class="n">__path__</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="s2">&quot;..&quot;</span><span class="p">,</span> <span class="s2">&quot;..&quot;</span><span class="p">,</span> <span class="n">subpkg</span><span class="p">))</span>
+    <span class="k">return</span> <span class="n">realpath</span><span class="p">(</span><span class="n">join</span><span class="p">(</span><span class="n">pkg</span><span class="o">.</span><span class="n">__path__</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="s2">&quot;..&quot;</span><span class="p">,</span> <span class="s2">&quot;..&quot;</span><span class="p">,</span> <span class="n">subpkg</span><span class="p">))</span>  <span class="c1"># type: ignore</span>
 
 
 <span class="k">def</span> <span class="nf">is_jsonable</span><span class="p">(</span><span class="n">item</span><span class="p">:</span> <span class="n">Any</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
diff --git a/docs/searchindex.js b/docs/searchindex.js
index 00618bf..cc7b0b2 100644
--- a/docs/searchindex.js
+++ b/docs/searchindex.js
@@ -1 +1 @@
-Search.setIndex({docnames:["index","modules/image","modules/initialize","modules/parameters","modules/plot","modules/save","modules/utils"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":3,"sphinx.domains.rst":2,"sphinx.domains.std":2,"sphinx.ext.intersphinx":1,"sphinx.ext.todo":2,sphinx:56},filenames:["index.rst","modules/image.rst","modules/initialize.rst","modules/parameters.rst","modules/plot.rst","modules/save.rst","modules/utils.rst"],objects:{"gmplib.image":{combine_images:[1,1,1,""],combine_pdf_images:[1,1,1,""],combine_pdf_images_horizontally:[1,1,1,""],combine_pdf_images_vertically:[1,1,1,""],combine_raster_images:[1,1,1,""],combine_raster_images_horizontally:[1,1,1,""],combine_raster_images_vertically:[1,1,1,""],fetch_images:[1,3,1,""],resize:[1,3,1,""]},"gmplib.image.combine_images":{__init__:[1,2,1,""],get_images:[1,2,1,""],paste_images:[1,2,1,""],save_combo_image:[1,2,1,""]},"gmplib.image.combine_pdf_images":{get_images:[1,2,1,""],save_combo_image:[1,2,1,""]},"gmplib.image.combine_pdf_images_horizontally":{paste_images:[1,2,1,""]},"gmplib.image.combine_pdf_images_vertically":{paste_images:[1,2,1,""]},"gmplib.image.combine_raster_images":{get_images:[1,2,1,""],save_combo_image:[1,2,1,""]},"gmplib.image.combine_raster_images_horizontally":{paste_images:[1,2,1,""]},"gmplib.image.combine_raster_images_vertically":{paste_images:[1,2,1,""]},"gmplib.initialize":{check_is_ipython:[2,3,1,""]},"gmplib.parameters":{Parameters:[3,1,1,""],ParametersNestedGroup:[3,1,1,""],import_parameters:[3,3,1,""],read_json_file:[3,3,1,""]},"gmplib.parameters.Parameters":{__init__:[3,2,1,""],various:[3,4,1,""]},"gmplib.parameters.ParametersNestedGroup":{__init__:[3,2,1,""],various:[3,4,1,""]},"gmplib.plot":{GraphingBase:[4,1,1,""]},"gmplib.plot.GraphingBase":{__init__:[4,2,1,""],color:[4,4,1,""],color_cycle:[4,4,1,""],colors:[4,4,1,""],create_figure:[4,2,1,""],dpi:[4,4,1,""],fdict:[4,4,1,""],font_size:[4,4,1,""],get_aspect:[4,2,1,""],get_fonts:[4,2,1,""],linestyle_list:[4,4,1,""],marker:[4,4,1,""],marker_cycle:[4,4,1,""],markers:[4,4,1,""],n_colors:[4,4,1,""],n_markers:[4,4,1,""],naturalize:[4,2,1,""],stretch:[4,2,1,""]},"gmplib.save":{create_dir:[5,3,1,""],create_directories:[5,3,1,""],export_plot:[5,3,1,""],export_plots:[5,3,1,""],export_results:[5,3,1,""]},"gmplib.utils":{ResultsContainer:[6,1,1,""],convert:[6,3,1,""],dict2mat:[6,3,1,""],e2d:[6,3,1,""],export_results:[6,3,1,""],get_pkg_path:[6,3,1,""],gmround:[6,3,1,""],is_jsonable:[6,3,1,""],numify:[6,3,1,""],omitdict:[6,3,1,""]},"gmplib.utils.ResultsContainer":{__init__:[6,2,1,""]},gmplib:{image:[1,0,0,"-"],initialize:[2,0,0,"-"],parameters:[3,0,0,"-"],plot:[4,0,0,"-"],save:[5,0,0,"-"],utils:[6,0,0,"-"]}},objnames:{"0":["py","module","Python module"],"1":["py","class","Python class"],"2":["py","method","Python method"],"3":["py","function","Python function"],"4":["py","attribute","Python attribute"]},objtypes:{"0":"py:module","1":"py:class","2":"py:method","3":"py:function","4":"py:attribute"},terms:{"0":[1,3,4,5,6],"02":4,"03":4,"05":5,"1":[1,3,4,5,6],"100":4,"11":4,"2":[2,4],"20":1,"255":1,"3":4,"4":[3,6],"5":4,"8":4,"abstract":[1,6],"break":4,"case":2,"class":[1,3,4,6],"default":[3,4,6],"do":[3,6],"export":[0,5,6],"float":[1,4,5,6],"function":1,"import":[1,2,3,4,5,6],"int":[1,4,5,6],"new":1,"return":[1,2,3,4,5,6],"throw":5,"true":[2,4,6],"try":[2,4,5,6],For:3,If:[1,3,6],It:2,The:[0,1,2,3],_:[2,4,5,6],__all__:[1,3,4,5,6],__dict__:6,__init__:[1,3,4,6],__path__:6,__post_init__:4,_autoreload:2,_ax:4,_ipython:2,_jupyt:2,_matplotlib:2,abc:[1,6],abstractmethod:[1,6],access:0,actual:1,add:[3,6],addit:5,addpag:1,adj:6,adjfloat:6,adjoint:[1,6],adjust:4,aimport:2,align:1,all:[1,3,4,5],allow:[1,3,6],along:1,alreadi:5,also:6,an:[1,2,3,5,6],analysi:6,ani:[1,3,4,6],appear:1,append:[1,4,5,6],approx_rh:6,ar:[1,2,3,5],arg:[1,3,4,5,6],arial:4,arrai:6,arrow:4,aspect:4,aspect_ratio:4,assign:3,attempt:6,attr:3,attribut:[3,4,6],attribute_valu:6,attribute_value_copi:6,attribute_value_dict:6,attributeerror:2,auto:5,automat:2,autoreload:2,avail:[2,4],ax:4,axi:4,backend:2,base:4,basic:0,bbox_inch:5,becaus:[1,2,4,6],been:2,befor:3,benign:2,better:3,between:1,bool:[1,6],both:6,bound:4,build:3,by_kei:4,c:4,callabl:4,can:[0,3,6],cannot:5,cf:6,chang:2,check:[2,3,6],check_is_ipython:2,choos:4,clean:3,cleaner:1,clear:1,close:1,code:0,color:4,color_cycl:4,combin:1,combine_imag:1,combine_pdf_imag:1,combine_pdf_images_horizont:1,combine_pdf_images_vert:1,combine_raster_imag:1,combine_raster_images_horizont:1,combine_raster_images_vert:1,combo_imag:1,combo_pag:1,combo_path:1,command:2,config:2,configur:2,constitu:2,constructor:1,contain:[3,6],continu:2,convers:5,convert:[3,5,6],convert_to:6,copi:[1,3,6],core:[1,6],covector_fishbon:4,covector_fishbone_vert:4,cover:2,creat:[1,3,4,5],create_dir:5,create_directori:5,create_figur:4,createblankpag:1,current:2,custom:4,cycl:4,d:4,d_norm:4,darkblu:4,dash:4,dashdot:4,data:[4,6],data_ratio:4,dataclass:[3,4],debug:[3,4,6],decim:[1,6],deepcopi:6,def:[1,2,3,4,5,6],default_factori:4,del:6,demo:5,dens:6,depend:3,destin:3,dict2mat:6,dict:[1,3,4,5,6],dict_:6,dictionari:[1,3,4,5,6],dictonari:6,dimens:6,dir:5,dir_:5,directli:0,directori:[1,5,6],dirpath:3,disabl:[1,2,6],discuss:1,disp_ratio:4,displai:[1,2,4],do_align_right:1,do_dolfin_adjoint:6,do_flip:6,do_neg:6,do_pars:6,do_raw:6,doe:3,doesn:[1,3,5],dolfin:[1,6],done:3,dpi:[4,5],dpi_:4,dump:[5,6],dx:4,dx_per_tick:4,dy:4,dy_per_tick:4,e2d:6,e:6,each:[3,4],ec:4,either:3,elif:[1,6],els:[1,3,4,5,6],en:2,enabl:2,encod:[3,5,6],ensur:[3,5],entri:5,enumer:1,environ:2,eq:[4,6],eqn:6,eqn_:6,eqn_dict:6,eqn_or_eqn:6,equal:6,equat:6,error:[1,2,6],etc:[2,3,6],eval:3,evalu:3,evaluations_:3,exactli:1,except:[2,4,5,6],exist:[1,3,5],expect:1,export_dict:6,export_plot:5,export_result:[5,6],extens:[2,5,6],f:[1,3,4,5,6],factor:[4,6],fail:[1,4,5,6],fals:[1,2,4,6],famili:4,family_nam:4,fdict:4,fenic:[1,6],fetch:[1,4],fetch_imag:1,field:4,fig:[4,5],fig_dict:5,fig_dict_item:5,fig_nam:[4,5],fig_name_:5,fig_siz:4,fig_size_:4,figh:4,figur:[4,5],figure_format:2,figw:4,figwh:4,file:[0,1,3,5,6],file_split:1,file_typ:[1,5],file_types_:5,filenam:[1,3,5,6],filepath:3,filterwarn:[1,3,4,5,6],find:6,findsystemfont:4,first:3,fishbone_len:4,flip_eqn:6,folder:6,follow:1,font:4,font_famili:4,font_manag:4,font_siz:4,forc:2,form:5,format:[5,6],found:6,fp:5,fpath:4,from:[1,2,3,4,5,6],frozen:4,full:4,functool:[1,6],g:6,gca:4,gener:[3,4],get:[1,4],get_aspect:4,get_figur:4,get_font:4,get_imag:1,get_ipython:2,get_pkg_path:6,get_posit:4,get_quantity_dimens:6,get_size_inch:4,get_xlim:4,get_ylim:4,getattr:[3,6],getheight:1,getpag:1,getwidth:1,given:6,gme:0,gmplib:[1,2,3,4,5,6],gmround:6,graph:[0,4],graphingbas:4,group:3,group_dict:3,group_nam:3,h:4,ha:2,handl:0,happen:3,head_length:4,head_length_:4,head_starts_at_zero:4,head_width:4,head_width_:4,height:[1,4],here:2,hierarch:6,horizont:1,how:1,html:2,http:2,i:4,i_:[1,4],ignor:[1,3,4,5,6],imag:[0,4,5],image_bundl:1,image_list:1,image_nam:1,image_path:1,image_sourc:1,immut:6,immutabledensematrix:6,import_paramet:3,imported_paramet:3,imported_parameters_:3,importerror:2,inch:4,indent:[3,6],index:0,info:[3,4,5],inherit:1,initi:[0,3,4,6],inlin:[1,2],inlinebackend:2,instanc:3,integ:6,into_filenam:1,invok:2,io:2,ipkernelapp:2,ipython:[1,2],is_json:6,is_python:2,isinst:[3,5,6],item:[3,5,6],iter:6,itertool:4,its:[2,3,4],itself:3,job:3,join:[1,3,5,6],jpeg:[1,5],jpg:1,json:[0,3,5,6],json_fil:[3,6],json_filenam:6,json_path:6,json_str:6,jsonabl:6,jupyt:2,k:6,kei:[1,3,4,5,6],kernel:2,keyerror:6,lambda:[1,4],latex:5,latin:[3,5,6],layout:[0,1],len:[1,4],length_includes_head:4,letter:6,level:3,lh:6,librari:[1,3,4,5,6],limit:6,line:4,linestyle_list:4,list:[1,3,4,5,6],listdir:[1,6],load:3,load_ext:2,log:[1,2,3,4,5,6],lower:[1,5],ls:3,lw:4,lw_:4,mac:2,made:[2,6],magic:2,make:2,make_dict:6,map:6,margin:1,marker:4,marker_cycl:4,match:3,matching_subattr:6,matplotlib:[2,4,5],matric:6,matrix:6,max:1,max_nparray_s:6,mediabox:1,mergetranslatedpag:1,method:[1,6],might:3,mkdir:5,mod:[1,2,3,4,5,6],modifi:1,modul:[0,1,2,3,4,5,6],mpl:[2,4],ms:4,mul:6,mutabledensematrix:6,n:[4,5,6],n_color:4,n_marker:4,n_tick:4,name:[1,3,4,5,6],nameerror:2,natur:4,ndarrai:6,necessari:5,need:[2,3,6],neg:4,negat:6,negate_eqn:6,none:[1,3,4,5,6],norm:4,normal:2,notebook:[1,2],np:6,npx:4,npy:4,number:[4,6],numer:6,numifi:6,numpi:6,o:4,obj:4,object:[1,3,4,5,6],omitdict:6,omitlist:6,one:[3,5],onli:3,op:4,open:[1,3,5,6],oper:[2,4],option:[1,3,4,5,6],order:4,org:2,os:[1,3,5,6],oserror:5,other:[3,5],otherwis:1,out_path:1,output:[1,5],outsid:[1,6],over:4,overhang:4,overrid:3,p:[3,4,6],p_norm:4,packag:[1,2,3,4,5,6],package_nam:2,pad:1,pad_inch:5,page:0,page_:1,page_list:1,pageobject:1,paramet:[0,1,4,5,6],parameters_dict:3,parameters_file_nam:3,parametersnestedgroup:3,parent:[2,3,5],pars:3,parse_expr:3,parseabl:6,pass:[2,4,6],past:1,paste_imag:1,path:[1,3,5,6],pathlik:[1,5,6],pdf:[1,5],pdf_path:1,pdf_reader:1,pdffileread:1,pdffilewrit:1,pdfimag:1,per:3,perhap:6,physic:6,pil:1,pixel:1,pkg:6,place:6,plot:[0,5],plt:4,png:[1,5],point:6,pop:3,possibl:[2,4,5],pp:3,pprint:3,pragma:2,pre:1,prepar:2,prettyprint:3,previou:3,princip:0,print:[2,5,6],prior:5,process:[1,2],progress:2,prop_cycl:4,properti:4,provid:[0,3,4,6],px:4,pylint:[1,6],pypdf2:1,pyplot:[4,5],python:[1,3,4,5,6],qtconsol:2,quantiti:6,quietli:5,rais:5,rang:4,raster:[1,4],ratio:4,raw_dict:5,rb:1,rc:4,rcparam:4,re:[2,4],read:[1,3],read_json_fil:3,readthedoc:2,realpath:[1,3,5,6],reduc:[1,6],ref:4,refer:[3,4],regardless:2,relat:6,reload:2,remain:[1,6],remov:6,replac:[3,6],report:2,repositori:0,repr:4,request:6,requir:[1,2,3,4,5,6],rerun:2,resiz:1,resolut:[2,4],respect:4,restart:2,result:[5,6],results_dir:[5,6],results_dir_:5,results_path:5,results_path_:5,results_to_export:6,resultscontain:6,retina:2,revers:[1,6],rgb:1,rh:6,right:1,round:6,rtn_dict_:6,run:[2,5],runtimeerror:4,s:[3,4],s_kei:3,s_valu:3,salt:2,save:1,save_combo_imag:1,savefig:5,scale:6,seamless:2,search:0,second:3,see:[3,5],self:[1,3,4,6],separ:5,sequenc:3,serial:[5,6],serializ:5,serializable_dict:5,set:[1,2,3,4],set_aspect:4,set_dpi:4,set_quantity_dimens:6,set_size_inch:4,set_xlim:4,set_ylim:4,setattr:[3,6],sf:[4,6],sf_:4,shape:4,should:3,si:6,side:6,situ:2,size:[1,4,6],skip:6,smooth:2,snapshot:1,so:3,softwar:0,solid:4,some:0,sort_kei:6,sourc:[1,3],space:1,splitext:1,stabl:2,start:3,step:3,str:[1,3,4,5,6],str_:6,streamlin:2,stretch:4,strip:6,style:4,sub:[3,4,6],sub_attribut:6,sub_attribute_valu:6,subitem:3,subpackag:6,subpkg:6,subsequ:[1,2,3],substitut:6,subtract:4,suffix:[5,6],support:0,sy:3,symbol:6,sympi:[3,5,6],sympy_pars:3,system:[4,6],t:[1,3,5],target:5,task:0,tbd:4,templat:[1,6],th:4,thei:1,them:3,thi:[0,1,2,3,6],through:3,tick_sf:4,tight:5,todo:3,togeth:1,tool:1,top:3,toplevel:[1,6],total:4,tri:5,tupl:[1,3,4,5,6],turn:3,type:[1,3,4,5,6],unavail:2,union:[1,3,5,6],unit:[4,6],unjsonable_sub_attribut:6,unknown_unit:6,unsafe_hash:4,up:2,updat:[1,3,4,5,6],us:[1,2,3,4,5,6],usual:[1,3],util:[0,1],v:4,valu:[3,5,6],var_typ:6,var_types_:6,variou:3,vertic:1,visual:4,w:[4,5,6],wai:3,wand:1,warn:[1,3,4,5,6],wb:1,we:[2,3],well:6,when:[1,2],where:1,whether:6,which:[1,4],whose:[3,6],width:[1,4],wit:3,work:1,workflow:3,write:[1,5,6],writer:1,written:6,x:[1,4],x_lim:4,x_offset:1,x_rang:4,x_size:1,x_size_:1,xs:4,y:[1,4],y_lim:4,y_offset:1,y_rang:4,y_size:1,y_size_:1,yet:3,ys:4,zero:6,zip:[1,3]},titles:["Geomorphysics Python Library (GMPLib)","<code class=\"docutils literal notranslate\"><span class=\"pre\">image.py</span></code>","<code class=\"docutils literal notranslate\"><span class=\"pre\">initialize.py</span></code>","<code class=\"docutils literal notranslate\"><span class=\"pre\">parameters.py</span></code>","<code class=\"docutils literal notranslate\"><span class=\"pre\">plot.py</span></code>","<code class=\"docutils literal notranslate\"><span class=\"pre\">save.py</span></code>","<code class=\"docutils literal notranslate\"><span class=\"pre\">utils.py</span></code>"],titleterms:{code:[1,2,3,4,5,6],geomorphys:0,gmplib:0,imag:1,indic:0,initi:2,librari:0,packag:0,paramet:3,plot:4,py:[1,2,3,4,5,6],python:0,save:5,tabl:0,util:6}})
\ No newline at end of file
+Search.setIndex({docnames:["index","modules/image","modules/initialize","modules/parameters","modules/plot","modules/save","modules/utils"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":3,"sphinx.domains.rst":2,"sphinx.domains.std":2,"sphinx.ext.intersphinx":1,"sphinx.ext.todo":2,sphinx:56},filenames:["index.rst","modules/image.rst","modules/initialize.rst","modules/parameters.rst","modules/plot.rst","modules/save.rst","modules/utils.rst"],objects:{"gmplib.image":{combine_images:[1,1,1,""],combine_pdf_images:[1,1,1,""],combine_pdf_images_horizontally:[1,1,1,""],combine_pdf_images_vertically:[1,1,1,""],combine_raster_images:[1,1,1,""],combine_raster_images_horizontally:[1,1,1,""],combine_raster_images_vertically:[1,1,1,""],fetch_images:[1,3,1,""],resize:[1,3,1,""]},"gmplib.image.combine_images":{__init__:[1,2,1,""],get_images:[1,2,1,""],paste_images:[1,2,1,""],save_combo_image:[1,2,1,""]},"gmplib.image.combine_pdf_images":{get_images:[1,2,1,""],save_combo_image:[1,2,1,""]},"gmplib.image.combine_pdf_images_horizontally":{paste_images:[1,2,1,""]},"gmplib.image.combine_pdf_images_vertically":{paste_images:[1,2,1,""]},"gmplib.image.combine_raster_images":{get_images:[1,2,1,""],save_combo_image:[1,2,1,""]},"gmplib.image.combine_raster_images_horizontally":{paste_images:[1,2,1,""]},"gmplib.image.combine_raster_images_vertically":{paste_images:[1,2,1,""]},"gmplib.initialize":{check_is_ipython:[2,3,1,""]},"gmplib.parameters":{Parameters:[3,1,1,""],ParametersNestedGroup:[3,1,1,""],import_parameters:[3,3,1,""],read_json_file:[3,3,1,""]},"gmplib.parameters.Parameters":{__init__:[3,2,1,""],various:[3,4,1,""]},"gmplib.parameters.ParametersNestedGroup":{__init__:[3,2,1,""],various:[3,4,1,""]},"gmplib.plot":{GraphingBase:[4,1,1,""]},"gmplib.plot.GraphingBase":{__init__:[4,2,1,""],color:[4,4,1,""],color_cycle:[4,4,1,""],colors:[4,4,1,""],create_figure:[4,2,1,""],dpi:[4,4,1,""],fdict:[4,4,1,""],font_size:[4,4,1,""],get_aspect:[4,2,1,""],get_fonts:[4,2,1,""],linestyle_list:[4,4,1,""],marker:[4,4,1,""],marker_cycle:[4,4,1,""],markers:[4,4,1,""],n_colors:[4,4,1,""],n_markers:[4,4,1,""],naturalize:[4,2,1,""],stretch:[4,2,1,""]},"gmplib.save":{create_dir:[5,3,1,""],create_directories:[5,3,1,""],export_plot:[5,3,1,""],export_plots:[5,3,1,""],export_results:[5,3,1,""]},"gmplib.utils":{ResultsContainer:[6,1,1,""],convert:[6,3,1,""],dict2mat:[6,3,1,""],e2d:[6,3,1,""],export_results:[6,3,1,""],get_pkg_path:[6,3,1,""],gmround:[6,3,1,""],is_jsonable:[6,3,1,""],numify:[6,3,1,""],omitdict:[6,3,1,""]},"gmplib.utils.ResultsContainer":{__init__:[6,2,1,""]},gmplib:{image:[1,0,0,"-"],initialize:[2,0,0,"-"],parameters:[3,0,0,"-"],plot:[4,0,0,"-"],save:[5,0,0,"-"],utils:[6,0,0,"-"]}},objnames:{"0":["py","module","Python module"],"1":["py","class","Python class"],"2":["py","method","Python method"],"3":["py","function","Python function"],"4":["py","attribute","Python attribute"]},objtypes:{"0":"py:module","1":"py:class","2":"py:method","3":"py:function","4":"py:attribute"},terms:{"0":[1,3,4,5,6],"02":4,"03":4,"05":5,"1":[1,3,4,5,6],"100":4,"11":4,"2":[2,4],"20":1,"255":1,"3":4,"4":[3,6],"5":4,"8":4,"abstract":[1,6],"break":4,"case":2,"class":[1,3,4,6],"default":[3,4,6],"do":[3,6],"export":[0,5,6],"float":[1,4,5,6],"function":1,"import":[1,2,3,4,5,6],"int":[1,4,5,6],"new":1,"return":[1,2,3,4,5,6],"throw":5,"true":[2,4,6],"try":[2,4,5,6],For:3,If:[1,3,6],It:2,The:[0,1,2,3],_:[2,4,5,6],__all__:[1,3,4,5,6],__dict__:6,__init__:[1,3,4,6],__path__:6,__post_init__:4,_autoreload:2,_ax:4,_ipython:2,_jupyt:2,_matplotlib:2,abc:[1,6],abstractmethod:[1,6],access:0,actual:1,add:[3,6],addit:5,addpag:1,adj:6,adjfloat:6,adjoint:[1,6],adjust:4,aimport:2,align:1,all:[1,3,4,5],allow:[1,3,6],along:1,alreadi:5,also:6,an:[1,2,3,5,6],analysi:6,ani:[1,3,4,6],appear:1,append:[1,4,5,6],approx_rh:6,ar:[1,2,3,5],arg:[1,3,4,5,6],arial:4,arrai:6,arrow:4,aspect:4,aspect_ratio:4,assign:3,attempt:6,attr:3,attribut:[3,4,6],attribute_valu:6,attribute_value_copi:6,attribute_value_dict:6,attributeerror:2,auto:5,automat:2,autoreload:2,avail:[2,4],ax:4,axi:4,backend:2,base:4,basic:0,bbox_inch:5,becaus:[1,2,4,6],been:2,befor:3,benign:2,better:3,between:1,bool:[1,2,6],both:6,bound:4,build:3,by_kei:4,c:4,callabl:4,can:[0,3,6],cannot:5,cf:6,chang:2,check:[2,3,6],check_is_ipython:2,choos:4,clean:3,cleaner:1,clear:1,close:1,code:0,color:4,color_:4,color_cycl:4,combin:1,combine_imag:1,combine_pdf_imag:1,combine_pdf_images_horizont:1,combine_pdf_images_vert:1,combine_raster_imag:1,combine_raster_images_horizont:1,combine_raster_images_vert:1,combo_imag:1,combo_pag:1,combo_path:1,command:2,config:2,configur:2,constitu:2,constructor:[],contain:[3,6],continu:2,convers:5,convert:[3,5,6],convert_to:6,copi:[1,3,6],core:[1,6],covector_fishbon:4,covector_fishbone_vert:4,cover:2,creat:[1,3,4,5],create_dir:5,create_directori:5,create_figur:4,createblankpag:1,current:2,custom:4,cycl:4,d:4,d_norm:4,darkblu:4,dash:4,dashdot:4,data:[4,6],data_ratio:4,dataclass:[3,4],debug:[3,4,6],decim:[1,6],deepcopi:6,def:[1,2,3,4,5,6],default_factori:4,definit:1,del:6,demo:5,dens:6,depend:3,destin:3,dict2mat:6,dict:[1,3,4,5,6],dict_:6,dictionari:[1,3,4,5,6],dictonari:6,dimens:6,dir:5,dir_:5,directli:0,directori:[1,5,6],dirpath:3,disabl:[1,2,6],discuss:1,disp_ratio:4,displai:[1,2,4],do_align_right:1,do_dolfin_adjoint:6,do_flip:6,do_neg:6,do_pars:6,do_raw:6,doe:3,doesn:[1,3,5],dolfin:[1,6],done:3,dpi:[4,5],dpi_:4,dump:[5,6],dx:4,dx_per_tick:4,dy:4,dy_per_tick:4,e2d:6,e:6,each:[3,4],ec:4,either:3,elif:[1,6],els:[1,3,4,5,6],en:2,enabl:2,encod:[3,5,6],ensur:[3,5],entri:5,enumer:1,environ:2,eq:[4,6],eqn:6,eqn_:6,eqn_dict:6,eqn_or_eqn:6,equal:6,equat:6,error:[1,2,6],etc:[2,3,6],eval:3,evalu:3,evaluations_:3,exactli:1,except:[2,4,5,6],exist:[1,3,5],expect:1,export_dict:6,export_plot:5,export_result:[5,6],extens:[2,5,6],f:[1,3,4,5,6],factor:[4,6],fail:[1,4,5,6],fals:[1,2,4,6],famili:4,family_nam:4,fdict:4,fenic:[1,6],fetch:[1,4],fetch_imag:1,field:4,fig:[4,5],fig_dict:5,fig_dict_item:5,fig_nam:[4,5],fig_name_:5,fig_siz:4,fig_size_:4,figh:4,figur:[4,5],figure_format:2,figw:4,figwh:4,file:[0,1,3,5,6],file_split:1,file_typ:[1,5],file_types_:5,filenam:[1,3,5,6],filepath:3,filterwarn:[1,3,4,5,6],find:6,findsystemfont:4,first:3,fishbone_len:4,flip_eqn:6,folder:6,follow:1,font:4,font_famili:4,font_manag:4,font_siz:4,forc:2,form:5,format:[5,6],found:6,fp:5,fpath:4,from:[1,2,3,4,5,6],frozen:4,full:4,functool:[1,6],g:6,gca:4,gener:[3,4],get:[1,4],get_aspect:4,get_figur:4,get_font:4,get_imag:1,get_ipython:2,get_pkg_path:6,get_posit:4,get_quantity_dimens:6,get_size_inch:4,get_xlim:4,get_ylim:4,getattr:[3,6],getheight:1,getpag:1,getwidth:1,given:6,gme:0,gmplib:[1,2,3,4,5,6],gmround:6,graph:[0,4],graphingbas:4,group:3,group_dict:3,group_nam:3,h:4,ha:2,handl:0,happen:3,head_length:4,head_length_:4,head_starts_at_zero:4,head_width:4,head_width_:4,height:[1,4],here:2,hierarch:6,horizont:1,how:1,html:2,http:2,i:4,i_:[1,4],ignor:[1,3,4,5,6],imag:[0,4,5],image_bundl:1,image_list:1,image_nam:1,image_path:1,image_sourc:1,immut:6,immutabledensematrix:6,import_paramet:3,imported_paramet:3,imported_parameters_:3,importerror:2,inch:4,indent:[3,6],index:0,info:[3,4,5],inherit:1,initi:[0,1,3,4,6],inlin:[1,2],inlinebackend:2,instanc:3,integ:6,into_filenam:1,invok:2,io:2,ipkernelapp:2,ipython:[1,2],is_json:6,is_python:2,isinst:[3,5,6],item:[3,5,6],iter:[4,6],itertool:4,its:[2,3,4],itself:3,job:3,join:[1,3,5,6],jpeg:[1,5],jpg:1,json:[0,3,5,6],json_fil:[3,6],json_filenam:6,json_path:6,json_str:6,jsonabl:6,jupyt:2,k:6,kei:[1,3,4,5,6],kernel:2,keyerror:6,lambda:[1,4],latex:5,latin:[3,5,6],layout:[0,1],len:[1,4],length_includes_head:4,letter:6,level:3,lh:6,librari:[1,3,4,5,6],limit:6,line:4,linestyle_list:4,list:[1,3,4,5,6],listdir:[1,6],load:3,load_ext:2,log:[1,2,3,4,5,6],lower:[1,5],ls:3,lw:4,lw_:4,mac:2,made:[2,6],magic:2,make:2,make_dict:6,map:6,margin:1,marker:4,marker_:4,marker_cycl:4,match:3,matching_subattr:6,matplotlib:[2,4,5],matric:6,matrix:6,max:1,max_nparray_s:6,mediabox:1,mergetranslatedpag:1,method:[1,6],might:3,mkdir:5,mod:[1,2,3,4,5,6],modifi:1,modul:[0,1,2,3,4,5,6],modulefind:6,mpl:[2,4],ms:4,mul:6,mutabledensematrix:6,n:[4,5,6],n_color:4,n_marker:4,n_tick:4,name:[1,3,4,5,6],nameerror:2,natur:4,ndarrai:6,necessari:5,need:[2,3,6],neg:4,negat:6,negate_eqn:6,none:[1,3,4,5,6],norm:4,normal:2,notebook:[1,2],np:6,npx:4,npy:4,number:[4,6],numer:6,numifi:6,numpi:6,o:4,obj:4,object:[1,3,4,5,6],omitdict:6,omitlist:6,one:[3,5],onli:3,op:4,open:[1,3,5,6],oper:[2,4],option:[1,3,4,5,6],order:4,org:2,os:[1,3,5,6],oserror:5,other:[3,5],otherwis:1,out_path:1,output:[1,5],outsid:[1,6],over:4,overhang:4,overrid:3,p:[3,4,6],p_norm:4,packag:[1,2,3,4,5,6],package_nam:2,pad:1,pad_inch:5,page:0,page_:1,page_list:1,pageobject:1,paramet:[0,1,4,5,6],parameters_dict:3,parameters_file_nam:3,parametersnestedgroup:3,parent:[2,3,5],pars:3,parse_expr:3,parseabl:6,pass:[2,4,6],past:1,paste_imag:1,path:[1,3,5,6],pathlik:[1,5,6],pdf:[1,5],pdf_path:1,pdf_reader:1,pdffileread:1,pdffilewrit:1,pdfimag:1,per:3,perhap:6,physic:6,pil:1,pixel:1,pkg:6,place:6,plot:[0,5],plt:4,png:[1,5],point:6,pop:3,possibl:[2,4,5],pp:3,pprint:3,pragma:2,pre:1,prepar:2,prettyprint:3,previou:3,princip:0,print:[2,5,6],prior:5,process:[1,2],progress:2,prop_cycl:4,properti:4,provid:[0,1,3,4,6],px:4,pylint:[1,6],pypdf2:1,pyplot:[4,5],python:[1,3,4,5,6],qtconsol:2,quantiti:6,quietli:5,rais:5,rang:4,raster:[1,4],ratio:4,raw_dict:5,rb:1,rc:4,rcparam:4,re:[2,4],read:3,read_json_fil:3,readthedoc:2,realpath:[1,3,5,6],reduc:[1,6],ref:4,refer:[3,4],regardless:2,relat:6,reload:2,remain:[1,6],remov:6,replac:[3,6],report:2,repositori:0,repr:4,request:6,requir:[1,2,3,4,5,6],rerun:2,resiz:1,resolut:[2,4],respect:4,restart:2,result:[5,6],results_dir:[5,6],results_dir_:5,results_path:5,results_path_:5,results_to_export:6,resultscontain:6,retina:2,revers:[1,6],rgb:1,rh:6,right:1,round:6,rtn_dict_:6,run:[2,5],runtimeerror:4,s:[3,4],s_kei:3,s_valu:3,salt:2,save:1,save_combo_imag:1,savefig:5,scale:6,seamless:2,search:0,second:3,see:[3,5],self:[1,3,4,6],separ:5,sequenc:3,serial:[5,6],serializ:5,serializable_dict:5,set:[1,2,3,4],set_aspect:4,set_dpi:4,set_quantity_dimens:6,set_size_inch:4,set_xlim:4,set_ylim:4,setattr:[3,6],sf:[4,6],sf_:4,shape:4,should:3,si:6,side:6,situ:2,size:[1,4,6],skip:6,smooth:2,snapshot:1,so:3,softwar:0,solid:4,some:0,sort_kei:6,sourc:[1,3],space:1,splitext:1,stabl:2,start:3,step:3,str:[1,3,4,5,6],str_:6,streamlin:2,stretch:4,strip:6,style:4,sub:[3,4,6],sub_attribut:6,sub_attribute_valu:6,subitem:3,subpackag:6,subpkg:6,subsequ:[1,2,3],substitut:6,subtract:4,suffix:[5,6],support:0,sy:3,symbol:6,sympi:[3,5,6],sympy_pars:3,system:[4,6],t:[1,3,5],target:5,task:0,tbd:4,templat:[1,6],th:4,thei:1,them:3,thi:[0,1,2,3,6],through:3,tick_sf:4,tight:5,todo:3,togeth:1,tool:1,top:3,toplevel:[1,6],total:4,tri:5,tupl:[1,3,4,5,6],turn:3,type:[1,3,4,5,6],unavail:2,union:[1,3,5,6],unit:[4,6],unjsonable_sub_attribut:6,unknown_unit:6,unsafe_hash:4,up:2,updat:[1,3,4,5,6],us:[1,2,3,4,5,6],usual:[1,3],util:[0,1],v:4,valu:[3,5,6],var_typ:6,var_types_:6,variou:3,vertic:1,visual:4,w:[4,5,6],wai:3,wand:1,warn:[1,3,4,5,6],wb:1,we:[2,3],well:6,when:[1,2],where:1,whether:6,which:[1,4],whose:[3,6],width:[1,4],wit:3,work:1,workflow:3,write:[1,5,6],writer:1,written:6,x:[1,4],x_lim:4,x_offset:1,x_rang:4,x_size:1,x_size_:1,xs:4,y:[1,4],y_lim:4,y_offset:1,y_rang:4,y_size:1,y_size_:1,yet:3,ys:4,zero:6,zip:[1,3]},titles:["Geomorphysics Python Library (GMPLib)","<code class=\"docutils literal notranslate\"><span class=\"pre\">image.py</span></code>","<code class=\"docutils literal notranslate\"><span class=\"pre\">initialize.py</span></code>","<code class=\"docutils literal notranslate\"><span class=\"pre\">parameters.py</span></code>","<code class=\"docutils literal notranslate\"><span class=\"pre\">plot.py</span></code>","<code class=\"docutils literal notranslate\"><span class=\"pre\">save.py</span></code>","<code class=\"docutils literal notranslate\"><span class=\"pre\">utils.py</span></code>"],titleterms:{code:[1,2,3,4,5,6],geomorphys:0,gmplib:0,imag:1,indic:0,initi:2,librari:0,packag:0,paramet:3,plot:4,py:[1,2,3,4,5,6],python:0,save:5,tabl:0,util:6}})
\ No newline at end of file