.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.46.4.
.TH OSSIM-CHIPPER "1" "December 2015" "ossim-chipper 1.8.20" "User Commands"
.SH NAME
ossim-chipper \- ossim-chipper
.SH SYNOPSIS
.B ossim-chipper
[\fI\,option\/\fR]... [\fI\,input-option\/\fR]... \fI\,<input-file(s)> <output-file>\/\fR
.SH DESCRIPTION
Note at least one input is required either from one of the input options, e.g. \fB\-\-input\-dem\fR <my\-dem.hgt> or adding to command line in front of the output file in which case the code will try to ascertain what type of input it is.
.PP
Available traces:
\fB\-T\fR "ossimChipperUtil:debug"   \- General debug trace to standard out.
\fB\-T\fR "ossimChipperUtil:log"     \- Writes a log file to output\-file.log.
\fB\-T\fR "ossimChipperUtil:options" \- Writes the options to output\-file\-options.kwl.
.PP
Description:
ossim\-chipper Utility application for generating elevation products from dem data.
.SH OPTIONS
.TP
\fB\-\-2cmv\-blue\-output\-source\fR
<source>
Two color multi view source input for blue output.
Either, old, new, or mp(min pix).  Default=new.
.TP
\fB\-\-2cmv\-green\-output\-source\fR
<source>
Two color multi view source input for green
output.  Either, old, new, or mp(min pix).
Default=new.
.TP
\fB\-\-2cmv\-new\-input\-band\fR
<band>
Band to use for two color multi view new input.
.TP
\fB\-\-2cmv\-old\-input\-band\fR
<band>
Band to use for two color multi view old input.
.TP
\fB\-\-2cmv\-red\-output\-source\fR
<source>
Two color multi view source input for red output.
Either, old, new, or mp(min pix).  Default=old.
.TP
\fB\-\-azimuth\fR
<azimuth>
hillshade option \- Light source azimuth angle for
bump shade.
Range: 0 to 360, Default = 180.0
.TP
\fB\-\-brightness\fR
<brightness>
Apply brightness to input image(s). Valid range:
\fB\-1\fR.0 to 1.0
.TP
\fB\-\-central\-meridian\fR
<central_meridian_in_decimal_degrees>
Note if set this will be used for the central
meridian of the projection.  This can be used to
lock the utm zone.
.TP
\fB\-\-clip\-poly\-lat\-lon\fR
Polygon in the form of a string:
(lat,lon),(lat,lon),...(lat,lon)
.TP
\fB\-\-clip\-wms\-bbox\-ll\fR
<minx>,<miny>,<maxx>,<maxy>
Specify a comma separated list in the format of a
WMS BBOX.
The units are always decimal degrees
.TP
\fB\-\-color\fR
<r> <g> <b>
hillshade option \- Set the red, green and blue
color values to be used with hillshade.
This option can be used with or without an image
source for color.
Range 0 to 255, Default r=255, g=255, b=255
.TP
\fB\-\-color\-table\fR
<color\-table.kwl>
hillshade or color\-relief option \- Keyword list
containing color table for color\-relief option.
.TP
\fB\-\-combiner\-type\fR
<type>
ossimBlendMosaic, ossimFeatherMosaic,
ossimImageMosaic.  Default: ossimImageMosaic.
Example \fB\-\-combiner\-type\fR ossimImageMosaic
.TP
\fB\-\-contrast\fR
<contrast>
Apply contrast to input image(s). Valid range:
\fB\-1\fR.0 to 1.0
.TP
\fB\-\-cut\-bbox\-ll\fR
<min_lat> <min_lon> <max_lat> <max_lon>
Specify a bounding box with the minimum
latitude/longitude and max latitude/longitude in
decimal degrees.
Note coordinates are edge to edge.
.TP
\fB\-\-cut\-bbox\-llwh\fR
<min_lat> <min_lon> <max_lat> <max_lon> <width>
<height>
Specify a bounding box with the minimum
latitude/longitude, max latitude/longitude in
decimal degrees and width/height in pixels.
Note coordinates are edge to edge.
.TP
\fB\-\-cut\-bbox\-xywh\fR
<x>,<y>,<width>,<height>
Specify a comma separated bounding box.
.TP
\fB\-\-cut\-center\-llr\fR
<latitude> <longitude> <radius_in_meters>
Specify the center cut in latitude longitude space
with radius in meters.
.TP
\fB\-\-cut\-center\-llwh\fR
<latitude> <longitude> <width> <height>
Specify the center cut in latitude longitude space
with width and height in pixels.
.TP
\fB\-\-cut\-height\fR
<height>
Specify the cut height in pixel
.TP
\fB\-\-cut\-width\fR
<width>
Specify the cut width in pixel
.TP
\fB\-\-cut\-wms\-bbox\fR
<minx>,<miny>,<maxx>,<maxy>
Specify a comma separated list in the format of a
WMS BBOX.
The units are in the units of the projector
defined by the \fB\-\-srs\fR key
.TP
\fB\-\-cut\-wms\-bbox\-ll\fR
<minx>,<miny>,<maxx>,<maxy>
Specify a comma separated list in the format of a
WMS BBOX.
The units are always decimal degrees
.TP
\fB\-\-degrees\fR
<dpp_xy> | <dpp_x> <dpp_y>
Specifies an override for degrees per pixel. Takes
either a single value applied equally to x and y
directions, or two values applied correspondingly
to x then y. This option takes precedence over the
"\-\-meters" option.
.TP
\fB\-\-disable\-elev\fR
Will disable the elevation
.TP
\fB\-\-disable\-notify\fR
Takes an argument. Arguments are ALL, WARN,
NOTICE, INFO, FATAL, DEBUG.  If you want multiple
disables then just do multiple \fB\-\-disable\-notify\fR on
the command line.  All argument are case
insensitive.  Default is all are enabled.
.TP
\fB\-\-disable\-plugin\fR
Will disable the plugin loader
.TP
\fB\-\-elevation\fR
<elevation>
hillshade option \- Light source elevation angle
for bumb shade.
Range: 0 to 90, Default = 45.0
.TP
\fB\-\-exaggeration\fR
<factor>
Multiplier for elevation values when computing
surface normals. Has the effect of lengthening
shadows for oblique lighting.
Range: .0001 to 50000, Default = 1.0
.TP
\fB\-\-hemisphere\fR
<hemisphere>
Specify a projection hemisphere if supported. E.g.
UTM projection. This will lock the hemisphere even
if input scene center is the other hemisphere.
Valid values for UTM are "N" and "S"
.TP
\fB\-\-histogram\-op\fR
<operation>
Histogram operation to perform. Valid operations
are "auto\-minmax", "std\-stretch\-1",
"std\-stretch\-2" and "std\-stretch\-3".
.TP
\fB\-\-image\-space\-scale\fR
<x> <y>
Specifies an image space scale for x and y
direction. "chip" operation only.
.TP
\fB\-\-input\-dem\fR
<dem> Input dem to process.
.TP
\fB\-\-input\-img\fR
<image> Input image to process.
.TP
\fB\-\-input\-src\fR
<file.src> Input source file list keyword list
with list of dems or images or both to process.
.TP
\fB\-\-meters\fR
<meters>
Specifies an override for the meters per pixel
.TP
\fB\-\-op\fR
<operation>
Operation to perform. Valid operations are "chip",
"color\-relief", "hillshade", "psm"(pan sharpened
multispectral), "2cmv"(two color multi view) and
"ortho".
chip = input projection = output projection(image
space), single image operation only.
.TP
\fB\-\-options\fR
<options.kwl>  This can be all or part of the
application options.  To get a template you can
turn on trace to the ossimChipperUtil class by
adding "\-T ossimChipperUtil" to your command.
.TP
\fB\-\-origin\-latitude\fR
<latidude_in_decimal_degrees>
Note if set this will be used for the origin
latitude of the projection.  Setting this to
something other than 0.0 with a geographic
projection creates a scaled geographic projection.
.TP
\fB\-\-ossim\-logfile\fR
takes a logfile as an argument.  All output
messages are redirected to the specified log file.
By default there is no log file and all messages
are enabled.
.TP
\fB\-\-output\-radiometry\fR
<R>
Specifies the desired product's pixel radiometry
type. Possible values for <R> are: U8, U11, U16,
S16, F32. Note this overrides the deprecated
option "scale\-to\-8\-bit".
.TP
\fB\-\-pad\-thumbnail\fR
<boolean>
If true, output thumbnail dimensions will be
padded in width or height to make square; else, it
will have the aspect ratio of input,
Default=false
.TP
\fB\-\-projection\fR
<output_projection> Valid projections: geo,
geo\-scaled, input or utm
geo = Equidistant Cylindrical, origin latitude =
0.0
geo\-scaled = Equidistant Cylindrical, origin
latitude = image center
input Use first images projection. Must be a map
projecion.
utm = Universal Tranverse Mercator
If input and multiple sources the projection of
the first image will be used.
If utm the zone will be set from the scene center
of first image.
NOTE: \fB\-\-srs\fR takes precedence over this option.
.TP
\fB\-\-reader\-prop\fR
<string>Adds a property to send to the reader.
format is name=value
.TP
\fB\-\-resample\-filter\fR
<type>
Specify what resampler filter to use, e.g. nearest
neighbor, bilinear, cubic, sinc.
See ossim\-info \fB\-\-resampler\-filters\fR
.TP
\fB\-\-rrds\fR
<rrds> Reduced resolution data set where 0 is full
resolution. "chip" operation only.
.TP
\fB\-\-scale\-to\-8\-bit\fR
Scales the output to unsigned eight bits per band.
This option has been deprecated by the newer
"\-\-output\-radiometry" option.
.TP
\fB\-\-sharpen\-mode\fR
<mode> Applies sharpness to image chain(s). Valid
modes: "light", "heavy"
.TP
\fB\-\-snap\-tie\-to\-origin\fR
Snaps tie point to projection origin so that
(tie\-origin)/gsd come out on an even integer
boundary.
.TP
\fB\-\-srs\fR
<src_code>
Specify a spatial reference system(srs) code for
the output projection. Example: \fB\-\-srs\fR EPSG:4326
.TP
\fB\-\-three\-band\-out\fR
Force three band output even if input is not.
Attempts to map bands to RGB if possible.
.TP
\fB\-\-tile\-size\fR
<size_in_pixels>
Sets the output tile size if supported by writer.
Notes: This sets both dimensions. Must be a
multiple of 16, e.g. 1024.
.TP
\fB\-\-writer\-prop\fR
<writer\-property>
Passes a name=value pair to the writer for setting
it's property. Any number of these can appear on
the line.
.TP
\fB\-\-zone\fR
<zone>
Specify a projection zone if supported.  E.g. UTM
projection. This will lock the zone even if input
scene center is in another zone. Valid values for
UTM are "1" to "60"
.TP
\fB\-K\fR
specify individual keywords to add to the
preferences keyword list: name=value
.TP
\fB\-P\fR
specify a preference file to load
.TP
\fB\-T\fR
specify the classes to trace, ex:
ossimInit|ossimImage.*
will trace ossimInit and all ossimImage classes
.TP
\fB\-b\fR or \fB\-\-bands\fR <n,n...>
Use the specified bands in given order: e.g.
"3,2,1" will select bands 3, 2 and 1 of the input
image.
Note: it is 1 based
.TP
\fB\-e\fR or \fB\-\-entry\fR
<entry> For multi image handlers which entry do
you wish to extract. For list of entries use:
"ossim\-info \fB\-i\fR <your_image>"
.TP
\fB\-h\fR or \fB\-\-help\fR
Display this help and exit.
.TP
\fB\-n\fR or \fB\-\-north\-up\fR
Rotates image North up. "chip" operation only.
.TP
\fB\-r\fR or \fB\-\-rotate\fR
<degrees>
Rotate image by degrees. "chip" operation only.
.TP
\fB\-t\fR or \fB\-\-thumbnail\fR
<max_dimension>
Specify a thumbnail resolution.
Scale will be adjusted so the maximum dimension =
argument given.
.TP
\fB\-u\fR or \fB\-\-up\-is\-up\fR
Rotates image to up is up. "chip" operation only.
.TP
\fB\-w\fR or \fB\-\-writer\fR
<writer>
Specifies the output writer.  Default uses output
file extension to determine writer. For valid
output writer types use: "ossim\-info \fB\-\-writers\fR"
.PP
NOTES:
1) Never use same base name in the same directory! Example is you have a Chicago.tif
.IP
and you want a Chicago.jp2, output Chicago.jp2 to its own directory.
.PP
Example commands:
.PP
// File conversion: Convert geotiff to a jp2 file.
ossim\-chipper \fB\-\-op\fR chip \fB\-w\fR ossim_kakadu_jp2 Chicago.tif outputs/Chicago.jp2
.PP
// Orthorectification: Orthorectify a nitf with RPC model out to a geotiff.
ossim\-chipper \fB\-\-op\fR ortho 5V090205P0001912264B220000100282M_001508507.ntf outputs/ortho.tif
.PP
// Mosaic: Mosaic multiple images together and output to a geotiff.
ossim\-chipper \fB\-\-combiner\-type\fR ossimImageMosaic \fB\-\-op\fR ortho f1.tif f2.tif f3.tif outputs/mosaic.tif
.PP
// Mosaic: Feather Mosaic multiple images together and output to a geotiff.
ossim\-chipper \fB\-\-combiner\-type\fR ossimFeatherMosaic \fB\-\-op\fR ortho f1.tif f2.tif f3.tif outputs/feather.tif
.PP
// Color relief: Colorize two DEMs from a lut, output to a geotiff.
ossim\-chipper \fB\-\-op\fR color\-relief \fB\-\-color\-table\fR ossim\-dem\-color\-table\-template.kwl N37W123.hgt N38W123.hgt outputs/color\-relief.tif
.PP
// Color relief: Colorize two DEMs from a lut, output to a png thumbnail.
ossim\-chipper \fB\-\-op\fR color\-relief \fB\-\-color\-table\fR ossim\-dem\-color\-table\-template.kwl \fB\-t\fR 1024 \fB\-w\fR ossim_png N37W123.hgt N38W123.hgt outputs/color\-relief.png
.PP
// Hill shade: Hill shade two DEMs, output to a geotiff.
ossim\-chipper \fB\-\-color\fR 255 255 255 \fB\-\-azimuth\fR 270 \fB\-\-elevation\fR 45 \fB\-\-exaggeration\fR 2.0 \fB\-\-op\fR  hillshade N37W123.hgt N38W123.hgt outputs/hillshade.tif
.PP
// Two color multi view with cut box.  First image is old, second image is new:
ossim\-chipper \fB\-\-cut\-bbox\-ll\fR 28.092885092033352 \fB\-80\fR.664539599998633 28.109128691071547 \fB\-80\fR.626914963229325 \fB\-\-op\fR 2cmv oldMLB.tif newMLB.tif outputs/2cmv\-test1.tif
.PP
// Ortho about point, 512x512, with histogram stretch, and 3,2,1 band order:
ossim\-chipper \fB\-\-op\fR ortho \fB\-b\fR 3,2,1 \fB\-\-histogram\-op\fR auto\-minmax \fB\-\-cut\-center\-llwh\fR \fB\-42\fR.819784401784275 147.265811350983 512 512 5V090205M0001912264B220000100072M_001508507.ntf orth.tif
.PP
// Chip, in image space, about point, 512x512, with histogram stretch, and 3,2,1 band order:
ossim\-chipper \fB\-\-op\fR chip \fB\-b\fR 3,2,1 \fB\-\-histogram\-op\fR auto\-minmax \fB\-\-cut\-center\-llwh\fR \fB\-42\fR.819784401784275 147.265811350983 512 512 5V090205M0001912264B220000100072M_001508507.ntf chip.tif
.PP
// Chip in image space, rotate "up is up"(\fB\-u\fR option) about point, 512x512 with histogram stretch and 3,2,1 band order:
ossim\-chipper \fB\-\-op\fR chip \fB\-u\fR \fB\-b\fR 3,2,1 \fB\-\-histogram\-op\fR auto\-minmax \fB\-\-cut\-center\-llwh\fR \fB\-42\fR.819784401784275 147.265811350983 512 512 5V090205M0001912264B220000100072M_001508507.ntf up\-is\-up\-chip.tif
.PP
// Chip in image space, rotate 39 degrees (\fB\-r\fR option) about point, 1024x1024, scaled to eight bit:
ossim\-chipper \fB\-\-op\fR chip \fB\-r\fR 39 \fB\-\-histogram\-op\fR auto\-minmax \fB\-\-cut\-center\-llwh\fR \fB\-42\fR.883809539602893 147.331984112985765 1024 1024 \fB\-\-output\-radiometry\fR U8 5V090205P0001912264B220000100282M_001508507.ntf outputs/r39.png
.PP
// Above command where all options are in a keyword list:
ossim\-chipper \fB\-\-options\fR r39\-options.kwl
.SH "SEE ALSO"
The full documentation for
.B ossim-chipper
is maintained as a Texinfo manual.  If the
.B info
and
.B ossim-chipper
programs are properly installed at your site, the command
.IP
.B info ossim-chipper
.PP
should give you access to the complete manual.