GITBOOK-131: No subject

BlockResearchGroup · Jan 30, 2025 · 04b691e · 04b691e
1 parent 6c264a2
commit 04b691e
Show file tree

Hide file tree

Showing 41 changed files with 100 additions and 53 deletions.
diff --git a/gitbook/.gitbook/assets/0_rhinovault_lips_pattern (1).json b/gitbook/.gitbook/assets/0_rhinovault_lips_pattern (1).json
diff --git a/gitbook/.gitbook/assets/0_rhinovault_lips_pattern.json b/gitbook/.gitbook/assets/0_rhinovault_lips_pattern.json
diff --git a/gitbook/.gitbook/assets/1_rhinovault_lips_boundary (1).json b/gitbook/.gitbook/assets/1_rhinovault_lips_boundary (1).json
diff --git a/gitbook/.gitbook/assets/1_rhinovault_lips_boundary.json b/gitbook/.gitbook/assets/1_rhinovault_lips_boundary.json
diff --git a/gitbook/.gitbook/assets/2_rhinovault_lips_form (1).json b/gitbook/.gitbook/assets/2_rhinovault_lips_form (1).json
diff --git a/gitbook/.gitbook/assets/2_rhinovault_lips_form (2).json b/gitbook/.gitbook/assets/2_rhinovault_lips_form (2).json
diff --git a/gitbook/.gitbook/assets/2_rhinovault_lips_form.json b/gitbook/.gitbook/assets/2_rhinovault_lips_form.json
diff --git a/gitbook/.gitbook/assets/3_rhinovault_lips_force.json b/gitbook/.gitbook/assets/3_rhinovault_lips_force.json
diff --git a/gitbook/.gitbook/assets/4_rhinovault_lips_horizontal_thrust.json b/gitbook/.gitbook/assets/4_rhinovault_lips_horizontal_thrust.json
diff --git a/gitbook/.gitbook/assets/5_rhinovault_lips_modify_horizontal_forces.json b/gitbook/.gitbook/assets/5_rhinovault_lips_modify_horizontal_forces.json
diff --git a/gitbook/.gitbook/assets/6_rhinovault_lips_horizontal_thrust (1).json b/gitbook/.gitbook/assets/6_rhinovault_lips_horizontal_thrust (1).json
diff --git a/gitbook/.gitbook/assets/6_rhinovault_lips_horizontal_thrust (2).json b/gitbook/.gitbook/assets/6_rhinovault_lips_horizontal_thrust (2).json
diff --git a/gitbook/.gitbook/assets/6_rhinovault_lips_horizontal_thrust.json b/gitbook/.gitbook/assets/6_rhinovault_lips_horizontal_thrust.json
diff --git a/gitbook/.gitbook/assets/7_rhinovault_vertical_thrust (1).json b/gitbook/.gitbook/assets/7_rhinovault_vertical_thrust (1).json
diff --git a/gitbook/.gitbook/assets/7_rhinovault_vertical_thrust.json b/gitbook/.gitbook/assets/7_rhinovault_vertical_thrust.json
diff --git a/gitbook/.gitbook/assets/barrel_0 (1) (1).png b/gitbook/.gitbook/assets/barrel_0 (1) (1).png
diff --git a/gitbook/.gitbook/assets/barrel_0 (1).png b/gitbook/.gitbook/assets/barrel_0 (1).png
diff --git a/gitbook/.gitbook/assets/barrel_0.png b/gitbook/.gitbook/assets/barrel_0.png
diff --git a/gitbook/.gitbook/assets/lips.3dm b/gitbook/.gitbook/assets/lips.3dm
diff --git a/gitbook/.gitbook/assets/lips_0_1.png b/gitbook/.gitbook/assets/lips_0_1.png
diff --git a/gitbook/.gitbook/assets/lips_1 (1).png b/gitbook/.gitbook/assets/lips_1 (1).png
diff --git a/gitbook/.gitbook/assets/lips_1.png b/gitbook/.gitbook/assets/lips_1.png
diff --git a/gitbook/.gitbook/assets/lips_2 (1).png b/gitbook/.gitbook/assets/lips_2 (1).png
diff --git a/gitbook/.gitbook/assets/lips_2.png b/gitbook/.gitbook/assets/lips_2.png
diff --git a/gitbook/.gitbook/assets/lips_3 (1) (1).png b/gitbook/.gitbook/assets/lips_3 (1) (1).png
diff --git a/gitbook/.gitbook/assets/lips_3.png b/gitbook/.gitbook/assets/lips_3.png
diff --git a/gitbook/.gitbook/assets/lips_4 (1) (1).png b/gitbook/.gitbook/assets/lips_4 (1) (1).png
diff --git a/gitbook/.gitbook/assets/lips_4 (1).png b/gitbook/.gitbook/assets/lips_4 (1).png
diff --git a/gitbook/.gitbook/assets/lips_4 (2) (1).png b/gitbook/.gitbook/assets/lips_4 (2) (1).png
diff --git a/gitbook/.gitbook/assets/lips_4.png b/gitbook/.gitbook/assets/lips_4.png
diff --git a/gitbook/.gitbook/assets/lips_5 (1).png b/gitbook/.gitbook/assets/lips_5 (1).png
diff --git a/gitbook/.gitbook/assets/lips_5.png b/gitbook/.gitbook/assets/lips_5.png
diff --git a/gitbook/.gitbook/assets/lips_6 (1).png b/gitbook/.gitbook/assets/lips_6 (1).png
diff --git a/gitbook/.gitbook/assets/lips_6 (2).png b/gitbook/.gitbook/assets/lips_6 (2).png
diff --git a/gitbook/.gitbook/assets/lips_6 (3).png b/gitbook/.gitbook/assets/lips_6 (3).png
diff --git a/gitbook/.gitbook/assets/lips_6.png b/gitbook/.gitbook/assets/lips_6.png
diff --git a/gitbook/.gitbook/assets/lips_7 (1).png b/gitbook/.gitbook/assets/lips_7 (1).png
diff --git a/gitbook/.gitbook/assets/lips_7 (2).png b/gitbook/.gitbook/assets/lips_7 (2).png
diff --git a/gitbook/.gitbook/assets/lips_7.png b/gitbook/.gitbook/assets/lips_7.png
diff --git a/gitbook/SUMMARY.md b/gitbook/SUMMARY.md
@@ -36,20 +36,20 @@
 ## Examples
 
 * [Basic Design](examples/basic-design/README.md)
-  * [Creases](examples/basic-design/barrel-vault.md)
+  * [\*Creases](examples/basic-design/barrel-vault.md)
   * [Lips](examples/basic-design/barrel-vault-1.md)
-  * [Holes](examples/basic-design/barrel-vault-2.md)
-  * [Dropdowns](examples/basic-design/barrel-vault-3.md)
-  * [Funnel Shell](examples/basic-design/barrel-vault-4.md)
+  * [\*Holes](examples/basic-design/barrel-vault-2.md)
+  * [\*Dropdowns](examples/basic-design/barrel-vault-3.md)
+  * [\*Funnel Shell](examples/basic-design/barrel-vault-4.md)
 * [Case Studies](examples/case-studies/README.md)
   * [\* British Museum](examples/case-studies/british-museum.md)
   * [\* Armadillo Vault](examples/case-studies/armadillo-vault.md)
   * [\* Free-form Tile Vault](examples/case-studies/free-form-tile-vault.md)
 * [Historical Typologies](examples/historical-typologies/README.md)
   * [Barrel Vault](examples/historical-typologies/barrel-vault.md)
-  * [Cross Vault](examples/historical-typologies/barrel-vault-1.md)
-  * [Pillow Vault](examples/historical-typologies/barrel-vault-2.md)
-  * [Fan Vault](examples/historical-typologies/barrel-vault-3.md)
+  * [\*Cross Vault](examples/historical-typologies/barrel-vault-1.md)
+  * [\*Pillow Vault](examples/historical-typologies/barrel-vault-2.md)
+  * [\*Fan Vault](examples/historical-typologies/barrel-vault-3.md)
 * [Advanced](examples/advanced/README.md)
   * [COMPAS Integration](examples/advanced/compas-integration.md)
   * [Materialization](examples/advanced/materialization.md)

diff --git a/gitbook/examples/basic-design/barrel-vault-1.md b/gitbook/examples/basic-design/barrel-vault-1.md
@@ -1,93 +1,125 @@
+---
+layout:
+  title:
+    visible: true
+  description:
+    visible: false
+  tableOfContents:
+    visible: true
+  outline:
+    visible: true
+  pagination:
+    visible: true
+---
+
 # Lips
 
+<figure><img src="../../.gitbook/assets/lips_0_1.png" alt=""><figcaption></figcaption></figure>
+
+In this tutorial, we modify the force diagram to create a lip at the edge of the shell. By "lip," we refer to historical examples such as Heinz Isler's _Wyss Garten Haus_. These folds at the boundary play a key structural role in stiffening the edges of a shell.
+
+To achieve this modification, we must redirect the flow of the greatest forces. Typically, in our shell form-finding process, the greatest forces have been concentrated along the outermost edge of the shell, flowing down to the support points at the corners. However, in this case, we aim to direct these forces through an edge that is not at the very perimeter of the shell.
+
+To accomplish this, we will set the force diagram edge length parameters [**lmin**](../../manual/7.-modify-diagrams/supports-1.md) and [**lmax**](../../manual/7.-modify-diagrams/supports-1.md) to 1 and 3, respectively, for all boundary edges. For the inner loop of edges, we will use a range of 10–15. These values are arbitrary and serve to illustrate the principle.
 
 
-## Rhino Geometry
 
-Download Rhino3D File:
+{% file src="../../.gitbook/assets/lips.3dm" %}
 
-{% file src="../../.gitbook/assets/lips.zip" %}
+***
 
-## Create Pattern
+## 1. Create Pattern
 
-|                                                                                  |                                                                          |                                                                                                                  |
-| -------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
-| <img src="../../.gitbook/assets/RV_pattern (2).svg" alt="" data-size="original"> | <p><strong>Rhino command name</strong></p><p><code>RV_pattern</code></p> | <p><strong>source file</strong></p><p><a href="../../../plugin/RV_pattern.py"><code>RV_pattern.py</code></a></p> |
+**Command:** `RV_pattern` > `RhinoMesh`
 
-**Command:** `RV_pattern` > `RhinoMesh` > `Select a Mesh`
+Create a pattern from a mesh. You can start with the attached Rhino file or a session file.
 
-<figure><img src="../../.gitbook/assets/lips_0.png" alt=""><figcaption><p>The display of the Mesh input changes when the <code>RV_pattern</code> command is initiated.</p></figcaption></figure>
+<figure><img src="../../.gitbook/assets/barrel_0.png" alt=""><figcaption></figcaption></figure>
 
+{% file src="../../.gitbook/assets/0_rhinovault_lips_pattern (1).json" %}
 
+***
 
-## Identify Supports
+## 2. Identify Supports
 
-<table><thead><tr><th></th><th width="228"></th><th></th></tr></thead><tbody><tr><td> <img src="../../.gitbook/assets/RV_supports (2).svg" alt=""></td><td><p><strong>Rhino command name</strong></p><p><code>RV_pattern_supports</code></p></td><td><p><strong>source file</strong></p><p><a href="../../../plugin/RV_pattern_supports.py"><code>RV_pattern_supports.py</code></a></p></td></tr></tbody></table>
+**Command:** `RV_pattern_supports` > `Add`> `Manual`> `Select Vertices`
 
-**Command:** `RV_pattern_supports` > `Add`> `Manual`> `Select Vertices`> `Enter`
+Manually set the boundary points from the three boundary arches.
 
-<figure><img src="../../.gitbook/assets/lips_1.png" alt=""><figcaption><p>Select the four corner vertices of the Mesh.</p></figcaption></figure>
+<figure><img src="../../.gitbook/assets/lips_1.png" alt=""><figcaption></figcaption></figure>
 
+{% file src="../../.gitbook/assets/1_rhinovault_lips_boundary (1).json" %}
 
+***
 
-## Form Diagram
+## 3. Form Diagram
 
-|                                                                                      |                                                                       |                                                                                                            |
-| ------------------------------------------------------------------------------------ | --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
-| <img src="../../.gitbook/assets/RV_FormDiagram (1).svg" alt="" data-size="original"> | <p><strong>Rhino command name</strong></p><p><code>RV_form</code></p> | <p><strong>source file</strong></p><p><a href="../../../plugin/RV_form.py"><code>RV_form.py</code></a></p> |
+**Command:** `RV_form`
 
-**Command:** `RV_form`\
+The mesh geometry is converted into a line preview, marked with green lines.
 
+<figure><img src="../../.gitbook/assets/lips_2.png" alt=""><figcaption></figcaption></figure>
 
-<figure><img src="../../.gitbook/assets/lips_2.png" alt=""><figcaption><p>The mesh geometry is converted to a line preview.</p></figcaption></figure>
+{% file src="../../.gitbook/assets/2_rhinovault_lips_form (2).json" %}
 
-## Form Diagram
+***
 
-|                                                                                       |                                                                        |                                                                                                              |
-| ------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
-| <img src="../../.gitbook/assets/RV_ForceDiagram (1).svg" alt="" data-size="original"> | <p><strong>Rhino command name</strong></p><p><code>RV_force</code></p> | <p><strong>source file</strong></p><p><a href="../../../plugin/RV_force.py"><code>RV_force.py</code></a></p> |
+## 4. Force Diagram
 
 **Command:** `RV_force`
 
-<figure><img src="../../.gitbook/assets/lips_3 (1).png" alt=""><figcaption><p>On the right side, the force diagram is created with TextDots marking the angle deviation between the form edge and its 90-degree rotated force edge. The next step, horizontal equilibrium, will aim to reduce this deviation to zero.</p></figcaption></figure>
+Create a force diagram that shows the angle differences between the form and force diagrams. Ideally, they should become orthogonal to each other to achieve a compression-only shell.
 
-## Horizontal Equilibrium
+<figure><img src="../../.gitbook/assets/lips_3.png" alt=""><figcaption></figcaption></figure>
 
-|                                                                                        |                                                                                 |                                                                                                                                |
-| -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
-| <img src="../../.gitbook/assets/RV_horizontal-eq (1).svg" alt="" data-size="original"> | <p><strong>Rhino command name</strong></p><p><code>RV_tna_horizontal</code></p> | <p><strong>source file</strong></p><p><a href="../../../plugin/RV_tna_horizontal.py"><code>RV_tna_horizontal.py</code></a></p> |
+{% file src="../../.gitbook/assets/3_rhinovault_lips_force.json" %}
 
-**Command:** `RV_tna_horizontal` > `Iterations` > `1000`
+***
+
+## 5. Horizontal Equilibrium
+
+**Command:** `RV_tna_horizontal` > `Iterations` > `1000`\
+\
+Set the iteration to 1000 to achieve horizontal equilibrium. Horizontal equilibrium is reached when no TextDot is visible, indicating that the angles between the force and form diagrams are orthogonal within the defined tolerance.
 
-<figure><img src="../../.gitbook/assets/lips_4 (2).png" alt=""><figcaption><p>The horizontal equilibrium minimizes the angles as much as possible, aiming to bring them close to zero.</p></figcaption></figure>
+<figure><img src="../../.gitbook/assets/lips_4 (1).png" alt=""><figcaption><p>.</p></figcaption></figure>
 
-## Modify Form Diagram
+{% file src="../../.gitbook/assets/4_rhinovault_lips_horizontal_thrust.json" %}
 
-|                                                                                              |                                                                               |                                                                                                                            |
-| -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
-| <img src="../../.gitbook/assets/RV_ForceDiagram-modify (1).svg" alt="" data-size="original"> | <p><strong>Rhino command name</strong></p><p><code>RV_force_modify</code></p> | <p><strong>source file</strong></p><p><a href="../../../plugin/RV_force_modify.py"><code>RV_force_modify.py</code></a></p> |
+***
 
-**Command:** `RV_force_modify`> `Edge Attributes` > `Manual`\
+## 6. Modify Force Diagram
 
+**Command:** `RV_force_modify`> `EdgeAttributes` > `Manual`
 
-<figure><img src="../../.gitbook/assets/lips_5.png" alt=""><figcaption><p>Select the edges according to the image from left to right, and set edge length (l_min and l_max) to: a) 15 and 10, b) 3, and 1.</p></figcaption></figure>
+Set the boundary edge length range ([lmin](../../manual/7.-modify-diagrams/supports-1.md) and [lmax](../../manual/7.-modify-diagrams/supports-1.md)) to \[1, 3], and the mesh edges representing the lip to \[10, 15].
 
-## Horizontal Equilibrium
+<figure><img src="../../.gitbook/assets/lips_5.png" alt=""><figcaption></figcaption></figure>
 
-|                                                                                        |                                                                                 |                                                                                                                                |
-| -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
-| <img src="../../.gitbook/assets/RV_horizontal-eq (1).svg" alt="" data-size="original"> | <p><strong>Rhino command name</strong></p><p><code>RV_tna_horizontal</code></p> | <p><strong>source file</strong></p><p><a href="../../../plugin/RV_tna_horizontal.py"><code>RV_tna_horizontal.py</code></a></p> |
+<figure><img src="../../.gitbook/assets/lips_6 (2).png" alt=""><figcaption></figcaption></figure>
+
+{% file src="../../.gitbook/assets/5_rhinovault_lips_modify_horizontal_forces.json" %}
+
+***
+
+## 7. Horizontal Equilibrium
 
 **Command:** `RV_tna_horizontal` > `Iterations` > `1000`
 
-<figure><img src="../../.gitbook/assets/lips_6.png" alt=""><figcaption><p>The horizontal equilibrium is recomputed to obtain minimal forces at the corners.</p></figcaption></figure>
+Rerun the horizontal equilibrium.
+
+<figure><img src="../../.gitbook/assets/lips_7 (1).png" alt=""><figcaption></figcaption></figure>
 
-## Vertical Equilibrium
+{% file src="../../.gitbook/assets/6_rhinovault_lips_horizontal_thrust (2).json" %}
 
-|                                                                                      |                                                                               |                                                                                                                            |
-| ------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
-| <img src="../../.gitbook/assets/RV_vertical-eq (1).svg" alt="" data-size="original"> | <p><strong>Rhino command name</strong></p><p><code>RV_tna_vertical</code></p> | <p><strong>source file</strong></p><p><a href="../../../plugin/RV_tna_vertical.py"><code>RV_tna_vertical.py</code></a></p> |
+***
+
+## 8. Vertical Equilibrium
 
 **Command:** `RV_tna_vertical`&#x20;
 
-<figure><img src="../../.gitbook/assets/lips_7.png" alt=""><figcaption><p>Vertical projection to get 3D geometry.<br>The pipes as colors can be turned on RV_settings > Drawing > show_pipes and show_forces.</p></figcaption></figure>
+The final geometry is computed by running the vertical equilibrium command, keeping the z-height unchanged. For preview, we use the following options:`RV_settings > Drawing > show_pipes` and `show_forces`.
+
+<figure><img src="../../.gitbook/assets/lips_7.png" alt=""><figcaption></figcaption></figure>
+
+{% file src="../../.gitbook/assets/7_rhinovault_vertical_thrust (1).json" %}