Skip to content

Commit f84c5ce

Browse files
committed
Update Sphinx Documentation
1 parent 6beb118 commit f84c5ce

11 files changed

+79
-6
lines changed

_sources/autodoc/hls4ml.model.optimizer.passes.rst.txt

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -140,6 +140,14 @@ hls4ml.model.optimizer.passes.multi\_dense module
140140
:undoc-members:
141141
:show-inheritance:
142142

143+
hls4ml.model.optimizer.passes.pad\_const module
144+
-----------------------------------------------
145+
146+
.. automodule:: hls4ml.model.optimizer.passes.pad_const
147+
:members:
148+
:undoc-members:
149+
:show-inheritance:
150+
143151
hls4ml.model.optimizer.passes.qkeras module
144152
-------------------------------------------
145153

autodoc/hls4ml.converters.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -360,6 +360,7 @@ <h2>Subpackages<a class="headerlink" href="#subpackages" title="Link to this hea
360360
</li>
361361
<li class="toctree-l2"><a class="reference internal" href="hls4ml.converters.onnx.html#module-hls4ml.converters.onnx.reshape">hls4ml.converters.onnx.reshape module</a><ul>
362362
<li class="toctree-l3"><a class="reference internal" href="hls4ml.converters.onnx.html#hls4ml.converters.onnx.reshape.parse_flatten_layer"><code class="docutils literal notranslate"><span class="pre">parse_flatten_layer()</span></code></a></li>
363+
<li class="toctree-l3"><a class="reference internal" href="hls4ml.converters.onnx.html#hls4ml.converters.onnx.reshape.parse_pad_layer"><code class="docutils literal notranslate"><span class="pre">parse_pad_layer()</span></code></a></li>
363364
<li class="toctree-l3"><a class="reference internal" href="hls4ml.converters.onnx.html#hls4ml.converters.onnx.reshape.parse_reshape_layer"><code class="docutils literal notranslate"><span class="pre">parse_reshape_layer()</span></code></a></li>
364365
<li class="toctree-l3"><a class="reference internal" href="hls4ml.converters.onnx.html#hls4ml.converters.onnx.reshape.parse_resize_layer"><code class="docutils literal notranslate"><span class="pre">parse_resize_layer()</span></code></a></li>
365366
<li class="toctree-l3"><a class="reference internal" href="hls4ml.converters.onnx.html#hls4ml.converters.onnx.reshape.parse_transpose_layer"><code class="docutils literal notranslate"><span class="pre">parse_transpose_layer()</span></code></a></li>

autodoc/hls4ml.converters.onnx.html

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -211,6 +211,11 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Link to this headi
211211
<span class="sig-prename descclassname"><span class="pre">hls4ml.converters.onnx.reshape.</span></span><span class="sig-name descname"><span class="pre">parse_flatten_layer</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">node</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">input_names</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">input_shapes</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">graph</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#hls4ml.converters.onnx.reshape.parse_flatten_layer" title="Link to this definition"></a></dt>
212212
<dd></dd></dl>
213213

214+
<dl class="py function">
215+
<dt class="sig sig-object py" id="hls4ml.converters.onnx.reshape.parse_pad_layer">
216+
<span class="sig-prename descclassname"><span class="pre">hls4ml.converters.onnx.reshape.</span></span><span class="sig-name descname"><span class="pre">parse_pad_layer</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">node</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">input_names</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">input_shapes</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">graph</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#hls4ml.converters.onnx.reshape.parse_pad_layer" title="Link to this definition"></a></dt>
217+
<dd></dd></dl>
218+
214219
<dl class="py function">
215220
<dt class="sig sig-object py" id="hls4ml.converters.onnx.reshape.parse_reshape_layer">
216221
<span class="sig-prename descclassname"><span class="pre">hls4ml.converters.onnx.reshape.</span></span><span class="sig-name descname"><span class="pre">parse_reshape_layer</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">node</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">input_names</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">input_shapes</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">graph</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#hls4ml.converters.onnx.reshape.parse_reshape_layer" title="Link to this definition"></a></dt>

autodoc/hls4ml.model.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -190,6 +190,7 @@ <h2>Subpackages<a class="headerlink" href="#subpackages" title="Link to this hea
190190
<li class="toctree-l4"><a class="reference internal" href="hls4ml.model.optimizer.passes.html#module-hls4ml.model.optimizer.passes.merge_const">hls4ml.model.optimizer.passes.merge_const module</a></li>
191191
<li class="toctree-l4"><a class="reference internal" href="hls4ml.model.optimizer.passes.html#module-hls4ml.model.optimizer.passes.move_scales">hls4ml.model.optimizer.passes.move_scales module</a></li>
192192
<li class="toctree-l4"><a class="reference internal" href="hls4ml.model.optimizer.passes.html#module-hls4ml.model.optimizer.passes.multi_dense">hls4ml.model.optimizer.passes.multi_dense module</a></li>
193+
<li class="toctree-l4"><a class="reference internal" href="hls4ml.model.optimizer.passes.html#module-hls4ml.model.optimizer.passes.pad_const">hls4ml.model.optimizer.passes.pad_const module</a></li>
193194
<li class="toctree-l4"><a class="reference internal" href="hls4ml.model.optimizer.passes.html#module-hls4ml.model.optimizer.passes.qkeras">hls4ml.model.optimizer.passes.qkeras module</a></li>
194195
<li class="toctree-l4"><a class="reference internal" href="hls4ml.model.optimizer.passes.html#module-hls4ml.model.optimizer.passes.quant_opt">hls4ml.model.optimizer.passes.quant_opt module</a></li>
195196
<li class="toctree-l4"><a class="reference internal" href="hls4ml.model.optimizer.passes.html#module-hls4ml.model.optimizer.passes.reshape_const">hls4ml.model.optimizer.passes.reshape_const module</a></li>

autodoc/hls4ml.model.optimizer.html

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -396,6 +396,14 @@ <h2>Subpackages<a class="headerlink" href="#subpackages" title="Link to this hea
396396
</li>
397397
</ul>
398398
</li>
399+
<li class="toctree-l2"><a class="reference internal" href="hls4ml.model.optimizer.passes.html#module-hls4ml.model.optimizer.passes.pad_const">hls4ml.model.optimizer.passes.pad_const module</a><ul>
400+
<li class="toctree-l3"><a class="reference internal" href="hls4ml.model.optimizer.passes.html#hls4ml.model.optimizer.passes.pad_const.PaddingConstant"><code class="docutils literal notranslate"><span class="pre">PaddingConstant</span></code></a><ul>
401+
<li class="toctree-l4"><a class="reference internal" href="hls4ml.model.optimizer.passes.html#hls4ml.model.optimizer.passes.pad_const.PaddingConstant.match"><code class="docutils literal notranslate"><span class="pre">PaddingConstant.match()</span></code></a></li>
402+
<li class="toctree-l4"><a class="reference internal" href="hls4ml.model.optimizer.passes.html#hls4ml.model.optimizer.passes.pad_const.PaddingConstant.transform"><code class="docutils literal notranslate"><span class="pre">PaddingConstant.transform()</span></code></a></li>
403+
</ul>
404+
</li>
405+
</ul>
406+
</li>
399407
<li class="toctree-l2"><a class="reference internal" href="hls4ml.model.optimizer.passes.html#module-hls4ml.model.optimizer.passes.qkeras">hls4ml.model.optimizer.passes.qkeras module</a><ul>
400408
<li class="toctree-l3"><a class="reference internal" href="hls4ml.model.optimizer.passes.html#hls4ml.model.optimizer.passes.qkeras.ExtractTernaryThreshold"><code class="docutils literal notranslate"><span class="pre">ExtractTernaryThreshold</span></code></a><ul>
401409
<li class="toctree-l4"><a class="reference internal" href="hls4ml.model.optimizer.passes.html#hls4ml.model.optimizer.passes.qkeras.ExtractTernaryThreshold.match"><code class="docutils literal notranslate"><span class="pre">ExtractTernaryThreshold.match()</span></code></a></li>

autodoc/hls4ml.model.optimizer.passes.html

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1366,6 +1366,34 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Link to this headi
13661366

13671367
</dd></dl>
13681368

1369+
</section>
1370+
<section id="module-hls4ml.model.optimizer.passes.pad_const">
1371+
<span id="hls4ml-model-optimizer-passes-pad-const-module"></span><h2>hls4ml.model.optimizer.passes.pad_const module<a class="headerlink" href="#module-hls4ml.model.optimizer.passes.pad_const" title="Link to this heading"></a></h2>
1372+
<dl class="py class">
1373+
<dt class="sig sig-object py" id="hls4ml.model.optimizer.passes.pad_const.PaddingConstant">
1374+
<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">hls4ml.model.optimizer.passes.pad_const.</span></span><span class="sig-name descname"><span class="pre">PaddingConstant</span></span><a class="headerlink" href="#hls4ml.model.optimizer.passes.pad_const.PaddingConstant" title="Link to this definition"></a></dt>
1375+
<dd><p>Bases: <a class="reference internal" href="hls4ml.model.optimizer.html#hls4ml.model.optimizer.optimizer.OptimizerPass" title="hls4ml.model.optimizer.optimizer.OptimizerPass"><code class="xref py py-class docutils literal notranslate"><span class="pre">OptimizerPass</span></code></a></p>
1376+
<p>ONNX has the padding come as an input, not a parameter. This removes the Constant node from the input.
1377+
The constant value was already used; this is just a cleanup uptimization.</p>
1378+
<dl class="py method">
1379+
<dt class="sig sig-object py" id="hls4ml.model.optimizer.passes.pad_const.PaddingConstant.match">
1380+
<span class="sig-name descname"><span class="pre">match</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">node</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#hls4ml.model.optimizer.passes.pad_const.PaddingConstant.match" title="Link to this definition"></a></dt>
1381+
<dd><p>Predicate to match on a given node.</p>
1382+
<dl class="field-list simple">
1383+
<dt class="field-odd">Parameters<span class="colon">:</span></dt>
1384+
<dd class="field-odd"><p><strong>node</strong> (<a class="reference internal" href="hls4ml.model.html#hls4ml.model.layers.Layer" title="hls4ml.model.layers.Layer"><em>Layer</em></a>) – Node in the model graph to try matching the optimizer on.</p>
1385+
</dd>
1386+
</dl>
1387+
</dd></dl>
1388+
1389+
<dl class="py method">
1390+
<dt class="sig sig-object py" id="hls4ml.model.optimizer.passes.pad_const.PaddingConstant.transform">
1391+
<span class="sig-name descname"><span class="pre">transform</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">model</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">node</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#hls4ml.model.optimizer.passes.pad_const.PaddingConstant.transform" title="Link to this definition"></a></dt>
1392+
<dd><p>Remove Constant node(s) from the graph. Note, padding is already present in ZeroPadding node.</p>
1393+
</dd></dl>
1394+
1395+
</dd></dl>
1396+
13691397
</section>
13701398
<section id="module-hls4ml.model.optimizer.passes.qkeras">
13711399
<span id="hls4ml-model-optimizer-passes-qkeras-module"></span><h2>hls4ml.model.optimizer.passes.qkeras module<a class="headerlink" href="#module-hls4ml.model.optimizer.passes.qkeras" title="Link to this heading"></a></h2>

genindex.html

Lines changed: 21 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2685,15 +2685,15 @@ <h2 id="H">H</h2>
26852685
<li><a href="autodoc/hls4ml.backends.vivado.passes.html#module-hls4ml.backends.vivado.passes.pipeline_style">module</a>
26862686
</li>
26872687
</ul></li>
2688-
</ul></td>
2689-
<td style="width: 33%; vertical-align: top;"><ul>
26902688
<li>
26912689
hls4ml.backends.vivado.passes.pointwise
26922690

26932691
<ul>
26942692
<li><a href="autodoc/hls4ml.backends.vivado.passes.html#module-hls4ml.backends.vivado.passes.pointwise">module</a>
26952693
</li>
26962694
</ul></li>
2695+
</ul></td>
2696+
<td style="width: 33%; vertical-align: top;"><ul>
26972697
<li>
26982698
hls4ml.backends.vivado.passes.pooling_templates
26992699

@@ -3294,6 +3294,13 @@ <h2 id="H">H</h2>
32943294

32953295
<ul>
32963296
<li><a href="autodoc/hls4ml.model.optimizer.passes.html#module-hls4ml.model.optimizer.passes.multi_dense">module</a>
3297+
</li>
3298+
</ul></li>
3299+
<li>
3300+
hls4ml.model.optimizer.passes.pad_const
3301+
3302+
<ul>
3303+
<li><a href="autodoc/hls4ml.model.optimizer.passes.html#module-hls4ml.model.optimizer.passes.pad_const">module</a>
32973304
</li>
32983305
</ul></li>
32993306
<li>
@@ -4184,6 +4191,8 @@ <h2 id="M">M</h2>
41844191
<li><a href="autodoc/hls4ml.model.optimizer.passes.html#hls4ml.model.optimizer.passes.move_scales.ScaleDownMatMul.match">(hls4ml.model.optimizer.passes.move_scales.ScaleDownMatMul method)</a>
41854192
</li>
41864193
<li><a href="autodoc/hls4ml.model.optimizer.passes.html#hls4ml.model.optimizer.passes.multi_dense.ReplaceMultidimensionalDenseWithConv.match">(hls4ml.model.optimizer.passes.multi_dense.ReplaceMultidimensionalDenseWithConv method)</a>
4194+
</li>
4195+
<li><a href="autodoc/hls4ml.model.optimizer.passes.html#hls4ml.model.optimizer.passes.pad_const.PaddingConstant.match">(hls4ml.model.optimizer.passes.pad_const.PaddingConstant method)</a>
41874196
</li>
41884197
<li><a href="autodoc/hls4ml.model.optimizer.passes.html#hls4ml.model.optimizer.passes.qkeras.ExtractTernaryThreshold.match">(hls4ml.model.optimizer.passes.qkeras.ExtractTernaryThreshold method)</a>
41894198
</li>
@@ -4663,6 +4672,8 @@ <h2 id="M">M</h2>
46634672
<li><a href="autodoc/hls4ml.model.optimizer.passes.html#module-hls4ml.model.optimizer.passes.move_scales">hls4ml.model.optimizer.passes.move_scales</a>
46644673
</li>
46654674
<li><a href="autodoc/hls4ml.model.optimizer.passes.html#module-hls4ml.model.optimizer.passes.multi_dense">hls4ml.model.optimizer.passes.multi_dense</a>
4675+
</li>
4676+
<li><a href="autodoc/hls4ml.model.optimizer.passes.html#module-hls4ml.model.optimizer.passes.pad_const">hls4ml.model.optimizer.passes.pad_const</a>
46664677
</li>
46674678
<li><a href="autodoc/hls4ml.model.optimizer.passes.html#module-hls4ml.model.optimizer.passes.qkeras">hls4ml.model.optimizer.passes.qkeras</a>
46684679
</li>
@@ -4882,6 +4893,8 @@ <h2 id="P">P</h2>
48824893
<li><a href="autodoc/hls4ml.backends.fpga.html#hls4ml.backends.fpga.fpga_types.PackedTypeConverter">PackedTypeConverter (class in hls4ml.backends.fpga.fpga_types)</a>
48834894
</li>
48844895
<li><a href="autodoc/hls4ml.model.optimizer.passes.html#hls4ml.model.optimizer.passes.bit_exact.pad_arrs">pad_arrs() (in module hls4ml.model.optimizer.passes.bit_exact)</a>
4896+
</li>
4897+
<li><a href="autodoc/hls4ml.model.optimizer.passes.html#hls4ml.model.optimizer.passes.pad_const.PaddingConstant">PaddingConstant (class in hls4ml.model.optimizer.passes.pad_const)</a>
48854898
</li>
48864899
<li><a href="autodoc/hls4ml.backends.catapult.passes.html#hls4ml.backends.catapult.passes.core_templates.ParamActivationConfigTemplate">ParamActivationConfigTemplate (class in hls4ml.backends.catapult.passes.core_templates)</a>
48874900

@@ -5020,6 +5033,8 @@ <h2 id="P">P</h2>
50205033
<li><a href="autodoc/hls4ml.report.html#hls4ml.report.oneapi_report.parse_oneapi_report">parse_oneapi_report() (in module hls4ml.report.oneapi_report)</a>
50215034
</li>
50225035
<li><a href="autodoc/hls4ml.converters.html#hls4ml.converters.onnx_to_hls.parse_onnx_model">parse_onnx_model() (in module hls4ml.converters.onnx_to_hls)</a>
5036+
</li>
5037+
<li><a href="autodoc/hls4ml.converters.onnx.html#hls4ml.converters.onnx.reshape.parse_pad_layer">parse_pad_layer() (in module hls4ml.converters.onnx.reshape)</a>
50235038
</li>
50245039
<li><a href="autodoc/hls4ml.converters.keras.html#hls4ml.converters.keras.reshape.parse_permute_layer">parse_permute_layer() (in module hls4ml.converters.keras.reshape)</a>
50255040
</li>
@@ -5061,10 +5076,10 @@ <h2 id="P">P</h2>
50615076
<li><a href="autodoc/hls4ml.converters.pytorch.html#hls4ml.converters.pytorch.reshape.parse_reshape_layer">(in module hls4ml.converters.pytorch.reshape)</a>
50625077
</li>
50635078
</ul></li>
5064-
<li><a href="autodoc/hls4ml.converters.onnx.html#hls4ml.converters.onnx.reshape.parse_resize_layer">parse_resize_layer() (in module hls4ml.converters.onnx.reshape)</a>
5065-
</li>
50665079
</ul></td>
50675080
<td style="width: 33%; vertical-align: top;"><ul>
5081+
<li><a href="autodoc/hls4ml.converters.onnx.html#hls4ml.converters.onnx.reshape.parse_resize_layer">parse_resize_layer() (in module hls4ml.converters.onnx.reshape)</a>
5082+
</li>
50685083
<li><a href="autodoc/hls4ml.converters.keras.html#hls4ml.converters.keras.recurrent.parse_rnn_layer">parse_rnn_layer() (in module hls4ml.converters.keras.recurrent)</a>
50695084

50705085
<ul>
@@ -6019,6 +6034,8 @@ <h2 id="T">T</h2>
60196034
<li><a href="autodoc/hls4ml.model.optimizer.passes.html#hls4ml.model.optimizer.passes.move_scales.ScaleDownMatMul.transform">(hls4ml.model.optimizer.passes.move_scales.ScaleDownMatMul method)</a>
60206035
</li>
60216036
<li><a href="autodoc/hls4ml.model.optimizer.passes.html#hls4ml.model.optimizer.passes.multi_dense.ReplaceMultidimensionalDenseWithConv.transform">(hls4ml.model.optimizer.passes.multi_dense.ReplaceMultidimensionalDenseWithConv method)</a>
6037+
</li>
6038+
<li><a href="autodoc/hls4ml.model.optimizer.passes.html#hls4ml.model.optimizer.passes.pad_const.PaddingConstant.transform">(hls4ml.model.optimizer.passes.pad_const.PaddingConstant method)</a>
60226039
</li>
60236040
<li><a href="autodoc/hls4ml.model.optimizer.passes.html#hls4ml.model.optimizer.passes.qkeras.ExtractTernaryThreshold.transform">(hls4ml.model.optimizer.passes.qkeras.ExtractTernaryThreshold method)</a>
60246041
</li>

intro/status.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -140,7 +140,7 @@
140140
<h1>Status and Features<a class="headerlink" href="#status-and-features" title="Link to this heading"></a></h1>
141141
<section id="status">
142142
<h2>Status<a class="headerlink" href="#status" title="Link to this heading"></a></h2>
143-
<p>The latest version (built from <code class="docutils literal notranslate"><span class="pre">main</span></code>) is 1.2.0.dev81+gf43776dd.
143+
<p>The latest version (built from <code class="docutils literal notranslate"><span class="pre">main</span></code>) is 1.2.0.dev82+gb493ea7f.
144144
The stable version (released on PyPI) is 1.1.0.
145145
See the <a class="reference internal" href="release_notes.html#release-notes"><span class="std std-ref">Release Notes</span></a> section for a changelog.</p>
146146
</section>

objects.inv

43 Bytes
Binary file not shown.

py-modindex.html

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1097,6 +1097,11 @@ <h1>Python Module Index</h1>
10971097
<td>&#160;&#160;&#160;
10981098
<a href="autodoc/hls4ml.model.optimizer.passes.html#module-hls4ml.model.optimizer.passes.multi_dense"><code class="xref">hls4ml.model.optimizer.passes.multi_dense</code></a></td><td>
10991099
<em></em></td></tr>
1100+
<tr class="cg-1">
1101+
<td></td>
1102+
<td>&#160;&#160;&#160;
1103+
<a href="autodoc/hls4ml.model.optimizer.passes.html#module-hls4ml.model.optimizer.passes.pad_const"><code class="xref">hls4ml.model.optimizer.passes.pad_const</code></a></td><td>
1104+
<em></em></td></tr>
11001105
<tr class="cg-1">
11011106
<td></td>
11021107
<td>&#160;&#160;&#160;

0 commit comments

Comments
 (0)