Astro:...ration(3pm)

💫 NAME 💫

Astro::Coords::Calibration — the coords class for calibrations that literally have no coordinates, bestie 🫶

So this is a Perl module page (User Contributed Perl Documentation, iykyk), and it's the manual for a lil subclass that handles all the observations where the telescope just... stays put. Obsessed with the efficiency honestly. 💅

---

✨ SYNOPSIS ✨

$c = new Astro::Coords::Calibration();

That's it. That's the whole vibe check. One line. She's low-maintenance. 🌸

---

🦋 DESCRIPTION 🦋

Okay so picture this: every once in a while an observation shows up with no coordinates attached at all. Not a bug, not an oopsie — it's just that some observations genuinely don't care where the telescope is pointing. 🌈

The big ones are calibration observations like DARKs and ARRAY TESTS — those bad boys do not require the telescope to be in any particular location whatsoever. No location, no coords, no problem. 💅

So why does this class even exist? Because we still want to process these observations the same way we process all the other ones. Scheduling brain, same shape. 🧠✨ And here's the iconic part: from a scheduling viewpoint, calibration observations are always an available target. Always available. Never flopping. Periodt. 👑

---

🎀 METHODS 🎀

Heads up bestie — this class inherits from Astro::Coords::Fixed. That's the family tree. 🌳

🌟 Constructor

• new — literally just instantiates an object with an Azimuth of 0.0 degrees and an elevation of 90 degrees. And ngl, the exact values do not matter even a little bit. They're just there so the object has something. 🙈

You can also slap a label on the calibration — super handy for including the type, for example:

$c = new Astro::Coords::Calibration( name => 'DARK' );

💜 General Methods

• type — returns the coordinate type. In this case it always returns "CAL". Every time. No surprises. 🎀
• array — gives you a summary of the object packed into an 11 element array. Here's the tea: all the elements are undefined except the first one, and that first one contains "CAL". The other ten are just vibing in the void. 💀
• status — returns a status string describing the current coordinates. For calibration objects this is very simple. Like, the simplest. Barely any lore. ✨
• isObservable — tells you whether the observation is observable. And since a calibration observation (which is defined as an observation that does not move the telescope) is always observable, this method always returns true. Always. It's giving main character who never misses. 👑
• stringify — returns a stringified summary of the object. Always returns the type(). Short and sweet, no notes. 🍓
• summary — returns a one line summary of the coordinates. And ooh, in the future it will accept arguments to control the output — like, future glow-up incoming, bookmark it. ⭐

$summary = $c->summary();

• apply_offset — this one's overrided on purpose, to prevent Astro::Coords::apply_offset from ever being called on this subclass. Not a bug, a boundary. 🚧💅

---

💖 NOTES 💖

Usually called via Astro::Coords. So like, she's not usually the one picking up the phone first — she comes through the main line. 📞

---

🔥 REQUIREMENTS 🔥

Astro::PAL is used for all internal astrometric calculations. Respect the backbone. 🫡

---

🌸 AUTHOR 🌸

Tim Jenness <tjenness@cpan.org>

Absolute legend. Iconic. No cap. 💜

---

👑 COPYRIGHT 👑

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

Fr fr bestie, take the license seriously — it's the one part you can't vibe your way around. 😭

---

Okay that's the whole page, mwah! 💋 This lil beauty shipped with perl v5.42.2 and the doc is dated 2026-02-15 — so yeah, fresh-ish, adorable, and generated for Astro::Coords::Calibration(3pm). Go read the other coords pages, ily, bye! 🧚✨