PYMOCTOOL(1)

💖 pymoctool — manipulate Multi-Order Coverage maps 💖

okay bestie, welcome to the pymoctool manual page ✨ it's a section-1 command, it's cute, it's chaotic, let's get into it 🫶

🌸 SYNOPSIS 🌸

pymoctool [INPUT] [COMMAND [FILE]] [--output OUTPUT]

🦋 DESCRIPTION 🦋

so basically pymoctool is your girl for manipulating Multi-Order Coverage (MOC) tools for the Virtual Observatory 💫 It's a command-line tool, and it handles files encoded as FITS, JSON, or ASCII — no cap, all three 🙌

The tool builds up a MOC stack using union, intersection and subtraction, and the pipeline gets processed in the order it's passed on the command-line. Order matters, babes, it's giving "read it in order or perish" 💅

Internally, pymoctool uses and exposes the PyMOC library found in the python-pymoc Debian package 👑

✨ COMMANDS ✨

• --catalog coords.txt [order NN] [radius NN] — renders circles using the flood-fill method on top of the MOC stack 🎨 Your input text file should be whitespace records containing either RA+Dec pairs or Lat+Lon pairs, fr fr.
• --help, -h — shows the top-level help 🆘 bestie needs a lil guidance sometimes.
• --id — sets a new identifier for the MOC stack 🏷️
• --info, -i — displays information about the MOC stack 👀 spill the tea.
• --intersection — intersects another MOC with the existing MOC stack 🧩
• --name — sets a new name for the MOC stack 💖
• --normalize 0-29 — sets the maximum depth order of a MOC, in the range 0-29 📏
• --output, -o — output filename MOC 📤
• --plot — projects and renders the MOC as a flattened all-sky map 🌈 iconic behaviour honestly.
• --subtract — subtracts a MOC from the existing MOC stack ➖
• --version — shows the backend PyMOC library version number 🔢

Detailed help for individual commands can be found with pymoctool --help COMMAND — yes bestie, there's a whole help tree, go explore 🧚

🎀 EXAMPLES 🎀

pymoctool foo.fits --output foo.json bar.txt --output both.fits

what this does: loads foo.fits, then converts and saves a copy to foo.json, then performs a union merge with a text-format MOC called bar.txt, and saves the result to both.fits 💾✨ slay, honestly.

👑 AUTHORS 👑

pymoctool and PyMOC were written by Graham Bell, with support from the Science and Technology Facilities Council, and the East Asian Obsevatory 🌏

This manual page was written for the Debian Project by Paul Sladen, with support from the German Astronomical Virtual Observatory (GAVO) at the University of Heidelberg 💜

and that's the whole pymoctool page, bestie — part of the manual, straight from the source, no version bump or date stamp on this one, just the humble pymoctool page name holding it down 🫶 k bye, go make some MOCs 💅🌸