GITBOOK-74: tidying up Pattern

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

@@ -4,19 +4,17 @@
 | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
 | <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> |
 
-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.github.io/main/api/compas.datastructures.html#meshes).
-
-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.&#x20;
-
-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.
+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.
 
 In the case of the rib layout variations for the [rib-stiffened funicular floor system](https://block.arch.ethz.ch/brg/research/rib-stiffened-funicular-floor-system), the boundary remains fixed (the footprint and depth of the floor). However, depending on the topology of the form diagram, the distribution and flow of forces change drastically.&#x20;
 
 <figure><img src="../../.gitbook/assets/3DP-floor.png" alt=""><figcaption><p>3D-printed floor system (Block Research Group)</p></figcaption></figure>
 
 <figure><img src="../../.gitbook/assets/3DP-floor_diagrams.png" alt=""><figcaption><p>Different patterns for the same floor geometry have significantly different force distributions</p></figcaption></figure>
 
-In RhinoVAULT, three types of Rhino geometries can be used to generate a `Pattern :` Lines, Mesh and Surfaces. These pattern generation features would be particularly useful when there is already an existing structure with a geometry that one would like to recreate the pattern for.
+***
+
+In RhinoVAULT, three types of Rhino geometries can be used to generate a `Pattern`: Lines, Mesh and Surfaces. These pattern generation features would be particularly useful when there is already an existing structure with a geometry that one would like to recreate the pattern for.
 
 <figure><img src="../../.gitbook/assets/fanvault.png" alt=""><figcaption><p>Three-dimensional equilibrium analysis of gothic masonry vaults" (Block and Lachauer, 2014)</p></figcaption></figure>
 
@@ -27,7 +25,7 @@ Photographs and diagrams of different rose windows with complex mullion geometri
 <figure><img src="../../.gitbook/assets/rose-windows.png" alt=""><figcaption><p> (a) Notre Dame de Mantes, France; (b) Notre Dame de Chartres, France (Photo by Holly Hayes); (c) Durham Cathedral, England (Photo by Carcharoth on Wikipedia); (d) Notre Dame de Paris, France (Photo by Ellen Brown); (e) Bisshop’s Eye of Lincoln Cathedral, England (Photo from Cornell University Library); (f) Sainte-Chapelle Paris, France.</p></figcaption></figure>
 
 {% hint style="warning" %}
-`Pattern` is a COMPAS [mesh](https://compas-dev.github.io/main/api/generated/compas.datastructures.Mesh.html#compas.datastructures.Mesh) object. A mesh datastructure is network of faces, where the connectivities of the faces are defined by halfedge adjacencies.&#x20;
+`Pattern` is a COMPAS [mesh](https://compas-dev.github.io/main/api/generated/compas.datastructures.Mesh.html#compas.datastructures.Mesh) object. A mesh datastructure is network of faces, where the connectivity of the faces are defined by halfedge adjacencies.&#x20;
 {% endhint %}
 
 ***
@@ -46,16 +44,20 @@ The input set of lines must consist of closed loops of lines representing the fa
 
 ### RhinoMesh
 
-A Rhino mesh object can be used to create a `Pattern`. Since a Pattern is also a mesh object, the vertices and edges can be directly used to create the vertices and edges of the `Pattern`.
+A Rhino mesh object can be used to create a `Pattern`. Since a `Pattern` is a mesh object, the vertices and edges of the Rhino mesh can be directly used to create the vertices and edges of the `Pattern`.
 
 <figure><img src="../../.gitbook/assets/from-mesh.jpg" alt=""><figcaption></figcaption></figure>
 
 ### RhinoSurface
 
-A non-trimmed Rhino surface object can be used to create a Pattern, using subdivision values for U and V.
+A non-trimmed Rhino surface object can be used to create a `Pattern`, using subdivision values for U and V.
 
 <figure><img src="../../.gitbook/assets/from-surface (1).jpg" alt=""><figcaption></figcaption></figure>
 
+{% hint style="warning" %}
+Creating a `Pattern` from RhinoSurface only works for single, non-trimmed surfaces only (not polysurfaces and must have four sides).&#x20;
+{% endhint %}
+
 ### MeshGrid
 
 This function automatically generates a mesh grid using number and size of the grid in x and y directions.