diff --git a/source/Hardware Guide/Lighthouses/setup.rst b/source/Hardware Guide/Lighthouses/setup.rst index 176154dc..cab11849 100644 --- a/source/Hardware Guide/Lighthouses/setup.rst +++ b/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 `_ and + `inspecting the TS4231V1PositionData position data visualizer `_. + 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 `_. + + .. 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 `_. 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 `_) diff --git a/source/_static/images/lighthouses/lighthouse-mount-example.png b/source/_static/images/lighthouses/lighthouse-mount-example.png new file mode 100644 index 00000000..a19425a9 Binary files /dev/null and b/source/_static/images/lighthouses/lighthouse-mount-example.png differ diff --git a/source/_static/images/lighthouses/lighthouse-onix-figures-cropped.webp b/source/_static/images/lighthouses/lighthouse-onix-figures-cropped.webp new file mode 100644 index 00000000..5ae87a94 Binary files /dev/null and b/source/_static/images/lighthouses/lighthouse-onix-figures-cropped.webp differ diff --git a/source/_static/images/lighthouses/lighthouse-onix-figures-cropped.xcf b/source/_static/images/lighthouses/lighthouse-onix-figures-cropped.xcf new file mode 100644 index 00000000..8a6437c6 Binary files /dev/null and b/source/_static/images/lighthouses/lighthouse-onix-figures-cropped.xcf differ diff --git a/source/_static/images/lighthouses/lighthouse_active-range.svg b/source/_static/images/lighthouses/lighthouse_active-range.svg new file mode 100644 index 00000000..8fd98eee --- /dev/null +++ b/source/_static/images/lighthouses/lighthouse_active-range.svg @@ -0,0 +1,2091 @@ + + + +Enable/Disable