Add guidelines about lighthouse base station mounting configuration

source/Hardware Guide/Lighthouses/setup.rst

@@ -3,23 +3,69 @@
 Setup
 #########################
 
-1. Mount 2 Vive Base Station Lighthouses over the setup.
+1.  Mount 2 HTC Vive Base Station v1.0 Lighthouses over the behavioral arena. Here we've used aluminum extrusion parts and made use of the 1/4"-20 mounting holes on the lighthouses.
 
-   .. image:: ../../_static/images/lighthouses/vive_front.jpg
-     :width: 48 %
-   .. image:: ../../_static/images/lighthouses/vive_front.jpg
-     :width: 48 %
+    ..  figure:: ../../_static/images/lighthouses/lighthouse-mount-example.png
 
-2. Connect one power adaptor to each base station.
-3. Using an audio to audio cable, connect the basestations to each other to
-   synchronise them.
+        How the actual hardware could look for mounting on extruded aluminum
+        rail. 
+
+    Follow these guidelines when deciding where to mount your lighthouses:
+
+    .. On the headstage64, the photodiodes allow can accommodate up to at least distance 3m between the lighthouse receivers and transmitters. THIS REQUIRES CONFIRMATION TO INCLUDE IN DOCS, OTHERWISE DELETE.
+
+    - They should be centered above the arena, with the front panel facing the arena and have the same orientation. Remove the thin film that covers the front panel.  
+    - The distance between the receivers on the headstage and the transmitters in the lighthouses should not exceed
+      the maximum range. This depends on the sensitivity of the receiver's
+      photodiode on the headstage and is best determined experimentally. Each
+      lighthouse has a 120° field of view. However, the receivers
+      have a higher chance loosing line of sight of the transmitters at these
+      larger angles if the headstage tilts. 
+    - The distance between the receivers on the headstage and the transmitters in the lighthouses should be within the minimum range. In our tests this was determined to be ~30 cm vertically but it is best determined experimentally. If you don't see any readings, ensure the headstage excessively close to the lighthouses.
+    - Position measurements are noisier when the headstage is at the boundary of the
+      lighthouses' range, so leave a safe margin. 
+    - The headstage must be in the range of *both* lighthouses in order to measure
+      position.
+    - Secure the lighthouses such that they can't be easily jostled or moved. The lighthouses interrupt their emission during movement.
+
+    ..  figure:: ../../_static/images/lighthouses/lighthouse_active-range.svg
+
+        A cartoon of what a lighthouse & commutator commutator might look
+        mounted on extruded aluminum rail. The overlapping green area represents
+        the region where a TS4231 device is in range of both lighthouses and
+        can measure position.
+
+    .. tip::
+      To confirm if the lighthouse configuration covers the entire behavioral arena, slowly move 
+      the TS4231 device through the entire arena while running 
+      `an example workflow <https://open-ephys.github.io/bonsai-onix1-docs/articles/hardware/hs64/workflow.html>`_ and
+      `inspecting the TS4231V1PositionData position data visualizer <https://open-ephys.github.io/bonsai-onix1-docs/articles/getting-started/visualize-data.html>`_. 
+      If the TS4231V1PositionData operator ceases to produce data (i.e. if the visualizer stops updating) 
+      at a certain spot, the current lighthouse configuration does not cover that spot. If you are unfamiliar with 
+      using Bonsai to acquire Onix data to do this, visit the OpenEphys.Onix1 Bonsai package 
+      `Getting Started page <https://open-ephys.github.io/bonsai-onix1-docs/articles/getting-started/index.html>`_.
+
+    ..  figure:: ../../_static/images/lighthouses/lighthouse-onix-figures-cropped.webp
+
+        Crops of figures from `ONIX: a unified open-source platform for
+        multimodal neural recording and perturbation during naturalistic
+        behavior <https://www.nature.com/articles/s41592-024-02521-1>`_. The
+        lighthouse transmitters are mounted on the ceiling and their range cover
+        the entire ~2m range. The blue line represents a mouse's movement over
+        ~8 hours.
+
+2. Connect one power adaptor to each lighthouse.
+
+3. Using a 3.5 mm Stereo Jack Plug to Plug (audio) cable, connect the basestations to each other to synchronise them.
 
    .. image:: ../../_static/images/connections/audio_synch_cable.jpg
        :width: 48%
    .. image:: ../../_static/images/lighthouses/vive_back.jpg
        :width: 48%
 
-4. Set one base station to 'A' and one to 'b' using the channel button
+4. Manage the cables such that they don't occlude the TS4231 receivers from the lighthouse transmitters.
+
+5. Set one lighthouse to 'A' and one to 'b' using the channel button
    (illustration below is from the `Vive manual
    <https://www.vive.com/eu/support/vive/category_howto/about-the-base-stations.html>`_)