build/doc: change doc settings to run with python 3.11 and numpy v2 (and disable dtcwt

Author: mrava87

.readthedocs.yaml

@@ -9,7 +9,7 @@ version: 2
 build:
   os: ubuntu-20.04
   tools:
-    python: "3.9"
+    python: "3.11"
 
 # Build documentation in the docs/ directory with Sphinx
 sphinx:

docs/source/conf.py

@@ -60,14 +60,16 @@
 numpydoc_class_members_toctree = False
 
 sphinx_gallery_conf = {
-    # path to your examples scripts
+    # Path to examples scripts
     "examples_dirs": [
         "../../examples",
         "../../tutorials",
     ],
-    # path where to save gallery generated examples
+    # Path where to save gallery generated examples
     "gallery_dirs": ["gallery", "tutorials"],
     "filename_pattern": r"\.py",
+    # Examples to skip when building the gallery
+    "ignore_pattern": r"plot_dtcwt\.py$",
     # Remove the "Download all examples" button from the top level gallery
     "download_all_examples": False,
     # Sort gallery example by file name instead of number of lines (default)

docs/source/installation.rst

@@ -322,10 +322,6 @@ In alphabetic order:
 dtcwt
 -----
 
-.. warning::
-
-   ``dtcwt`` is not yet supported with Numpy 2.
-
 `dtcwt <https://dtcwt.readthedocs.io/en/0.12.0/>`_ is a library used to implement the DT-CWT operators.
 
 Install it via ``pip`` with:
@@ -334,7 +330,9 @@ Install it via ``pip`` with:
 
    >> pip install dtcwt
 
-
+.. warning::
+   ``dtcwt`` does not support NumPy 2 yet, so make sure you use NumPy 1.x 
+   to be able to use the ``DTCWT`` operator.
 
 Devito
 ------
@@ -439,6 +437,7 @@ It can also be checked dynamically with ``numba.config.NUMBA_DEFAULT_NUM_THREADS
 
 PyMC and PyTensor
 -----------------
+
 `PyTensor <https://pytensor.readthedocs.io/en/latest/>`_ is used to allow seamless integration between PyLops and 
 `PyMC <https://www.pymc.io/welcome.html>`_ operators.
 Install both of them via ``conda`` with:
@@ -453,10 +452,11 @@ or via ``pip`` with
 
    >> pip install pytensor pymc
 
-.. note::
-   PyTensor does not support NumPy 2 yet, so make sure you use NumPy 1.x with PyTensor and PyMC.
-
-.. note::
+.. warning::
+   ``PyTensor`` does not support NumPy 2 yet, so make sure you use NumPy 1.x with PyTensor and PyMC.
+   to be able to use PyLops operators with ``PyMC``.
+   
+.. warning::
    OSX users may experience a ``CompileError`` error when using PyTensor. This can be solved by adding 
    ``pytensor.config.gcc__cxxflags = "-Wno-c++11-narrowing"`` after ``import pytensor``.
 

requirements-doc.txt

@@ -1,20 +1,14 @@
-# Currently we force rdt to use numpy<2.0.0 to build the documentation
-# since the dtcwt is not yet compatible with numpy=2.0.0. For the
-# same reason, we force devito==4.8.6 as later versions of devito
-# require numpy>=2.0.0
-numpy>=1.21.0,<2.0.0
-scipy>=1.11.0,<1.13
+numpy>=2.0.0
+scipy>=1.13.0
 jax
---extra-index-url https://download.pytorch.org/whl/cpu
-torch>=1.2.0
 numba
 pyfftw
 PyWavelets
 spgl1
 scikit-fmm
 sympy
-devito==4.8.6
-dtcwt
+devito
+# dtcwt (until numpy>=2.0.0 is supported)
 matplotlib
 ipython
 pytest