From 282e85021e3c33b715feeeefec8c7c98a03ed3d9 Mon Sep 17 00:00:00 2001
From: Maximilian Linhoff <maximilian.linhoff@tu-dortmund.de>
Date: Tue, 10 Sep 2024 15:02:10 +0200
Subject: [PATCH] Include interpolation in docs

---
 docs/api-reference/monitoring/index.rst         |  2 +-
 docs/api-reference/monitoring/interpolation.rst | 11 +++++++++++
 src/ctapipe/io/__init__.py                      |  7 -------
 src/ctapipe/monitoring/interpolation.py         |  8 +++++++-
 4 files changed, 19 insertions(+), 9 deletions(-)
 create mode 100644 docs/api-reference/monitoring/interpolation.rst

diff --git a/docs/api-reference/monitoring/index.rst b/docs/api-reference/monitoring/index.rst
index 51268d35fc8..c38bf7bb3a9 100644
--- a/docs/api-reference/monitoring/index.rst
+++ b/docs/api-reference/monitoring/index.rst
@@ -18,9 +18,9 @@ Submodules
 
 .. toctree::
   :maxdepth: 1
-  :glob:
 
   aggregator
+  interpolation
   outlier
 
 
diff --git a/docs/api-reference/monitoring/interpolation.rst b/docs/api-reference/monitoring/interpolation.rst
new file mode 100644
index 00000000000..7fab95f007f
--- /dev/null
+++ b/docs/api-reference/monitoring/interpolation.rst
@@ -0,0 +1,11 @@
+.. _monitoring_interpolation:
+
+*************
+Interpolation
+*************
+
+
+Reference/API
+=============
+
+.. automodapi:: ctapipe.monitoring.interpolation
diff --git a/src/ctapipe/io/__init__.py b/src/ctapipe/io/__init__.py
index 28603643160..cfb5fc5501e 100644
--- a/src/ctapipe/io/__init__.py
+++ b/src/ctapipe/io/__init__.py
@@ -18,11 +18,6 @@
 
 from .datawriter import DATA_MODEL_VERSION, DataWriter
 
-from .interpolation import (
-    Interpolator,
-    PointingInterpolator,
-)
-
 __all__ = [
     "HDF5TableWriter",
     "HDF5TableReader",
@@ -40,6 +35,4 @@
     "DataWriter",
     "DATA_MODEL_VERSION",
     "get_hdf5_datalevels",
-    "Interpolator",
-    "PointingInterpolator",
 ]
diff --git a/src/ctapipe/monitoring/interpolation.py b/src/ctapipe/monitoring/interpolation.py
index 82de9f0bd19..84064cbc1a3 100644
--- a/src/ctapipe/monitoring/interpolation.py
+++ b/src/ctapipe/monitoring/interpolation.py
@@ -9,7 +9,10 @@
 
 from ctapipe.core import Component, traits
 
-from .astropy_helpers import read_table
+__all__ = [
+    "Interpolator",
+    "PointingInterpolator",
+]
 
 
 class Interpolator(Component, metaclass=ABCMeta):
@@ -103,6 +106,9 @@ def _check_interpolators(self, tel_id):
                 raise KeyError(f"No table available for tel_id {tel_id}")
 
     def _read_parameter_table(self, tel_id):
+        # prevent circular import between io and monitoring
+        from ..io import read_table
+
         input_table = read_table(
             self.h5file,
             f"{self.telescope_data_group}/tel_{tel_id:03d}",