GNU Astronomy Utilities
Table of Contents
- Book (documentation)
- Gnuastro mailing lists
- Report a Bug
- Getting involved
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:
- Quick start: To install Gnuastro.
- List of Gnuastro programs: For a complete list of the programs.
- Tutorials: for entertaining and easy to read real world examples of using Gnuastro.
The current stable release
0.2 (October 3rd, 2016).
mirror if possible.
The current Test release is Gnuastro 0.2.28-34fb (October 23rd, 2016). See the NEWS file for changes.
New releases are announced in info-gnuastro. To stay up to date, please subscribe.
For details of the significant changes please see the NEWS file.
The canonical http://ftp.gnu.org/gnu/gnuastro/gnuastro-latest.tar.gz will always contain the most recent Gnuastro release. Use the mirror link (http://ftpmirror.gnu.org/gnuastro/gnuastro-latest.tar.gz) if possible.
chapter of the Gnuastro book
methods, and the
installation of Gnuastro. In short once the three mandatory
and GNU Scientific
Library) are installed the
make install are enough
(see Quick start).
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 find navigate to any major part of the book on the command-line:
info gnuastro: To view the complete Gnuastro book from the beginning.
info ProgramName: To view the complete section about a specific program. For example
info astprogname: To only view the "Invoking ProgramName" sub-section of the manual. Each program has this subsection which explains the input(s), output(s) and command-line options for that particular program. For example
astprogname --help: A description and full list of options (classified by context) for this program will be printed. For example
man astprogname: A man page listing the options and arguments of this program. For example
man astnoisechisel, or
Gnuastro mailing lists
Gnuastro has the following mailing lists:
- info-gnuastro: All official Gnuastro announcements will be circulated through this mailing list.
- help-gnuastro: Get in touch with experienced Gnuastro users and developers on problems and advice in using Gnuastro (it will help if you have had a look at the documentation first).
- bug-gnuastro: Report a bug, or suggest a new feature (see Report a bug and Suggest new feature in the documentation).
- gnuastro-devel: Circulating development discussions (mainly interesting for Gnuastro developers).
- gnuastro-commits: Circulate commits made to Gnuastro's version controlled history in the official repository.
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.
- Submit your bug through the main project management webpage. This is the recommended way to inform us of your bug. Please also fill out the meta-data (category, item group and etc) as much as possible.
- Send a mail to bug-gnuastro::at::gnu.org which is one of Gnuastro's mailing lists. This will be slower than the first. Because of the large number of spam messages, this mailing list is moderated and other developers will only see it after it has been approved. So to immediately let all the developers know, please use the first option.
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. Test releases of Gnuastro can be found at http://alpha.gnu.org/gnu/gnuastro/ (via HTTP) and ftp://alpha.gnu.org/gnu/gnuastro/ (via FTP).
- 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
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
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.
- Gnuastro was created and is currently maintained by Mohammad Akhlaghi <akhlaghi::at::gnu.org>. Please use the mailing lists for contact.
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.