8. Settings

	Rhino command name RV_settings	source file RV_settings.py

Under Settings, global parameters (RhinoVAULT, ThrustNetworkAnalysis) and visualization (Drawing) options can be modified. For each of the categories, various parameters and display settings can be modified. The modifiable parameters for each category are summarized below.

---

Categories

RhinoVAULT

These are the global parameters for RhinoVAULT.

• autosave - If set to True, temporary session files are saved every time a change has been made in the scene. This feature is necessary for enabling RhinoVAULT-specific undo/redo, so it is recommended to not turn this off. Set to True by default.

• autoupdate - If set to True, any modifications made in the scene will automatically update the ThrustDiagram. Set to False by default.

ThrustNetworkAnalysis

These are the parameters related to Horizontal equilibrium and Vertical equilibrium solvers.

• horizontal_kmax - Number of iterations to be executed by RV_tna_horizontal (horizontal equilibrium solver). This number can be reset before the solver is run. This number is set to 100 by default.

• horizontal_alpha - Percentage value (0.0 to 100.0) that determines how much influence FormDiagram has during RV_tna_horizontal. For example, an Alpha value of 100.0 means that the FormDiagram remains fixed and only the ForceDiagram will be reconfigures, while an Alpha value of 50 will reconfigure both the FormDiagram and ForceDiagram with equal weight. This value is set to 100.0 by default.

• horizontal_max_angle - Tolerance value for displaying angle deviations. If the maximum angle deviation between a pair of corresponding edges in the FormDiagram and the ForceDiagram is greater than this value, angle deviation will be displayed in the scene with a Rhino dot. This value is set to 5.0 by default.

• horizontal_refreshrate - Number of iterations to skip during dynamic visualization of RV_tna_horizontal. For example, a value of 1 will visualize every iteration step, and therefore take much longer for the final result to be displayed. This value is set to 5 by default.

• vertical_kmax - Number of iterations to be executed by RV_tna_vertical (vertical equilibrium solver). This number is set to 300 by default.

• vertical_zmax - Default target height for the ThrustDiagram. This value is automatically computed and set by the dimensions of the bounding box of the FormDiagram in the scene.

Drawing

These are the visualization parameters for various RhinoVAULT elements.

• show_angles - If set to True, angle deviations between the corresponding edges of the FormDiagram and ForceDiagram are displayed. This is set to True by default.

• show_forces - If set to True, the corresponding edges of the FormDiagram and ForceDiagram are displayed in matching colors. The color gradient is determined based on the relative magnitudes of the internal horizontal forces (Red is higher, blue is lower; the color is independent of whether or not the force is in compression or tension). This is set to False by default.

• show_reactions - If set to True, reaction forces at the supports will be displayed as vectors. This is set to True by default.

• show_residuals - If set to True, residual forces present at every vertex will be displayed as vectors. This is set to False by default.

• show_pipes - If set to True, pipes will be displayed for the edges of the ThrustDiagram. The radius of the pipes are relative to the edge's internal force, subject to scale_pipes. This is set to False by default.

• show_loads - If set to True, any additional loads applied to the ThrustDiagram will be displayed. This is set to False by default.

• show_selfweight - If set to True, self-weight of the ThrustDiagram will be displayed at the vertices. This is set to False by default.

• show_thickness - Not implemented.

• scale_reactions - This value scales all reaction forces. This value is set to 0.1 by default.

• scale_residuals - This value scales all residual forces. This value is set to 1.0 by default.

• scale_pipes - This value scales the radius of all pipes. This is value is set to 0.01 by default.

• scale_loads - This value scales all applied loads on the ThrustDiagam. This value is set to 1.0 by default.

• scale_selfweight - This value scales the vectors representing the self-weight of the ThrustDiagram. This value is set to 1.0 by default.

• tol_vectors - This value is the minimum length for all vectors. This value is set to 0.001 by default.

• tol_pipes - This value is the minimum radius for all pipes. This value is set to 0.01 by default.