From 1a8dd4a0fef244c955238d0daac5131a8a5ab414 Mon Sep 17 00:00:00 2001 From: Juney Lee Date: Sun, 10 Nov 2024 20:27:11 +0000 Subject: [PATCH] GITBOOK-38: splitting up modify functions --- gitbook/SUMMARY.md | 4 +++- gitbook/manual/9.-utilities.md | 4 ---- gitbook/manual/fitting.md | 23 ++++++++++++++++++---- gitbook/manual/horizontal-equilibrium.md | 25 ++++++++++++------------ gitbook/manual/supports-1.md | 10 ++++++++++ gitbook/manual/supports-2.md | 6 ++++++ gitbook/manual/supports.md | 20 +------------------ 7 files changed, 51 insertions(+), 41 deletions(-) create mode 100644 gitbook/manual/supports-1.md create mode 100644 gitbook/manual/supports-2.md diff --git a/gitbook/SUMMARY.md b/gitbook/SUMMARY.md index d32bbca..3989e24 100644 --- a/gitbook/SUMMARY.md +++ b/gitbook/SUMMARY.md @@ -21,7 +21,9 @@ * [4. Force diagram](manual/equilibrium.md) * [5. Horizontal equilibrium](manual/horizontal-equilibrium.md) * [6. Vertical equilibrium](manual/fitting.md) -* [7. Modify diagrams](manual/supports.md) +* [7a. Modify FormDiagram](manual/supports.md) +* [7b. Modify ForceDiagram](manual/supports-1.md) +* [7c. Modify ThrustDiagram](manual/supports-2.md) * [8. Settings](manual/settings.md) * [9. Utilities](manual/9.-utilities.md) diff --git a/gitbook/manual/9.-utilities.md b/gitbook/manual/9.-utilities.md index 4ba0e37..39e14af 100644 --- a/gitbook/manual/9.-utilities.md +++ b/gitbook/manual/9.-utilities.md @@ -1,7 +1,3 @@ ---- -hidden: true ---- - # 9. Utilities ## Undo diff --git a/gitbook/manual/fitting.md b/gitbook/manual/fitting.md index 1aee147..913cc4c 100644 --- a/gitbook/manual/fitting.md +++ b/gitbook/manual/fitting.md @@ -4,7 +4,19 @@ | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | | |

Rhino command name

RV_tna_vertical

|

source file

RV_tna_vertical.py

| -## Target Height +Description. + + + +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. + +A `ThrustDiagram` is represented by the mesh datastructure. + +*** + +## Algorithm Parameter + +### 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. @@ -12,8 +24,11 @@ The meaning of the scale factor and the magnitude of horizontal forces is relate *** -## Thrust Diagram +Note on height... + + + + + -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. -A `ThrustDiagram` is represented by the mesh datastructure. diff --git a/gitbook/manual/horizontal-equilibrium.md b/gitbook/manual/horizontal-equilibrium.md index 2c1c676..84c039b 100644 --- a/gitbook/manual/horizontal-equilibrium.md +++ b/gitbook/manual/horizontal-equilibrium.md @@ -8,15 +8,7 @@ This function geometrically reconfigures the the edges of the ForceDiagram, such *** -## Deviation Angles - - - - - -*** - -## Sub functions +## Algorithm Parameters ### Alpha @@ -34,8 +26,6 @@ $$ 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. @@ -44,10 +34,19 @@ 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. For large diagrams the dynamic visualisation slows down the calculations a little bit. In these cases, and/or for high numbers of iterations (`> 1000`), it is therefore advisable to set the refreshrate to a higher value. For example, if the number of iterations is `1000`, then a refresh rate of `100` seems more appropriate. + + + +*** + +## Deviation Angles + + + + + diff --git a/gitbook/manual/supports-1.md b/gitbook/manual/supports-1.md new file mode 100644 index 0000000..1027e59 --- /dev/null +++ b/gitbook/manual/supports-1.md @@ -0,0 +1,10 @@ +# 7b. Modify ForceDiagram + +| | | | +| ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | +| |

Rhino command name

RV_force_modify

|

source file

RV_force_modify.py

| + + + + + diff --git a/gitbook/manual/supports-2.md b/gitbook/manual/supports-2.md new file mode 100644 index 0000000..1e1f25c --- /dev/null +++ b/gitbook/manual/supports-2.md @@ -0,0 +1,6 @@ +# 7c. Modify ThrustDiagram + +| | | | +| -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- | +| |

Rhino command name

RV_thrust_modify

|

source file

RV_thrust_modify.py

| + diff --git a/gitbook/manual/supports.md b/gitbook/manual/supports.md index 822521a..efa2b5f 100644 --- a/gitbook/manual/supports.md +++ b/gitbook/manual/supports.md @@ -1,6 +1,4 @@ -# 7. Modify diagrams - -## 7a. Modify FormDiagram +# 7a. Modify FormDiagram | | | | | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | @@ -8,23 +6,7 @@ -*** - -## 7b. Modify Forcediagram - -| | | | -| ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | -| |

Rhino command name

RV_force_modify

|

source file

RV_force_modify.py

| - - - - -*** -## 7c. Modify ThrustDiagram -| | | | -| -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- | -| |

Rhino command name

RV_thrust_modify

|

source file

RV_thrust_modify.py

|