NAME

Isis2png

Convert an ISIS cube file to PNG format using isis2raw and the netpbm graphics package


SYNOPSIS

isis2png -Input <pathname> -Output <pathname> -Reduce <f[,g,h]> -Minimum <xx.xx[,yy.yy,zz.zz]> -Maximum <xx.xx[,yy.yy,zz.zz]> -Id <string> -DN -Ordinal -Help


OPTIONS

-Input <pathname>

The full pathname of the input ISIS cube file

-Output <pathname>

The full pathname of the output jpeg file

-Reduce <factor>

If specified, performs a reduction of the input cube to a temporary file, then uses that to obtain the minimum and maximum stats. Multiple values can be specified, pertaining to each band.

If provided, the values of reduce must be integers greater than one.

-Minimum <xx.xx[,yy.yy,zz.zz]>

The minimum low-end histogram value to map to the output 0 DN value. By default, it is expressed as a cumulative percentage value beginning from 0 at the start of the histogram. However, if -Ordinal is specified, the value will be interpreted as the number of DN bins in from the start of the histogram. If -DN is specified, it will be interpreted as a DN value.

If this parameter is not specified then the value 0.01% is used by default. If this parameter is not specified, but -Ordinal is, then the value 1 is used.

Multiple values can be specified, corresponding to the bands of a multi-band input file. They may be expressed as a comma-delimited array, or by using multiple -Minimum parameters.

-Maximum <xx.xx[,yy.yy,zz.zz]>

The maximum high-end histogram value to map to the output 255 DN value. By default, it is expressed as a cumulative percentage value beginning from 0 at the start of the histogram. However, if -Ordinal is specified, the value will be interpreted as the number of DN bins in from the end of the histogram. If -DN is specified, it will be interpreted as a DN value.

If this parameter is not specified then the value 99.99% is used by default. If this parameter is not specified, but -Ordinal is, then the value 1 is used.

Multiple values can be specified, corresponding to the bands of a multi-band input file. They may be expressed as a comma-delimited array, or by using multiple -Minimum parameters.

-DN

If the DN flag is specified, the minimum and maximum parameters are interpreted as DN values. -DN and -Ordinal are mutually exclusive.

-Ordinal

If the ordinal flag is specified, the minimum and maximum parameters are interpreted as ordinal positions in the histogram (min from the start, max from the end).

-Id <string>

The ID to be used for temp files. If unspecified, the process ID will be used.

-Help

Get help on the command line


DESCRIPTION

Isis2png converts an ISIS cube to the jpeg format. The script uses the netpbm graphics package. *** WARNING only output files of size 2 gigabytes or less can be created ***

Return Codes

The following codes are returned by Isis2png:

 0 - Success value
 1 - Command line error
 2 - Input ISIS cube file does not exist
 3 - Error in call to netpbm system used to generate jpeg images
 4 - Can not delete the output file if it already existed.


Author

Eric Eliason and Guy McArthur, UA/LPL


Copyright

Copyright(C) 2006 Arizona Board of Regents on behalf of the Lunar and Planetary Laboratory at the University of Arizona.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.


Version

1.3 2008/09/02 20:46:16