AstroPoP
========
|GHAction Status| |Codecov Status| |RTD Status| |CODACY|
The ASTROnomical POlarimetry and Photometry pipeline. Developed for work with IAGPOL and SPARC4 polarimeters at Observatório Pico dos Dias (Brazil), but suitable to be used in other image polarimeters around the world.
Features
^^^^^^^^
This software is intended to provide a full pipeline to reduce raw polarimetry and photometry data taken with common CCD telescope cameras. It can do:
- Create calibrate frames;
- Calibrate images using bias/flat/dark frames;
- Gain correction and in-processing image binnig;
- Cosmic ray extraction (astroscrappy);
- Align image sets;
- Aperture and (planned) PSF photometry;
- Calcite polarimeters;
- Automatic pairs of stars identification;
- Automatic photometry calibration using online catalogs.
Support and Community
^^^^^^^^^^^^^^^^^^^^^
We have a community of people using astropop to perform data reduction. Also, we use this community to offer support for astropop users. Join the community at `astropop-users Google-Groups <https://groups.google.com/g/astropop-users>`_
Dependencies
^^^^^^^^^^^^
Some of astropop dependencies (numpy, astropy, scipy, astroscrappy) need gcc to get build. Make sure gcc is installed properly in your system.
There is nothing that prevent astropop itself to run on Windows. However, due to problems that comes from dependencies, mainly numpy and astrometry.net, astropop is currently supported only on Linux and Mac.
Bellow we list all the necessary dependencies for the good working of the code. Note that this can be changed with the time.
- astroalign;
- astropy >= 4.3;
- astroquery;
- astroscrappy;
- numpy >= 1.17;
- scikit-image;
- scikit-learn;
- scipy;
- sep.
Installation
^^^^^^^^^^^^
Astropop can be downloaded from `gh/sparc4-dev/astropop <https://github.com/sparc4-dev/astropop>`_. It follows the stadard python package install procedure. All requirements can be installed with `pip` or `conda`.
Anaconda Environment
--------------------
We recomend to use a `anaconda <https://www.anaconda.com/>`_ environment to use astropop. Having the anaconda installed, use the following command to install a new `<environment name>` with conda dependencies:
.. code-block::
conda create -n <environment name> -c conda-forge python=3.10 astroalign astropy astroquery astroscrappy matplotlib numpy pyyaml reproject scikit-image scikit-learn scipy sep
Once the environment is created, you can `activate the environment <https://conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html#activating-an-environment>`_ and install the astropop with `pip`.
.. code-block::
conda activate <environment name>
Stable Version
--------------
The stable version of astropop is available in `PyPi <https://pypi.org/>`_ and can be installed directly with `pip` command.
.. code-block::
pip install astropop
Development Version
-------------------
The development (unstable) version can be installed from the github code. With `pip`, can be done in any of the 3 ways:
.. code-block::
pip install -U git+https://github.com/sparc4-dev/astropop
or
.. code-block::
pip install -U https://github.com/sparc4-dev/astropop/archive/refs/heads/main.zip
or
.. code-block::
git clone https://github.com/sparc4-dev/astropop
cd astropop
pip install -U .
Citing
^^^^^^^^
|ADS| |PASP| |arXiv| |ASCL|
An article was published in `Publications of the Astronomical Society of the Pacific, vol.131, n.996, pp.024501 <https://iopscience.iop.org/article/10.1088/1538-3873/aaecc2>`_,
which is the main reference to this work. If you do not have access to PASP, the preprint was uploaded to `arXiv:1811.01408 <https://arxiv.org/abs/1811.01408>`_.
Also, for latex citation, you can use the following BibTex:
.. code-block::
@article{Campagnolo_2018,
doi = {10.1088/1538-3873/aaecc2},
url = {https://doi.org/10.1088%2F1538-3873%2Faaecc2},
year = 2018,
month = {dec},
publisher = {{IOP} Publishing},
volume = {131},
number = {996},
pages = {024501},
author = {Julio Cesar Neves Campagnolo},
title = {{ASTROPOP}: the {ASTROnomical} {POlarimetry} and Photometry Pipeline},
journal = {Publications of the Astronomical Society of the Pacific},
}
Documentation
^^^^^^^^^^^^^
Documentation (not complete yet) can be found at `astropop.readthedocs.io <https://astropop.readthedocs.io>`_
.. |GHAction Status| image:: https://github.com/sparc4-dev/astropop/actions/workflows/unit-tests.yml/badge.svg
:target: https://github.com/sparc4-dev/astropop/actions
:alt: Astropop's Github CI Status
.. |Codecov Status| image:: https://codecov.io/gh/sparc4-dev/astropop/branch/main/graph/badge.svg?token=tzrOfWMhUb
:target: https://codecov.io/gh/sparc4-dev/astropop
:alt: Astropop's Codecov Coverage Status
.. |RTD Status| image:: https://readthedocs.org/projects/astropop/badge/?version=latest
:target: https://astropop.readthedocs.io/en/latest/?badge=latest
:alt: Astropop's Documentation Status
.. |Powered by Astropy| image:: http://img.shields.io/badge/powered%20by-AstroPy-orange.svg?style=flat
:target: http://www.astropy.org/
:alt: Powered by AstroPy
.. |ADS| image:: http://img.shields.io/badge/ADS-2019PASP..131b4501N-blue.svg?style=flat
:target: https://ui.adsabs.harvard.edu/abs/2019PASP..131b4501N/abstract
:alt: ADS Reference
.. |PASP| image:: http://img.shields.io/badge/PASP-pp.024501-blue.svg?style=flat
:target: https://iopscience.iop.org/article/10.1088/1538-3873/aaecc2
:alt: Publications of the Astronomy Society of the Pacific
.. |arXiv| image:: http://img.shields.io/badge/arXiv-1811.01408-red.svg?style=flat
:target: https://arxiv.org/abs/1811.01408
:alt: arXiv preprint
.. |ASCL| image:: https://img.shields.io/badge/ascl-1805.024-blue.svg?colorB=262255
:target: http://ascl.net/1805.024
:alt: ASCL register
.. |CODACY| image:: https://app.codacy.com/project/badge/Grade/ab9d4647935d4b33aee0544b6957d7a7
:target: https://www.codacy.com/gh/sparc4-dev/astropop/dashboard?utm_source=github.com&utm_medium=referral&utm_content=sparc4-dev/astropop&utm_campaign=Badge_Grade
Raw data
{
"_id": null,
"home_page": "",
"name": "astropop",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "astronomy,astrophysics,science,units,data-reduction,photometry,polarimetry,astrometry",
"author": "",
"author_email": "Julio Campagnolo <julio.campagnolo@cefet-rj.br>",
"download_url": "https://files.pythonhosted.org/packages/78/a8/5dfa0cc5d5687d2270d3951a3ce68149ded3bcedba8fc89a12ccc60b26af/astropop-0.9.3.tar.gz",
"platform": null,
"description": "AstroPoP\n========\n\n|GHAction Status| |Codecov Status| |RTD Status| |CODACY|\n\nThe ASTROnomical POlarimetry and Photometry pipeline. Developed for work with IAGPOL and SPARC4 polarimeters at Observat\u00f3rio Pico dos Dias (Brazil), but suitable to be used in other image polarimeters around the world.\n\nFeatures\n^^^^^^^^\n\nThis software is intended to provide a full pipeline to reduce raw polarimetry and photometry data taken with common CCD telescope cameras. It can do:\n\n- Create calibrate frames;\n\n- Calibrate images using bias/flat/dark frames;\n\n- Gain correction and in-processing image binnig;\n\n- Cosmic ray extraction (astroscrappy);\n\n- Align image sets;\n\n- Aperture and (planned) PSF photometry;\n\n- Calcite polarimeters;\n\n - Automatic pairs of stars identification;\n\n- Automatic photometry calibration using online catalogs.\n\nSupport and Community\n^^^^^^^^^^^^^^^^^^^^^\n\nWe have a community of people using astropop to perform data reduction. Also, we use this community to offer support for astropop users. Join the community at `astropop-users Google-Groups <https://groups.google.com/g/astropop-users>`_\n\nDependencies\n^^^^^^^^^^^^\n\nSome of astropop dependencies (numpy, astropy, scipy, astroscrappy) need gcc to get build. Make sure gcc is installed properly in your system.\n\nThere is nothing that prevent astropop itself to run on Windows. However, due to problems that comes from dependencies, mainly numpy and astrometry.net, astropop is currently supported only on Linux and Mac.\n\nBellow we list all the necessary dependencies for the good working of the code. Note that this can be changed with the time.\n\n- astroalign;\n\n- astropy >= 4.3;\n\n- astroquery;\n\n- astroscrappy;\n\n- numpy >= 1.17;\n\n- scikit-image;\n\n- scikit-learn;\n\n- scipy;\n\n- sep.\n\nInstallation\n^^^^^^^^^^^^\n\nAstropop can be downloaded from `gh/sparc4-dev/astropop <https://github.com/sparc4-dev/astropop>`_. It follows the stadard python package install procedure. All requirements can be installed with `pip` or `conda`.\n\nAnaconda Environment\n--------------------\n\nWe recomend to use a `anaconda <https://www.anaconda.com/>`_ environment to use astropop. Having the anaconda installed, use the following command to install a new `<environment name>` with conda dependencies:\n\n.. code-block::\n\n conda create -n <environment name> -c conda-forge python=3.10 astroalign astropy astroquery astroscrappy matplotlib numpy pyyaml reproject scikit-image scikit-learn scipy sep\n\nOnce the environment is created, you can `activate the environment <https://conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html#activating-an-environment>`_ and install the astropop with `pip`.\n\n.. code-block::\n\n conda activate <environment name>\n\nStable Version\n--------------\n\nThe stable version of astropop is available in `PyPi <https://pypi.org/>`_ and can be installed directly with `pip` command.\n\n.. code-block::\n\n pip install astropop\n\nDevelopment Version\n-------------------\n\nThe development (unstable) version can be installed from the github code. With `pip`, can be done in any of the 3 ways:\n\n.. code-block::\n\n pip install -U git+https://github.com/sparc4-dev/astropop\n\nor\n\n.. code-block::\n\n pip install -U https://github.com/sparc4-dev/astropop/archive/refs/heads/main.zip\n\nor\n\n.. code-block::\n\n git clone https://github.com/sparc4-dev/astropop\n cd astropop\n pip install -U .\n\nCiting\n^^^^^^^^\n\n|ADS| |PASP| |arXiv| |ASCL|\n\nAn article was published in `Publications of the Astronomical Society of the Pacific, vol.131, n.996, pp.024501 <https://iopscience.iop.org/article/10.1088/1538-3873/aaecc2>`_,\nwhich is the main reference to this work. If you do not have access to PASP, the preprint was uploaded to `arXiv:1811.01408 <https://arxiv.org/abs/1811.01408>`_.\n\nAlso, for latex citation, you can use the following BibTex:\n\n.. code-block::\n\n @article{Campagnolo_2018,\n \tdoi = {10.1088/1538-3873/aaecc2},\n\t url = {https://doi.org/10.1088%2F1538-3873%2Faaecc2},\n\t year = 2018,\n\t month = {dec},\n\t publisher = {{IOP} Publishing},\n\t volume = {131},\n\t number = {996},\n\t pages = {024501},\n\t author = {Julio Cesar Neves Campagnolo},\n\t title = {{ASTROPOP}: the {ASTROnomical} {POlarimetry} and Photometry Pipeline},\n\t journal = {Publications of the Astronomical Society of the Pacific},\n }\n\nDocumentation\n^^^^^^^^^^^^^\n\nDocumentation (not complete yet) can be found at `astropop.readthedocs.io <https://astropop.readthedocs.io>`_\n\n.. |GHAction Status| image:: https://github.com/sparc4-dev/astropop/actions/workflows/unit-tests.yml/badge.svg\n :target: https://github.com/sparc4-dev/astropop/actions\n :alt: Astropop's Github CI Status\n\n.. |Codecov Status| image:: https://codecov.io/gh/sparc4-dev/astropop/branch/main/graph/badge.svg?token=tzrOfWMhUb\n :target: https://codecov.io/gh/sparc4-dev/astropop\n :alt: Astropop's Codecov Coverage Status\n\n.. |RTD Status| image:: https://readthedocs.org/projects/astropop/badge/?version=latest\n :target: https://astropop.readthedocs.io/en/latest/?badge=latest\n :alt: Astropop's Documentation Status\n\n.. |Powered by Astropy| image:: http://img.shields.io/badge/powered%20by-AstroPy-orange.svg?style=flat\n :target: http://www.astropy.org/\n :alt: Powered by AstroPy\n\n.. |ADS| image:: http://img.shields.io/badge/ADS-2019PASP..131b4501N-blue.svg?style=flat\n :target: https://ui.adsabs.harvard.edu/abs/2019PASP..131b4501N/abstract\n :alt: ADS Reference\n\n.. |PASP| image:: http://img.shields.io/badge/PASP-pp.024501-blue.svg?style=flat\n :target: https://iopscience.iop.org/article/10.1088/1538-3873/aaecc2\n :alt: Publications of the Astronomy Society of the Pacific\n\n.. |arXiv| image:: http://img.shields.io/badge/arXiv-1811.01408-red.svg?style=flat\n :target: https://arxiv.org/abs/1811.01408\n :alt: arXiv preprint\n\n.. |ASCL| image:: https://img.shields.io/badge/ascl-1805.024-blue.svg?colorB=262255\n :target: http://ascl.net/1805.024\n :alt: ASCL register\n\n.. |CODACY| image:: https://app.codacy.com/project/badge/Grade/ab9d4647935d4b33aee0544b6957d7a7\n :target: https://www.codacy.com/gh/sparc4-dev/astropop/dashboard?utm_source=github.com&utm_medium=referral&utm_content=sparc4-dev/astropop&utm_campaign=Badge_Grade\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "Astronomical Polarimetry and Photometry Pipeline",
"version": "0.9.3",
"project_urls": {
"documentation": "https://astropop.readthedocs.io/en/latest/",
"homepage": "https://github.com/sparc4-dev/astropop",
"repository": "https://github.com/sparc4-dev/astropop"
},
"split_keywords": [
"astronomy",
"astrophysics",
"science",
"units",
"data-reduction",
"photometry",
"polarimetry",
"astrometry"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d9ddd965e5316bab5dfe36d13e6786bb083222a961ce85d46a4b63ebd6947f6b",
"md5": "ec198d8f9bdf1358b1a0bce045d42a13",
"sha256": "cb5e2941e113564339fdd8c14c39b3aa2d18bd354b1676e751bcc97c7677de63"
},
"downloads": -1,
"filename": "astropop-0.9.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ec198d8f9bdf1358b1a0bce045d42a13",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 117521,
"upload_time": "2023-09-27T12:19:34",
"upload_time_iso_8601": "2023-09-27T12:19:34.828569Z",
"url": "https://files.pythonhosted.org/packages/d9/dd/d965e5316bab5dfe36d13e6786bb083222a961ce85d46a4b63ebd6947f6b/astropop-0.9.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "78a85dfa0cc5d5687d2270d3951a3ce68149ded3bcedba8fc89a12ccc60b26af",
"md5": "882b811131c164a11be0b96fa46ed0a3",
"sha256": "bfb30e4281a3d945a5963771061a46d95d396cefd80affa869910ee7062feca3"
},
"downloads": -1,
"filename": "astropop-0.9.3.tar.gz",
"has_sig": false,
"md5_digest": "882b811131c164a11be0b96fa46ed0a3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 295929,
"upload_time": "2023-09-27T12:19:36",
"upload_time_iso_8601": "2023-09-27T12:19:36.457443Z",
"url": "https://files.pythonhosted.org/packages/78/a8/5dfa0cc5d5687d2270d3951a3ce68149ded3bcedba8fc89a12ccc60b26af/astropop-0.9.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-27 12:19:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sparc4-dev",
"github_project": "astropop",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "astropop"
}
JSON
