GITBOOK-35: vertical equilibrium

Author: juney-lee

gitbook/.gitbook/assets/RV_ForceDiagram-modify (1).svg

@@ -1,13 +1,17 @@
 # 6. Vertical equilibrium
 
-|                                                                                   |                                                                                                                                                                                                             |   |
-| --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - |
-| <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></p><p><strong>source file</strong></p><p><a href="../../plugin/RV_tna_vertical.py"><code>RV_tna_vertical.py</code></a></p> |   |
+|                                                                               |                                                                               |                                                                                                                         |
+| ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| <img src="../.gitbook/assets/RV_vertical-eq.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> |
 
-Once the Form and Force Diagrams have been created and horizontal equilibrium has been established through parallelisation, the distribution of horizontal forces in the system is fixed. The actual magnitude of the horizontal forces depends on a _scale factor_ and will determine the target heightof the final thrust diagram. A higher scale factor results in higher horizontal forces and therefore a shallower three-dimensional shape. Vice versa, a lower scale factor results in lower horizontal thrust and thus a deeper solution.
+## Target Height
+
+Once the Form and Force Diagrams have been created and horizontal equilibrium has been established through parallelisation, the distribution of horizontal forces in the system is fixed. The actual magnitude of the horizontal forces depends on a _scale factor_ and will determine the _target height_ of the final thrust diagram. A higher scale factor results in higher horizontal forces and therefore a shallower three-dimensional shape. Vice versa, a lower scale factor results in lower horizontal thrust and thus a deeper solution.
 
 The meaning of the scale factor and the magnitude of horizontal forces is related to the magnitude of the loads, which in turn are related to the self-weight of the resulting three-dimensional geometry. Rather than asking you to "guess" the scale factor to get the three-dimensional shape you want, RhinoVAULT will determine the scale for you based on the desired height of the final solution. The default value for the target height is 25% of the length of the diagonal of the bounding box of the Form Diagram (essentially of the bounding box of the footprint of your shell). This value tends to produce well-proportioned geometries.
 
+***
+
 ## Thrust Diagram
 
 In RhinoVAULT, the `ThrustDiagram` representing the thrust network, is an instance of the `FormDiagram`, with the only difference being the $$z$$ coordinates. A `ThrustDiagram` is simply an alternate visualisation of the `FormDiagram` with updated $$z$$ coordinates. When a `FormDiagram` is successfully created, the `ThrustDiagram` is automatically created.&#x20;

gitbook/.gitbook/assets/RV_ForceDiagram-modify.svg

@@ -20,6 +20,8 @@ $$
 
 Note that using `alpha` efficiently requires a bit of practice and experience. Since the Form Diagram defines the intended  layout of horizontal forces and RV2 has many tools for designing force layouts that provide a good starting point for form finding explorations, it is usually a good idea to start with `alpha = 100`. However, once you have the horizontal equilibrium under control, playing around with lower `alpha` values can have a significant influence on finding nicely balanced force distributions.
 
+***
+
 ## Iterations
 
 Computing horizontal equilibrium is an iterative process. The default number of iterations is `100`. For sensible force layouts, this value should go a long way. However, there are many cases in which more iterations are required. For example, if the Form Diagram has multiple open/unsupported edges, and especially if those edges have a low "sag" value, more iterations will typically be required to reduce all angle deviations between corresponding edges to less than 5 degrees.
@@ -28,6 +30,8 @@ Computing horizontal equilibrium is quite fast. Therefore, don't hesitate to set
 
 Furthermore, resolving all angle deviations is not an absolute requirement, and is in many cases unnecessary. For example, the angle deviations between very short edges tend to be quite persistent as they are dominated by edges with (much) longer lengths during the calculation process. Since short edges in the Force Diagram also represent (relatively) small horizontal forces, these deviations can often be ignored.
 
+***
+
 ## Refreshrate
 
 The iterations of the horizontal equilibrium calculation process is dynamically visualised. The rate at which the diagrams are updated is controlled by the refreshrate. The default value is `10`, which means that the diagrams are updated every 10 iterations.

gitbook/.gitbook/assets/RV_FormDiagram-modify (1).svg

@@ -2,19 +2,19 @@
 
 ## 7a. Modify FormDiagram
 
-|   |                                                                                                                                                                                                          |   |
-| - | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - |
-|   | <p><strong>Rhino command name</strong></p><p><code>RV_form_modify</code></p><p></p><p><strong>source file</strong></p><p><a href="../../plugin/RV_form_modify.py"><code>RV_form_modify.py</code></a></p> |   |
+|                                                                                          |                                                                              |                                                                                                                       |
+| ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| <img src="../.gitbook/assets/RV_FormDiagram-modify (1).svg" alt="" data-size="original"> | <p><strong>Rhino command name</strong></p><p><code>RV_form_modify</code></p> | <p><strong>source file</strong></p><p><a href="../../plugin/RV_form_modify.py"><code>RV_form_modify.py</code></a></p> |
 
 
 
 ***
 
 ## 7b. Modify Forcediagram
 
-|   |                                                                                                                                                                                                             |   |
-| - | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - |
-|   | <p><strong>Rhino command name</strong></p><p><code>RV_force_modify</code></p><p></p><p><strong>source file</strong></p><p><a href="../../plugin/RV_force_modify.py"><code>RV_force_modify.py</code></a></p> |   |
+|                                                                                           |                                                                               |                                                                                                                         |
+| ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| <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> |
 
 
 
@@ -24,7 +24,7 @@
 
 ## 7c. Modify ThrustDiagram
 
-|   |                                                                                                                                                                                                                |   |
-| - | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - |
-|   | <p><strong>Rhino command name</strong></p><p><code>RV_thrust_modify</code></p><p></p><p><strong>source file</strong></p><p><a href="../../plugin/RV_thrust_modify.py"><code>RV_thrust_modify.py</code></a></p> |   |
+|                                                                                        |                                                                                |                                                                                                                           |
+| -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- |
+| <img src="../.gitbook/assets/RV_ThrustDiagram-modify.svg" alt="" data-size="original"> | <p><strong>Rhino command name</strong></p><p><code>RV_thrust_modify</code></p> | <p><strong>source file</strong></p><p><a href="../../plugin/RV_thrust_modify.py"><code>RV_thrust_modify.py</code></a></p> |