Skip to content

Commit bbf14af

Browse files
author
sdemarch
committed
Update API docs from pynever
1 parent 61ce3cb commit bbf14af

21 files changed

+317
-56
lines changed

pynever/API/0_Networks.html

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@
2020
<link rel="index" title="Index" href="../genindex.html" />
2121
<link rel="search" title="Search" href="../search.html" />
2222
<link rel="next" title="Nodes" href="1_Nodes.html" />
23-
<link rel="prev" title="Installation and Setup" href="../Setup/setup.html" />
23+
<link rel="prev" title="Verification" href="../Guide/usage.html" />
2424
</head>
2525

2626
<body class="wy-body-for-nav">
@@ -42,10 +42,14 @@
4242
</form>
4343
</div>
4444
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
45-
<p class="caption" role="heading"><span class="caption-text">Setup</span></p>
45+
<p class="caption" role="heading"><span class="caption-text">Getting started</span></p>
4646
<ul>
4747
<li class="toctree-l1"><a class="reference internal" href="../Setup/setup.html">Installation and Setup</a></li>
4848
</ul>
49+
<p class="caption" role="heading"><span class="caption-text">Usage</span></p>
50+
<ul>
51+
<li class="toctree-l1"><a class="reference internal" href="../Guide/usage.html">Verification</a></li>
52+
</ul>
4953
<p class="caption" role="heading"><span class="caption-text">API Documentation</span></p>
5054
<ul class="current">
5155
<li class="toctree-l1 current"><a class="current reference internal" href="#">Networks</a><ul>
@@ -616,7 +620,7 @@
616620
</div>
617621
</div>
618622
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
619-
<a href="../Setup/setup.html" class="btn btn-neutral float-left" title="Installation and Setup" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
623+
<a href="../Guide/usage.html" class="btn btn-neutral float-left" title="Verification" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
620624
<a href="1_Nodes.html" class="btn btn-neutral float-right" title="Nodes" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
621625
</div>
622626

pynever/API/1_Nodes.html

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,10 +42,14 @@
4242
</form>
4343
</div>
4444
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
45-
<p class="caption" role="heading"><span class="caption-text">Setup</span></p>
45+
<p class="caption" role="heading"><span class="caption-text">Getting started</span></p>
4646
<ul>
4747
<li class="toctree-l1"><a class="reference internal" href="../Setup/setup.html">Installation and Setup</a></li>
4848
</ul>
49+
<p class="caption" role="heading"><span class="caption-text">Usage</span></p>
50+
<ul>
51+
<li class="toctree-l1"><a class="reference internal" href="../Guide/usage.html">Verification</a></li>
52+
</ul>
4953
<p class="caption" role="heading"><span class="caption-text">API Documentation</span></p>
5054
<ul class="current">
5155
<li class="toctree-l1"><a class="reference internal" href="0_Networks.html">Networks</a></li>

pynever/API/2_Training.html

Lines changed: 11 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -42,23 +42,25 @@
4242
</form>
4343
</div>
4444
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
45-
<p class="caption" role="heading"><span class="caption-text">Setup</span></p>
45+
<p class="caption" role="heading"><span class="caption-text">Getting started</span></p>
4646
<ul>
4747
<li class="toctree-l1"><a class="reference internal" href="../Setup/setup.html">Installation and Setup</a></li>
4848
</ul>
49+
<p class="caption" role="heading"><span class="caption-text">Usage</span></p>
50+
<ul>
51+
<li class="toctree-l1"><a class="reference internal" href="../Guide/usage.html">Verification</a></li>
52+
</ul>
4953
<p class="caption" role="heading"><span class="caption-text">API Documentation</span></p>
5054
<ul class="current">
5155
<li class="toctree-l1"><a class="reference internal" href="0_Networks.html">Networks</a></li>
5256
<li class="toctree-l1"><a class="reference internal" href="1_Nodes.html">Nodes</a></li>
5357
<li class="toctree-l1 current"><a class="current reference internal" href="#">Training</a><ul>
5458
<li class="toctree-l2"><a class="reference internal" href="#pynever.strategies.training.TrainingStrategy"><code class="docutils literal notranslate"><span class="pre">TrainingStrategy</span></code></a><ul>
5559
<li class="toctree-l3"><a class="reference internal" href="#pynever.strategies.training.TrainingStrategy.train"><code class="docutils literal notranslate"><span class="pre">TrainingStrategy.train()</span></code></a></li>
56-
<li class="toctree-l3"><a class="reference internal" href="#id0"><code class="docutils literal notranslate"><span class="pre">TrainingStrategy.train()</span></code></a></li>
5760
</ul>
5861
</li>
5962
<li class="toctree-l2"><a class="reference internal" href="#pynever.strategies.training.TestingStrategy"><code class="docutils literal notranslate"><span class="pre">TestingStrategy</span></code></a><ul>
6063
<li class="toctree-l3"><a class="reference internal" href="#pynever.strategies.training.TestingStrategy.test"><code class="docutils literal notranslate"><span class="pre">TestingStrategy.test()</span></code></a></li>
61-
<li class="toctree-l3"><a class="reference internal" href="#id1"><code class="docutils literal notranslate"><span class="pre">TestingStrategy.test()</span></code></a></li>
6264
</ul>
6365
</li>
6466
<li class="toctree-l2"><a class="reference internal" href="#pynever.strategies.training.PytorchTraining"><code class="docutils literal notranslate"><span class="pre">PytorchTraining</span></code></a><ul>
@@ -119,20 +121,17 @@
119121

120122
<section id="module-pynever.strategies.training">
121123
<span id="training"></span><h1>Training<a class="headerlink" href="#module-pynever.strategies.training" title="Link to this heading"></a></h1>
124+
<p>This module contains the classes to train neural networks. It follows the Strategy design pattern providing the abstract
125+
interfaces <code class="docutils literal notranslate"><span class="pre">TrainingStrategy</span></code> and <code class="docutils literal notranslate"><span class="pre">TestingStrategy</span></code>.
126+
At the moment, we provide only a single training and testing strategy using PyTorch.</p>
122127
<dl class="py class">
123128
<dt class="sig sig-object py" id="pynever.strategies.training.TrainingStrategy">
124129
<em class="property"><span class="k"><span class="pre">class</span></span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">pynever.strategies.training.</span></span><span class="sig-name descname"><span class="pre">TrainingStrategy</span></span><a class="reference internal" href="../_modules/pynever/strategies/training.html#TrainingStrategy"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#pynever.strategies.training.TrainingStrategy" title="Link to this definition"></a></dt>
125130
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">ABC</span></code></p>
126131
<p>An abstract class used to represent a Training Strategy.</p>
127132
<dl class="py method">
128133
<dt class="sig sig-object py" id="pynever.strategies.training.TrainingStrategy.train">
129-
<span class="sig-name descname"><span class="pre">train</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">NeuralNetwork</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">Dataset</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/pynever/strategies/training.html#TrainingStrategy.train"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#pynever.strategies.training.TrainingStrategy.train" title="Link to this definition"></a></dt>
130-
<dd><p>Train the neural network of interest using a training strategy determined in the concrete children.</p>
131-
</dd></dl>
132-
133-
<dl class="py method">
134-
<dt class="sig sig-object py" id="id0">
135-
<em class="property"><span class="k"><span class="pre">abstractmethod</span></span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">train</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">network</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dataset</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/pynever/strategies/training.html#TrainingStrategy.train"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#id0" title="Link to this definition"></a></dt>
134+
<em class="property"><span class="k"><span class="pre">abstractmethod</span></span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">train</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">network</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dataset</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/pynever/strategies/training.html#TrainingStrategy.train"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#pynever.strategies.training.TrainingStrategy.train" title="Link to this definition"></a></dt>
136135
<dd><p>Train the neural network of interest using a testing strategy determined in the concrete children.</p>
137136
<dl class="field-list simple">
138137
<dt class="field-odd">Parameters<span class="colon">:</span></dt>
@@ -160,13 +159,7 @@
160159
<p>An abstract class used to represent a Testing Strategy.</p>
161160
<dl class="py method">
162161
<dt class="sig sig-object py" id="pynever.strategies.training.TestingStrategy.test">
163-
<span class="sig-name descname"><span class="pre">test</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">NeuralNetwork</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">Dataset</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/pynever/strategies/training.html#TestingStrategy.test"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#pynever.strategies.training.TestingStrategy.test" title="Link to this definition"></a></dt>
164-
<dd><p>Test the neural network of interest using a testing strategy determined in the concrete children.</p>
165-
</dd></dl>
166-
167-
<dl class="py method">
168-
<dt class="sig sig-object py" id="id1">
169-
<em class="property"><span class="k"><span class="pre">abstractmethod</span></span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">test</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">network</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dataset</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/pynever/strategies/training.html#TestingStrategy.test"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#id1" title="Link to this definition"></a></dt>
162+
<em class="property"><span class="k"><span class="pre">abstractmethod</span></span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">test</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">network</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dataset</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/pynever/strategies/training.html#TestingStrategy.test"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#pynever.strategies.training.TestingStrategy.test" title="Link to this definition"></a></dt>
170163
<dd><p>Test the neural network of interest using a testing strategy determined in the concrete children.</p>
171164
<dl class="field-list simple">
172165
<dt class="field-odd">Parameters<span class="colon">:</span></dt>
@@ -220,7 +213,7 @@
220213
<dt class="sig sig-object py" id="pynever.strategies.training.PytorchTraining.loss_function">
221214
<span class="sig-name descname"><span class="pre">loss_function</span></span><a class="headerlink" href="#pynever.strategies.training.PytorchTraining.loss_function" title="Link to this definition"></a></dt>
222215
<dd><p>Loss function for the training strategy. We assume it to take as parameters two pytorch Tensor
223-
corresponding to the output of the network and the target. Other parameter should be given as attribute of
216+
corresponding to the output of the network and the target. Other parameters should be given as attributes of
224217
the callable object.</p>
225218
<dl class="field-list simple">
226219
<dt class="field-odd">Type<span class="colon">:</span></dt>

pynever/API/3_Conversion.html

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -41,10 +41,14 @@
4141
</form>
4242
</div>
4343
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
44-
<p class="caption" role="heading"><span class="caption-text">Setup</span></p>
44+
<p class="caption" role="heading"><span class="caption-text">Getting started</span></p>
4545
<ul>
4646
<li class="toctree-l1"><a class="reference internal" href="../Setup/setup.html">Installation and Setup</a></li>
4747
</ul>
48+
<p class="caption" role="heading"><span class="caption-text">Usage</span></p>
49+
<ul>
50+
<li class="toctree-l1"><a class="reference internal" href="../Guide/usage.html">Verification</a></li>
51+
</ul>
4852
<p class="caption" role="heading"><span class="caption-text">API Documentation</span></p>
4953
<ul class="current">
5054
<li class="toctree-l1"><a class="reference internal" href="0_Networks.html">Networks</a></li>
@@ -103,7 +107,7 @@
103107
<div itemprop="articleBody">
104108

105109
<section id="module-pynever.strategies.conversion.representation">
106-
<span id="conversion"></span><h1>Conversion<a class="headerlink" href="#module-pynever.strategies.conversion.representation" title="Link to this heading"></a></h1>
110+
<span id="conversion"></span><span id="conversion-ref"></span><h1>Conversion<a class="headerlink" href="#module-pynever.strategies.conversion.representation" title="Link to this heading"></a></h1>
107111
<dl class="py class">
108112
<dt class="sig sig-object py" id="pynever.strategies.conversion.representation.AlternativeRepresentation">
109113
<em class="property"><span class="k"><span class="pre">class</span></span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">pynever.strategies.conversion.representation.</span></span><span class="sig-name descname"><span class="pre">AlternativeRepresentation</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">path</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">identifier</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="reference internal" href="../_modules/pynever/strategies/conversion/representation.html#AlternativeRepresentation"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#pynever.strategies.conversion.representation.AlternativeRepresentation" title="Link to this definition"></a></dt>

0 commit comments

Comments
 (0)