.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH ASTSCRIPT-POINTING-SIMULATE "1" "February 2024" "GNU Astronomy Utilities 0.22" "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 stack after applying that dither (where each pixel contains
the number of exposures that were used in it). The field of the final stack
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 stacked 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 stack (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\-\-stack\-operator=\fR"STR" Arithmetic operator to use for stacking.
.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\-2024 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.