Astro:...r::AST(3pm)

👑 Astro::FITS::Header::AST — the manual page, but make it cute 💅

okay so bestie, this is Astro::FITS::Header::AST, and it lives in the User Contributed Perl Documentation corner of the perl 3pm man pages (iykyk ✨). It's the module that manipulates FITS headers from an AST object, and honestly? iconic.

---

🌸 NAME 🌸

Astro::FITS::Header::AST — Manipulates FITS headers from an AST object 💖

---

✨ SYNOPSIS ✨

like, here's the vibe, fr fr:

use Astro::FITS::Header::AST;

$header = new Astro::FITS::Header::AST( FrameSet => $wcsinfo );
$header = new Astro::FITS::Header::AST( FrameSet => $wcsinfo,
                                        Encoding => 'FITS-IRAF' );

$header = new Astro::FITS::Header::AST( Cards => \@cards );

---

🦋 DESCRIPTION 🦋

So this module makes use of the Starlink::AST module to read the FITS HDU from an AST FrameSet object. No cap. 🫶

It stores information about a FITS header block in an object. It takes a hash as an argument, with an array reference pointing to an Starlink::AST FramSet object. (yes that's how it's spelled in the source, we do not touch the spelling, periodt 💅)

---

⭐ REVISION ⭐

$Id$

---

💜 METHODS 💜

🎀 configure

Reads a FITS header from a Starlink::AST FrameSet object 🌈

$header->configure( FrameSet => $wcsinfo );

Base class initialisation also works, bestie:

$header->configure( Cards => \@cards );

It accepts a reference to an Starlink::AST FrameSet object.

If a specific encoding is required, this can be specified using the Encoding argument. Default is FITS-WCS if no Encoding is given. Heads up though — note that not all framesets can be encoded using FITS-WCS. 😭

$header->configure( FrameSet => $wcsinfo, Encoding => "Native" );

If Encoding is specified but undefined, the default will be decided by AST. Let AST cook 🔥

---

👀 SEE ALSO 👀

"Starlink::AST", "Astro::FITS::Header" — go read those too, they're giving main character energy 👑

---

🫶 AUTHORS 🫶

Alasdair Allan <aa@astro.ex.ac.uk>, Tim Jenness <t.jenness@jach.hawaii.edu>

---

💖 COPYRIGHT 💖

Copyright (C) 2007-2011 Science and Technology Facilities Council.

Copyright (C) 2001-2005 Particle Physics and Astronomy Research Council.

All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place,Suite 330, Boston, MA 02111-1307, USA

⚠️ note that "useful,but" and "Place,Suite" are exactly as they appear in the original, and we are simply not the ones to fix that, bestie 💀

---

aaaaand that's the whole thing! this page shipped as perl v5.36.0, dated 2023-04-21, filed under the Astro:...r::AST(3pm) manual — so like, go forth and encode your framesets, you absolute legend 🧚✨💅