Skip to content

AllenNeuralDynamics/parallax

Repository files navigation

Parallax

Parallax

Parallax is a graphical user interface designed to streamline the process of setting up and performing acute in vivo electrophysiology experiments.

Documentation: parallax.readthedocs.io.

Prerequisites

  • Python==3.8 (Recommended to install via Anaconda or Miniconda)
    • Python 3.8 is required for the Spinnaker library.
  • PySpin (for Linux or Mac OS users)
  • Spinnaker SDK

Installation

  1. Create a virtual environment with Python 3.8 and activate it:
  • On Windows:
conda create -n parallax python=3.8
conda activate parallax
  1. To install Parallax into a fresh environment, run:
pip install parallax-app

To upgrade to the latest version, run:

pip install parallax-app --upgrade
  1. To install the camera interface:
pip install parallax-app[camera]

Additional Setup for Linux and macOS

  • Download the Spinnaker SDK package for your system here
  • Follow the installation instructions in the README
  • Install the Python bindings found alongside the SDK package

Running Parallax

python -m parallax

For developers:

  1. Clone the repository:
git clone https://github.com/AllenNeuralDynamics/parallax.git
  1. Install the package along with dev dependencies:
pip install -e .[dev]

Documentation

  1. To install the dependencies:
pip install -e .[docs]
  1. Then to create the documentation html files, run:
sphinx-build -b html docs/ docs/_build

Support and Contribution

If you encounter any problems or would like to contribute to the project, please submit an Issue on GitHub.

License

Parallax is licensed under the MIT License. For more details, see the LICENSE file.