imsize(1)

📦 version 3.9.7, in debian bookworm, debian trixie, epel 9, fedora 43, fedora 44, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ imsize(1) — the General Commands Manual page, but make it cute ✨

okay bestie, gather round 💖 this is imsize, living in section 1 of the General Commands Manual, and she is literally the moment.

🎀 NAME 🎀

imsize — Print size of image in WCS and pixels

like… she tells you how big your image is, in world coordinates AND in pixels. iconic behaviour honestly 💅

🌸 SYNOPSIS 🌸

imsize [-vcd] [-p scale] [-b ra dec] [-j ra dec] FITS or IRAF file(s)

yes she takes FITS or IRAF files (plural!! she's flexible like that 🦋) and a whole lil bouquet of flags.

💫 DESCRIPTION 💫

so imsize is a utility for printing the region covered by an image, using the world coordinate system parameters that are chillin' inside IRAF and FITS image headers. no cap.

the way she does it: she converts IRAF .imh image headers to FITS format first, and only then extracts the info. periodt.

and for IRAF files specifically? the image dimensions and the object name get set from the binary portion of the header. that's just how she rolls 🙈

👑 OPTIONS 👑

one bullet per flag, no skipping, we respect the whole menu:

  • -b [<RA> <Dec>] — Output B1950 (B1950) coordinates, with an optional center
  • -c — Format output without pixel dimensions (optional size change)
  • -d — Format output as input to DSS getimage (optional size change)
  • -e — Add epoch of image to output line
  • -j [<RA> <Dec>] — Output J2000 (J2000) coordinates, with an optional center
  • -n <number> — Number of decimal places in output (default 3)
  • -p <scale> — Initial plate scale in arcsec per pixel (default 0)
  • -r — Print range in RA and Dec
  • -v — Print more intermediate information for debugging
  • -z — Use AIPS classic projections instead of WCSLIB
ngl the -n default of 3 and the -p default of 0 are just sitting there quietly doing their thing, and I respect them for it 🫶

🌈 AUTHOR 🌈

Jessica Mink, SAO (jmink@cfa.harvard.edu) — absolute legend, wrote her, we stan 💜

and that's the whole vibe check, bestie! 🍓 this page is from WCSTools, dated 6 July 2001, and it's the imsize(1) manual page — she's been serving WCS realness since 2001 and she has NOT missed a day. slay, honestly. go measure some images 💖✨🎀🦋🌸💅

📦 where this page comes from