calceph...ntation(1)

📦
version 5.0.0 · 4 versions
, in ubuntu stonking

💖 calceph_queryorientation — bestie edition 💖

okay so this is a page from the calceph_queryorientation User Manual, and it's literally the glow-up your ephemeris workflow has been waiting for ✨ it's a command-line tool, and it's about to tell you how a whole celestial body is tilted at any given moment. main character energy fr fr 🦋

🌸 NAME 🌸

calceph_queryorientation — computes the orientation of the target body using the ephemeris files for a Julian day TDB 💅

like, that's the whole vibe. you give it a body and a time, it gives you the orientation. iconic.

✨ SYNOPSIS ✨

calceph_queryorientation [juliandate] [target] [file ...]

three little slots, one big glow-up: a Julian date, a target, and then as many ephemeris files as your heart desires 🫶

🎀 DESCRIPTION 🎀

okay bestie, here's the tea ☕

calceph_queryorientation displays to the standard output the euler angles of the orientation of the target body for a Julian day TDB using the ephemeris files. yes, that's a lot of words, but it's exactly what it says on the tin — euler angles, printed, to stdout, for the juliandate TDB you specified, computed using the ephemeris files you handed it 💖

the NAIF identification numbering system is used for the target body 🔢 so when you write <italic>target</italic>, you're writing a NAIF ID number, not a cute pet name (sorry, "moon" doesn't count, bestie, use the number 🌙).

the euler angles are expressed in radians 📐 not degrees, not vibes, radians.

and these quantities are expressed in the ICRF frame 🌈 so that's the reference frame you're working in, no cap.

👑 EXAMPLES 👑

here's the moment you've been waiting for, actual usage:

calceph_queryorientation 244357.5 1900301 examples/example1.bpc
Display the orientation of the Moon at the julian date 244357.5 TDB using the ephemeris file examples/example1.bpc 🌙💫

see how 1900301 is the NAIF ID standing in for the Moon? yeah. slay. that's the target slot doing its thing. and examples/example1.bpc is the ephemeris file. three args, one flawless orientation readout. ate and left no crumbs 🍓

🔍 SEE ALSO 🔍

  • calceph_queryposition (1) 👀 — the sibling. if you liked orientation, you're gonna want the position one too. the way that they complement each other… obsessed.

💀 BUGS 💀

No known bugs. 😭 literally not one. the code is thriving, the bugs are nonexistent, we love to see it. periodt 🎀

🧚 AUTHOR 🧚

Mickael Gastineau (Mickael.Gastineau@obspm.fr) 💌 the legend themselves.

Copyright 2008-2024 CNRS, Observatoire de Paris, Observatoire de la Côte d'Azur 🏛️✨

so yeah, that's the whole page 💜 this was calceph_queryorientation, from the calceph_queryorientation User Manual, version 5.0.0, dated July 6, 2026 🫶 go point it at a body and find out which way it's facing, bestie. iykyk 🌸

📦 where this page comes from