# JP2ECW -- ERMapper JPEG2000 (.jp2)

GDAL supports reading and writing JPEG2000 files using the ECW SDK from ERMapper.

Coordinate system and georeferencing transformations are read, and some degree of support is included for GeoJP2 (tm) (GeoTIFF-in-JPEG2000), ERMapper GML-in-JPEG2000, and the new GML-in-JPEG2000 specification developed at OGC.

Support for the JP2ECW driver in GDAL is optional, and requires linking in external ECW SDK libraries provided by ERMapper.

## Creation Issues

The free ECW compression kit only supports compression of images up to 500MB. To compress very large images it is necessary to license ECW technology from ERMapper. Creation of 8 bit, and 16bit signed or unsigned values is supported.

Creation Options:

- TARGET=percent: Set the target size reduction as a percentage of the original. If not provided defaults to 75 for an 75% reduction.

- PROJ=name: Name of the ERMapper projection string to use. Common examples are NUTM11, or GEODETIC.

- DATUM=name: Name of the ERMapper datum string to use. Common examples are WGS84 or NAD83.

- LARGE_OK=YES/NO: Under some circumstances this option can be set to allow compressing files larger than 500MB. It is the users responsibility to ensure that ERMapper licensing requirments for large file compression are being adhered to.

- PROFILE=profile: One of BASELINE_0, BASELINE_1, BASELINE_2, NPJE or EPJE. Review the ECW SDK documentation for details on profile meanings.

- PROGRESSION=LRCP/RLCP/RPCL: Set the progression order with which the JPEG2000 codestream is written.

- CODESTREAM_ONLY=YES/NO: If set to YES, only the compressed imagery code stream will be written. If NO (the default) a JP2 package will be written around the code stream including a variety of meta information.

- LEVELS=n: See ECW SDK for details.

- LAYERS=n: See ECW SDK for details.

- PRECINCT_WIDTH=n: See ECW SDK for details.

- PRECINCT_HEIGHT=n: See ECW SDK for details.

- TILE_WIDTH=n: See ECW SDK for details.

- TILE_HEIGHT=n: See ECW SDK for details.

- INCLUDE_SOP=YES/NO: See ECW SDK for details.

- INCLUDE_EPH=YES/NO: See ECW SDK for details.

- DECOMPRESS_LAYERS=n: See ECW SDK for details.

- DECOMPRESS_RECONSTRUCTION_PARAMETER=n: See ECW SDK for details.

JPEG2000 format does not support creation of overviews since the format is already considered to be optimized for "arbitrary overviews".

See Also:

- Implemented as `gdal/frmts/ecw/ecwdataset.cpp`.

- ECW Page at www.ermapper.com.