ASTSCRIPT-PSF-SCALE-FACTOR(1)

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

💖 astscript-psf-scale-factor — User Commands, section 1 💖

okay bestie, sit down, hydrate, because this one is lowkey iconic ✨ — it's astscript-psf-scale-factor, and it's here to do exactly one (1) job and do it gorgeously.

🌸 NAME 🌸

astscript-psf-scale-factor — find the factor to scale a PSF so it matches a given star. that's it. that's the whole vibe. 🎀

🦋 SYNOPSIS 🦋

astscript-psf-scale-factor [OPTION] FITS-files

✨ DESCRIPTION ✨

so this script is part of GNU Astronomy Utilities 0.24 — she's got a whole family, we love a nepo baby that actually delivers 💅

here's the tea: you give her a center position, and she computes the factor you need to multiply your specified PSF image by so that it matches the object sitting at that center — within a ring radii (yes, ring radii, that's the technical term, she said what she said). the whole main character idea here is: you need that factor so you can allocate the PSF with the proper flux value for constructing the scattered light field. no cap. 🫶

want more info? run any of these. and like, especially the first one — it has a very comprehensive explanation of this script's invocation: the expected input(s), the output(s), and a full description of all the options. she spilled everything.

Inputs/Outputs and options:

$ info astscript-psf-scale-factor

Full Gnuastro manual/book:

$ info gnuastro

and if the manual did NOT have your answer (rude of it), you can get direct help from experienced Gnuastro users and developers. for more info, run:

$ info help-gnuastro

🌈 astscript-psf-scale-factor options: 🌈

🍓 Input:

  • -h, --hdu=STR — HDU/extension of all input FITS files. (all of them. every single one. she's not picking favorites.)
  • -p, --psf=STR — PSF image fits file.
  • -P, --psfhdu=STR — HDU/extension of the PSF image.
  • -O, --mode=STR — Coordinates mode. it's 'wcs' or 'img', pick your fighter ⭐
  • -c, --center=FLT,FLT — Center coordinates of the object. the whole point tbh.
  • -W, --widthinpix=INT,INT Width of the stamp in pixels. — yes bestie, that formatting is exactly how the original wrote it, I'm just the messenger 🙈 it's the width of the stamp in pixels.
  • -n, --normradii=INT,INT — Minimum and maximum radii (in pixels) for computing the scaling factor value. the ring radii in question 💫
  • -S, --segment=STR — Output of Segment (with OBJECTS and CLUMPS). 👑
  • -s, --sigmaclip=FLT,FLT — Sigma-clip multiple and tolerance.
  • -d, --nocentering — Do not do the sub-pixel centering to new pix grid. like, she simply won't ✋

🧚 Output:

  • -t, --tmpdir — Directory to keep temporary files.
  • -k, --keeptmp — Keep temporal/auxiliar files. (yes, "auxiliar". she's been saying it that way for years and she's not stopping now 💖)

💜 Operating mode:

  • -?, --help — Print this help list. your bestie when you're lost.
  • --cite — BibTeX citation for this program. cite her, she deserves it 🎀
  • -q, --quiet — Don't print any extra information in stdout. sometimes silence IS the answer.
  • -V, --version — Print program version.
⚠️ Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options. read it twice, it's giving ✨reciprocity✨

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

💀 REPORTING BUGS 💀

found a bug? report bugs to bug-gnuastro@gnu.org. not me, I'm just the vibes. 🐛

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. none. zero. not even a little. she's free and she's honest about it. 😭

Written/developed by Raul Infante-Sainz — legend behavior, fr fr 🫶

🌈 SEE ALSO 🌈

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

info astscript-psf-scale-factor

should give you access to the complete manual.

and that's a wrap, bestie 🎀 this whole page is GNU Astronomy Utilities 0.24, dated November 2025 — go scale some PSFs, you're gonna eat 💅✨🦋

📦 where this page comes from