GALFITools


NameGALFITools JSON
Version 1.7.7 PyPI version JSON
download
home_pagehttps://github.com/pyscaffold/pyscaffold/
SummaryA library for GALFIT package
upload_time2024-05-16 23:33:41
maintainerNone
docs_urlNone
authorChristopher Añorve
requires_pythonNone
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            .. These are examples of badges you might want to add to your README:
   please update the URLs accordingly

    .. image:: https://api.cirrus-ci.com/github/<USER>/GALFITools.svg?branch=main
        :alt: Built Status
        :target: https://cirrus-ci.com/github/<USER>/GALFITools
    .. image:: https://readthedocs.org/projects/GALFITools/badge/?version=latest
        :alt: ReadTheDocs
        :target: https://GALFITools.readthedocs.io/en/stable/
    .. image:: https://img.shields.io/coveralls/github/<USER>/GALFITools/main.svg
        :alt: Coveralls
        :target: https://coveralls.io/r/<USER>/GALFITools
    .. image:: https://img.shields.io/conda/vn/conda-forge/GALFITools.svg
        :alt: Conda-Forge
        :target: https://anaconda.org/conda-forge/GALFITools
    .. image:: https://pepy.tech/badge/GALFITools/month
        :alt: Monthly Downloads
        :target: https://pepy.tech/project/GALFITools
    .. image:: https://img.shields.io/twitter/url/http/shields.io.svg?style=social&label=Twitter
        :alt: Twitter
        :target: https://twitter.com/GALFITools

.. image:: https://img.shields.io/pypi/v/GALFITools.svg
    :alt: PyPI-Server
    :target: https://pypi.org/project/GALFITools/

.. image:: https://img.shields.io/badge/-PyScaffold-005CA0?logo=pyscaffold
    :alt: Project generated with PyScaffold
    :target: https://pyscaffold.org/

.. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.8216472.svg 
  :target: https://doi.org/10.5281/zenodo.8216472 


==========
GALFITools
==========


A library for  `GALFIT`_ 

`GALFIT`_, a well-established two-dimensional image fitting algorithm, 
as outlined in the work by Peng et al. (2002, AJ, 124, 266), 
serves as the basis for precise astronomical image surface brightness 
analysis. In pursuit of optimizing the utilization of GALFIT, GALFITools emerges 
as an collection of Python routines. These routines 
enhances the input and output parsing associated with GALFIT.



.. _GALFIT: https://users.obs.carnegiescience.edu/peng/work/galfit/galfit.html


GALFITools extends its utility through an array of functionalities, 
including the facilitation of mask creation, star selection for PSFs, generation 
of multiple initial parameters, simulate galaxy images, multigaussian 
expansion (MGE) fitting, as well as computation of sky background 
and other pertinent photometric variables.




--------------------------------

**Installation Instructions**
-------------------------------



The python libraries required are:

-  numpy
-  astropy
-  scipy
-  matplotlib
-  mgefit



Install `GALFIT`_ if you haven't done so. Make sure
that GALFIT can run in any path in your terminal.


*Optionally*, the establishment of a virtual environment can be considered.


The latest release of GALFITools can be downloaded 
and subsequently installed via one of the following methods:


::

   cd GALFITools 
   pip install . 

or

::

   cd GALFITools 
   python setup.py install


Alternatively, you can install it via pip:


::

   pip install GALFITools 




In conjunction with the installation, a compilation of pertinent 
shell `commands <docs/howto.rst>`__ will be incorporated. Subsequently, a comprehensive 
evaluation of GALFITools' performance can be conducted through 
automated tests using the following procedure:

To run the tests locally, install and invoke tox:

::
   
   pip install tox


run the tests:

::

    tox 



-----------------

**HOW TO USE**
~~~~~~~~~~~~~~~~~

For comprehensive insights into GALFITools' repertoire 
of routines and their optimal deployment, it is 
recommended to consult the provided documentation on 
usage, accessible via the following link: 

`How to use <docs/howto.rst>`__

This comprehensive resource elaborates on the 
practical implementation of each individual routine.

---------------------

**API Reference**
~~~~~~~~~~~~~~~~~~~~


For the customization of these functions 
to align with your specific scripting requirements, 
the API documentation serves as an indispensable resource. 
The detailed instructions for utilizing these 
functions within your own scripts can be found here: 

`API <docs/api.rst>`__


--------------

**License**
--------------

The codebase of GALFITools is governed by the terms of the **MIT** license.


-----------

**Cite as**
-----------

To acknowledge the utility of GALFITools in your research, 
we kindly request that you cite it as follows:

Añorve, C. (2024). canorve/GALFITools: GALFITools v1.7.0 (v1.7.0). Zenodo. https://doi.org/10.5281/zenodo.10968602


--------------------------

**Additional Resources**
--------------------------

Check EllipSect to create surface brightness profiles
from GALFIT output and estimate other photometric parameters:

For further capabilities and valuable extensions 
pertaining to GALFIT output, such as the generation of 
surface brightness profiles and estimation of other 
photometric parameters, we invite you to explore the 
EllipSect tool: 

`EllipSect <https://github.com/canorve/EllipSect>`__



--------------

**Questions?**
--------------


Should any questions or innovative suggestions arise, 
we encourage you to reach out via email to  canorve [at] gmail [dot] com  
or initiate a discussion by opening an  `issue <https://github.com/canorve/GALFITools/issues>`__.  
Your input is invaluable in fostering the continual refinement of 
GALFITools, for the betterment of the *GALFIT* community and beyond.




.. _pyscaffold-notes:


====
Note
====

This project has been set up using PyScaffold 4.2.1. For details and usage
information on PyScaffold see https://pyscaffold.org/.


            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/pyscaffold/pyscaffold/",
    "name": "GALFITools",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": null,
    "author": "Christopher A\u00f1orve",
    "author_email": "canorve@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/4b/26/6dedf2754c69b44b30ad0ef23a12a2d165e325e62628612d51c13e8f95f2/galfitools-1.7.7.tar.gz",
    "platform": "Mac",
    "description": ".. These are examples of badges you might want to add to your README:\n   please update the URLs accordingly\n\n    .. image:: https://api.cirrus-ci.com/github/<USER>/GALFITools.svg?branch=main\n        :alt: Built Status\n        :target: https://cirrus-ci.com/github/<USER>/GALFITools\n    .. image:: https://readthedocs.org/projects/GALFITools/badge/?version=latest\n        :alt: ReadTheDocs\n        :target: https://GALFITools.readthedocs.io/en/stable/\n    .. image:: https://img.shields.io/coveralls/github/<USER>/GALFITools/main.svg\n        :alt: Coveralls\n        :target: https://coveralls.io/r/<USER>/GALFITools\n    .. image:: https://img.shields.io/conda/vn/conda-forge/GALFITools.svg\n        :alt: Conda-Forge\n        :target: https://anaconda.org/conda-forge/GALFITools\n    .. image:: https://pepy.tech/badge/GALFITools/month\n        :alt: Monthly Downloads\n        :target: https://pepy.tech/project/GALFITools\n    .. image:: https://img.shields.io/twitter/url/http/shields.io.svg?style=social&label=Twitter\n        :alt: Twitter\n        :target: https://twitter.com/GALFITools\n\n.. image:: https://img.shields.io/pypi/v/GALFITools.svg\n    :alt: PyPI-Server\n    :target: https://pypi.org/project/GALFITools/\n\n.. image:: https://img.shields.io/badge/-PyScaffold-005CA0?logo=pyscaffold\n    :alt: Project generated with PyScaffold\n    :target: https://pyscaffold.org/\n\n.. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.8216472.svg \n  :target: https://doi.org/10.5281/zenodo.8216472 \n\n\n==========\nGALFITools\n==========\n\n\nA library for  `GALFIT`_ \n\n`GALFIT`_, a well-established two-dimensional image fitting algorithm, \nas outlined in the work by Peng et al. (2002, AJ, 124, 266), \nserves as the basis for precise astronomical image surface brightness \nanalysis. In pursuit of optimizing the utilization of GALFIT, GALFITools emerges \nas an collection of Python routines. These routines \nenhances the input and output parsing associated with GALFIT.\n\n\n\n.. _GALFIT: https://users.obs.carnegiescience.edu/peng/work/galfit/galfit.html\n\n\nGALFITools extends its utility through an array of functionalities, \nincluding the facilitation of mask creation, star selection for PSFs, generation \nof multiple initial parameters, simulate galaxy images, multigaussian \nexpansion (MGE) fitting, as well as computation of sky background \nand other pertinent photometric variables.\n\n\n\n\n--------------------------------\n\n**Installation Instructions**\n-------------------------------\n\n\n\nThe python libraries required are:\n\n-  numpy\n-  astropy\n-  scipy\n-  matplotlib\n-  mgefit\n\n\n\nInstall `GALFIT`_ if you haven't done so. Make sure\nthat GALFIT can run in any path in your terminal.\n\n\n*Optionally*, the establishment of a virtual environment can be considered.\n\n\nThe latest release of GALFITools can be downloaded \nand subsequently installed via one of the following methods:\n\n\n::\n\n   cd GALFITools \n   pip install . \n\nor\n\n::\n\n   cd GALFITools \n   python setup.py install\n\n\nAlternatively, you can install it via pip:\n\n\n::\n\n   pip install GALFITools \n\n\n\n\nIn conjunction with the installation, a compilation of pertinent \nshell `commands <docs/howto.rst>`__ will be incorporated. Subsequently, a comprehensive \nevaluation of GALFITools' performance can be conducted through \nautomated tests using the following procedure:\n\nTo run the tests locally, install and invoke tox:\n\n::\n   \n   pip install tox\n\n\nrun the tests:\n\n::\n\n    tox \n\n\n\n-----------------\n\n**HOW TO USE**\n~~~~~~~~~~~~~~~~~\n\nFor comprehensive insights into GALFITools' repertoire \nof routines and their optimal deployment, it is \nrecommended to consult the provided documentation on \nusage, accessible via the following link: \n\n`How to use <docs/howto.rst>`__\n\nThis comprehensive resource elaborates on the \npractical implementation of each individual routine.\n\n---------------------\n\n**API Reference**\n~~~~~~~~~~~~~~~~~~~~\n\n\nFor the customization of these functions \nto align with your specific scripting requirements, \nthe API documentation serves as an indispensable resource. \nThe detailed instructions for utilizing these \nfunctions within your own scripts can be found here: \n\n`API <docs/api.rst>`__\n\n\n--------------\n\n**License**\n--------------\n\nThe codebase of GALFITools is governed by the terms of the **MIT** license.\n\n\n-----------\n\n**Cite as**\n-----------\n\nTo acknowledge the utility of GALFITools in your research, \nwe kindly request that you cite it as follows:\n\nA\u00f1orve, C. (2024). canorve/GALFITools: GALFITools v1.7.0 (v1.7.0). Zenodo. https://doi.org/10.5281/zenodo.10968602\n\n\n--------------------------\n\n**Additional Resources**\n--------------------------\n\nCheck EllipSect to create surface brightness profiles\nfrom GALFIT output and estimate other photometric parameters:\n\nFor further capabilities and valuable extensions \npertaining to GALFIT output, such as the generation of \nsurface brightness profiles and estimation of other \nphotometric parameters, we invite you to explore the \nEllipSect tool: \n\n`EllipSect <https://github.com/canorve/EllipSect>`__\n\n\n\n--------------\n\n**Questions?**\n--------------\n\n\nShould any questions or innovative suggestions arise, \nwe encourage you to reach out via email to  canorve [at] gmail [dot] com  \nor initiate a discussion by opening an  `issue <https://github.com/canorve/GALFITools/issues>`__.  \nYour input is invaluable in fostering the continual refinement of \nGALFITools, for the betterment of the *GALFIT* community and beyond.\n\n\n\n\n.. _pyscaffold-notes:\n\n\n====\nNote\n====\n\nThis project has been set up using PyScaffold 4.2.1. For details and usage\ninformation on PyScaffold see https://pyscaffold.org/.\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A library for GALFIT package",
    "version": "1.7.7",
    "project_urls": {
        "Documentation": "https://pyscaffold.org/",
        "GALFIT": "https://users.obs.carnegiescience.edu/peng/work/galfit/galfit.html",
        "Homepage": "https://github.com/pyscaffold/pyscaffold/",
        "Source": "https://github.com/canorve/GALFITools"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d3475463548cb89caacc6db5083c73007b0f9f9fa1e2402fa2a6fdaa49ef9763",
                "md5": "7766dddb298a8a6dd12d90e21fabda5d",
                "sha256": "47a1980664b3aa26def2ec66bdfad44839b329bb5d4def09db139ebdab6b6faf"
            },
            "downloads": -1,
            "filename": "GALFITools-1.7.7-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "7766dddb298a8a6dd12d90e21fabda5d",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 103437,
            "upload_time": "2024-05-16T23:33:36",
            "upload_time_iso_8601": "2024-05-16T23:33:36.712048Z",
            "url": "https://files.pythonhosted.org/packages/d3/47/5463548cb89caacc6db5083c73007b0f9f9fa1e2402fa2a6fdaa49ef9763/GALFITools-1.7.7-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "4b266dedf2754c69b44b30ad0ef23a12a2d165e325e62628612d51c13e8f95f2",
                "md5": "3c9bf0e7872696674ab3eb01b95ecc72",
                "sha256": "6974c900e0715fa6c4be232218c45c1e228ded604f27e9cb24c24188f396b54a"
            },
            "downloads": -1,
            "filename": "galfitools-1.7.7.tar.gz",
            "has_sig": false,
            "md5_digest": "3c9bf0e7872696674ab3eb01b95ecc72",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 25782448,
            "upload_time": "2024-05-16T23:33:41",
            "upload_time_iso_8601": "2024-05-16T23:33:41.434052Z",
            "url": "https://files.pythonhosted.org/packages/4b/26/6dedf2754c69b44b30ad0ef23a12a2d165e325e62628612d51c13e8f95f2/galfitools-1.7.7.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-05-16 23:33:41",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "pyscaffold",
    "github_project": "pyscaffold",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "tox": true,
    "lcname": "galfitools"
}
        
Elapsed time: 0.26059s