This is a module for doing Adaptive-Optics-y things in Python. There are several subdirectories in this repository.

• aopy - Basic Adaptive Optics routines. These directories will hold python ports of Don Gavel's libraries. This should eventualy be split into its own library.
• cextern - c source files.
• docs - Sphinx based documentation for all of the python code in here.
• IDL - IDL code which does the same thing as this python code, used for parity testing.
• licences - The licenses used for this code.
• scripts - Command line tools for this code.
• tests - Python unit tests.

This module was written in Python 2.7, and only tested on Python 2.7

This module requires Numpy and Scipy for algorithms, and uses Matplotlib for plotting. It is often easiest to install these three modules on their own, before installing aopy. You should be able to install any dependents you need using pip.

• numpy
• scipy
• matplotlib

This module might use some components from the pyshell library, although I've tried to avoid that. If it does use any pyshell tools, please let me know, and I'll try to eliminate them if they are unnecessary.

This module also does depend on astropy, but that installation should be handled automatically by aopy. (Actually, all of the installations could be handled by aopy, but there are some tricky aspects to installing matplotlib that make this perhaps a bad idea.)

Once you have Numpy, Scipy and Matplotlib installed, try:

$ python setup.py install

to install aopy.

You can see some working examples in the examples directory:

• depiston uses pIDLy to test the aopy.util.math.depiston function.
• make_wind makes a multi-layer phase screen, saving each time step to an array and then making a fits file.
• play_screens shows a movie of a pair of translating phase screens stacked on top of each other.

To build the documentation, you'll need sphinx. Then you can run:

$ cd docs/
$ make html

When you run this, the HTML documentation is stored in docs/_build/html/, so you can open the homepage from docs/_build/html/index.html.

For testing, you'll need:

• nosetests
• pIDLy

Then, from the source directory, try:

$ python setup.py nosetests

You should also check out tests/screens.py, which is a testing script for comparing phase screens between python and IDL. Its functionality is duplicated in the noestests suite, but tests/screens.py is a more verbose version.