pripy is a python package aimed at providing phase retrieval algorithms, primarily for use in adaptive optics systems and simulators. These algorithms must have a common and minimal API, in order to accelerate the testing of various algorithms on a given optical system.

• A recent version of Python 3 installed on any Windows/Linux/MacOS machine,

To install the most recent stable version of pripy, simply:

pip install pripy

To install the latest development version from this git repo, instead do:

git clone https://github.com/jcranney/pripy
cd pripy
pip install -e .

To use pripy, follow the provided examples, e.g., using Gerchberg-Saxton in the sandbox AO environment (no external simulator required):

cd examples
ipython -i sandbox_gs.py   # run the sandbox Gerchberg-Saxton example

pripy is in its infancy and welcomes collaborative input. To contribute to pripy, follow these steps:

1. Fork this repository.
2. Create a branch: git checkout -b <branch_name>.
3. Make your changes and commit them: git commit -m '<commit_message>'
4. Push to the branch: git push
5. Create the pull request.

Alternatively see the GitHub documentation on creating a pull request.

• @jcranney
• @mvandam
• @ndoucet

If you want to contact me you can reach me at [email protected].

This project uses the following license: MIT License.