GITBOOK-82: Tutorial - create and modify pattern

gitbook/introduction/tutorial.md

@@ -1,27 +1,116 @@
 # Tutorial
 
-In this tutorials, we will use COMPAS RHinoVAULT to find the equilibrium shape
-of a simple compression shell with 4 corner supports and unsupported, open boundaries.
+<figure><img src="../.gitbook/assets/RV_tutorial_cover (1).png" alt=""><figcaption></figcaption></figure>
 
-We will go through the following steps:
+In this tutorial, we will use all of the basic RhinoVAULT features to find the equilibrium shape of a simple compression shell with 4 corner supports and unsupported, open boundaries. This tutorial is intended to be a “quick start” guide of the main steps and procedures of the RhinoVAULT workflow. Specific parameters and optional features will not be addressed in detail. We will go through the following steps:
 
-1. Define a force pattern.
-2. Define the boundary conditions.
-3. Make a form diagram.
-4. Make a force diagram.
-5. Compute horizontal equilibrium.
-6. Compute vertical equilibrium.
+1. Create & Modify Pattern
+2. Define Boundary Conditions.
+3. Form Diagram
+4. Force Diagram
+5. Horizontal Equilibrium
+6. Vertical Equilibrium
+7. Modify Diagrams (skip)
+8. Settings
+9. Utilities
 
-## Force pattern
+***
 
-## Boundary conditions
+## 1. Create & Modify Pattern
+
+### 1a. Create Pattern
+
+A `Pattern` is a collection of lines that define the topology of the form diagram. In this tutorial, we will use the `MeshGrid` option to generate a simple 10x10 orthogonal grid. You have the option to choose the size of the mesh and the number of division in x and y axis.
+
+From the RhinoVAULT toolbar, click <img src="../.gitbook/assets/RV_pattern (1).svg" alt="" data-size="line"> or type `RV_pattern` in the command line. From the sub-commands, select `MeshGrid`. From the option prompts that follow, enter through them to keep the default settings. The default settings will create an orthogonal grid that has a dimension of 10 (in current Rhino units) in X and Y directions, with 10 subdivisions in X and Y directions.
+
+<figure><img src="../.gitbook/assets/RV_tutorial_01_pattern.png" alt=""><figcaption></figcaption></figure>
+
+<div data-full-width="false">
+
+<figure><img src="../.gitbook/assets/RV_tutorial_02_meshgrid.png" alt=""><figcaption></figcaption></figure>
+
+</div>
+
+### 1b. Modify Pattern
+
+RhinoVAULT provides various mechanisms for modifying the geometry of the `Pattern`, such as moving vertices, changing attributes of vertices and edges, and relaxing. These features will not be covered in this tutorial.&#x20;
+
+***
+
+## 2. Define  Boundary Conditions
+
+
+
+
+
+
+
+***
+
+## 3. Form Diagram
+
+
+
+
+
+
+
+***
+
+## 4. Force Diagram
+
+
+
+
+
+
+
+***
+
+## 5. Horizontal Equilibrium&#x20;
+
+
+
+
+
+
+
+***
+
+## 6. Boundary conditions
+
+
+
+
+
+
+
+***
+
+## 7. Modify Diagrams (skip)
+
+
+
+
+
+
+
+***
+
+## 8. Settings
+
+
+
+
+
+
+
+***
+
+## 9. Utilities
 
-## Form Diagram
 
-## Force Diagram
 
-## Horizontal Equilibrium
 
-## Vertical Equilibrium
 
-## Thrust Diagram

gitbook/manual/1.-create-and-modify-pattern/patterns.md

@@ -1,8 +1,8 @@
 # 1a. Create Pattern
 
-|                                                                              |                                                                          |                                                                                                                  |
-| ---------------------------------------------------------------------------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
-| <img src="../../.gitbook/assets/RV_pattern.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> |
+|                                                                                  |                                                                          |                                                                                                                  |
+| -------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
+| <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> |
 
 The first step of the workflow is to generate the topology of the `FormDiagram`, which is called the `Pattern` in RhinoVAULT. A `Pattern` is a collection of vertices interconnected by lines, represented by the COMPAS [mesh datastructure](https://compas.dev/compas/latest/api/compas.datastructures.Mesh.html). RhinoVAULT offers several methods for generating a `Pattern`. Each method has a direct influence not only on the topology of the eventual shell structure, but also the type of application and interaction that is desired during the design process.There are many ways to generate a topological pattern. Each method has pros and cons, and the desired design or workflow will help determine which method is more appropriate.