Astro:...:Planet(3pm)

💅 NAME 💅

Astro::Coords::Planet — coordinates relating to planetary motion 🪐✨

ok so real quick, this page is from the User Contributed Perl Documentation for Astro:...:Planet(3pm) — yes that's the manual name, we're folding it in up here like a little name tag 🎀

---

🌸 SYNOPSIS 🌸

$c = new Astro::Coords::Planet( 'uranus' );

---

🦋 DESCRIPTION 🦋

So Astro::Coords uses this whole class to handle coordinates for planets.. 🪐 yes bestie, planets with the double dot, that's canon, I don't make the rules 💀

---

✨ METHODS ✨

🎀 Constructor

• new — instantiates a shiny new object using the options you hand it 💖

$c = new Astro::Coords::Planet( 'mars' );

Returns undef on error. no cap, that's your failure signal 🙈

🌈 Class Methods

• planets — returns a list of supported planet names 🪐

@planets = Astro::Coords::Planet->planets();

💜 Accessor Methods

• planet — returns the name of the planet. that's it, that's the whole gig 👑
• name — for planets, the name is always just the planet name. iconic behaviour, zero surprises 🫶

---

🌟 GENERAL METHODS 🌟

• array — returns back an 11 element array, with the first element containing the planet name ✨

This method returns a standardised set of elements across all types of coordinates — so every coordinate type plays nice together 💖

• type — returns the generic type associated with the coordinate system. For this class the answer is always "RADEC" ⭐

This is used to aid construction of summary tables when using mixed coordinates.

It could be done using isa relationships. (iykyk 😌)

• stringify — Stringify overload. Simply returns the name of the planet in capitals 💅 PERIODT.
• summary — returns a one line summary of the coordinates. In the future will accept arguments to control output. 🔮

$summary = $c->summary();

• diam — returns the apparent angular planet diameter from the most recent calculation of the apparent RA/Dec 🍓

$diam = $c->diam();

Returns the answer as an Astro::Coords::Angle object.

⚠️ bestie listen — this number is not updated automatically. (so don't change the time and expect to get the correct answer without first asking for a ra/dec calculation) 😭

• apparent — returns the apparent RA and Dec as two Astro::Coords::Angle objects for the current coordinates and time 🌸

($ra_app, $dec_app) = $self->apparent();

• rv — Radial velocity of the planet relative to the Earth geocentre 🌍🔥
• vdefn — Velocity definition. Always 'RADIO' 📻
• vframe — Velocity reference frame. Always 'GEO' 🌐
• apply_offset — Overrided method to warn if Astro::Coords::apply_offset is called on this subclass 🙈 consider yourself warned, babe.

---

🧚 NOTES 🧚

Usually called via Astro::Coords. 💫

---

🔥 REQUIREMENTS 🔥

Astro::PAL is used for all internal astrometric calculations 🌌 the whole math situation runs on it, no cap.

---

👑 AUTHOR 👑

Tim Jenness <t.jenness@cpan.org> 💌

---

💖 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

---

ok that's the whole page bestie, slay 🎀✨ this drop is from perl v5.42.2, dated 2026-02-15, and it's still serving Astro:...:Planet(3pm) energy 💅🫶💜