Bug: Doc: clean up imports in doc

.circleci/config.yml

@@ -83,7 +83,7 @@ jobs:
           command: |
             pip install ".[docs]"
             cd docs/
-            make html
+            make html SPHINXOPTS="-W"
 
   test_deprecation_warnings:
     parameters:

docs/api_reference.rst

@@ -23,13 +23,13 @@ Modules
 
 .. toctree::
    :maxdepth: 1
-
+   
    modules/spharpy.beamforming
-   modules/spharpy.indexing
    modules/spharpy.interpolate
    modules/spharpy.plot
    modules/spharpy.samplings
    modules/spharpy.spatial
+   modules/spharpy.special
    modules/spharpy.spherical
    modules/spharpy.transforms
 

docs/spharpy.special.rst → docs/modules/spharpy.special.rst

@@ -1,7 +1,8 @@
 spharpy.special
------------------
+---------------
 
 .. automodule:: spharpy.special
    :members:
+   :special-members: __init__
    :undoc-members:
    :show-inheritance:

spharpy/classes/audio.py

@@ -52,7 +52,7 @@ class SphericalHarmonicSignal(Signal):
     fft_norm : str, optional
         The normalization of the Discrete Fourier Transform (DFT). Can be
         ``'none'``, ``'unitary'``, ``'amplitude'``, ``'rms'``, ``'power'``,
-        or ``'psd'``. See :py:func:`~pyfar.dsp.fft.normalization` and [#]_
+        or ``'psd'``. See :py:func:`~pyfar.dsp.fft.normalization`
         for more information. The default is ``'none'``, which is typically
         used for energy signals, such as impulse responses.
     comment : str

spharpy/spherical.py

@@ -93,6 +93,8 @@ def nm_to_fuma(n, m):
     and degree m, according to the FuMa (Furse-Malham)
     Channel Ordering Convention.
 
+    See [#]_ for details.
+
     Parameters
     ----------
     n : integer, ndarray
@@ -137,7 +139,9 @@ def fuma_to_nm(fuma):
     r"""
     Calculate the spherical harmonic order n and degree m for a linear
     coefficient index, according to the FuMa (Furse-Malham)
-    Channel Ordering Convention [#]_.
+    Channel Ordering Convention.
+
+    See [#]_ for details.
 
     FuMa = WXYZ | RSTUV | KLMNOPQ
     ACN = WYZX | VTRSU | QOMKLNP
@@ -472,7 +476,7 @@ def spherical_harmonic_basis_gradient(n_max, coordinates, normalization="n3d",
 
 
     This implementation avoids singularities at the poles using identities
-    derived in [#]_.
+    derived in [#]_ and [#]_.
 
 
     References