SATTO8 version 0.10 (970825) -------------------------------------------------------------------------- SatTo8 is a command line utility program used to convert 8, 10 and 16 bit grayscale satellite data to 'standard' 8-bit image formats. Platforms Supported: ------------------- *) IBM Pc-Dos (or a DOS window within WIN3/WIN95) --------------------------------------------------------------------------- This program has been distributed as FREEWARE and can be used and/or redistributed without charge - as long as it is not modified. All source code and associated executables however, remain the property of and are copyrighted @1997 by Mark A. Thomas. All rights remain reserved. More information about this program and its' applications, and the most recent versions of the program and documentation are available at either: http://www.m-a-t.com/freeware ftp://www.m-a-t.com/pub/progs =========================================================================== Supported input file formats: ---------------------------- HDF - *) currently limited to one data set (channel) per file. *) 8-bit raster images or 10/16 bit scientific data sets. AVHRR - supports all AVHRR Level 1B formats including: *) HRPT, LAC and GAC data sets. *) 8, 10 or 16 bit data formats. *) Single or multiple channel data sets. Supported output file formats: ------------------------------ BMP - 8bit / Uncompressed. TIF - 8bit / Uncompressed or RLE. ======================================================================== COMMAND LINE: SATTO8 infilename [-option, -option ...] ======================================================================== -------------------------- GENERAL options -------------------------- -oFILENAME Specify output filename [Default="inname.TIF"] -cN Extract channel number 'N' [Default=channel#1] -h[FILENAME] Create Histogram [Default filename="sat8hist"] -d Supress image information display -b Output type = BMP [Default=TIF] -t Output type = TIF [Default=TIF] -r Use RLE/PackBits Compression [Default=No Compression] -i Display info only. (does not create output file) ----------------------- TONAL LIMIT options -------------------------- -n No limits (lower limit=0, upper limit=1023) -slN Specify lower limit (N= 0-768) -suN Specify upper limit (N= 256-1023) -alN Auto lower limit variance (N= 1-99%) -auN Auto upper limit variance (N= 1-99%) -------------------- TONAL EQUALIZATION options ---------------------- -gN Set GAMMA (N= 5-999, default=100) --- EXAMPLES: ----------------------------------------------------------- *) SATTO8 filename Converts the specified file to an 8-bit tif grayscale. No equalization is performed. *) SATTO8 filename -i Displays information about a satellite file without converting it. *) SATTO8 filename -g175 -hhist.bmp Converts the specified file to an 8-bit tif grayscale with a gamma equalization of 1.75 (this brings out land detail in a visible scan). A histogram ("hist.bmp") is created, showing the tonal maps of both the input and output files. --- GENERAL NOTES: ------------------------------------------------------ *) If SatTo8 is run without any command line options, help information is displayed. *) Tonal LIMIT and EQUALIZATION options are only used if the input file word size is greater than 8 bits. Otherwise, they are ignored and a straight conversion is performed. *) If no TONAL LIMIT options are specified, automatic high and low limits are used with a variance of 5%. *) If Output or Histogram filename(s) are specified, and they contain a 'BMP' or 'TIF' extension, the output type (-b or -t), is overridden. --- REVISION HISTORY: --------------------------------------------------- 0.01 8/10/97 Initial Release. 0.02 8/16/97 *) Added GAMMA option. *) Fixed a problem with reading certain HDF files. 0.03 8/17/97 *) Added TIF support. *) Fixed output file 'upside down/backwards' orientation problem. 0.04 8/20/97 *) Fixed problem with parsing filenames when path was specified. *) Improved file buffering to provide faster throughput. *) Data set information is now imbedded as a comment in TIF files. *) Implemented optional RLE/PackBits compression for TIF files. *) Added date and time of AVHRR data sets to info display. 0.10 8/25/97 *) Fixed date in the image info display. Version 0.04 showed the incorrect day of the month. *) Fixed problem in GAC(AVHRR) format translation logic. *) Made minor cosmetic improvements in histogram image file output. *) Added "-i" Info Only command. *) Changed channel selection logic to use physical rather than relative channel numbers. --- Enhancements planned for future versions: --------------------------- *) More EQUALIZATION options: +) Histo-Equalize +) AutoLow / AutoHigh *) Implement programs for different platforms (UNIX) *) Support for more input formats (maybe McIDAS) *************************************************************************** This program has been tested with the following data sets: HDF: NASA/GSFC's GOES and GMS 4Km archive at: http://rsd.gsfc.nasa.gov/goesg/earth/Weather/ AVHRR: LAC,GAC, HRPT images from NOAA's Satellite Active Archive at: http://saars3.saa.noaa.gov ====================================================== Your suggestions are WELCOME! Visit me at WWW.M-A-T.COM and tell me what you think...