home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / NETWORK / netpbm_docs.lzh / NETPBM / DOCS / fitstopnm.1 < prev    next >
Text File  |  1996-11-18  |  2KB  |  73 lines
  1. .TH fitstopnm 1 "20 September 89"
  2. .IX fitstopnm
  3. .SH NAME
  4. fitstopnm - convert a FITS file into a portable anymap
  5. .SH SYNOPSIS
  6. .B fitstopnm
  7. .RB [ -image
  8. .IR N ]
  9. .RB [ -noraw ]
  10. .RB [ -scanmax ]
  11. .RB [ -printmax ]
  12. .RB [ -min 
  13. .IR f ]
  14. .RB [ -max
  15. .IR f ]
  16. .RI [ FITSfile ]
  17. .SH DESCRIPTION
  18. Reads a FITS file as input.
  19. .IX FITS
  20. Produces a portable pixmap if the FITS file consists of 3 image planes
  21. (NAXIS = 3 and NAXIS3 = 3), a portable graymap if the FITS file
  22. consists of 2 image planes (NAXIS = 2), or whenever the 
  23. .B \-image 
  24. flag is specified.
  25. The results may need to be flipped top for bottom; if so, just
  26. pipe the output through
  27. .B pnmflip -tb.
  28. .IX pnmflip
  29. .SH OPTIONS
  30. .PP
  31. The
  32. .B -image
  33. option is for FITS files with three axes.
  34. The assumption is that the third axis is for multiple images,
  35. and this option lets you select which one you want.
  36. .PP
  37. Flags 
  38. .B -min
  39. and 
  40. .B -max 
  41. can be used to override the min and max values as read from the FITS
  42. header or the image data if no DATAMIN and DATAMAX keywords are found.
  43. Flag
  44. .B -scanmax
  45. can be used to force the program to scan the data even when DATAMIN
  46. and DATAMAX are found in the header. If 
  47. .B -printmax 
  48. is specified, the program will just print the min and max values and
  49. quit.
  50. Flag
  51. .B -noraw
  52. can be used to force 
  53. the program to produce an ASCII portable anymap.
  54. .PP
  55. The program will tell what kind of anymap is writing.
  56. All flags can be abbreviated to their shortest unique prefix.
  57. .SH REFERENCES
  58. FITS stands for Flexible Image Transport System.  A full description
  59. can be found in Astronomy & Astrophysics Supplement Series 44 (1981),
  60. page 363.
  61. .SH "SEE ALSO"
  62. pnmtofits(1), pgm(5), pnmflip(1)
  63. .SH AUTHOR
  64. Copyright (C) 1989 by Jef Poskanzer, with modifications by 
  65. Daniel Briggs (dbriggs@nrao.edu) and Alberto
  66. Accomazzi (alberto@cfa.harvard.edu).
  67. .\" Permission to use, copy, modify, and distribute this software and its
  68. .\" documentation for any purpose and without fee is hereby granted, provided
  69. .\" that the above copyright notice appear in all copies and that both that
  70. .\" copyright notice and this permission notice appear in supporting
  71. .\" documentation.  This software is provided "as is" without express or
  72. .\" implied warranty.
  73.