SAO DS9 is not a requirement of Gnuastro, it is a FITS image viewer. It is therefore a useful tool to visually inspect the images/cubes of your Gnuastro inputs or outputs (for tables, see TOPCAT). In Gnuastro we have an installed script to run DS9 or TOPCAT on any number of FITS files (depending on it being an image or table), see Viewing FITS file contents with DS9 or TOPCAT (which also includes a .desktop file for GUI integration). After installing DS9, you can easily use that script to open any FITS file (table, image or cube).
Like the other packages, it might already be available in your distribution’s repositories.
It is also already pre-compiled in the download section of its web page.
Once you download it you can unpack and install (move it to a system recognized directory) with the following commands (
x.x.x is the version number):
$ tar xf ds9.linux64.x.x.x.tar.gz $ sudo mv ds9 /usr/local/bin
To test the build (as long as /usr/local/bin is in your
PATH, see Installation directory), you can simply run the command below.
Install without root permissions: If you do not have root permissions, you can simply replace /usr/local/bin in the command above with $HOME/.local/bin.
If this directory is not in your
Below you can see a list of known issues in some operating systems that we have found so far. You should be able to identify any potential error when running DS9 from the command-line like above.
XPArelated error. In this case, you have to add the following line to your ~/.bashrc and ~/.profile file (you will have to log out and back in again for the latter):