perfect muack done

Author: h-mayorquin

doc/neuropixels_readers.rst

@@ -42,28 +42,8 @@ convert raw samples to microvolts via the per-contact gains, or to plot
 the recorded contacts alongside the recorded traces.
 
 
-How readers connect the two
----------------------------
-
-A format reader turns a Neuropixels recording into a recording-setup probe
-in three steps:
-
-1. **Fetch the catalogue probe.** Look up the probe part number (SKU) in
-   the recording's metadata, then call
-   :py:func:`build_neuropixels_probe(part_number) <build_neuropixels_probe>`.
-2. **Identify the active electrodes.** Read the recording's channel
-   configuration to find which catalogue contacts were actually recorded,
-   and slice the catalogue probe down to that subset via
-   :py:meth:`probe.get_slice(active_indices) <Probe.get_slice>`.
-3. **Attach the recording-setup metadata.** Add the per-contact gains,
-   reference settings, and sampling order, and set the probe wiring.
-
-The sections below cover where the part number comes from per reader
-(step 1) and where the catalogue data itself comes from.
-
-
-The catalogue
--------------
+The catalogue source
+--------------------
 
 A probe part number (SKU) is an IMEC identifier such as ``"NP1000"``,
 ``"NP2000"``, or ``"NP2014"``. The part number determines the silicon
@@ -77,11 +57,24 @@ ProbeTable is the canonical machine-readable inventory of IMEC Neuropixels
 probe specifications, all keyed by part number.
 
 
-The readers
------------
+Format readers
+--------------
+
+A format reader turns a Neuropixels recording into a recording-setup probe
+in three steps:
+
+1. **Fetch the catalogue probe.** Look up the probe part number (SKU) in
+   the recording's metadata, then call
+   :py:func:`build_neuropixels_probe(part_number) <build_neuropixels_probe>`.
+2. **Identify the active electrodes.** Read the recording's channel
+   configuration to find which catalogue contacts were actually recorded,
+   and slice the catalogue probe down to that subset via
+   :py:meth:`probe.get_slice(active_indices) <Probe.get_slice>`.
+3. **Attach the recording-setup metadata.** Add the per-contact gains,
+   reference settings, and sampling order, and set the probe wiring.
 
-Four readers produce a probe from a Neuropixels recording. They differ in
-where they look up the part number:
+The four readers in probeinterface differ in step 1: where they look up the
+part number in the recording's metadata.
 
 .. list-table::
    :header-rows: 1