Geoexpress Command Line User Manual
Total Page:16
File Type:pdf, Size:1020Kb
LizardTech GeoExpress 9.5 Command Line User Manual Copyright © 2009–2017 Celartem, Inc., doing business as LizardTech. All rights reserved. Information in this document is subject to change without notice. The software described in this document is furnished under a license agreement or nondisclosure agreement. The software may be used or copied only in accordance with the terms of those agreements. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or any means electronic or mechanical, including photocopying and recording for any purpose other than the purchaser's personal use without the written permission of LizardTech. LizardTech, MrSID, GeoExpress and Express Server are registered trademarks in the United States and the LizardTech, GeoExpress, Express Server, ExpressView and GeoViewer logos are trademarks, and all are the property of Celartem Inc., doing business as LizardTech. Unauthorized use is prohibited. LizardTech acknowledges and thanks the many individuals and organizations whose efforts have made our products possible. A full list of copyright, trademark and credit information is available in the document “Copyrights, Trademarks, and Credits” installed automatically with your product. LizardTech 1008 Western Avenue, Suite 403 Seattle, Washington, USA 98104 206-652-5211 www.lizardtech.com - ii - Preface The GeoExpress Command Line User Manual is written for geographic information system (GIS) professionals that want to compress and manipulate geospatial imagery with GeoExpress. This guide assumes that you have basic knowledge of GIS, including mosaics, coordinate reference systems, and multispectral imagery. This guide describes how to install and operate the command line version of GeoExpress.For installation instructions and other information about the graphical version of GeoExpress, see the GeoExpress User Manual. - iii - Table of Contents Preface iii Table of Contents iv Chapter 1: Before You Begin 1 Product Overview 1 New Features 1 System Requirements 7 Getting the Software 8 Chapter 2: Installation and Licensing 9 Installation and Licensing Overview 9 Installing GeoExpress 9 Licensing GeoExpress 11 Installing Data Cartridges 14 Chapter 3: Getting Started 17 Getting Started Overview 17 Supported Input Formats 17 Supported Output Formats 20 Comparison of Compressed Output Formats 22 Chapter 4: Basic Encoding 25 Basic Encoding Overview 25 Encoding Options 25 Creating a Test Encode 33 Cropping an Image 34 Generating AUX Files 37 Locking a File with a Password 37 Optimizing MG3 and MG4 Files 38 Creating World Files 38 Creating and Viewing Logs 39 Chapter 5: Advanced Encoding and Tools 41 - iv - Advanced Encoding Overview 41 Advanced Encoding Options 41 Creating Color Composite Images 46 Despeckling an Image 47 Despeckling Existing Imagery 49 Demosaicking an Image 50 Alpha Bands and MrSID 51 Floating Point Images 53 Encoding Areas of Interest 56 Reprojection 65 Creating and Working with Mosaics 69 Working with Metadata 76 Chapter 6: LiDAR Data 97 LiDAR Data Overview 97 Basic LiDAR Switches 97 LiDAR Input Switches 98 MG4 LiDAR Switches 100 Chapter 7: JPEG 2000 Images 103 JPEG 2000 Overview 103 JPEG 2000 Encoding 103 Using JPEG 2000 Profiles 110 Encoding with Alpha Bands in JPEG 2000 112 About GML and GMLJP2 112 Creating Multiband JPEG 2000 Files 114 Chapter 8: NITF Images 117 NITF Images Overview 117 NITF* Compliance in GeoExpress 117 Creating NITF* Files 118 Creating and Using Multiple Image Segment NITF* Files 121 Applying NITF RPC 124 Chapter 9: Common Commands 125 Common Commands Overview 125 - v - Common Raster Commands 125 Common LiDAR Commands 127 Chapter 10: Troubleshooting 129 Troubleshooting Overview 129 Installation Problems 129 Encoding Problems 130 Finding Your GeoExpress Version and Build Numbers 131 Technical Support 131 Contacting Technical Support 132 Appendix A - Technical Information 133 Switches Listed Alphabetically 133 Lossy and Lossless Compression 152 Multispectral Images and the RGB Color Transform 153 Calculating Memory Usage 153 How Mosaic Sizes are Calculated 155 Calculating MrSID Area of Interest Weight 155 Header Files for BIP, BIL and BSQ Images 157 Header Files for USGS DOQ Images 162 Supported TIFF Compression Types 165 World Files 166 NITF* Input Metadata 167 Appendix B - Cartridges and Floating Licenses 171 Data Cartridges 171 Floating Licenses 172 Frequently Asked Questions 178 Appendix C - Company and Product Information 181 GeoExpress Feature History 181 Other LizardTech Products 191 About LizardTech 192 Command Line Applications 193 Command Line Applications Overview 193 mrsidgeoinfo 193 - vi - mrsidgeodecode 196 mrsidgeometa 204 Glossary 209 Index 211 - vii - Chapter 1: Before You Begin Product Overview 1 New Features 1 System Requirements 7 Getting the Software 8 Product Overview GeoExpress is a software solution for compressing and manipulating geospatial data. GeoExpress supports a broad range of file formats, including the industry standard MrSID format and the ISO standard JPEG 2000 format. Here are some of the tasks that you can perform with GeoExpress: l Compress raster and LiDAR data. l Create seamless mosaics. l Specify separate compression ratios for individual bands in a multispectral image. l Reproject raster images to another coordinate reference system. l Perform color balancing. l Crop and demosaick raster images. l Despeckle raster images. l Edit image metadata. Save the images that you create with GeoExpress to a local machine or a LizardTech Express Server. Then, view the images in the geographic information system (GIS) software of your choice, including Esri®, Bentley®, Autodesk®, and more. New Features Recent versions of GeoExpress include the following new features and enhancements: - 1 - GeoExpress 9.5 Command Line User Manual Version 9.5.4 New features l Seamlines shapefile: We added an option to generate a shapefile representing the tiles included in a raster mosaic. You can use this in another program, like GeoViewer, to identify tiles and overlap in the output image. l Command line tools: We improved the method used to create MrSID mosaics from the command line. Bugs fixed l Fixed a bug where mosaicking multispectral images could yield an incorrect alpha band in output. l Fixed a bug where the Express Catridge Server installer was not installing some required libraries. l Fixed a bug where the GeoExpress installer could not install a required library if an older version was already installed. l Fixed a bug where mosaicking a low-res image could result in the low-res tile being shifted by 1 pixel. l Fixed a bug where setting advanced alpha options for a multi-file job could result in a crash. l Fixed a bug where resampling an image could shift its corner points slightly. Version 9.5.3 New features l BPF support: GeoExpress supports input and output of Binary Point Files often used in Geiger Mode LiDAR imagery. l NAD83 2011 support: GeoExpress now supports EPSG Coordinate Reference Systems and Coordinate Transformations related to NOAA’s National Adjustment of 2011. l Better color balancing: We added an option for color balancing mosaics that allows you to apply the correction to each band in the image, rather than just to the intensity (the pre- vious built-in behavior). The new option is the default behavior, but you can switch back to the previous method if necessary. - 2 - Chapter 1: Before You Begin l Custom Watermarks: The size limitation for custom watermark files has been removed. Previously, the maxium size for a watermark was 128 pixels × 128 pixels. l RGB Color Transform enabled by default: For multispectral source images, the option to compress the first 3 bands as RGB bands is enabled by default. This results in truer colors in the compressed output image. l Simpler licensing: To license GeoExpress on a stand-alone system, you can import a license file. The License Server Utility makes it a snap to add floating licenses. Bugs fixed l Both Reprojection and Color Balancing now respect the operating system's setting for num- ber format. Specifically, if your region's standard number format uses a comma (,) to sep- arate integral from decimal portions of a number, these values are now stored correctly. l A bug where NITF files larger than 4GB were not read correctly has been fixed. Version 9.5.2 Overview GeoExpress 9.5.2 is a patch release to enable users with a floating license to access the software via Remote Desktop. Previously, users were forced to use a special Remote Edition license. Features and Fixes l A floating license now allows access via Remote Desktop l Documentation updates (including Area of Interest changes) l Fixed batch silent install Version 9.5.1 Faster Default Workflows Some operations are optimizable, which means the image does not need to be re-encoded, making the operations significantly faster. In GeoExpress 9.5.1, we've added two new options that allow the application to default to the optimized process whenever possible: l Default output format same as input format l No additional compression - 3 - GeoExpress 9.5 Command Line User Manual PIX Support GeoExpress supports PCIDSK (PIX) files as input files. The output image is stored in the MrSid Generation 4 format. Windows 10 Support GeoExpress is now supported on Windows 10 32-bit and 64-bit systems. Version 9.5 LiDAR Compression GeoExpress supports compressing LiDAR point clouds stored in plain-text format or in the LAS and LAZ formats. The output image is stored in the MrSID Generation 4 format or the LAZ format. Multipolygon Shapefile Cropping When you crop images, you can define the area that you want to crop with a shapefile. The shapefile that you select can contain multiple polygons. You can then create a single image that contains the area of all the polygons, or you can create separate images for each polygon. Previously, shapefiles needed to contain exactly one polygon. Batch Color Balancing Perform color balancing operations on multiple images. When you adjust color balancing settings for one image, you can apply the settings to multiple other images.