AdaptiveBramich

As of 2022-04-19:

1. The definitive version of GPU-accelerated OIS is now stored in /home/nebula/oisgpu. From any venv, pip install /home/nebula/oisgpu.
2. export LD_LIBRARY_PATH=/home/nebula/oisgpu/tools
3. Steps 2 and 3 are as below, but import oisgpu and replace ois.* with oisgpu.*

How to use the AdaptiveBramich subtraction method, as of 2020-01-07:

1. Run $ . /home/varun/oistest/bin/activate. You should see an (oistest) before your prompt now. This is sourcing the Python virtual environment that contains our custom, modified version of OIS that includes a GPU-accelerated AdaptiveBramich.

2. Modify subtract.py to use the AdaptiveBramich method. Open subtract/subtract.py and look for this line:

diff = ois.optimal_system(image=element.data, refimage=template, method='Bramich')

Change this to read

diff = ois.optimal_system(image=element.data, refimage=template, method='AdaptiveBramich', poly_degree=2, gridshape=(3, 3))

Making the gridshape less than ~2x2 will break things badly by exhausting GPU memory --- I would recommend against this.

3. Run the pipeline as normal. It will still take longer than usual.