pyhirs - HIRS L1B Conversion Utilities Version 1.0 Nick Bearson nickb@ssec.wisc.edu --------------------------- DEPENDENCIES Python (tested on 2.6.8, but most 2.x versions should do.) http://www.python.org/download/ NumPy http://www.numpy.org/ HDF5 ftp://ftp.hdfgroup.org/HDF5/current/src netCDF-4 ftp://ftp.unidata.ucar.edu/pub/netcdf netcdf4-python (will be included at install time, if above requirements are met) http://code.google.com/p/netcdf4-python/ --------------------------- INSTALLATION Typical installation is handled by the python setuptools package, and should be simple. From the base directory of this package (where you found this README), run: python setup.py install Note that, depending on the location of your python installation, you may require root priviledges. --------------------------- USAGE Installation will add two utility scripts to your path: hirs2nc - This is the primary program used to convert HIRS L1B flat binary files into netCDF4 It requires the HIRS version (3 or 4), an input file, and an output file. ie: hirs2nc 3 NSS.HIRX.NK.D04303.S2302.E0057.B3359799.GC NSS.HIRX.NK.D04303.S2302.E0057.B3359799.GC.nc hirs_calibrate - This is a testing utility used to check the netCDF4 output, it applies various calibration coefficients to convert raw "counts" into radiances and brightness temperatures. It provides a netCDF4 file as output. ie: hirs_calibrate NSS.HIRX.NK.D04303.S2302.E0057.B3359799.GC.nc NSS.HIRX.NK.D04303.S2302.E0057.B3359799.GC.calib.nc --------------------------- DISCLAIMER Original scripts and automation included as part of this package are distributed under the GNU GENERAL PUBLIC LICENSE agreement included with this release. Binary executables included as part of this software package are copyrighted and licensed by their respective organizations, and distributed consistent with their licensing terms. In addition, this disclaimer applies to all parts of this release: The University of Wisconsin-Madison Space Science and Engineering Center (SSEC) makes no warranty of any kind with regard to the pyhirs software or any accompanying documentation, including but not limited to the implied warranties of merchantability and fitness for a particular purpose. SSEC does not indemnify any infringement of copyright, patent, or trademark through the use or modification of this software. There is no expressed or implied warranty made to anyone as to the suitability of this software for any purpose. All risk of use is assumed by the user. Users agree not to hold SSEC, the University of Wisconsin-Madison, or any of its employees or assigns liable for any consequences resulting from the use of the pyhirs software.