ASTSCRIPT-ZEROPOINT(1)

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

✨ astscript-zeropoint(1) — User Commands ✨

okay bestie, gather round 💖 this is astscript-zeropoint, and it lives in section 1 of the manual (User Commands, iykyk). She's here to do exactly one iconic thing: estimate the zero point of an image. Let's get into it 🦋

🌸 NAME 🌸

astscript-zeropoint — Estimate zero point of an image. that's it. that's the girl. 💅

✨ SYNOPSIS ✨

astscript-zeropoint [OPTIONS] image.fits

like, you hand her an image, you give her some options, she gives you a zeropoint. slay. 🎀

👑 DESCRIPTION 👑

So basically, this script calculates the Zeropoint of the image based on a reference image or a reference catalog. Pick your fighter, bestie — either mode works. 🔥

💫 astscript-zeropoint options:

🍓 Input(s):

  • -h, --hdu=STR/INT — the HDU/Extension name or number of the input. tell her where the data lives, she's not a mind reader 💀
  • -S, --starcat=STR — a catalog with positions, used for aperture photometry.
  • --starcathdu=STR/INT — which HDU of the table inside --starcat we're talking about.
  • --starcatra=STR/INT — the column in --starcat that holds the RA (Right Ascension, the celestial x-axis, we love her).
  • --starcatdec=STR/INT — the column in --starcat that holds the DEC (Declination, celestial y-axis, equally iconic).
  • --mksrc=STR — Makefile. this one's for developers, specifically when they're out here debugging 🛠️

🎀 Output:

  • -o, --output — the output file name. name your baby, bestie.
  • -t, --tmpdir — the directory where temporary files get to hang out.
  • -k, --keeptmp — keep those temporal/auxiliar files around (yes, you read it, don't lose your temp files if you need them).
  • -K, --keepzpap — keep each aperture's zp in a different HDU. every aperture gets its own little room, no sharing 🏠

🌈 General settings

  • -a, --aperarcsec=FLT[,FLT] — the aperture radius, in arc-seconds, for photometry. you can give more than one, comma-separated, and she's obsessed with that.
  • -M, --magnituderange=FLT,FLT — the Range of the magnitude to be considered.

🧚 Reference catalog mode

  • -c, --refcat=STR — the reference catalog file name.
  • -C, --refcathdu=STR/INT — the reference catalog's HDU name or number.
  • -r, --refcatra=STR — the reference catalog's Right Ascension (R.A.) column.
  • -d, --refcatdec=STR — the reference catalog's Declination (Dec) column.
  • -m, --refcatmag=STR — the reference catalog's Magnitude column.
  • -s, --matchradius=FLT — the radius, in arcsec, used to match with the reference.

⭐ Reference image mode

  • -R, --refimgs=STR[,STR] — reference image name(s) that already have a known zeropoint. multiple? comma-separate them, she eats that up.
  • -H, --refimgshdu=STR/INT — reference image HDU name(s) or number(s).
  • -z, --refimgszp=FLT[,FLT] — the Zero point(s) of the reference image(s). one per image, comma-separated, you got this.

💜 Operating mode:

  • -h, --help — Print this help. yes, -h is here too, and yes, it's also --hdu up above. iconic double-booking, no notes. 🙈
  • --cite — BibTeX citation for this program. cite your sources, academic bestie.
  • -q, --quiet — Don't print any extra information in stdout. she'll be silent, she'll be mysterious 💅
  • -V, --version — Print program version.
  • -N, --numthreads=INT — Number of threads; maximum if not given. let her use the whole engine 🔥

Mandatory or optional arguments to long options are also mandatory or optional for any corresponfing short options. (yes, that's spelled exactly like that in the original and we respect the original's spelling, no cap.)

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

😭 REPORTING BUGS 😭

found a bug? don't suffer in silence, bestie. Report bugs to bug-gnuastro@gnu.org. they wanna hear it fr fr.

Copyright © 2022-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.

⚠️ NO WARRANTY, like actually none, to the extent permitted by law. read it, know it, respect it.

Written/developed by Sepideh Eskandarlou et al. 💖 absolute main character energy, we stan.

🦋 SEE ALSO 🦋

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

info astscript-zeropoint

should give you access to the complete manual. that's your VIP backstage pass, go use it 🎟️✨

GNU Astronomy Utilities 0.24 · November 2025 — mwah, that's the whole page, thanks for coming to my TED talk 💅🎀💖

📦 where this page comes from