ecmwf · JamesVarndell · Oct 23, 2025 · Oct 23, 2025 · Oct 23, 2025 · Oct 23, 2025
diff --git a/docs/conf.py b/docs/conf.py
@@ -37,8 +37,15 @@
     "sphinx_issues",
     "sphinx_copybutton",
     "xref",
+    "matplotlib.sphinxext.plot_directive",
 ]
 
+# Plot directive configuration
+plot_include_source = True
+plot_html_show_source_link = False
+plot_formats = [("png", 150)]
+plot_html_show_formats = False
+
 # autodoc configuration
 autodoc_typehints = "none"
 

diff --git a/docs/examples/country_polygons.ipynb b/docs/examples/country_polygons.ipynb
@@ -100,7 +100,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.10.6"
+   "version": "3.10.7"
   }
  },
  "nbformat": 4,

diff --git a/docs/examples/grids.ipynb b/docs/examples/grids.ipynb
diff --git a/docs/examples/index.rst b/docs/examples/index.rst
@@ -8,5 +8,6 @@ Here is a list of example notebooks to illustrate how to use earthkit-geo.
 .. toctree::
     :maxdepth: 1
 
+    grids.ipynb
     rotate.ipynb
     country_polygons.ipynb
diff --git a/docs/grids.rst b/docs/grids.rst
@@ -0,0 +1,40 @@
+.. _grids:
+
+Grid Types
+==========
+
+This page provides an overview of all grid types supported by earthkit-geo.
+
+The :class:`~earthkit.geo.grids.Grid` class provides factory methods that automatically return the appropriate grid subclass:
+
+.. code-block:: python
+
+    from earthkit.geo import Grid
+
+    # Automatically returns HEALPix instance
+    grid = Grid.from_string("H32")
+
+    # Automatically returns Equirectangular instance
+    grid = Grid.from_dict({"grid": [1, 1]})
+
+.. autoclass:: earthkit.geo.grids.Equirectangular
+
+----
+
+.. autoclass:: earthkit.geo.grids.HEALPix
+
+----
+
+.. autoclass:: earthkit.geo.grids.ReducedGaussian
+
+----
+
+.. autoclass:: earthkit.geo.grids.Octahedral
+
+----
+
+.. autoclass:: earthkit.geo.grids.ICON_CH1_EPS
+
+----
+
+.. autoclass:: earthkit.geo.grids.ICON_CH2_EPS
diff --git a/docs/index.rst b/docs/index.rst
@@ -33,6 +33,7 @@ Welcome to earthkit-geo's documentation
    :maxdepth: 1
    :caption: Documentation
 
+   grids
    API Reference <autoapi/earthkit/geo/index.rst>
    references.rst
 

diff --git a/docs/requirements.txt b/docs/requirements.txt
@@ -9,3 +9,5 @@ setuptools
 sphinx-autoapi
 sphinx-issues
 sphinx-copybutton
+earthkit-plots
+matplotlib
diff --git a/pyproject.toml b/pyproject.toml
@@ -32,8 +32,10 @@ dependencies = [
   "requests",
   "scipy",
 ]
-optional-dependencies.all = [ "cartopy" ]
+optional-dependencies.all = [ "cartopy", "earthkit-plots", "eckit" ]
 optional-dependencies.cartography = [ "cartopy" ]
+optional-dependencies.grids = [ "eckit" ]
+optional-dependencies.plots = [ "earthkit-plots" ]
 optional-dependencies.test = [
   "pytest",
   "pytest-cov",

diff --git a/src/earthkit/geo/__init__.py b/src/earthkit/geo/__init__.py
@@ -16,6 +16,7 @@
     __version__ = "999"
 
 
+from earthkit.geo import grids
 from earthkit.geo.distance import GeoKDTree
 from earthkit.geo.distance import haversine_distance
 from earthkit.geo.distance import nearest_point_haversine
@@ -30,5 +31,6 @@
     "nearest_point_haversine",
     "nearest_point_kdtree",
     UNIT_SPHERE,
+    "grids",
     "__version__",
 ]