ASTSCRIPT-PSF-SUBTRACT(1)

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

💖 ASTSCRIPT-PSF-SUBTRACT 💖

okay bestie, welcome to the astscript-psf-subtract manual page, part of the User Commands crew 🫶 this is the little script that takes a PSF model you already made and yeets it out of your image. it's giving subtraction, it's giving precision, and yes it lives in GNU Astronomy Utilities 0.24 ✨

🌸 NAME 🌸

astscript-psf-subtract — literally just: subtract a given PSF model from the image. that's it. that's the whole job. slay 💅

✨ SYNOPSIS ✨

astscript-psf-subtract [OPTION] FITS-files

🦋 DESCRIPTION 🦋

okay so first thing's first: this script is part of GNU Astronomy Utilities 0.24. like, it's a card-carrying member of the family 🌈

what it does? it takes the PSF image you hand it, plops it down at some central position inside your image, and then subtracts it. that's the vibe. placement + subtraction, no cap.

want more tea? run any of these, fr fr — and lowkey the first one is the one you want because it has the most comprehensive explanation of how to invoke this script ever: expected input(s), output(s), and a full rundown of every single option 👑

Inputs/Outputs and options:

$ info astscript-psf-subtract

Full Gnuastro manual/book:

$ info gnuastro

and if the manual still left you hanging? you can get direct help from experienced Gnuastro users and developers 💜 for more info, run:

$ info help-gnuastro

💅 astscript-psf-subtract options: 💅

🎀 Input:

  • -h, --hdu=STR — HDU/extension of all input FITS files.
  • -p, --psf=STR — PSF FITS image.
  • -P, --psfhdu=STR — HDU/extension of the PSF image.
  • -O, --mode=STR — Coordinates mode ('wcs' or 'img').
  • -c, --center=FLT,FLT — Center coordinates of the object.
  • -s, --scale=FLT — Factor by which the PSF is multiplied.

🍓 Output:

  • -o, --output — Output table with the radial profile.
  • -t, --tmpdir — Directory to keep temporary files.
  • -k, --keeptmp — Keep temporal/auxiliar files.
  • -m, --modelonly — Give the model as output (don't subtract it).

⭐ Operating mode:

  • -?, --help — Print this help list.
  • --cite — BibTeX citation for this program.
  • -q, --quiet — Don't print any extra information in stdout.
  • -V, --version — Print program version.
just a heads up bestie: mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options. so don't get cute with it 🙈

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

😭 REPORTING BUGS 😭

found a bug? not the fun kind 🐛 report bugs to bug-gnuastro@gnu.org.

Copyright © 2020-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 Raul Infante-Sainz 🫶

🌈 SEE ALSO 🌈

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

info astscript-psf-subtract

should give you access to the complete manual.

and that's the whole page, bestie 💖 this manual is GNU Astronomy Utilities 0.24, dated November 2025, and it's the ASTSCRIPT-PSF-SUBTRACT(1) era. go subtract something iconic ✨💅🧚

📦 where this page comes from