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; but these may be outdated. DS9 is also already pre-compiled for many common operating systems in the download section of its own web page:
$ tar -xf ds9.debian11.X.X.X.tar.gz
$ sudo mv ds9 /usr/local/bin
$ cd $ ds9
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):