| 2 | | ossim-chipper is a command line application used to generate elevation products from raw dem, dted, and srtm data. This application supports 2 basic functions: hillshade and color-relief. From these 2 operations you can create the following products. |
| | 2 | ossim-chipper is a command line application used to generate image products from single or multiple image inputs. This includes chipping in image space, format conversions, ortho-rectification, elevation products from raw dem, dted, and srtm data. |
| | 3 | |
| | 4 | '''Usage:''' |
| | 5 | {{{ |
| | 6 | $ ossim-chipper |
| | 7 | Usage: ossim-chipper [option]... [input-option]... <input-file(s)> <output-file> |
| | 8 | Note at least one input is required either from one of the input options, e.g. --input-dem <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. |
| | 9 | |
| | 10 | Available traces: |
| | 11 | -T "ossimChipperUtil:debug" - General debug trace to standard out. |
| | 12 | -T "ossimChipperUtil:log" - Writes a log file to output-file.log. |
| | 13 | -T "ossimChipperUtil:options" - Writes the options to output-file-options.kwl. |
| | 14 | |
| | 15 | Description: |
| | 16 | ossim-chipper Utility application for generating elevation products from dem data. |
| | 17 | |
| | 18 | Options: |
| | 19 | --2cmv-blue-output-source <source> |
| | 20 | Two color multi view source input for blue output. |
| | 21 | Either, old, new, or mp(min pix). Default=new. |
| | 22 | --2cmv-green-output-source <source> |
| | 23 | Two color multi view source input for green |
| | 24 | output. Either, old, new, or mp(min pix). |
| | 25 | Default=new. |
| | 26 | --2cmv-new-input-band <band> |
| | 27 | Band to use for two color multi view new input. |
| | 28 | --2cmv-old-input-band <band> |
| | 29 | Band to use for two color multi view old input. |
| | 30 | --2cmv-red-output-source <source> |
| | 31 | Two color multi view source input for red output. |
| | 32 | Either, old, new, or mp(min pix). Default=old. |
| | 33 | --azimuth <azimuth> |
| | 34 | hillshade option - Light source azimuth angle for |
| | 35 | bump shade. |
| | 36 | Range: 0 to 360, Default = 180.0 |
| | 37 | --central-meridian <central_meridian_in_decimal_degrees> |
| | 38 | Note if set this will be used for the central |
| | 39 | meridian of the projection. This can be used to |
| | 40 | lock the utm zone. |
| | 41 | --color <r> <g> <b> |
| | 42 | hillshade option - Set the red, green and blue |
| | 43 | color values to be used with hillshade. |
| | 44 | This option can be used with or without an image |
| | 45 | source for color. |
| | 46 | Range 0 to 255, Defualt r=255, g=255, b=255 |
| | 47 | --color-table <color-table.kwl> |
| | 48 | hillshade or color-relief option - Keyword list |
| | 49 | containing color table for color-relief option. |
| | 50 | --cut-bbox-ll <min_lat> <min_lon> <max_lat> <max_lon> |
| | 51 | Specify a bounding box with the minimum |
| | 52 | latitude/longitude and max latitude/longitude in |
| | 53 | decimal degrees. |
| | 54 | Note coordinates are edge to edge. |
| | 55 | --cut-bbox-llwh <min_lat> <min_lon> <max_lat> <max_lon> <width> |
| | 56 | <height> |
| | 57 | Specify a bounding box with the minimum |
| | 58 | latitude/longitude, max latitude/longitude in |
| | 59 | decimal degrees and width/height in pixels. |
| | 60 | Note coordinates are edge to edge. |
| | 61 | --cut-center-llr <latitude> <longitude> <radius_in_meters> |
| | 62 | Specify the center cut in latitude longitude space |
| | 63 | with radius in meters. |
| | 64 | --cut-center-llwh <latitude> <longitude> <width> <height> |
| | 65 | Specify the center cut in latitude longitude space |
| | 66 | with width and height in pixels. |
| | 67 | --degrees <dpp_xy> | <dpp_x> <dpp_y> |
| | 68 | Specifies an override for degrees per pixel. Takes |
| | 69 | either a single value applied equally to x and y |
| | 70 | directions, or two values applied correspondingly |
| | 71 | to x then y. This option takes precedence over the |
| | 72 | "--meters" option. |
| | 73 | --disable-elev Will disable the elevation |
| | 74 | --disable-notify Takes an argument. Arguments are ALL, WARN, |
| | 75 | NOTICE, INFO, FATAL, DEBUG. If you want multiple |
| | 76 | disables then just do multiple --disable-notify on |
| | 77 | the command line. All argument are case |
| | 78 | insensitive. Default is all are enabled. |
| | 79 | --disable-plugin Will disable the plugin loader |
| | 80 | --elevation <elevation> |
| | 81 | hillshade option - Light source elevation angle |
| | 82 | for bumb shade. |
| | 83 | Range: 0 to 90, Default = 45.0 |
| | 84 | --exaggeration <factor> |
| | 85 | Multiplier for elevation values when computing |
| | 86 | surface normals. Has the effect of lengthening |
| | 87 | shadows for oblique lighting. |
| | 88 | Range: .0001 to 50000, Default = 1.0 |
| | 89 | --histogram-op <operation> |
| | 90 | Histogram operation to perform. Valid operations |
| | 91 | are "auto-minmax", "std-stretch-1", |
| | 92 | "std-stretch-2" and "std-stretch-3". |
| | 93 | --input-dem <dem> Input dem to process. |
| | 94 | --input-img <image> Input image to process. |
| | 95 | --input-src <file.src> Input source file list keyword list |
| | 96 | with list of dems or images or both to process. |
| | 97 | --meters <meters> |
| | 98 | Specifies an override for the meters per pixel |
| | 99 | --op <operation> |
| | 100 | Operation to perform. Valid operations are "chip", |
| | 101 | "color-relief", "hillshade", "psm"(pan sharpened |
| | 102 | multispectral), "2cmv"(two color multi view) and |
| | 103 | "ortho". |
| | 104 | chip = input projection = output projection(image |
| | 105 | space), single image operation only. |
| | 106 | --options-keyword-list <options.kwl> This can be all or part of the |
| | 107 | application options. To get a template you can |
| | 108 | turn on trace to the ossimChipperUtil class by |
| | 109 | adding "-T ossimChipperUtil" to your command. |
| | 110 | --origin-latitude <latidude_in_decimal_degrees> |
| | 111 | Note if set this will be used for the origin |
| | 112 | latitude of the projection. Setting this to |
| | 113 | something other than 0.0 with a geographic |
| | 114 | projection creates a scaled geographic projection. |
| | 115 | --ossim-logfile takes a logfile as an argument. All output |
| | 116 | messages are redirected to the specified log file. |
| | 117 | By default there is no log file and all messages |
| | 118 | are enabled. |
| | 119 | --output-radiometry <R> |
| | 120 | Specifies the desired product's pixel radiometry |
| | 121 | type. Possible values for <R> are: U8, U11, U16, |
| | 122 | S16, F32. Note this overrides the deprecated |
| | 123 | option "scale-to-8-bit". |
| | 124 | --projection <output_projection> Valid projections: geo, |
| | 125 | geo-scaled, input or utm |
| | 126 | geo = Equidistant Cylindrical, origin latitude = |
| | 127 | 0.0 |
| | 128 | geo-scaled = Equidistant Cylindrical, origin |
| | 129 | latitude = image center |
| | 130 | input Use first images projection. Must be a map |
| | 131 | projecion. |
| | 132 | utm = Universal Tranverse Mercator |
| | 133 | If input and multiple sources the projection of |
| | 134 | the first image will be used. |
| | 135 | If utm the zone will be set from the scene center |
| | 136 | of first image. |
| | 137 | NOTE: --srs takes precedence over this option. |
| | 138 | --reader-prop <string> Adds a property to send to the reader. format is |
| | 139 | name=value |
| | 140 | --resample-filter <type> |
| | 141 | Specify what resampler filter to use, e.g. nearest |
| | 142 | neighbor, bilinear, cubic, sinc. |
| | 143 | See ossim-info --resampler-filters |
| | 144 | --scale-to-8-bit Scales the output to unsigned eight bits per band. |
| | 145 | This option has been deprecated by the newer |
| | 146 | "--output-radiometry" option. |
| | 147 | --snap-tie-to-origin Snaps tie point to projection origin so that |
| | 148 | (tie-origin)/gsd come out on an even integer |
| | 149 | boundary. |
| | 150 | --srs <src_code> |
| | 151 | Specify an output reference frame/projection. |
| | 152 | Example: --srs EPSG:4326 |
| | 153 | --three-band-out Force three band output even if input is not. |
| | 154 | --writer-prop <writer-property> |
| | 155 | Passes a name=value pair to the writer for setting |
| | 156 | it's property. Any number of these can appear on |
| | 157 | the line. |
| | 158 | -K specify individual keywords to add to the |
| | 159 | preferences keyword list: name=value |
| | 160 | -P specify a preference file to load |
| | 161 | -T specify the classes to trace, ex: |
| | 162 | ossimInit|ossimImage.* |
| | 163 | will trace ossimInit and all ossimImage classes |
| | 164 | -V or --version Display version information. |
| | 165 | -b or --bands <n,n...> Use the specified bands in given order: e.g. |
| | 166 | "3,2,1" will select bands 3, 2 and 1 of the input |
| | 167 | image. |
| | 168 | Note: it is 1 based |
| | 169 | -e or --entry <entry> For multi image handlers which entry do |
| | 170 | you wish to extract. For list of entries use: |
| | 171 | "ossim-info -i <your_image>" |
| | 172 | -h or --help Display this help and exit. |
| | 173 | -n or --north-up Rotates image North up. "chip" operation only. |
| | 174 | -r or --rotate <degrees> |
| | 175 | Rotate image by degrees. "chip" operation only. |
| | 176 | -t or --thumbnail <max_dimension> |
| | 177 | Specify a thumbnail resolution. |
| | 178 | Scale will be adjusted so the maximum dimension = |
| | 179 | argument given. |
| | 180 | -u or --up-is-up Rotates image to up is up. "chip" operation only. |
| | 181 | -w or --writer <writer> |
| | 182 | Specifies the output writer. Default uses output |
| | 183 | file extension to determine writer. For valid |
| | 184 | output writer types use: "ossim-info --writers" |
| | 185 | |
| | 186 | NOTES: |
| | 187 | 1) Never use same base name in the same directory! Example is you have a Chicago.tif |
| | 188 | and you want a Chicago.jp2, output Chicago.jp2 to its own directory. |
| | 189 | |
| | 190 | Example commands: |
| | 191 | |
| | 192 | // Simple file conversion: Convert geotiff to a jp2 file. |
| | 193 | ossim-chipperossim_kakadu_jp2 Chicago.tif outputs/Chicago.jp2 |
| | 194 | |
| | 195 | // Basic orthorectification: Orthorectify a nitf with RPC model out to a geotiff. |
| | 196 | ossim-chipper --op ortho 5V090205P0001912264B220000100282M_001508507.ntf outputs/ortho.tif |
| | 197 | |
| | 198 | // A two color multi view with cut box. First image is old, second image is new: |
| | 199 | ossim-chipper --cut-bbox-ll 28.092885092033352 -80.664539599998633 28.109128691071547 -80.626914963229325 --op 2cmv oldMLB.tif newMLB.tif outputs/2cmv-test1.tif |
| | 200 | |
| | 201 | // Ortho about point, 512x512, with histogram stretch, and 3,2,1 band order: |
| | 202 | ossim-chipper --op ortho -b 3,2,1 --histogram-op auto-minmax --cut-center-llwh -42.819784401784275 147.265811350983 512 512 5V090205M0001912264B220000100072M_001508507.ntf orth.tif |
| | 203 | |
| | 204 | // Chip, in image space, about point, 512x512, with histogram stretch, and 3,2,1 band order: |
| | 205 | ossim-chipper --op chip -b 3,2,1 --histogram-op auto-minmax --cut-center-llwh -42.819784401784275 147.265811350983 512 512 5V090205M0001912264B220000100072M_001508507.ntf chip.tif |
| | 206 | |
| | 207 | // Chip in image space, rotate "up is up"(-u option) about point, 512x512 with histogram stretch and 3,2,1 band order: |
| | 208 | ossim-chipper --op chip -u -b 3,2,1 --histogram-op auto-minmax --cut-center-llwh -42.819784401784275 147.265811350983 512 512 5V090205M0001912264B220000100072M_001508507.ntf up-is-up-chip.tif |
| | 209 | |
| | 210 | // Chip in image space, rotate 39 degrees (-r option) about point, 1024x1024, scaled to eight bit: |
| | 211 | ossim-chipper --op chip -r 39 --histogram-op auto-minmax --cut-center-llwh -42.883809539602893 147.331984112985765 1024 1024 --scale-to-8-bit 5V090205P0001912264B220000100282M_001508507.ntf outputs/r39.png |
| | 212 | |
| | 213 | // Above command where all options are in a keyword list: |
| | 214 | ossim-chipper --options-keyword-list r39-options.kwl |
| | 215 | }}} |
| | 216 | |
| | 217 | |
| | 218 | |
| | 219 | '''Exmple commands:''' |
| | 220 | |
