dtscalibration · bdestombe · Oct 27, 2023 · Aug 14, 2023 · Aug 14, 2023 · Aug 14, 2023
diff --git a/.gitignore b/.gitignore
@@ -57,6 +57,7 @@ output/*/index.html
 
 # Sphinx
 docs/_build
+**/generated/**/*
 
 .DS_Store
 *~

diff --git a/README.rst b/README.rst
@@ -93,6 +93,7 @@ Devices currently supported
 Documentation
 =============
 
+* A full calibration procedure for single-ended setups is presented in notebook `07Calibrate_single_ended.ipynb <https://github.com/dtscalibration/python-dts-calibration/blob/main/docs/notebooks/07Calibrate_single_ended.ipynb>`_ and for double-ended setups in `08Calibrate_double_ended.ipynb <https://github.com/dtscalibration/python-dts-calibration/blob/main/docs/notebooks/08Calibrate_double_ended.ipynb>`_.
 * Documentation at https://python-dts-calibration.readthedocs.io/ .
 * Example notebooks that work within the browser can be viewed `here <https://python-dts-calibration.readthedocs.io/en/latest/learn_by_examples.html>`_.
 

diff --git a/docs/api/dtscalibration.DataStore.rst b/docs/api/dtscalibration.DataStore.rst
diff --git a/docs/api/dtscalibration.check_dims.rst b/docs/api/dtscalibration.check_dims.rst
diff --git a/docs/api/dtscalibration.check_timestep_allclose.rst b/docs/api/dtscalibration.check_timestep_allclose.rst
diff --git a/docs/api/dtscalibration.get_netcdf_encoding.rst b/docs/api/dtscalibration.get_netcdf_encoding.rst
diff --git a/docs/api/dtscalibration.merge_double_ended.rst b/docs/api/dtscalibration.merge_double_ended.rst
diff --git a/docs/api/dtscalibration.open_datastore.rst b/docs/api/dtscalibration.open_datastore.rst
diff --git a/docs/api/dtscalibration.open_mf_datastore.rst b/docs/api/dtscalibration.open_mf_datastore.rst
diff --git a/docs/api/dtscalibration.plot_accuracy.rst b/docs/api/dtscalibration.plot_accuracy.rst
diff --git a/docs/api/dtscalibration.plot_location_residuals_double_ended.rst b/docs/api/dtscalibration.plot_location_residuals_double_ended.rst
diff --git a/docs/api/dtscalibration.plot_residuals_reference_sections.rst b/docs/api/dtscalibration.plot_residuals_reference_sections.rst
diff --git a/docs/api/dtscalibration.plot_residuals_reference_sections_single.rst b/docs/api/dtscalibration.plot_residuals_reference_sections_single.rst
diff --git a/docs/api/dtscalibration.plot_sigma_report.rst b/docs/api/dtscalibration.plot_sigma_report.rst
diff --git a/docs/api/dtscalibration.read_apsensing_files.rst b/docs/api/dtscalibration.read_apsensing_files.rst
diff --git a/docs/api/dtscalibration.read_sensornet_files.rst b/docs/api/dtscalibration.read_sensornet_files.rst
diff --git a/docs/api/dtscalibration.read_sensortran_files.rst b/docs/api/dtscalibration.read_sensortran_files.rst
diff --git a/docs/api/dtscalibration.read_silixa_files.rst b/docs/api/dtscalibration.read_silixa_files.rst
diff --git a/docs/api/dtscalibration.shift_double_ended.rst b/docs/api/dtscalibration.shift_double_ended.rst
diff --git a/docs/api/dtscalibration.suggest_cable_shift_double_ended.rst b/docs/api/dtscalibration.suggest_cable_shift_double_ended.rst
diff --git a/docs/conf.py b/docs/conf.py
@@ -1,7 +1,11 @@
-# -*- coding: utf-8 -*-
-from datetime import date
 import os
+from datetime import date
+
+from xarray import Dataset  # noqa: E402
+import sphinx_autosummary_accessors
 
+import dtscalibration  # noqa: E402
+from dtscalibration.dts_accessor import DtsAccessor  # noqa: E402
 
 extensions = [
     "sphinx_rtd_theme",
@@ -15,6 +19,7 @@
     "sphinx.ext.todo",
     "sphinx.ext.viewcode",
     "sphinx.ext.autosectionlabel",
+    "sphinx_autosummary_accessors",
     "nbsphinx",
     "sphinx.ext.mathjax",
     "sphinx.ext.intersphinx",
@@ -41,11 +46,11 @@
 project = "dtscalibration"
 year = str(date.today().year)
 author = "Bas des Tombe and Bart Schilperoort"
-copyright = "{0}, {1}".format(year, author)
+copyright = f"{year}, {author}"
 version = release = "2.0.0"
 
 pygments_style = "trac"
-templates_path = ["."]
+templates_path = [".", sphinx_autosummary_accessors.templates_path]
 extlinks = {
     "issue": (
         "https://github.com/dtscalibration/python-dts-calibration/issues" "/%s",
@@ -63,7 +68,7 @@
 html_sidebars = {
     "**": ["searchbox.html", "globaltoc.html", "sourcelink.html"],
 }
-html_short_title = "%s-%s" % (project, version)
+html_short_title = f"{project}-{version}"
 
 napoleon_use_ivar = True
 napoleon_use_rtype = False

diff --git a/docs/notebooks/01Load_xml_measurement_files.ipynb b/docs/notebooks/01Load_xml_measurement_files.ipynb
@@ -7,13 +7,13 @@
    "source": [
     "# 1. Load your first measurement files\n",
     "\n",
-    "The goal of this notebook is to show the different options of loading measurements from raw DTS files. These files are loaded into a `DataStore` object. This object has various methods for calibration, plotting. The current supported devices are:\n",
+    "The goal of this notebook is to show the different options of loading measurements from raw DTS files. These files are loaded into a `xarray.Dataset` object. This object has various methods for calibration, plotting. Both single-ended and double-ended measurements are supported. The current supported devices are:\n",
     "- Silixa\n",
     "- Sensornet\n",
+    "- AP Sensing\n",
+    "- Sensortran\n",
     "\n",
-    "This example loads Silixa files. Both single-ended and double-ended measurements are supported. The first step is to load the correct read routine from `dtscalibration`.\n",
-    "- Silixa -> `dtscalibration.read_silixa_files`\n",
-    "- Sensornet -> `dtscalibration.read_sensornet_files`"
+    "See notebooks A2, A3, and A4."
    ]
   },
   {
@@ -125,20 +125,6 @@
    "source": [
     "print(ds)"
    ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": []
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": []
   }
  ],
  "metadata": {
@@ -157,7 +143,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.10.5"
+   "version": "3.10.10"
   }
  },
  "nbformat": 4,