docs: add grid module documentation and bibliography support

Author: Hem-W

docs/source/api/grid.rst

@@ -0,0 +1,17 @@
+.. _grid:
+
+Grid Module
+==========
+
+The grid module provides utilities for generating and manipulating spatial grids for climate data analysis.
+
+Fekete Points
+------------
+
+The ``FeketeGrid`` class implements algorithms for generating equidistant points on a sphere, based on the work by :cite:`strnad_climnet_2023`.
+
+.. autoclass:: dominosee.grid.grid.FeketeGrid
+   :members:
+   :undoc-members:
+   :show-inheritance:
+

docs/source/api/index.rst

@@ -21,6 +21,11 @@ Network construction
 
 - :doc:`network`: Network creation and analysis utilities
 
+Grid generation
+--------------
+
+- :doc:`grid`: Grid generation and manipulation utilities
+
 .. Utilities
 .. ---------
 
@@ -34,4 +39,5 @@ Network construction
    eca
    es
    network
+   grid
    .. utilities

docs/source/conf.py

@@ -31,6 +31,8 @@
     'sphinx_copybutton',         # Add copy button to code blocks
     'jupyter_sphinx',            # Execute code in the documentation
     'sphinx_autodoc_typehints',  # Better handling of type hints in docstrings
+    'sphinxcontrib.bibtex',      # Bibliography support
+    'sphinx_design',             # Grid layouts and design elements
 ]
 
 # Add any paths that contain templates
@@ -102,6 +104,9 @@
     'dask': ('https://docs.dask.org/en/stable/', None),
 }
 
+# Bibliography configuration
+bibtex_bibfiles = ['references.bib']
+
 # Include documentation from both class docstring and __init__ docstring
 autoclass_content = 'both'
 

docs/source/references.bib

@@ -0,0 +1,71 @@
+@article{wang_spatially_2025,
+  author = {Wang, Hui-Min and He, Xiaogang},
+  title = {TBA},
+  journal = {TBA},
+  volume = {XX},
+  number = {X},
+  pages = {XXX--XXX},
+  year = {2025},
+  doi = {TBA}
+}
+
+@article{bendito_estimation_2007,
+	title = {Estimation of {Fekete} points},
+	volume = {225},
+	copyright = {https://www.elsevier.com/tdm/userlicense/1.0/},
+	issn = {0021-9991},
+	url = {https://linkinghub.elsevier.com/retrieve/pii/S0021999107001362},
+	doi = {10.1016/j.jcp.2007.03.017},
+	abstract = {We aim here at presenting a new procedure to numerically estimate the Fekete points of a wide variety of compact sets in R3. We understand the Fekete point problem in terms of the identification of near equilibrium configurations for a potential energy that depends on the relative position of N particles.},
+	language = {en},
+	number = {2},
+	urldate = {2025-07-17},
+	journal = {Journal of Computational Physics},
+	author = {Bendito, E. and Carmona, A. and Encinas, A.M. and Gesto, J.M.},
+	month = aug,
+	year = {2007},
+	note = {Publisher: Elsevier BV},
+	pages = {2354--2376},
+}
+
+
+@software{strnad_climnet_2023,
+  author       = {Strnad, Felix and
+                  Schlör, Jakob},
+  title        = {climnet},
+  month        = aug,
+  year         = 2023,
+  publisher    = {Zenodo},
+  version      = {v2.2.0},
+  doi          = {10.5281/zenodo.8233634},
+  url          = {https://doi.org/10.5281/zenodo.8233634},
+}
+
+@article{es_methods_placeholder,
+  author = {Author, C.},
+  title = {Event synchronization methods for climate networks},
+  journal = {Climate Dynamics},
+  volume = {XX},
+  number = {X},
+  pages = {XXX--XXX},
+  year = {2025},
+  doi = {placeholder}
+}
+
+@article{siegmund_coincalcnew_2017,
+	title = {{CoinCalc}—{A} new {R} package for quantifying simultaneities of event series},
+	volume = {98},
+	copyright = {https://www.elsevier.com/tdm/userlicense/1.0/},
+	issn = {0098-3004},
+	url = {https://linkinghub.elsevier.com/retrieve/pii/S0098300416305489},
+	doi = {10.1016/j.cageo.2016.10.004},
+	abstract = {We present the new R package CoinCalc for performing event coincidence analysis (ECA), a novel statistical method to quantify the simultaneity of events contained in two series of observations, either as simultaneous or lagged coincidences within a user-specific temporal tolerance window. The package also provides different analytical as well as surrogate-based significance tests (valid under different assumptions about the nature of the observed event series) as well as an intuitive visualization of the identified coincidences. We demonstrate the usage of CoinCalc based on two typical geoscientific example problems addressing the relationship between meteorological extremes and plant phenology as well as that between soil properties and land cover.},
+	language = {en},
+	urldate = {2025-07-09},
+	journal = {Computers \& Geosciences},
+	author = {Siegmund, Jonatan F. and Siegmund, Nicole and Donner, Reik V.},
+	month = jan,
+	year = {2017},
+	note = {Publisher: Elsevier BV},
+	pages = {64--72},
+}

pyproject.toml

@@ -45,13 +45,15 @@ dev = [
     "cartopy",
 ]
 docs = [
-    "sphinx>=4.0.0",
-    "sphinx-rtd-theme>=1.0.0",
+    "sphinx>=6.0.0",
+    # "sphinx-rtd-theme>=1.0.0",  # Not currently used, using Furo instead
     "furo>=2023.9.10",
     "nbsphinx>=0.8.0",
     "sphinx-copybutton>=0.5.0",
     "jupyter-sphinx>=0.3.2",
     "sphinx-autodoc-typehints>=1.15.0",
+    "sphinx-design>=0.5.0",
+    "sphinxcontrib-bibtex>=2.5.0",
     "matplotlib",
     "cartopy"
 ]