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
110
111
112
|
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
.TH ASTSCRIPT-POINTING-SIMULATE "1" "November 2025" "GNU Astronomy Utilities 0.24" "User Commands"
.SH NAME
astscript-pointing-simulate \- Simulate the exposure map of a pointing pattern
.SH SYNOPSIS
.B astscript-pointing-simulate
\fI\,positions-cat.fits --center=1.23,4.56 --width=2,2 --img=image.fits \/\fR[\fI\,OPTIONS\/\fR]
.SH DESCRIPTION
Given a set of dithering positions ('positions\-cat.fits' in the example
above), and an image ('image.fits' which can be from any part of the sky,
only its distortion and orientation are important), build the exposure map
of the output coadd after applying that dither (where each pixel contains
the number of exposures that were used in it). The field of the final coad
can be set with the '\-\-center' and '\-\-width' options.
.SS "astscript-pointing-simulate options:"
.IP
Input:
.TP
\fB\-h\fR, \fB\-\-hdu\fR=\fI\,STR\/\fR/INT
HDU name or number of the positions catalog.
.TP
\fB\-i\fR, \fB\-\-img\fR=\fI\,STR\/\fR
Name of reference image.
.TP
\fB\-H\fR, \fB\-\-imghdu\fR=\fI\,STR\/\fR/INT
HDU name or number of the input image.
.TP
\fB\-r\fR, \fB\-\-racol\fR=\fI\,STR\/\fR/INT
Name/number of column containing RA.
.TP
\fB\-d\fR, \fB\-\-deccol\fR=\fI\,STR\/\fR/INT
Name/number of column containing Declination.
.TP
\fB\-\-mksrc\fR=\fI\,STR\/\fR
Makefile (for developers when debugging).
.IP
Hooks:
.TP
\fB\-\-hook\-warp\-before=\fR'COMMAND' Before warping each exposure;
Input: ''. Output: ''.
.TP
\fB\-\-hook\-warp\-after=\fR'COMMAND' After warping each exposure;
Input: ''. Output: ''.
.IP
Output:
.TP
\fB\-o\fR, \fB\-\-output\fR=\fI\,STR\/\fR
Name of finally coadded image.
.TP
\fB\-C\fR, \fB\-\-center\fR=\fI\,FLT\/\fR,FLT
Center of output stack (in RA,Dec).
.TP
\fB\-w\fR, \fB\-\-width\fR=\fI\,FLT\/\fR,FLT
Width of output coadd (in WCS).
.TP
\fB\-\-ctype\fR=\fI\,STR\/\fR,STR
Projection of output (CTYPEi in WCS).
.TP
\fB\-\-widthinpix\fR
Interpret '\-\-width' values in pixels.
.HP
\fB\-\-coadd\-operator=\fR"STR" Arithmetic operator to use for coadding.
.TP
\fB\-t\fR, \fB\-\-tmpdir\fR=\fI\,STR\/\fR
Directory to keep temporary files.
.TP
\fB\-k\fR, \fB\-\-keeptmp\fR
Keep temporal/auxiliar files.
.IP
Operating mode:
.TP
\-?, \fB\-\-help\fR
Print this help.
.TP
\fB\-N\fR, \fB\-\-numthreads\fR=\fI\,INT\/\fR
Number of threads; maximum if not given.
.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 corresponfing 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 2023\-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, Raul Infante\-Sainz and Sepideh Eskandarlou.
.SH "SEE ALSO"
The full documentation for
.B astscript-pointing-simulate
is maintained as a Texinfo manual. If the
.B info
and
.B astscript-pointing-simulate
programs are properly installed at your site, the command
.IP
.B info astscript-pointing-simulate
.PP
should give you access to the complete manual.
|
