ASTSCRIPT-POINTING-SIMULATE(1)

📦
version 0.24 · 3 versions
, in epel 10, epel 9, nixos 26.05, nixpkgs unstable, ubuntu resolute, ubuntu stonking

✨ astscript-pointing-simulate ✨

okay bestie, welcome to the User Commands section of the manual, and this one is astscript-pointing-simulate — yes, that whole mouthful, we love her anyway 💖

🌸 NAME 🌸

astscript-pointing-simulate — simulate the exposure map of a pointing pattern 🦋

🎀 SYNOPSIS 🎀

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

💫 DESCRIPTION 💫

So like, you hand her a set of dithering positions (positions-cat.fits in the example up there 👆), plus an image (image.fits — and ngl she does not care which part of the sky it came from, the only things she's looking at are its distortion and its orientation), and she builds you the exposure map of the output coadd after that dither gets applied. Every pixel in that map literally just holds the number of exposures that landed in it. iconic behavior, no cap 🔥

And the field of the final coadd? You get to set that yourself with the --center and --width options. main character energy, you decide the frame 💅

🧚 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.
💡 bestie PSA: mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options. fr fr, they're a package deal 🫶

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

😭 REPORTING BUGS 😭

Report bugs to bug-gnuastro@gnu.org — yes, actually email them, they wanna know 💀

Copyright © 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 Eskandarlou. 👑

⭐ 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. go read it, it's giving ✨thorough✨ 📖

okay that's the whole page bestie, you ate it 🍓💅 and just so you know, this was GNU Astronomy Utilities 0.24, dated November 2025 — stan an iconic release, periodt 🎀✨

📦 where this page comes from