GNU Astronomy Utilities


Next: , Previous: , Up: Introduction   [Contents][Index]


1.1 Quick start

Gnuastro has three mandatory dependencies and three optional dependencies for extra functionality, see Dependencies. The latest official release tarball is always available as gnuastro-latest.tar.gz. For better compression (faster download), and robust archival features, an Lzip compressed tarball is also available at gnuastro-latest.tar.lz, see Release tarball for more details on the tarball release. If you have downloaded the tarball in the TOPGNUASTRO directory and the dependencies are installed, you can unpack, compile, check and install Gnuastro with the following commands. If you use GNU Tar, the same command ($ tar xf) can also be used to unpack .tar.lz tarballs (the Lzip must already be installed).

$ cd TOPGNUASTRO
$ tar xf gnuastro-latest.tar.gz    # This works on `.tar.lz' too.
$ cd gnuastro-X.X                  # Replace X.X with version number.
$ ./configure
$ make -j8                         # Replace 8 with no. CPU threads.
$ make check
$ sudo make install

See Known issues if you confront any complications. For each program there is an ‘Invoke ProgramName’ sub-section in this book which explains how the programs should be run on the command-line. You can read it on the command-line by running the command $ info astprogname, see Naming convention and Getting help. The ‘Invoke ProgramName’ sub-section starts with a few examples of each program and goes on to explain the invocation details. In Tutorials some real life examples of how these programs might be used are given.