NAME

Isis2jp2

Convert an ISIS cube file to JP2 format using isis2raw and kdu_compress.

SYNOPSIS

Isis2jp2 -Input <pathname> -Output <pathname> -Bpp <N> -Precision <M> -Rate <xx.xx> -NoStrech -Reduce <f[,g,h]> -Minimum <xx.xx[,yy.yy,zz.zz]> -Maximum <xx.xx[,yy.yy,zz.zz]> -Id <string> -Ordinal -DN -NoPLTs -Help

OPTIONS

-Input <pathname>

The full pathname of the input ISIS cube file

-Output <pathname>

The full pathname of the output jp2 file

-Bpp <N>

Number of bits/pixel for the conversion to raw. This should match the bits per pixel per band in the input cube file.

The value should be one of the following: 8 (one byte per pixel), U16 (two bytes per pixel, unsigned), S16 (two bytes per pixel, signed), or 32.

-Precision <M>

Bit precision for the JP2 encoding, defaults to the same as the number of bits per pixel. kdu_compress -usage indicates this is"the bit-depth of each codestream image component."

-Rate <xx.xx>

Number of bits/pixel for compressed JPEG2000 file. If the rate is not specified then Isis2jp2 will use lossless compression.

-NoStretch

Do not perform a stretch

-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).

-NoPLTs

Do not include the PLT markers in the output JP2. By default, PLT markers are included.

-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

Isis2jp2 converts an ISIS cube to the jp2 format. The script uses the Kakadu Software kdu_compress package.

Return Codes

The following codes are returned by Isis2jp2:

0 - Success value
1 - Command line error
2 - Input file does not exist
3 - Error returned from kdu_compress
4 - Can not delete the output file

Author

Guy McArthur and Eric Eliason, 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.35 2020/06/05 01:12:20