man > fitstopnm(1)

man perldoc info pydoc3 ri search

fitstopnm(1) — General Commands Manual

📋 NAME

fitstopnm - convert a FITS file into a portable anymap

🚀 Quick Reference

Use Case	Command	Description
Convert FITS image to PPM (color)	fitstopnm image.fits	Converts a 3-plane FITS file to a PPM image
Convert FITS image to PGM (grayscale)	fitstopnm image.fits	For 2-plane FITS files, outputs a PGM
Select a specific image plane	fitstopnm -image 2 image.fits	Extracts the 2nd image from a multi-image FITS
Force ASCII output (slow)	fitstopnm -noraw image.fits	Produces ASCII (text) PPM/PGM instead of raw binary
Override data range	fitstopnm -min 0 -max 255 image.fits	Manually set pixel value scaling
Print min/max values	fitstopnm -printmax image.fits	Display the data min and max and exit
Force scanning for min/max	fitstopnm -scanmax image.fits	Ignore header DATAMIN/DATAMAX and scan the actual data

📜 SYNOPSIS

fitstopnm [ -image N ] [ -noraw ] [ -scanmax ] [ -printmax ] [ -min f ] [ -max f ] [ FITSfile ]

📖 DESCRIPTION

Reads a FITS file as input. Produces a portable pixmap (PPM) if the FITS file consists of 3 image planes (NAXIS = 3 and NAXIS3 = 3), a portable graymap (PGM) if the FITS file consists of 2 image planes (NAXIS = 2), or whenever the -image flag is specified. The results may need to be flipped top for bottom; if so, just pipe the output through pnmflip -tb.

⚙️ OPTIONS

• -image N — For FITS files with three axes. The assumption is that the third axis is for multiple images, and this option lets you select which one you want.
• -min f and -max f — Override the min and max values as read from the FITS header or the image data if no DATAMIN and DATAMAX keywords are found.
• -scanmax — Force the program to scan the data even when DATAMIN and DATAMAX are found in the header.
• -printmax — Just print the min and max values and quit.
• -noraw — Force the program to produce an ASCII portable anymap (text format instead of raw binary).

The program will tell what kind of anymap is writing. All flags can be abbreviated to their shortest unique prefix.

📚 REFERENCES

FITS stands for Flexible Image Transport System. A full description can be found in Astronomy & Astrophysics Supplement Series 44 (1981), page 363.

🔗 SEE ALSO

• pnmtofits(1)
• pgm(5)
• pnmflip(1)

👤 AUTHOR

Copyright (C) 1989 by Jef Poskanzer, with modifications by Daniel Briggs (dbriggs AT nrao.edu) and Alberto Accomazzi (alberto AT cfa.edu).

20 September 89

fitstopnm(1) — General Commands Manual 📋 NAME 🚀 Quick Reference 📜 SYNOPSIS 📖 DESCRIPTION ⚙️ OPTIONS 📚 REFERENCES 🔗 SEE ALSO 👤 AUTHOR