Skip to content

Commit

Permalink
Added quickstart to docs.
Browse files Browse the repository at this point in the history
  • Loading branch information
senthurayyappan committed Aug 30, 2020
1 parent 81a54ab commit 17f1817
Show file tree
Hide file tree
Showing 18 changed files with 141 additions and 19 deletions.
Binary file modified docs/_build/doctrees/environment.pickle
Binary file not shown.
Binary file modified docs/_build/doctrees/installation.doctree
Binary file not shown.
Binary file modified docs/_build/doctrees/quickstart.doctree
Binary file not shown.
Binary file added docs/_build/html/_images/define.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/_build/html/_images/gen.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/_build/html/_images/visualize.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/_build/html/_images/viz.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
5 changes: 2 additions & 3 deletions docs/_build/html/_sources/installation.rst.txt
Original file line number Diff line number Diff line change
@@ -1,9 +1,6 @@
Installation
============

.. image:: ./installation.gif
:alt: Installation

* Download the latest release
* Open Blender and head over to ``Edit`` -> ``Preferences`` -> ``Add-ons`` -> ``Install``
* Navigate to the downloaded **.zip** file and click ``Install Add-on``
Expand All @@ -16,3 +13,5 @@ Installation

* If you dont have these modules installed, click ``Install required modules``

.. image:: ./installation.gif
:alt: Installation
49 changes: 45 additions & 4 deletions docs/_build/html/_sources/quickstart.rst.txt
Original file line number Diff line number Diff line change
Expand Up @@ -25,12 +25,53 @@ Define
:align: right

* Specify the ``number of forces`` acting on the object.
* Assign materials to face(s) corresponding to each force.
* Assign vertex groups to edges that depict the direction of each corresponding force.
* Input the magnitude and click the ``Expand`` button to visualize each one of the aaplied forces.
* Assign ``materials`` to face(s) corresponding to each force, fixed and non-design space.
* Assign ``vertex groups`` to edges that depict the direction of each corresponding force.
* Input the ``magnitude`` and click the ``Expand`` button to visualize each one of the applied forces.
* Specify the ``maximum element size`` for tetrahedral finite element mesh generation and click ``Define``


\

.. image:: ./define.gif
:alt: Define

Generate
--------

.. figure:: ./gen.png
:figwidth: 32%
:align: right

* Select a ``material`` for the object.
* Specify optimization parameters:
* ``Emin``
* ``Density change``
* ``Volumina ratio``
* ``Penalty exponent``

* Specify filter parameters:
* ``Number of neighbours``
* ``Neighbourhood radius``

* Read more about these parameters `here. <scripts.html#module-properties>`_
* For a conceptual understanding of these parameters, read `Material interpolation schemes in topology optimization. <https://www.researchgate.net/publication/225613840_Material_interpolation_schemes_in_topology_optimization>`_
* Input the ``number of iterations`` and click ``Generate``

Visualize
---------
---------

.. figure:: ./viz.png
:figwidth: 32%
:align: right

* Specify ``radius`` and ``sensitivity`` of the `metaballs. <https://docs.blender.org/manual/en/latest/modeling/metas/introduction.html>`_
* Input the ``number of keyframes`` and ``instantiation points`` for animation.
* Mention which iteration to visualize and click ``Visualize``.
* The generated metaball object can then be converted into a mesh via ``Object`` -> ``Covert to`` -> ``Mesh from Curve/Meta/Surf/Text``
* A ``Smooth Corrective`` modifier can then be applied on the mesh during export.

\

.. image:: ./visualize.gif
:alt: Visualize
2 changes: 1 addition & 1 deletion docs/_build/html/installation.html
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,6 @@

<div class="section" id="installation">
<h1>Installation<a class="headerlink" href="#installation" title="Permalink to this headline"></a></h1>
<img alt="Installation" src="_images/installation.gif" />
<ul class="simple">
<li><p>Download the latest release</p></li>
<li><p>Open Blender and head over to <code class="docutils literal notranslate"><span class="pre">Edit</span></code> -&gt; <code class="docutils literal notranslate"><span class="pre">Preferences</span></code> -&gt; <code class="docutils literal notranslate"><span class="pre">Add-ons</span></code> -&gt; <code class="docutils literal notranslate"><span class="pre">Install</span></code></p></li>
Expand All @@ -54,6 +53,7 @@ <h1>Installation<a class="headerlink" href="#installation" title="Permalink to t
</li>
<li><p>If you dont have these modules installed, click <code class="docutils literal notranslate"><span class="pre">Install</span> <span class="pre">required</span> <span class="pre">modules</span></code></p></li>
</ul>
<img alt="Installation" src="_images/installation.gif" />
</div>


Expand Down
48 changes: 45 additions & 3 deletions docs/_build/html/quickstart.html
Original file line number Diff line number Diff line change
Expand Up @@ -57,16 +57,58 @@ <h2>Define<a class="headerlink" href="#define" title="Permalink to this headline
</div>
<ul class="simple">
<li><p>Specify the <code class="docutils literal notranslate"><span class="pre">number</span> <span class="pre">of</span> <span class="pre">forces</span></code> acting on the object.</p></li>
<li><p>Assign materials to face(s) corresponding to each force.</p></li>
<li><p>Assign vertex groups to edges that depict the direction of each corresponding force.</p></li>
<li><p>Input the magnitude and click the <code class="docutils literal notranslate"><span class="pre">Expand</span></code> button to visualize each one of the aaplied forces.</p></li>
<li><p>Assign <code class="docutils literal notranslate"><span class="pre">materials</span></code> to face(s) corresponding to each force, fixed and non-design space.</p></li>
<li><p>Assign <code class="docutils literal notranslate"><span class="pre">vertex</span> <span class="pre">groups</span></code> to edges that depict the direction of each corresponding force.</p></li>
<li><p>Input the <code class="docutils literal notranslate"><span class="pre">magnitude</span></code> and click the <code class="docutils literal notranslate"><span class="pre">Expand</span></code> button to visualize each one of the applied forces.</p></li>
<li><p>Specify the <code class="docutils literal notranslate"><span class="pre">maximum</span> <span class="pre">element</span> <span class="pre">size</span></code> for tetrahedral finite element mesh generation and click <code class="docutils literal notranslate"><span class="pre">Define</span></code></p></li>
</ul>
<p></p>
<img alt="Define" src="_images/define.gif" />
</div>
<div class="section" id="generate">
<h2>Generate<a class="headerlink" href="#generate" title="Permalink to this headline"></a></h2>
<div class="figure align-right" style="width: 32%">
<img alt="_images/gen.png" src="_images/gen.png" />
</div>
<ul class="simple">
<li><p>Select a <code class="docutils literal notranslate"><span class="pre">material</span></code> for the object.</p></li>
<li><dl class="simple">
<dt>Specify optimization parameters:</dt><dd><ul>
<li><p><code class="docutils literal notranslate"><span class="pre">Emin</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">Density</span> <span class="pre">change</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">Volumina</span> <span class="pre">ratio</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">Penalty</span> <span class="pre">exponent</span></code></p></li>
</ul>
</dd>
</dl>
</li>
<li><dl class="simple">
<dt>Specify filter parameters:</dt><dd><ul>
<li><p><code class="docutils literal notranslate"><span class="pre">Number</span> <span class="pre">of</span> <span class="pre">neighbours</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">Neighbourhood</span> <span class="pre">radius</span></code></p></li>
</ul>
</dd>
</dl>
</li>
<li><p>Read more about these parameters <a class="reference external" href="scripts.html#module-properties">here.</a></p></li>
<li><p>For a conceptual understanding of these parameters, read <a class="reference external" href="https://www.researchgate.net/publication/225613840_Material_interpolation_schemes_in_topology_optimization">Material interpolation schemes in topology optimization.</a></p></li>
<li><p>Input the <code class="docutils literal notranslate"><span class="pre">number</span> <span class="pre">of</span> <span class="pre">iterations</span></code> and click <code class="docutils literal notranslate"><span class="pre">Generate</span></code></p></li>
</ul>
</div>
<div class="section" id="visualize">
<h2>Visualize<a class="headerlink" href="#visualize" title="Permalink to this headline"></a></h2>
<div class="figure align-right" style="width: 32%">
<img alt="_images/viz.png" src="_images/viz.png" />
</div>
<ul class="simple">
<li><p>Specify <code class="docutils literal notranslate"><span class="pre">radius</span></code> and <code class="docutils literal notranslate"><span class="pre">sensitivity</span></code> of the <a class="reference external" href="https://docs.blender.org/manual/en/latest/modeling/metas/introduction.html">metaballs.</a></p></li>
<li><p>Input the <code class="docutils literal notranslate"><span class="pre">number</span> <span class="pre">of</span> <span class="pre">keyframes</span></code> and <code class="docutils literal notranslate"><span class="pre">instantiation</span> <span class="pre">points</span></code> for animation.</p></li>
<li><p>Mention which iteration to visualize and click <code class="docutils literal notranslate"><span class="pre">Visualize</span></code>.</p></li>
<li><p>The generated metaball object can then be converted into a mesh via <code class="docutils literal notranslate"><span class="pre">Object</span></code> -&gt; <code class="docutils literal notranslate"><span class="pre">Covert</span> <span class="pre">to</span></code> -&gt; <code class="docutils literal notranslate"><span class="pre">Mesh</span> <span class="pre">from</span> <span class="pre">Curve/Meta/Surf/Text</span></code></p></li>
<li><p>A <code class="docutils literal notranslate"><span class="pre">Smooth</span> <span class="pre">Corrective</span></code> modifier can then be applied on the mesh during export.</p></li>
</ul>
<p></p>
<img alt="Visualize" src="_images/visualize.gif" />
</div>
</div>

Expand Down
Loading

0 comments on commit 17f1817

Please sign in to comment.