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-2020 Arizona Board of Regents on behalf of the Lunar and Planetary Laboratory at the University of Arizona.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Version

1.5 2020/04/28 18:02:55