Update Model Setup - Context page

docs/model-setup-context.rst

@@ -4,27 +4,39 @@ Model Setup - Context
 
 In addition to the Rhino layer for buildings, a new umi project has a variety of other context layers for other objects relevant to various aspects of urban simulation. Each of these is a sublayer of the "Context" layer, which is in turn a sublayer of the "umi" layer, and is explained below.
 
-1. Streets
-----------
+Streets
+-------
 
    The umi mobility analysis module relies upon the existance of a suitable street network for the site. This network should exist on the Rhino "Streets" layer. For details on setting it up, refer to the relevant section of the user guide.
 
-2. Ground
----------
+Site boundary
+-------------
 
-   The "Ground" layer contains user-specified, site-level ground objects. These objects are used to establish the site area for the purposes of calculating the site Floor Area Ratio (FAR). See :ref:`site-stats-far` for details.
+   The "Site boundary" layer contains closed polylines that mark the boundaries of the site. The total area enclosed by these polylines is used to calculate the site Floor Area Ratio (FAR). Please note that the site area should not includes streets and public sidewalks. See the Site Analysis Module for details.
 
-3. Parks
---------
+Parks
+-----
 
    Objects on the "Parks" layer can be used in mobility calculations. For details, see the relevant User Guide section.
 
-4. Shading/Trees
-----------------
+Shading
+----------
 
-   Objects on these layers are used for operational energy simulations. Objects on the "Shading" layer are used to calculate shadows cast on simulated buildings. This is used for shading objects that do not touch the buildings to be analyzed.
+   Objects on these layers are used for operational energy and daylight simulations. Objects on the "Shading" layer are used to calculate shadows cast on simulated buildings. This is used for shading objects that do not touch the buildings to be analyzed.
 
-5. Boundary Objects
--------------------
+Boundary Objects
+----------------
 
    Boundary objects are similar to the shading objects. They are used for contextual shading. However, on these objects an adjacency test is performed in order to detect adjacencies and adiabatic surfaces. Boundary objects have to be closed breps.
+
+
+Water bodies
+------------
+
+   This layer consists of surfaces that correspond to outdoor bodies of water such as rivers and swimming pools. This layer is currently only used by an experimental water use module.
+
+
+Irrigated land
+--------------
+
+   This layer consists of surfaces that correspond to land surfaces on site that are actively irrigated. This layer is currently only used by an experimental water use module.

docs/umi_bundle.rst

@@ -7,9 +7,9 @@
 What is an UMI bundle?
 ======================
 
-UMI stores all project information in a single file called an UMI bundle. The file has the extension *.UMI and has the format of a Microsoft Windows ZIP archive file. When you open an UMI bundle, the project content is extracted into a temporary directory on your computer. While you are working in UMI, files in that directory get updated and/or created. When an UMI project is saved, the directory content is saved back into the UMI bundle.
+UMI stores all project information in a single file called an UMI bundle. The file has the extension FILE.UMI and has the format of a Microsoft Windows ZIP archive file. When you open an UMI bundle, the project content is extracted into a temporary directory on your computer. While you are working in UMI, files in that directory get updated and/or created. When an UMI project is saved, the directory content is saved back into the UMI bundle.
 
-To access the content of an UMI bundle, rename the file extension to *.ZIP and open the file. A typical bundle content is shown below.
+To access the content of an UMI bundle, rename the file extension to FILE.ZIP and open the file. A typical bundle content is shown below.
 
 
 .. figure:: ./assets/UMI_zip_file.PNG