Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
ASTSCRIPT-POINTING-SIMULATE(1)	  User Commands   ASTSCRIPT-POINTING-SIMULATE(1)

NAME
     astscript-pointing-simulate  - Simulate the exposure map of a pointing pat-
     tern

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

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.

   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 coadded image.

     -C, --center=FLT,FLT
	    Center of output stack (in RA,Dec).

     -w, --width=FLT,FLT
	    Width of output coadd (in WCS).

     --ctype=STR,STR
	    Projection of output (CTYPEi in WCS).

     --widthinpix
	    Interpret '--width' values in pixels.

     --coadd-operator="STR" Arithmetic operator to use for coadding.

     -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  op-
     tional for any corresponfing short options.

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

REPORTING BUGS
     Report bugs to bug-gnuastro@gnu.org

COPYRIGHT
     Copyright (C) 2023-2025 Free Software Foundation, Inc.  License GPLv3+: GNU
     General public license version 3 or later.
     This  is  free software: you are free to change and redistribute it.  There
     is NO WARRANTY, to the extent permitted by law.

     Written/developed by Mohammad Akhlaghi, Raul Infante-Sainz and Sepideh  Es-
     kandarlou.

SEE ALSO
     The  full	documentation for astscript-pointing-simulate is maintained as a
     Texinfo manual.  If the info and astscript-pointing-simulate  programs  are
     properly installed at your site, the command

	    info astscript-pointing-simulate

     should give you access to the complete manual.

GNU Astronomy Utilities 0.24	  November 2025   ASTSCRIPT-POINTING-SIMULATE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=astscript-pointing-simulate&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help