1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
.TH ASTSCRIPT-FITS-VIEW "1" "November 2025" "GNU Astronomy Utilities 0.24" "User Commands"
.SH NAME
astscript-fits-view \- View FITS images in DS9 and tables in TOPCAT
.SH SYNOPSIS
.B astscript-fits-view
[\fI\,OPTION\/\fR] \fI\,FITS-file(s)\/\fR
.SH DESCRIPTION
This script is part of GNU Astronomy Utilities 0.24.
.PP
This script will take any number of FITS inputs and will pass them to
TOPCAT or SAO DS9 depending on the the first input FITS file: if it
contains an image HDU, the files will be passed to SAO DS9, otherwise, to
TOPCAT.
.PP
For more information, please run any of the following commands. In
particular the first contains a very comprehensive explanation of this
script's invocation: expected input(s), output(s), and a full description
of all the options.
.TP
Inputs/Outputs and options:
$ info astscript\-fits\-view
.TP
Full Gnuastro manual/book:
$ info gnuastro
.PP
If you couldn't find your answer in the manual, you can get direct help from
experienced Gnuastro users and developers. For more information, please run:
.IP
\f(CW$ info help-gnuastro\fR
.SS "astscript-fits-view options:"
.IP
Input:
.TP
\fB\-h\fR, \fB\-\-hdu\fR=\fI\,STR\/\fR
Extension name or number of input data.
.TP
\fB\-g\fR, \fB\-\-globalhdu\fR=\fI\,STR\/\fR
Use this HDU for all inputs, ignore '\-\-hdu'.
.IP
Output:
.TP
\fB\-G\fR, \fB\-\-ds9geometry\fR=\fI\,INTxINT\/\fR Size of DS9 window, e.g., for HD (800x1000) and
for 4K (1800x3000). If not given, the script will
attempt to find your screen resolution and find a
good match, otherwise, use the default size.
.TP
\fB\-e\fR, \fB\-\-ds9extra\fR=\fI\,STR\/\fR
Extra options to pass to DS9 after default ones.
.TP
\fB\-s\fR, \fB\-\-ds9scale\fR=\fI\,STR\/\fR
Custom value to '\-scale' option in DS9.
.HP
\fB\-c\fR, \fB\-\-ds9center\fR=\fI\,FLT\/\fR,FLT Coordinates of center in shown DS9 window.
.HP
\fB\-r\fR, \fB\-\-ds9region\fR=\fI\,STR[\/\fR,...] DS9 region(s) to load.
.TP
\fB\-O\fR, \fB\-\-ds9mode\fR=\fI\,img\/\fR/wcs
Coord system to interpret '\-\-ds9center' (img/wcs).
.TP
\fB\-m\fR, \fB\-\-ds9colorbarmulti\fR
Separate color bars for each loaded image.
.TP
\fB\-k\fR, \fB\-\-topcat4k\fR
TOPCAT UI is scaled by double (for 4K displays).
.TP
\fB\-p\fR, \fB\-\-prefix\fR=\fI\,STR\/\fR
Directory containing DS9 or TOPCAT executables.
.IP
Operating mode:
.TP
\-?, \fB\-\-help\fR
Print this help list.
.TP
\fB\-\-cite\fR
BibTeX citation for this program.
.TP
\fB\-q\fR, \fB\-\-quiet\fR
Don't print any extra information in stdout.
.TP
\fB\-V\fR, \fB\-\-version\fR
Print program version.
.PP
Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.
.PP
GNU Astronomy Utilities home page: http://www.gnu.org/software/gnuastro/
.SH "REPORTING BUGS"
Report bugs to bug\-gnuastro@gnu.org.
.SH COPYRIGHT
Copyright \(co 2020\-2025 Free Software Foundation, Inc.
License GPLv3+: GNU General public license version 3 or later.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.PP
Written/developed by Mohammad Akhlaghi and Sepideh Eskandarlou
.SH "SEE ALSO"
The full documentation for
.B astscript-fits-view
is maintained as a Texinfo manual. If the
.B info
and
.B astscript-fits-view
programs are properly installed at your site, the command
.IP
.B info astscript-fits-view
.PP
should give you access to the complete manual.
|
