130
500 members

GNU Astronomy Utilities


Introduction

The GNU Astronomy Utilities (Gnuastro) is an official GNU package consisting of various programs and library functions for the manipulation and analysis of astronomical data. All the programs share the same basic command-line user interface for the comfort of both the users and developers. Gnuastro is written to comply fully with the GNU coding standards so it integrates finely with the GNU/Linux operating system. This also enables astronomers to expect a fully familiar experience in the source code, building, installing and command-line user interaction that they have seen in all the other GNU software that they use.

In case you are new to Gnuastro, you might find these links useful:

Download

The current stable release is Gnuastro 0.13 (September 7th, 2020). Use a mirror if possible.
New releases are announced in info-gnuastro. To stay up to date, please subscribe.

For details of the significant changes in this release, please see the NEWS file.

The canonical https://ftp.gnu.org/gnu/gnuastro/gnuastro-latest.tar.gz will always contain the most recent Gnuastro release. Use the mirror link (https://ftpmirror.gnu.org/gnuastro/gnuastro-latest.tar.gz) if possible.

Previous versions and PGP signatures are always available at https://ftp.gnu.org/gnu/gnuastro. Use a mirror if possible.

Packaging status

Installation

See Quick start for a fast review of the Gnuastro's building and installation commands.

Gnuastro only has three mandatory dependencies: GNU Scientific Library, CFITSIO, WCSLIB.
See Dependencies from package managers for easy installation of Gnuastro's dependencies using tools like apt-get, dnf (or yum), pacman, zypper or brew.

For a more detailed description, see the Installation chapter of the Gnuastro book. It thoroughly discusses the dependencies, downloading methods, and the building and installation of Gnuastro.

Gnuastro book (documentation)

The Gnuastro book (official Gnuastro documentation or manual) is available online in various formats, as is documentation for most GNU software. After installation, you can access the complete book, or the sections related to individual programs and library headers on the command-line (in Info format). See Getting help for more. As a summary, here are the ways you can immediately navigate to any major part of the book on the command-line:

Mailing lists

Gnuastro has the following mailing lists:

Security reports that should not be made immediately public can be sent directly to the maintainer. If there is no response to an urgent issue, you can escalate to the general security mailing list for advice.

Report a bug

The Report a bug section of the manual thoroughly explains the process to report a bug, please read that section. As a summary, first have a look at the Gnuastro bug archive. Click on the "Display criteria" (above the list), choose "Any" in the "Open/Closed" drop-down menu, and under "Category" choose the part of Gnuastro that corresponds to your bug. By clicking on the "Apply" button, only the relevant bugs will be listed. Green items have been solved and closed, while red items are still open. If your bug isn't listed, please take one of the following steps. Please try to be as descriptive as possible and include the Gnuastro version you are using along with the commands or code that created the bug so we can reproduce and thus fix it faster.

Getting involved

The most important principle behind Gnuastro is to be easy for anyone to hack into it (add a new feature, change an existing one, fix a problem and most importantly to understand what is going on under the hood), please see Science and its tools. So you are most welcome and highly encouraged to contribute. There is even a full chapter dedicated to Developing to make it as easy as possible for you to get involved. Also see How to help GNU for joining the full GNU project.

Test releases
Trying the latest test release (when available) is always appreciated. Official alpha-releases of Gnuastro can be found at http://alpha.gnu.org/gnu/gnuastro/ (via HTTP) and ftp://alpha.gnu.org/gnu/gnuastro/ (via FTP). Only one or two of these will be available between the offical releases, but they are also archived in the URLs above.
Alternatively, the tarball corresponding to the most recent commit, is also available at http://akhlaghi.org/gnuastro-latest.tar.lz and its PDF manual is available at http://akhlaghi.org/gnuastro.pdf. For the changes compared to the last major release, see the NEWS file (also available in the tarball). Just note that the contents of this tarball constantly change with every commit in the Gnuastro history. So the tarball can be reproduced by bootstrapping that commit, but it will not be archived for future direct downloads.
Development
Gnuastro is still under active development. So if you are interested, please have a look at the Developing chapter of the documentation and start hacking into Gnuastro or even write your own program within it (Gnuastro has a template to help you). For development sources, bug trackers, task trackers (planned features to be added), and other information, please see the Gnuastro project page at savannah.gnu.org. The trackers can be a good starting point if you want to get involved in the coding. To stay up to date with Gnuastro's development activities, please subscribe to the gnuastro-devel, and/or the gnuastro-commits mailing lists.
Gnuastro is version controlled using Git. The version controlled source can be inspected online, or you can see the latest history. To keep a local copy, please clone it onto your system with any one of the following commands (if it works, the first one is recommended).
git clone git://git.sv.gnu.org/gnuastro
git clone http://git.sv.gnu.org/r/gnuastro.git
To configure and build the version controlled source, you will need to bootstrap it (also see bootstrapping dependencies). See the forking tutorial for a demonstration of the Gnuastro project workflow.
Maintainer
Gnuastro was created and is currently maintained by Mohammad Akhlaghi <mohammad::at::akhlaghi.org>. Please use the mailing lists for contact.

How to cite

Citations are vital for the continued work on Gnuastro. All the programs accept the common --cite option which will guide you on how to properly cite and acknowledge the work that has gone into creating and maintaining that particular program and Gnuastro in general. If any of the programs or libraries offered in Gnuastro are useful in your research, please use the output of this option to cite the program and Gnuastro in your research paper. Note that different programs may require citation of different papers specifically devoted to them.

Gnuastro is still new, thus there is no paper fully devoted to introducing it and its capabilities yet. Until then, the paper to cite for Gnuastro in general is the paper which introduced NoiseChisel (ApJS 220, 1). It was the first published paper using Gnuastro. Upon reaching a certain point, a paper completely devoted to Gnuastro will be published, see GNU Astronomy Utilities 1.0.

Gnuastro is also registered on the Astrophysics Source Code Library (ASCL) with ascl.net/1801.009. Please use this identifier somewhere in the body of your paper (for example in the acknowledgments or first mention of Gnuastro). For the bibliography/references list at the end of the paper, please only use the papers listed in the output of --cite.

Recent citations of Gnuastro

Below you can see a list of the 20 recent papers that have cited Gnuastro (any of its programs or libraries) as of September 7th, 2020. For the full, and up-to-date, list please see the respective Google Scholar or ADS pages.

  1. Bilek, M. Duc, P.A., et al. (2020) Census and classification of low-surface-brightness structures in nearby early-type galaxies from the MATLAS survey. Monthly Notices of the Royal Astronomical Society (MNRAS), August 2020. DOI:10.1093/mnras/staa2248. arXiv:2007.13772.
  2. Sachdeva, S., Ho, L.C., et al. (2020) Correlation of Structure and Stellar Properties of Galaxies in Stripe 82. Astrophysical Journal. DOI:10.3847/1538-4357/aba82d. arXiv:2007.08328.
  3. Rampazzo, R., Omizzolo, A., et al. (2020) Morphology and surface photometry of a sample of isolated early-type galaxies from deep imaging. Astronomy & Astrophysics 640, 38. DOI:10.1051/0004-6361/202038156. arXiv:2006.05323.
  4. Popescu, M., de León, J., et al. (2020) Physical characterization of 2020 AV2, the first known asteroid orbiting inside Venus orbit . Monthly Notices of the Royal Astronomical Society (MNRAS), 496, 3, 3572. DOI:10.1093/mnras/staa1728. arXiv:2006.08304.
  5. Brough, S., Collins, C., et al. (2020) The Vera Rubin Observatory Legacy Survey of Space and Time and the Low Surface Brightness Universe. IAU Symposium 355 (in press). arXiv:2001.11067.
  6. Duc, P.A (2020) MATLAS: a deep exploration of the surroundings of massive early-type galaxies. IAU Symposium 355 (in press). hal-02382682.
  7. Kaviraj, S. (2020) The low-surface-brightness Universe: a new frontier in the study of galaxy evolution. IAU Symposium 355 (in press). arXiv:2001.01728.
  8. Akhlaghi M., (2020) Carving out the low surface brightness universe with NoiseChisel. IAU Symposium 355 (in press). arXiv:1909.11230.
  9. Infante-Sainz, R., Trujillo, I., Román, J., (2020) The Sloan Digital Sky Survey extended Point Spread Functions. Monthly Notices of the Royal Astronomical Society (MNRAS), 491, 4, 5317. DOI:10.1093/mnras/stz3111. arXiv:1911.01430.
  10. Habas, R., Marleau, F.R., et al. (2019) Newly discovered dwarf galaxies in the MATLAS low density fields. Monthly Notices of the Royal Astronomical Society (MNRAS), 491, 2, 1901. DOI:10.1093/mnras/stz3045. arXiv:1910.13462.
  11. Jones, M.G., Verdes-Montenegro, L., et al. (2019) Evolution of compact groups from intermediate to final stages. A case study of the H I content of HCG 16. Astronomy & Astrophysics 632, 78. DOI:10.1051/0004-6361/201936349. arXiv:1910.03420.
  12. Calvi, R., Rodríguez Espinosa, J.M., et al. (2019) MOS spectroscopy of protocluster candidate galaxies at z = 6.5. Monthly Notices of the Royal Astronomical Society 489, 329. DOI:10.1093/mnras/stz2177, arXiv:1908.01827.
  13. Boogaard, L.A., Decarli, R., et al. (2019) The ALMA Spectroscopic Survey in the HUDF: Nature and Physical Properties of Gas-mass Selected Galaxies Using MUSE Spectroscopy. The Astrophysical Journal 882, 140B. DOI:10.3847/1538-4357/ab3102, arXiv:1903.09167.
  14. Sachdeva, S., Gogoi, R., et al. (2019) Formation of disc galaxies around z~2 . Monthly Notices of the Royal Astronomical Society 487, 1795. DOI:10.1093/mnras/stz1417, arXiv:1905.08432.
  15. de La Vieuville, G., Bina, D., et al. (2019) Faint end of the z~3-7 luminosity function of Lyman-alpha emitters behind lensing clusters observed with MUSE. Astronomy & Astrophysics, 628, A3. DOI:10.1051/0004-6361/201834471, arXiv:1905.13696.
  16. Román, J., Trujillo, I., Montes, M. (2019) Galactic cirri in deep optical imaging. Astronomy & Astrophysics (Submitted). arXiv:1907.00978.
  17. Trujillo, I., Beasley, M.A., et al. (2019) A distance of 13 Mpc resolves the claimed anomalies of the galaxy lacking dark matter. Monthly Notices of the Royal Astronomical Society, 486, 1192. DOI:10.1093/mnras/stz771, arXiv:1806.10141.
  18. Hsieh, H.H.; Bannister, M.T., et al. (2019) Maximizing LSST Solar System Science: Approaches, Software Tools, and Infrastructure Needs. White paper. arXiv:1906.11346.
  19. Martin, G., Kaviraj, S., et al. (2019) The formation and evolution of low-surface-brightness galaxies. Monthly Notices of the Royal Astronomical Society, 485, 796. DOI:10.1093/mnras/stz356, arXiv:1902.04580.
  20. Chandler, C.O., Kueny, J., et al. (2019) Six Years of Sustained Activity in (6478) Gault. The Astrophysical Journal Letters 877, L12. DOI:10.3847/2041-8213/ab1aaa, arXiv:1904.10530.

Licensing

GNU Astronomy Utilities (Gnuastro) is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.


Available for this page:

English [en]   français [fr]  

 [FSF logo]  “The Free Software Foundation (FSF) is a nonprofit with a worldwide mission to promote computer user freedom. We defend the rights of all software users.”