ASTSCRIPT-DS9-REGION(1)

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

✨ ASTSCRIPT-DS9-REGION ✨

okay bestie, welcome to astscript-ds9-region(1) from the User Commands section 💖 this one is literally the glow-up your catalog tables have been waiting for.

🌸 NAME 🌸

astscript-ds9-region — make an SAO DS9 region file out of a table. that's it, that's the whole vibe 🎀

🦋 SYNOPSIS 🦋

astscript-ds9-region [OPTION] FITS-files

💫 DESCRIPTION 💫

so this script is part of GNU Astronomy Utilities 0.24 ✨ (yes, the whole squad).

what it does is: you hand it two column names (or numbers) and it hands you back a "region file" — with one region sitting over every single entry — so you can inspect all your catalog entries in SAO DS9 and feel like a main character while doing it 👑

want more tea? run any of these. and honestly the first one is the one that spills EVERYTHING — expected input(s), output(s), and a full description of all the options:

Inputs/Outputs and options:

$ info astscript-ds9-region

Full Gnuastro manual/book:

$ info gnuastro

and if the manual is giving nothing and you still can't find your answer, you can get direct help from experienced Gnuastro users and developers 🫶 for that, just run:

$ info help-gnuastro

🎀 OPTIONS 🎀

💜 astscript-ds9-region options:

🌈 Input:

  • -h, --hdu=STR — the HDU/extension of all the input FITS files.
  • -c, --column=STR,STR — the columns to use as coordinates (name or number, whichever you vibe with).
  • -m, --mode=wcs|img — are the coordinates in WCS or image? (default: wcs)
  • -n, --namecol=STR — the ID of each region (name or number of a column).

🌟 Output:

  • -C, --color=STR — the color for the regions (DS9 is the one reading this, bestie).
  • -w, --width=INT — line thickness of the regions (in DS9).
  • -r, --radius=FLT — the radius of each region (in arcseconds if you're in WCS mode).
  • -s, --fontsize=INT — font size for the name.
  • -D, --dontdelete — do NOT delete the output if it already exists. she persists 💅
  • -o, --output=STR — name of the output file.
  • --command="STR" — a DS9 command to run after making the region.

⭐ Operating mode:

  • -?, --help — print this help list.
  • --cite — BibTeX citation for this program (cite your sources, queen).
  • -V, --version — print program version.
mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options. no cap, that's just how it works 🙈

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

😭 REPORTING BUGS 😭

found a bug? report it to bug-gnuastro@gnu.org. don't be shy, they wanna know 🫶

Copyright © 2015-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 ✨

🔥 SEE ALSO 🔥

the full documentation for astscript-ds9-region lives in a Texinfo manual. if info and astscript-ds9-region are properly installed at your site, this command:

info astscript-ds9-region

should give you access to the complete manual. slay 📖

and that's the whole page bestie, no notes 💖 this was GNU Astronomy Utilities 0.24, dated November 2025 — periodt, go make some regions 🎀✨🦋

📦 where this page comes from