Isis2jpeg
Convert an ISIS cube file to jpeg format using isis2raw and the netpbm graphics package
isis2jpeg -Input <pathname> -NoStrech -Output <pathname> -Quality <xxx> -Reduce <f[,g,h]> -Minimum <xx.xx[,yy.yy,zz.zz]> -Maximum <xx.xx[,yy.yy,zz.zz]> -Id <string> -DN -Ordinal -Help
The full pathname of the input ISIS cube file
Do not perform a stretch
The full pathname of the output jpeg file
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.
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.
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.
If the DN flag is specified, the minimum and maximum parameters are interpreted as DN values. -DN and -Ordinal are mutually exclusive.
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).
The ID to be used for temp files. If unspecified, the process ID will be used.
Quality code for jpeg image 50=worst, 100=best. If this parameter is not specified then the value 90 is used.
Get help on the command line
Isis2jpeg 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 ***
The following codes are returned by Isis2jpeg:
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.
Eric Eliason and Guy McArthur, UA/LPL
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.
1.27 2020/04/28 18:02:55