Update the example sections

docs/examples/farrow-resampler.ipynb

@@ -5,6 +5,7 @@
  "cell_type": "markdown",
  "metadata": {},
  "source": [
+ "(farrow-arbitrary-resampler)=\n",
  "# Farrow arbitrary resampler"
  ]
  },

src/sdr/_farrow.py

@@ -14,6 +14,9 @@ class FarrowResampler:
  References:
  - https://wirelesspi.com/fractional-delay-filters-using-the-farrow-structure/
 
+ Examples:
+ See the :ref:`farrow-arbitrary-resampler` example.
+
  Group:
  resampling
  """
@@ -63,6 +66,9 @@ def resample(self, x: np.ndarray, rate: float) -> np.ndarray:
 
  Returns:
  The resampled signal, $y[n] = x(n \frac{T_s}{r})$.
+
+ Examples:
+ See the :ref:`farrow-arbitrary-resampler` example.
  """
  if not rate > 0:
  raise ValueError("Argument 'rate' must be positive.")
@@ -115,10 +121,11 @@ def streaming(self) -> bool:
 
  In streaming mode, the filter state is preserved between calls to :obj:`resample()`.
 
- .. ipython:: python
+ Examples:
+ .. ipython:: python
 
- farrow = sdr.FarrowResampler()
- farrow.streaming
+  farrow = sdr.FarrowResampler()
+  farrow.streaming
  """
  return self._streaming
 
@@ -127,10 +134,11 @@ def order(self) -> int:
  """
  Returns the order of the filter.
 
- .. ipython:: python
+ Examples:
+ .. ipython:: python
 
- farrow = sdr.FarrowResampler()
- farrow.order
+  farrow = sdr.FarrowResampler()
+  farrow.order
  """
  return self._taps.shape[1] - 1
 
@@ -139,9 +147,10 @@ def taps(self) -> np.ndarray:
  """
  Returns the Farrow filter taps.
 
- .. ipython:: python
+ Examples:
+ .. ipython:: python
 
- farrow = sdr.FarrowResampler()
- farrow.taps
+  farrow = sdr.FarrowResampler()
+  farrow.taps
  """
  return self._taps