Metadata-Version: 2.1
Name: parallax-app
Version: 0.37.17
Summary: GUI software for photogrammetry-assisted probe targeting in electrophysiology
Author-email: Hanna Lee <hanna.lee@alleninstitute.org>
License: MIT
Keywords: parallax
Classifier: Programming Language :: Python :: 3
Requires-Python: ~=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pip
Requires-Dist: PyQt5>=5.15
Requires-Dist: pyqtgraph
Requires-Dist: opencv-python
Requires-Dist: scipy
Requires-Dist: pandas
Requires-Dist: scikit-image
Requires-Dist: requests
Requires-Dist: scikit-learn
Provides-Extra: dev
Requires-Dist: parallax-app[linters]; extra == "dev"
Provides-Extra: camera
Requires-Dist: spinnaker-python; extra == "camera"
Provides-Extra: linters
Requires-Dist: codespell; extra == "linters"
Requires-Dist: coverage; extra == "linters"
Requires-Dist: flake8; extra == "linters"
Requires-Dist: interrogate; extra == "linters"
Requires-Dist: isort; extra == "linters"
Requires-Dist: pytest-mock; extra == "linters"
Provides-Extra: docs
Requires-Dist: Sphinx; extra == "docs"
Requires-Dist: sphinx-jinja; extra == "docs"
Requires-Dist: furo; extra == "docs"
Requires-Dist: docutils; extra == "docs"

# Parallax

![Parallax](ui/ParallaxReadME.JPG)

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](https://parallax.readthedocs.io/en/stable/).

### Prerequisites
- **Python==3.8** (Recommended to install via 
[Anaconda](https://www.anaconda.com/products/individual) or 
[Miniconda](https://docs.conda.io/en/latest/miniconda.html))
  -  Python 3.8 is required for the Spinnaker library.
- PySpin (for Linux or Mac OS users)


### Installation
1. Create a virtual environment with **Python 3.8** and activate it:
- On Windows:
```bash
conda create -n parallax python=3.8
conda activate parallax
```

2. To install Parallax into a fresh environment, run:
```bash
pip install parallax-app
```

To upgrade to the latest version, run:
```bash
pip install parallax-app --upgrade
```

3. To install the camera interface:
```bash
pip install parallax-app[camera]
```

#### Additional Setup for Linux and macOS
* Download the Spinnaker SDK package for your system [here](https://flir.app.boxcn.net/v/SpinnakerSDK)
* Follow the installation instructions in the README
* Install the Python bindings found alongside the SDK package

### Running Parallax
```bash
python -m parallax
```

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

### Documentation
1. To install the dependencies:
```bash
pip install -e .[docs]
```
2. Then to create the documentation html files, run:
```bash
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](https://github.com/AllenNeuralDynamics/parallax/issues) 
on GitHub.

### License
Parallax is licensed under the MIT License. For more details, see 
the [LICENSE](LICENSE) file.
