34 | | |
35 | | |
36 | | |
37 | | |
38 | | |
39 | | |
40 | | EXAMPLES: |
41 | | |
42 | | BLEND thumbnail |
43 | | |
44 | | orthoigen /data/sanfran_ccf/foo.ccf /data/sanfran_map/sanfran_map.tif output/blend.jpg --combiner-type ossimBlendMosaic -t 512 --utm |
45 | | |
46 | | 1024x1024 tiling |
47 | | orthoigen --chain-template chain_templates/landsat_projected_321.kwl --tiling-template tiling_templates/1024x1024.kwl --thumbnail 2048 --utm /data/p44r34/l71044034_03420000725_hrf.fst output/ |
48 | | |
49 | | SRTM 90 meter tiling |
50 | | orthoigen --geo --tiling-template tiling_templates/orthoigen_srtm_3arc.kwl /data/ele1/DTED3arc/w100/n40.dt1 output/ |
51 | | |
52 | | orthoigen --view-template view_template/utm_8.kwl /data/sanfran_ccf/foo.ccf output/utm8.jpg --thumbnail 1024 |
53 | | |
54 | | orthoigen |
55 | | Usage: |
56 | | Options: |
57 | | --chain-template Specify an external file that contains chain informatio |
58 | | --combiner-template Specify an external file that contains combiner |
59 | | information |
60 | | --combiner-type Specify what mosaic to use, ossimImageMosiac or |
61 | | ossimFeatherMosaic or osimBlendMosaic ... etc |
62 | | --disable-elev Will disable the elevation |
63 | | --disable-notify Takes an argument. Arguments are ALL, WARN, NOTICE, INF |
64 | | FATAL, DEBUG. If you want multiple disables then just |
65 | | multiple --disable-notify on the command line. All |
66 | | argument are case insensitive. Default is all are |
67 | | enabled. |
68 | | --geo Defaults to a geographic image chain with GSD = to the |
69 | | input. Origin of latitude is on the equator. |
70 | | --geo-scaled Takes a latitude as an argument for purpose of scaling. |
71 | | Specifies that no spec file was defined. Defaults to a |
72 | | scaled geographic image chain with GSD = to the input. |
73 | | --input-proj Makes the view equal to the input. If more than one fi |
74 | | then the first is taken |
75 | | --meters Specifies an override for the meters per pixel |
76 | | --ossim-logfile takes a logfile as an argument. All output messages ar |
77 | | redirected to the specified log file. By default there |
78 | | is no log file and all messages are enabled. |
79 | | --resample-type Specify what resampler to use, nearest neighbor, |
80 | | bilinear, bicubic |
81 | | --slave-buffers number of slave tile buffers for mpi processing (defaul |
82 | | = 2) |
83 | | --tiling-template Specify an external file that contains tiling informati |
84 | | --utm Defaults to a utm image chain with GSD = to the input |
85 | | --view-template Specify an external file that contains view information |
86 | | --writer-template Specify an external file that contains tiling informati |
87 | | -K specify individual keywords to add to the preferences |
88 | | keyword list: name=value |
89 | | -P specify a preference file to load |
90 | | -T specify the classes to trace, ex: ossimInit|ossimImage. |
91 | | will trace ossimInit and all ossimImage classes |
92 | | -h or --help Display this information |
93 | | -t or --thumbnail thumbnail resolution |
94 | | }}} |
| 68 | }}} |
| 69 | |
| 70 | |
| 71 | |
| 72 | == Examples == |
| 73 | * ossim-orthoigen --geo -t 512 <sourceFile> <sourceFile_tn>[[BR]] |
| 74 | ''creates an image in geographic projection that is at most 512 pixels on a side (output is tif) - used for thumbnail generation.'' |
| 75 | |
| 76 | * ossim-orthoigen --geo -t 512 --enable-entry-decoding <sourceFile>|<entryNumber> <sourceFile_tn>[[BR]] |
| 77 | ''same as above but used to make a thumbnail for a specific entry in an RPF set.'' |
| 78 | |
| 79 | * ossim-orthoigen <sourceFile>|<band order> <outputFile>[[BR]] |
| 80 | ''creates an image using the specified band order - e.g entering 2,4,6 will create an image using bands 2 4 & 6.'' |
| 81 | |
| 82 | * ossim-orthoigen --writer-prop FORMAT=<format> <sourceFile> <outputFile.kml or kmz>[[BR]] |
| 83 | ''creates a super overlay used by Google Earth.''[[BR]] |
| 84 | ''If no format is specified the default is JPG. Otherwise user can specify "PNG".''[[BR]] |
| 85 | ''keys off file extension - kml or kmz.'' |
| 86 | |
| 87 | * ossim-orthoigen <srcFile> <outputFile>[[BR]] |
| 88 | ''creates a product using the passed in src file.'' |
| 89 | |
| 90 | * ossim-orthoigen --srs <<outputFrame/Projection> <sourceFile> <outputFile>[[BR]] |
| 91 | ''creates a product that specifies an output reference frame/projection'' ''(e.g. "--srs EPSG:4326")'' [[BR]] |
| 92 | |
| 93 | * ossim-orthoigen.exe --cut-bbox-ll <minLat> <minLon> <maxLat> <maxLon> --enable-entry-decoding <"sourceFile|0|1,2,3"> <outputFile> [[BR]] |
| 94 | ''creates a product from image0 that uses bands 1, 2, and 3. Also specifies the bounding box coordinates of the source AOI'' |
| 95 | |
| 96 | * ossim-orthoigen --hist-std-stretch <standardDeviation> <sourceFile> <outputFile> [[BR]] |
| 97 | ''perform a linear contrast stretch using a standard deviation (1, 2, or 3 std deviations).'' |
| 98 | |
| 99 | * orthoigen /data/sanfran_ccf/foo.ccf /data/sanfran_map/sanfran_map.tif output/blend.jpg --combiner-type ossimBlendMosaic -t 512 --utm |
| 100 | ''BLEND thumbnail'' |
| 101 | |
| 102 | * orthoigen --chain-template chain_templates/landsat_projected_321.kwl --tiling-template tiling_templates/1024x1024.kwl --thumbnail 2048 --utm /data/p44r34/l71044034_03420000725_hrf.fst output/ |
| 103 | ''1024x1024 tiling'' |
| 104 | |
| 105 | * orthoigen --geo --tiling-template tiling_templates/orthoigen_srtm_3arc.kwl /data/ele1/DTED3arc/w100/n40.dt1 output/ |
| 106 | ''SRTM 90 meter tiling'' |
| 107 | |
| 108 | * orthoigen --view-template view_template/utm_8.kwl /data/sanfran_ccf/foo.ccf output/utm8.jpg --thumbnail 1024 |
| 109 | |
| 110 | |
| 111 | == Options == |
| 112 | {{{ |
| 113 | --annotate annotation keyword list |
| 114 | --chain-template Specify an external file that contains |
| 115 | chain information |
| 116 | --clip-to-valid-rect <true|false> When true, any requested cut rect is |
| 117 | clipped by the valid image bounding |
| 118 | rect to minimize null border pixels. |
| 119 | If false, the output will correspond |
| 120 | to the cut rect as close as possible |
| 121 | given the product projection. This |
| 122 | option overrides the ossim_preferences |
| 123 | setting. If no cut options are |
| 124 | supplied, this option is ignored. |
| 125 | --combiner-template Specify an external file that contains |
| 126 | combiner information |
| 127 | --combiner-type Specify what mosaic to use, |
| 128 | ossimImageMosiac or ossimFeatherMosaic |
| 129 | or osimBlendMosaic ... etc |
| 130 | --cut-bbox-en Specify the min easting, min northing, |
| 131 | max easting, max northing |
| 132 | --cut-bbox-ll Specify the min lat and min lon and |
| 133 | max lat and maxlon <minLat> <minLon> |
| 134 | <maxLat> <maxLon> |
| 135 | --cut-center-ll Specify the center cut in lat lon |
| 136 | space. Takes two argument <lat> <lon> |
| 137 | --cut-pixel-width-height Specify cut box's width and height in |
| 138 | pixels |
| 139 | --cut-radius-meters Specify the cut distance in meters. A |
| 140 | bounding box for the cut will be |
| 141 | produced |
| 142 | --disable-elev Will disable the elevation |
| 143 | --disable-notify Takes an argument. Arguments are ALL, |
| 144 | WARN, NOTICE, INFO, FATAL, DEBUG. If |
| 145 | you want multiple disables then just |
| 146 | do multiple --disable-notify on the |
| 147 | command line. All argument are case |
| 148 | insensitive. Default is all are |
| 149 | enabled. |
| 150 | --disable-plugin Will disable the plugin loader |
| 151 | --enable-entry-decoding A filename can be separated by a | and |
| 152 | a number (NO space). |
| 153 | Example: a.toc|0 will do entry 0 of |
| 154 | a.toc file and on unix you might want |
| 155 | to use a \ since |
| 156 | the separator is a pipe sign. Example: |
| 157 | ./a.toc\|0 will do entry 0 of a.toc. |
| 158 | --geo Defaults to a geographic image chain |
| 159 | with GSD = to the input. Origin of |
| 160 | latitude ison the equator. |
| 161 | --geo-scaled Takes a latitude as an argument for |
| 162 | purpose of scaling. Specifies that no |
| 163 | spec file was defined. Defaults to a |
| 164 | scaled geographic image chain with GSD |
| 165 | = to the input. |
| 166 | --hist-auto-minmax uses the automatic search for the best |
| 167 | min and max clip values. Incompatible |
| 168 | with other histogram options. |
| 169 | --hist-match Takes one image filename argument for |
| 170 | target histogram to match. |
| 171 | Incompatible with other histogram |
| 172 | options. |
| 173 | --hist-std-stretch Specify histogram stretch as a |
| 174 | standard deviation from the mean as |
| 175 | <int>, where <int> is 1, 2, or 3. |
| 176 | Incompatible with other histogram |
| 177 | options. |
| 178 | --hist-stretch Specify in normalized percent the low |
| 179 | clip and then the high clip value as |
| 180 | <low.dd> <hi.dd>. Incompatible with |
| 181 | other histogram options. |
| 182 | --input-proj Makes the view equal to the input. If |
| 183 | more than one file then the first is |
| 184 | taken |
| 185 | --mask Specify the ESRI shape file with |
| 186 | polygons to clip the image |
| 187 | --meters Specifies an override for the meters |
| 188 | per pixel. Takes a single value |
| 189 | applied equally to x and y directions. |
| 190 | --meters-xy Specifies an override for the |
| 191 | meters-per-pixel. Takes two values <x> |
| 192 | <y> |
| 193 | --ossim-logfile takes a logfile as an argument. All |
| 194 | output messages are redirected to the |
| 195 | specified log file. By default there |
| 196 | is no log file and all messages are |
| 197 | enabled. |
| 198 | --resample-type Specify what resampler to use, nearest |
| 199 | neighbor, bilinear, cubic |
| 200 | --scale-to-8-bit Scales output to eight bits if not |
| 201 | already. |
| 202 | --slave-buffers number of slave tile buffers for mpi |
| 203 | processing (default = 2) |
| 204 | --srs specify an output reference |
| 205 | frame/projection. Example: --srs |
| 206 | EPSG:4326 |
| 207 | --stdout Output the image to standard out. |
| 208 | This will return an error if writer |
| 209 | does not support writing to standard |
| 210 | out. Callers should combine this with |
| 211 | the --ossim-logfile option to ensure |
| 212 | output image stream does not get |
| 213 | corrupted. You must still pass an |
| 214 | output file so the writer type can be |
| 215 | determined like "dummy.png". |
| 216 | --supplementary-directory or --support Specify the supplementary directory |
| 217 | path where overviews, histograms and |
| 218 | external geometries are located |
| 219 | --tiling-template Specify an external file that contains |
| 220 | tiling information |
| 221 | --utm Defaults to a utm image chain with GSD |
| 222 | = to the input |
| 223 | --view-template Specify an external file that contains |
| 224 | view information |
| 225 | --wkt specify an output reference |
| 226 | frame/projection that is in a wkt |
| 227 | format. Must have the |
| 228 | ossimgdal_plugin compiled |
| 229 | --writer-prop Passes a name=value pair to the writer |
| 230 | for setting it's property. Any number |
| 231 | of these can appear on the line. |
| 232 | --writer-template Specify an external file that contains |
| 233 | tiling information |
| 234 | -K specify individual keywords to add to |
| 235 | the preferences keyword list: |
| 236 | name=value |
| 237 | -P specify a preference file to load |
| 238 | -T specify the classes to trace, ex: |
| 239 | ossimInit|ossimImage.* |
| 240 | will trace ossimInit and all |
| 241 | ossimImage classes |
| 242 | -V or --version Display version information. |
| 243 | -h or --help Display this information |
| 244 | -t or --thumbnail thumbnail size |
| 245 | -w or --writer Specifies the output writer. Default |
| 246 | uses output file extension to |
| 247 | determine writer. |
| 248 | |
| 249 | }}} |