Skip to content

Commit

Permalink
Update articles
Browse files Browse the repository at this point in the history
- Reorder tabs
- Link to the ONIX PCIe system instead of acquisition board
- Remove rollinggraph template
- Spelling
  • Loading branch information
bparks13 committed Jul 31, 2024
1 parent d06310f commit 1731c6d
Show file tree
Hide file tree
Showing 5 changed files with 6 additions and 11 deletions.
4 changes: 2 additions & 2 deletions articles/getting-started/what_is_onix.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,12 @@ ONIX is a data acquisition system for neuroscience, composed of various pieces o
## 1. Standards
All acquisition systems follow specific sets of rules that outline how data is structured and transmitted between parts of the system. For instance, Intan headstages and the [classic Open Ephys Board](https://open-ephys.org/acq-board) use a [Serial Peripheral Interface (SPI)](https://en.wikipedia.org/wiki/Serial_Peripheral_Interface) for communication. Many different and non-interchangeable interfaces and protocols are in use, which is why each type of probe or camera usually comes with its own specific acquisition board.

The [Open Neuro Interface (ONI)](https://open-ephys.github.io/ONI/) is an open standard that was designed as a unified protocol to communicate with a wide variety of instruments. By specifying how data should be organised but remaining agnostic to the type of data, a single acquisition system can be used to acquire from, for instance, extracellular probes, cameras, and tracking systems.
The [Open Neuro Interface (ONI)](https://open-ephys.github.io/ONI/) is an open standard that was designed as a unified protocol to communicate with a wide variety of instruments. By specifying how data should be organized but remaining agnostic to the type of data, a single acquisition system can be used to acquire from, for instance, extracellular probes, cameras, and tracking systems.

This means that the same software and hardware can now be used for a wide range of different recording instruments, so that labs do not have to spend time and money purchasing separate acquisition systems for each extra tool they wish to add to their experiment. Additionally, for those who want to develop new tools to study the brain, ONIX provides a powerful hardware backend and software infrastructure that can be reused to control almost any type of recoding instrument.

## 2. Tethers
There is a growing appreciation of experiments that examine the natural behaviours of animals. This often means using larger and more intricate (perhaps 3D) experimental setups. It also means that the animal should be impaired as little as possible by the recording setup. To achieve this it is of course important to reducing the weight of the headstage, but the weight of the tether that connects the headstage to the acquisition system is often overlooked. As the animal explores the arena, the centre of mass of the tether is rarely directly above the animal. Instead, it is off to one side, introducing a rotational force on the animal. The animal must compensate for this torque in order to keep its head up straight. Because the ONI specification allows communication over a single wire, ONIX uses a single coaxial cable, making ONIX tethers lighter and thinner compared to classic acquisition systems. ONIX tethers are 0.1 to 0.4 mm in diameter and are extremely flexible.
There is a growing appreciation of experiments that examine the natural behaviors of animals. This often means using larger and more intricate (perhaps 3D) experimental setups. It also means that the animal should be impaired as little as possible by the recording setup. To achieve this it is of course important to reducing the weight of the headstage, but the weight of the tether that connects the headstage to the acquisition system is often overlooked. As the animal explores the arena, the centre of mass of the tether is rarely directly above the animal. Instead, it is off to one side, introducing a rotational force on the animal. The animal must compensate for this torque in order to keep its head up straight. Because the ONI specification allows communication over a single wire, ONIX uses a single coaxial cable, making ONIX tethers lighter and thinner compared to classic acquisition systems. ONIX tethers are 0.1 to 0.4 mm in diameter and are extremely flexible.

The tether must also be able to rotate as the animal does to prevent it from becoming twisted. Commutators are hardware devices that allow the tether to rotate while maintaining an electrical connection to the rest of the path to the acquisition system. As the animal moves through the arena, the ONIX commutator receives 3D tracking information from the headstage and drives a motor to actively rotate the tether, preventing twisting.

Expand Down
2 changes: 1 addition & 1 deletion index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ title: OpenEphys.Onix
> [!Warning]
> These docs are under active development, feel free to contribute by either [raising an issue](https://github.com/bonsai-rx/docs/issues) or following the links saying **Edit this page**.
`OpenEphys.Onix` is a library that can be used in [Bonsai](https://bonsai-rx.org/) to acquire data from ONIX devices, such as the [Open Ephys Acquisition Board](https://open-ephys.github.io/acq-board-docs/). For more details on the ONI specification, check out [this link](https://open-ephys.github.io/ONI/), and to learn more about ONIX devices and their implemention of ONI, click [here](https://open-ephys.github.io/onix-docs/).
`OpenEphys.Onix` is a library that can be used in [Bonsai](https://bonsai-rx.org/) to acquire data from ONIX devices, such as the [ONIX PCIe Acquisition System](https://open-ephys.org/onix/oeps-9006). For more details on the ONI specification, check out [this link](https://open-ephys.github.io/ONI/), and to learn more about ONIX devices and their implementation of ONI, click [here](https://open-ephys.github.io/onix-docs/).

## Advantages

Expand Down
4 changes: 0 additions & 4 deletions template/conceptual.html.primary.tmpl
Original file line number Diff line number Diff line change
Expand Up @@ -19,10 +19,6 @@
<br>
<h2 id="visualize-data">Visualize Data</h2>

{{#visualize_rollinggraph}}
{{>partials/device.visualize_rollinggraph}}
{{/visualize_rollinggraph}}

{{#visualize_timeseries}}
{{>partials/device.visualize_timeseries}}
{{/visualize_timeseries}}
Expand Down

This file was deleted.

6 changes: 3 additions & 3 deletions toc.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
- name: User Guide
href: articles/
- name: Operators
href: api/
- name: Tutorials
href: tutorials/
href: tutorials/
- name: Operators
href: api/

0 comments on commit 1731c6d

Please sign in to comment.