MiraGeoscience · benk-mira · May 26, 2026 · May 26, 2026 · May 27, 2026 · May 27, 2026
diff --git a/docs/source/block_model.rst b/docs/source/block_model.rst
@@ -3,13 +3,13 @@
 Block Model Creation
 ====================
 
-.. note::
-
-    Under construction.
-
 The ``Block Model`` module has been developed as a user-interface for the creation of regular (Tensor) BlockModel objects using the `discretize <https://discretize.simpeg.xyz/en/main/>`_ package.
 
-# .. figure:: /images/octree_grid.png
-#    :width: 800
+.. figure:: /images/block_model_creation_uijson.png
+   :width: 500
+
+A Block Model grid is a discretization of a 3D volume into a set of rectangular cells. The core region is defined by both the input ``Object`` with a depth limiter provided by the
+``Core depth (m)``.  Cell sizes are provided for each axis, and a padding region may be specified where the cells expand at a rate given by the ``Expansion factor``.
 
-An Block Model grid is a discretization of a 3D volume into a set of rectangular cells.
+.. figure:: /images/block_model_creation_result.png
+    :width: 800
diff --git a/docs/source/block_model_to_octree.rst b/docs/source/block_model_to_octree.rst
@@ -3,14 +3,17 @@
 Block Model to Octree
 =====================
 
-.. note::
-
-    Under construction.
+.. figure:: /images/block_model_to_octree_uijson.png
+   :width: 500
 
 The ``Block model to Octree`` module has been developed as a user-interface for the conversion between regular (Tensor) BlockModel objects to Octree, using the `discretize <https://discretize.simpeg.xyz/en/main/>`_ package.
-.. figure:: /images/block_model_to_octree_uijson.png
-   :width: 500
-
-The ``Block model to Octree`` module has been developed as a user-interface for the conversion between regular (Tensor) BlockModel objects to Octree, using the `discretize <https://discretize.simpeg.xyz/en/main/>`_ package.
+The ``Block model to Octree`` module has been developed as a user-interface for the conversion between regular (Tensor) BlockModel objects to Octree, using the `discretize <https://discretize.simpeg.xyz/en/main/>`_ package.
+
+.. figure:: /images/block_model_to_octree_uijson.png
+   :width: 500
+   
-.. figure:: /images/block_model_to_octree_uijson.png
-   :width: 500
-
-The ``Block model to Octree`` module has been developed as a user-interface for the conversion between regular (Tensor) BlockModel objects to Octree, using the `discretize <https://discretize.simpeg.xyz/en/main/>`_ package.
+The ``Block model to Octree`` module has been developed as a user-interface for the conversion between regular (Tensor) BlockModel objects to Octree, using the `discretize <https://discretize.simpeg.xyz/en/main/>`_ package.
+
+.. figure:: /images/block_model_to_octree_uijson.png
+   :width: 500
+   
 
-# .. figure:: /images/octree_grid.png
-#    :width: 800
+In its most simple form, the application will create an octree with the core region matching the cells of the block model with a small padding region where the cells are allowed to expand.
-In its most simple form, the application will create an octree with the core region matching the cells of the block model with a small padding region where the cells are allowed to expand.
+In its simplest form, the application will create an octree with the core region matching the cells of the block model. Cells are allowed to expand to the closest octree level within the volume of padding cells.
-In its most simple form, the application will create an octree with the core region matching the cells of the block model with a small padding region where the cells are allowed to expand.
+In its simplest form, the application will create an octree with the core region matching the cells of the block model. Cells are allowed to expand to the closest octree level within the volume of padding cells.
+
+.. figure:: /images/block_model_to_octree_basic_usage.png
+    :width: 800
+
+There is also an option to refine the octree on a specified model.  This will create an octree that is refined in areas that contain large gradient in the provided model.
 
-An octree mesh is a discretization of a 3D volume into a set of rectangular cells. The cells are defined by a tree
-structure, where each node has 8 children.
+.. figure:: /images/block_model_to_octree_advanced.png
+    :width: 800
diff --git a/docs/source/images/block_model_creation_result.png b/docs/source/images/block_model_creation_result.png
diff --git a/docs/source/images/block_model_creation_uijson.png b/docs/source/images/block_model_creation_uijson.png
diff --git a/docs/source/images/block_model_to_octree_advanced.png b/docs/source/images/block_model_to_octree_advanced.png
diff --git a/docs/source/images/block_model_to_octree_basic_usage.png b/docs/source/images/block_model_to_octree_basic_usage.png
diff --git a/docs/source/images/block_model_to_octree_uijson.png b/docs/source/images/block_model_to_octree_uijson.png
diff --git a/docs/source/images/ui_json_general.png b/docs/source/images/ui_json_general.png
diff --git a/docs/source/images/ui_json_refinements.png b/docs/source/images/ui_json_refinements.png