astroplotlib 0.2.6
Python scripts to handle astronomical images

# astroplotlib

Python scripts to handle astronomical images. It allows the user building images
with any scale, overlay contours, and adding physical bars and orientation
arrows (N and E axes) automatically (e.g., [Hernandez-Jimenez 13](https://ui.adsabs.harvard.edu/abs/2013MNRAS.435.3342H/abstract), [15](https://ui.adsabs.harvard.edu/abs/2015MNRAS.451.2278H/abstract)). It is
possible to overlay pseudo-slits and obtain statistics from apertures
(e.g., [Dametto, N. Z. et al. 2014](https://ui.adsabs.harvard.edu/abs/2014MNRAS.443.1754D/abstract)). The user can also estimate the background
sky of the images (e.g., [Buzzo 2021](https://ui.adsabs.harvard.edu/abs/2021MNRAS.504.2146B/abstract)). There is a module to work with the output
table from the `Ellipse` task of `IRAF`.  The user can overlay the fitted isophotes
and their respective contours on the image (e.g.,  [Mora et al. 2019](https://ui.adsabs.harvard.edu/abs/2019MNRAS.488..830M/abstract),
[Buzzo et al. 2021](https://ui.adsabs.harvard.edu/abs/2021MNRAS.504.2146B/abstract), [Brito-Silva et al. 2021](https://ui.adsabs.harvard.edu/abs/2021arXiv211004423B/abstract)). The package also has a GUI  to mask
areas in the images by using different polygons.  It is possible to obtain
statistical information (e.g, total flux, mean, std, etc.) from the masked areas
too. There is also a GUI  to overlay star catalogues on the image and an option
to download them directly from the Vizier server.

:sparkles: Current version: [0.2.6](https://pypi.org/project/astroplotlib/)

(c) 2014-2022 J. A. Hernandez-Jimenez

E-mail: joseaher@gmail.com

Website: https://gitlab.com/joseaher/astroplotlib

## Installation

astroplotlib requires:

    * numpy
    * scipy
    * matplotlib
    * astropy
    * astroquery
    * tkinter

This version can be easily installed within Anaconda Enviroment via [PyPI](https://pypi.org/project/astroplotlib/):

    % pip install astroplotlib

If you prefer to install astroplotlib manually, you can clone the developing
version at https://gitlab.com/joseaher/astroplotlib. In the directory this
README is in, simply:

    % pip install .

or,

    % python setup.py install

## Uninstallation

To uninstall astroplotlib, simply

    % pip uninstall astroplotlib

## Citing

If you use this package for a scientific publication, please cite it ([Hernandez-Jimenez 2022](https://ascl.net/2204.002)). The BibTeX entry for this package is:

```
  @MISC{2022ascl.soft04002H,
        author = {{Hernandez-Jimenez}, Jose A.},
        title = "{Astroplotlib: Python scripts to handle astronomical images}",
        keywords = {Software},
        howpublished = {Astrophysics Source Code Library, record ascl:2204.002},
        year = 2022,
        month = apr,
        eid = {ascl:2204.002},
        pages = {ascl:2204.002},
        archivePrefix = {ascl},
        eprint = {2204.002},
        adsurl = {https://ui.adsabs.harvard.edu/abs/2022ascl.soft04002H},
        adsnote = {Provided by the SAO/NASA Astrophysics Data System}
       }
```
## Acknowledgements

This software was funded partially by Brazilian agency FAPESP, process number 2021/08920-8.