In this chapter we give several tutorials or cookbooks on how to use the various tools in Gnuastro for your scientific purposes. In these tutorials, we have intentionally avoided too many cross references to make it more easily readable. To get more information about a particular program, you can visit the section with the same name as the program in this book. Each program section starts by explaining the general concepts behind what it does. If you only want to see an explanation of the options and arguments of any program, see the subsection titled ‘Invoking ProgramName’. See Conventions, for an explanation of the conventions we use in the example codes through the book.
The tutorials in this section use a fictional setting of some historical figures in the history of astronomy. We have tried to show how Gnuastro would have been helpful for them in making their discoveries if there were GNU/Linux computers in their times! Please excuse us for any historical inaccuracy, this is not intended to be a historical reference. This form of presentation can make the tutorials more pleasant and entertaining to read while also being more practical (explaining from a user’s point of view)13. The main reference for the historical facts mentioned in these fictional settings was Wikipedia.
|• Hubble visually checks and classifies his catalog:||Check a catalog.|
|• Sufi simulates a detection:||Simulating a detection.|
|• General program usage tutorial:||Usage of all programs in a good way.|
This form of presenting a tutorial was influenced by the PGF/TikZ and Beamer manuals. The first provides graphic capabilities, while with the second you can make presentation slides in TeX and LaTeX. In these manuals, Till Tantau (author of the manual) uses Euclid as the protagonist. There are also some nice words of wisdom for Unix-like systems called “Rootless Root”: http://catb.org/esr/writings/unix-koans/. These also have a similar style but they use a mythical figure named Master Foo. If you already have some experience in Unix-like systems, you will definitely find these “Unix Koans” very entertaining.