=====
PyRAF
=====
|Release| |CI Status| |Coverage Status| |Documentation|
PyRAF is a command language for running IRAF tasks in a Python like
environment. It works very similar to IRAF, but has been updated to
allow such things as importing Python modules, starting in any
directory, GUI parameter editing and help. Most importantly, it can be
imported into Python allowing you to run IRAF commands from within a
larger script.
Installation
------------
To install PyRAF, it is required to have both IRAF_ and Python_
already installed. For the IRAF installation, both a self-compiled and
a binary IRAF package (f.e. in Ubuntu_) will work.
The IRAF installation should have a properly configured environment,
especially the ``iraf`` environment variable must be set to point to
the IRAF installation directory (i.e. to ``/usr/lib/iraf/`` on Ubuntu
or Debian systems). On multi-arch IRAF installations, the ``IRAFARCH``
environment variable should specify the architecture to use. This is
usually already set during the IRAF installation procedure.
The minimal Python required for PyRAF is 3.6, but it is recommended to
use the latest available version. An installation in an virtual
environment like venv_ or conda_ is possible.
The package can be installed from PyPI_ with the command ``pip3
install pyraf``. Note that if no binary installation is available on
PyPI, the package requires a compilation, so aside from pip3, the C
compiler and development libraries (on Linux ``libx11-dev``) should be
installed.
Contributing Code, Documentation, or Feedback
---------------------------------------------
IRAF and PyRAF can only survive by the contribution of its users, so
we welcome and encourage your contributions. The preferred way to
report a bug is to create a new issue on the `PyRAF GitHub
issue <https://github.com/iraf-community/pyraf/issues>`_ page. To
contribute patches, we suggest to create a `pull request on
GitHub <https://github.com/iraf-community/pyraf/pulls>`_.
License
-------
PyRAF is licensed under a 3-clause BSD style license - see the
`LICENSE.txt <LICENSE.txt>`_ file.
Documentation
-------------
* `The PyRAF Tutorial <https://pyraf.readthedocs.io>`_
.. |CI Status| image:: https://github.com/iraf-community/pyraf/actions/workflows/citest.yml/badge.svg
:target: https://github.com/iraf-community/pyraf/actions
:alt: Pyraf CI Status
.. |Coverage Status| image:: https://codecov.io/gh/iraf-community/pyraf/branch/main/graph/badge.svg
:target: https://codecov.io/gh/iraf-community/pyraf
:alt: PyRAF Coverage Status
.. |Release| image:: https://img.shields.io/github/release/iraf-community/pyraf.svg
:target: https://github.com/iraf-community/pyraf/releases/latest
:alt: Pyraf release
.. |Documentation| image:: https://readthedocs.org/projects/pyraf/badge/?version=latest
:target: https://pyraf.readthedocs.io/en/latest/
:alt: Documentation Status
.. _Python: https://www.python.org/
.. _venv: https://docs.python.org/3/library/venv.html
.. _conda: https://docs.conda.io/
.. _PyPI: https://pypi.org/project/pyraf
.. _IRAF: https://iraf-community.github.io
.. _iraf-community: https://iraf-community.github.io
.. _Ubuntu: https://www.ubuntu.com/
Raw data
{
"_id": null,
"home_page": null,
"name": "pyraf",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "astronomy, astrophysics, utility, iraf",
"author": "Rick White, Perry Greenfield, Chris Sontag, Ole Streicher",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/d9/ea/359640137867c9f3b3ddbc78874c80adf6b98b7ab1ff05637f6eea63d8d8/pyraf-2.2.2.tar.gz",
"platform": null,
"description": "=====\nPyRAF\n=====\n\n|Release| |CI Status| |Coverage Status| |Documentation|\n\nPyRAF is a command language for running IRAF tasks in a Python like\nenvironment. It works very similar to IRAF, but has been updated to\nallow such things as importing Python modules, starting in any\ndirectory, GUI parameter editing and help. Most importantly, it can be\nimported into Python allowing you to run IRAF commands from within a\nlarger script.\n\nInstallation\n------------\n\nTo install PyRAF, it is required to have both IRAF_ and Python_\nalready installed. For the IRAF installation, both a self-compiled and\na binary IRAF package (f.e. in Ubuntu_) will work.\n\nThe IRAF installation should have a properly configured environment,\nespecially the ``iraf`` environment variable must be set to point to\nthe IRAF installation directory (i.e. to ``/usr/lib/iraf/`` on Ubuntu\nor Debian systems). On multi-arch IRAF installations, the ``IRAFARCH``\nenvironment variable should specify the architecture to use. This is\nusually already set during the IRAF installation procedure.\n\nThe minimal Python required for PyRAF is 3.6, but it is recommended to\nuse the latest available version. An installation in an virtual\nenvironment like venv_ or conda_ is possible.\n\nThe package can be installed from PyPI_ with the command ``pip3\ninstall pyraf``. Note that if no binary installation is available on\nPyPI, the package requires a compilation, so aside from pip3, the C\ncompiler and development libraries (on Linux ``libx11-dev``) should be\ninstalled.\n\nContributing Code, Documentation, or Feedback\n---------------------------------------------\n\nIRAF and PyRAF can only survive by the contribution of its users, so\nwe welcome and encourage your contributions. The preferred way to\nreport a bug is to create a new issue on the `PyRAF GitHub\nissue <https://github.com/iraf-community/pyraf/issues>`_ page. To\ncontribute patches, we suggest to create a `pull request on\nGitHub <https://github.com/iraf-community/pyraf/pulls>`_.\n\nLicense\n-------\n\nPyRAF is licensed under a 3-clause BSD style license - see the\n`LICENSE.txt <LICENSE.txt>`_ file.\n\nDocumentation\n-------------\n\n* `The PyRAF Tutorial <https://pyraf.readthedocs.io>`_\n\n\n.. |CI Status| image:: https://github.com/iraf-community/pyraf/actions/workflows/citest.yml/badge.svg\n :target: https://github.com/iraf-community/pyraf/actions\n :alt: Pyraf CI Status\n\n.. |Coverage Status| image:: https://codecov.io/gh/iraf-community/pyraf/branch/main/graph/badge.svg\n :target: https://codecov.io/gh/iraf-community/pyraf\n :alt: PyRAF Coverage Status\n\t \n.. |Release| image:: https://img.shields.io/github/release/iraf-community/pyraf.svg\n :target: https://github.com/iraf-community/pyraf/releases/latest\n :alt: Pyraf release\n\n.. |Documentation| image:: https://readthedocs.org/projects/pyraf/badge/?version=latest\n :target: https://pyraf.readthedocs.io/en/latest/\n :alt: Documentation Status\n\n.. _Python: https://www.python.org/\n\n.. _venv: https://docs.python.org/3/library/venv.html\n\n.. _conda: https://docs.conda.io/\n\n.. _PyPI: https://pypi.org/project/pyraf\n\n.. _IRAF: https://iraf-community.github.io\n\n.. _iraf-community: https://iraf-community.github.io\n\n.. _Ubuntu: https://www.ubuntu.com/\n",
"bugtrack_url": null,
"license": "BSD 3-Clause",
"summary": "Pythonic interface to IRAF that can be used in place of the existing IRAF CL",
"version": "2.2.2",
"project_urls": null,
"split_keywords": [
"astronomy",
" astrophysics",
" utility",
" iraf"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d9ea359640137867c9f3b3ddbc78874c80adf6b98b7ab1ff05637f6eea63d8d8",
"md5": "1e72b450eb2d47b158068ac2597e3981",
"sha256": "c122d01a22da8ee181f874b7ce7b7f720587a9a72910333d2af09a25b91a2f45"
},
"downloads": -1,
"filename": "pyraf-2.2.2.tar.gz",
"has_sig": false,
"md5_digest": "1e72b450eb2d47b158068ac2597e3981",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 600596,
"upload_time": "2024-04-22T16:41:13",
"upload_time_iso_8601": "2024-04-22T16:41:13.896700Z",
"url": "https://files.pythonhosted.org/packages/d9/ea/359640137867c9f3b3ddbc78874c80adf6b98b7ab1ff05637f6eea63d8d8/pyraf-2.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-22 16:41:13",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pyraf"
}
JSON