Skip to content
This repository has been archived by the owner on Nov 26, 2022. It is now read-only.

quatrope/ois

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Optimal Image Subtraction (OIS)

Build Status codecov.io Documentation Status DOI Updates Python 3 PyPI version

WARNING:

This project is no longer maintained.


OIS is a Python package to perform optimal image subtraction on astronomical images. It also has a companion command-line program written entirely in C.

OIS offers different methods to subtract images:

Each method can (optionally) simultaneously fit and remove common background.

You can find a Jupyter notebook example with the main features at http://toros-astro.github.io/ois.


Installation

To install the Python module:

$ pip install ois

To instal and run the C command-line program, download this repo to your local machine and execute:

$ git clone https://github.com/toros-astro/ois.git
$ cd ois
$ make ois
$ ./ois --help

The C command-line program is somewhat limited in functionality compared to the Python module. Please see the documentation for more information.


Minimal usage example

>>> from ois import optimal_system
>>> diff = optimal_system(image, image_ref)[0]

Check the documentation for a full tutorial.


Other Parameters:

kernelshape: shape of the kernel to use. Must be of odd size.

bkgdegree: degree of the polynomial to fit the background. To turn off background fitting set this to None.

method: One of the following strings

  • Bramich: A Delta basis for the kernel (all pixels fit independently). Default method.

  • AdaptiveBramich: Same as Bramich, but with a polynomial variation across the image. It needs the parameter poly_degree, which is the polynomial degree of the variation.

  • Alard-Lupton: A modulated multi-Gaussian kernel. It needs the gausslist keyword. gausslist is a list of dictionaries containing data of the gaussians used in the decomposition of the kernel. Dictionary keywords are: center, sx, sy, modPolyDeg

Extra parameters are passed to the individual methods.

poly_degree: needed only for AdaptiveBramich. It is the degree of the polynomial for the kernel spatial variation.

gausslist: needed only for Alard-Lupton. A list of dictionaries with info for the modulated multi-Gaussian. Dictionary keys are:

  • center: a (row, column) tuple for the center of the Gaussian. Default: kernel center.
  • modPolyDeg: the degree of the modulating polynomial. Default: 2
  • sx: sigma in x direction. Default: 2.
  • sy: sigma in y direction. Deafult: 2.

Other Similar Projects

You may want to check this other projects for image subtraction.


Author: Martin Beroiz

[email protected]