From f184414668d00c2013443ca284016557c8fe84a5 Mon Sep 17 00:00:00 2001
From: Philip Chmielowiec <philipchmielowiec@gmail.com>
Date: Sun, 10 Dec 2023 00:45:52 -0600
Subject: [PATCH] markdown and admonition formatting

---
 .../02-methods/02-rendering-techniques.ipynb  | 21 ++++++++++++++-----
 notebooks/03-uxarray-vis/03-polygons.ipynb    | 10 +++++----
 notebooks/03-uxarray-vis/04-points.ipynb      | 13 ++++++++++--
 3 files changed, 33 insertions(+), 11 deletions(-)

diff --git a/notebooks/02-methods/02-rendering-techniques.ipynb b/notebooks/02-methods/02-rendering-techniques.ipynb
index e6468617..17992740 100644
--- a/notebooks/02-methods/02-rendering-techniques.ipynb
+++ b/notebooks/02-methods/02-rendering-techniques.ipynb
@@ -29,6 +29,7 @@
     "\n",
     "Rendering each face as a polygon will lead to visuals that look like this, which are extremely high-quality and represent the exact geometry of each face.\n",
     "\n",
+    "&nbsp;\n",
     "\n",
     "<img src=\"../images/rendering/polygons.png\" alt=\"Continents\" width=\"400\"/>"
    ]
@@ -41,6 +42,7 @@
    "source": [
     "Another example of Vector Geometries is encountered when adding features to a visualization, such as Contents or Borders. The geometries of these features are drawn onto our screen.\n",
     "\n",
+    "&nbsp;\n",
     "\n",
     "<img src=\"../images/rendering/contients.jpg\" alt=\"Continents\" width=\"600\"/>"
    ]
@@ -97,9 +99,12 @@
     "\n",
     "While there is definitely merit in rendering each geometric shape directly, this operation is extremely computationally expensive for large datasets.\n",
     "\n",
-    "Rasterization is a technique in computer graphics that converts vector (a.k.a geometric shapes) graphics into a raster image, which is simply a series of pixels.\n",
+    "Rasterization is a technique in computer graphics that converts vector (a.k.a geometric shapes) graphics into a raster image, which can be thought of as a regularly-sampled array of pixel values used for rendering.\n",
+    "\n",
+    "The figure below shows a simplified example of rasterization \"approximates\" the geometry of different elements.\n",
+    "\n",
+    "&nbsp;\n",
     "\n",
-    "The figure below shows how rasterization approximates the geometry of geometries.\n",
     "\n",
     "\n",
     "<img src=\"../images/rendering/raster_example.png\" alt=\"Rasterization Example\" width=\"1000\"/>"
@@ -111,17 +116,23 @@
     "collapsed": false
    },
    "source": [
-    "Below is an example of rasterized polygons plotted against the expected geometry.\n",
+    "For unstructured grids, rasterization looks something like this:\n",
+    "\n",
+    "&nbsp;\n",
     "\n",
     "<img src=\"../images/rendering/raster-vs-vector.png\" alt=\"raster and vector\" width=\"400\"/>"
    ]
   },
   {
    "cell_type": "markdown",
+   "source": [
+    "The black edges outline the expected geometry of each face (a.k.a polygon).\n",
+    "\n",
+    "We can observe the jaggedness in the shading, which is the product of rasterization approximating each face."
+   ],
    "metadata": {
     "collapsed": false
-   },
-   "source": []
+   }
   }
  ],
  "metadata": {
diff --git a/notebooks/03-uxarray-vis/03-polygons.ipynb b/notebooks/03-uxarray-vis/03-polygons.ipynb
index 85b6ce68..705d9348 100644
--- a/notebooks/03-uxarray-vis/03-polygons.ipynb
+++ b/notebooks/03-uxarray-vis/03-polygons.ipynb
@@ -219,8 +219,10 @@
   {
    "cell_type": "markdown",
    "source": [
-    ":::{important}\n",
-    "For large datasets (i.e. 1,000,000 or more faces), it's not recommended to directly plot Polygons.\n",
+    ":::{attention}\n",
+    "For moderately to high resolution grids, it's not recommended to directly plot polygons.\n",
+    "\n",
+    "Plotting each polygon is extremely computationally expensive to render and may not provide the most visually-appealing plots.\n",
     ":::"
    ],
    "metadata": {
@@ -234,7 +236,7 @@
     "\n",
     "Instead of plotting the geometry of each polygon directly, we can rasterize our set of polygons to obtain a raster plot.\n",
     "\n",
-    ":::{remember}\n",
+    ":::{hint}\n",
     "A raster plot of any set of geometric elements (in this case Polygons) renders each data into a regularly shaped array as opposed to rendering each shape directly.\n",
     ":::\n"
    ],
@@ -286,7 +288,7 @@
     "You can select whether to include or exclude these antimeridian polygons by using the `exclude_antimeridian` parameter. \n",
     "\n",
     "\n",
-    ":::{important}\n",
+    ":::{attention}\n",
     "For larger, higher-resolution, grids, it's suggested to keep `exclude_antimeridian=True` to decrease the time needed to process the grid for visualization.\n",
     ":::\n"
    ],
diff --git a/notebooks/03-uxarray-vis/04-points.ipynb b/notebooks/03-uxarray-vis/04-points.ipynb
index 3a3ad456..cf860cce 100644
--- a/notebooks/03-uxarray-vis/04-points.ipynb
+++ b/notebooks/03-uxarray-vis/04-points.ipynb
@@ -137,7 +137,7 @@
     "\n",
     "Instead of plotting the geometry of each point directly, we can rasterize our set of points to obtain a raster plot.\n",
     "\n",
-    ":::{remember}\n",
+    ":::{hint}\n",
     "A raster plot of any set of geometric elements (in this case Points) renders each data into a regularly shaped array as opposed to rendering each shape directly.\n",
     ":::"
    ],
@@ -262,13 +262,22 @@
   {
    "cell_type": "markdown",
    "source": [
-    ":::{Important}\n",
+    ":::{attention}\n",
     "Visualization at higher resolutions, including a discussion about Point Rasterization, is discussed in the \"Visualuzation at Scale\" notebook.\n",
     ":::"
    ],
    "metadata": {
     "collapsed": false
    }
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "outputs": [],
+   "source": [],
+   "metadata": {
+    "collapsed": false
+   }
   }
  ],
  "metadata": {