astscript-pointing-simulate(1)

astscript-pointing-simulate1

Simulate the exposure map of a pointing pattern

Usage

astscript-pointing-simulate positions-cat.fits --center=1.23,4.56 --width=2,2 --img=image.fits [OPTIONS]

Overview

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.

astscript-pointing-simulate options:

Input:

-h, --hdu=STR/INT

HDU name or number of the positions catalog.

-i, --img=STR

Name of reference image.

-H, --imghdu=STR/INT

HDU name or number of the input image.

-r, --racol=STR/INT

Name/number of column containing RA.

-d, --deccol=STR/INT

Name/number of column containing Declination.

--mksrc=STR

Makefile (for developers when debugging).

Hooks:

--hook-warp-before='COMMAND' Before warping each exposure;

Input: ''. Output: ''.

--hook-warp-after='COMMAND' After warping each exposure;

Input: ''. Output: ''.

Output:

-o, --output=STR

Name of finally stacked image.

-C, --center=FLT,FLT

Center of output stack (in RA,Dec).

-w, --width=FLT,FLT

Width of output stack (in WCS).

--ctype=STR,STR

Projection of output (CTYPEi in WCS).

--widthinpix

Interpret '--width' values in pixels.

--stack-operator="STR" Arithmetic operator to use for stacking.

-t, --tmpdir=STR

Directory to keep temporary files.

-k, --keeptmp

Keep temporal/auxiliar files.

Operating mode:

-?, --help

Print this help.

-N, --numthreads=INT

Number of threads; maximum if not given.

--cite

BibTeX citation for this program.

-q, --quiet

Don't print any extra information in stdout.

-V, --version

Print program version.

Mandatory or optional arguments to long options are also mandatory or optional for any corresponfing short options.

GNU Astronomy Utilities home page: http://www.gnu.org/software/gnuastro/

Reporting bugs

Report bugs to [email protected]

From gnuastro 0.23-2+b3 in Debian 13 (Trixie). Parsed by carta from the page's man source.