HPSPLIT(1)

✨ HPSPLIT ✨

okay so bestie, welcome to hpsplit 💖 this is a astrometry.net tool (that's the manual section it lives in, HPSPLIT(1), iykyk) and its whole thing is: you hand it a bunch of FITS tables, and it splits them up into healpix tiles. that's it. that's the job. slay. 🦋

🌸 NAME 🌸

hpsplit — split a list of FITS tables into healpix tiles 💅

🎀 SYNOPSIS 🎀

hpsplit [options] input-FITS-catalog [...]

like, give it one catalog, give it twelve, she doesn't care, she's built for this. ✨

👑 OPTIONS 👑

okay here's the menu, no skips, we're doing all of them 🫶

• -o pattern — the output filename pattern. it takes a %i printf-pattern, so the filenumber slots in wherever you put that. 💫
• -r column — tell her the name of the RA column in your FITS table. default is RA. 🌈
• -d column — same deal but for the DEC column. default is DEC. ⭐
• -n Nside — the healpix Nside. default is 1. 🌸
• -m margin — add a margin of this many degrees around the healpixes. default is 0. 🎀
• -g — gzip'd inputs. that's it, that's the flag. 🍓
• -c name — copy the given column name over into the output files. ✨
• -t dir — use the given temp dir. default is /tmp. 🧚
• -b file — save the filenumber→filename map into this file. and heads up: this also enables writing backreferences, so it's doing two things at once, main character behaviour fr. 👑
• -v — +verbose. she will tell you more. 💬

💜 AUTHOR 💜

The Astrometry.net team, obviously. 🫶 Principal investigators are David W. Hogg (NYU) and Dustin Lang (CMU). iconic duo, no notes. 💅

🌈 SEE ALSO 🌈

• build-astrometry-index (1)
• for a tutorial, hit up http://astrometry.net/doc/build-index.html — go read it bestie, it's giving helpful 📚

and that's the whole page!! go split some tables, you're gonna eat 💖✨

okay so real talk, this was version 0.56 from July 2015, and it's part of the astrometry.net family, which is the source/version situation for this whole thing. mwah. bye bestie!! 🎀💅🦋