11 | | For orthoigen you must at a minimum specify an input and an output file. This would actually be equivalent to an image copy. Currently the output writer type is specified by the extension of the output file. Example: |
12 | | {{{ |
13 | | ossim-orthoigen C:\input.tif D:\output.jpg |
14 | | }}} |
15 | | |
16 | | Users can specify multiple input files like this: |
17 | | {{{ |
18 | | ossim-orthoigen C:\input.tif C:\input2.tif C:\input3.tif D:\output.jpg |
19 | | }}} |
20 | | |
21 | | Alternatively, you can pass in a text file with a ".src" extension with a list of file paths separated by a newline. Example: |
22 | | {{{ |
23 | | ossim-orthoigen image.src output.ntf |
24 | | }}} |
25 | | |
26 | | The corresponding image.src file would be as simple as this: |
27 | | {{{ |
28 | | image0.file: C:\input1.tif |
29 | | image1.file: C:\input2.tif |
30 | | image2.file: C:\input3.tif |
31 | | }}} |
32 | | |
33 | | |
34 | | |
35 | | == Output Format == |
36 | | By default, the output writer type is determined by the extension of the output file. You can specify a specific writer to use via the -w argument. Example: |
37 | | {{{ |
38 | | ossim-orthoigen -w ossim_kakadu_jp2 --writer-prop threads=4 --writer-prop compression_quality=visually_lossless --srs EPSG:4326 N10-E024.tif N10-E024.jp2 |
39 | | }}} |
40 | | |
41 | | |
42 | | == Output Projection == |
43 | | orthoigen provides users several options for defining the output projection. The options are summarized below. If none of these options are used, orthoigen will default to the projection of the input file. If multiple input files are supplied, orthoigen will use the projection of the first image in the image chain. |
44 | | |
45 | | * '''srs''': Allows users to specify a PCS or EPSG code for the output image. For example, to set the output projection to NAD83/UTM zone 12N, specify the following: |
46 | | {{{ |
47 | | orthoigen --srs EPSG:26912 <input files> <output> |
48 | | }}} |
49 | | * '''geo''': Sets the output projection to WGS84. This is identical to "--srs EPSG:4326". Example: |
50 | | {{{ |
51 | | orthoigen --geo <input files> <output> |
52 | | }}} |
53 | | * Other methods: |
54 | | {{{ |
55 | | orthoigen --utm <input files> <output> |
56 | | orthoigen --geo-scaled <latitude> <input files> <output> |
57 | | orthoigen --input-proj <input files> <output> |
58 | | orthoigen --view-template view_template/utm_8.kwl <input files> <output> |
59 | | }}} |
60 | | |
61 | | |
62 | | == Tiling Template == |
63 | | |
64 | | For now we have to enable a view when tiling |
65 | | |
66 | | {{{ |
67 | | orthoigen --utm --tiling-template <template> <input files> <output> |
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 |
| 152 | |
| 153 | |
| 154 | |
| 155 | == Input Files == |
| 156 | |
| 157 | For orthoigen you must at a minimum specify an input and an output file. This would actually be equivalent to an image copy. Currently the output writer type is specified by the extension of the output file. Example: |
| 158 | {{{ |
| 159 | ossim-orthoigen C:\input.tif D:\output.jpg |
| 160 | }}} |
| 161 | |
| 162 | Users can specify multiple input files like this: |
| 163 | {{{ |
| 164 | ossim-orthoigen C:\input.tif C:\input2.tif C:\input3.tif D:\output.jpg |
| 165 | }}} |
| 166 | |
| 167 | Alternatively, you can pass in a text file with a ".src" extension with a list of file paths separated by a newline. Example: |
| 168 | {{{ |
| 169 | ossim-orthoigen image.src output.ntf |
| 170 | }}} |
| 171 | |
| 172 | The corresponding image.src file would be as simple as this: |
| 173 | {{{ |
| 174 | image0.file: C:\input1.tif |
| 175 | image1.file: C:\input2.tif |
| 176 | image2.file: C:\input3.tif |
| 177 | }}} |
| 178 | |
| 179 | |
| 180 | |
| 181 | == Output Format == |
| 182 | By default, the output writer type is determined by the extension of the output file. You can specify a specific writer to use via the -w argument. Example: |
| 183 | {{{ |
| 184 | ossim-orthoigen -w ossim_kakadu_jp2 --writer-prop threads=4 --writer-prop compression_quality=visually_lossless --srs EPSG:4326 N10-E024.tif N10-E024.jp2 |
| 185 | }}} |
| 186 | |
| 187 | |
| 188 | == Output Projection == |
| 189 | orthoigen provides users several options for defining the output projection. The options are summarized below. If none of these options are used, orthoigen will default to the projection of the input file. If multiple input files are supplied, orthoigen will use the projection of the first image in the image chain. |
| 190 | |
| 191 | * '''srs''': Allows users to specify a PCS or EPSG code for the output image. For example, to set the output projection to NAD83/UTM zone 12N, specify the following: |
| 192 | {{{ |
| 193 | orthoigen --srs EPSG:26912 <input files> <output> |
| 194 | }}} |
| 195 | * '''geo''': Sets the output projection to WGS84. This is identical to "--srs EPSG:4326". Example: |
| 196 | {{{ |
| 197 | orthoigen --geo <input files> <output> |
| 198 | }}} |
| 199 | * Other methods: |
| 200 | {{{ |
| 201 | orthoigen --utm <input files> <output> |
| 202 | orthoigen --geo-scaled <latitude> <input files> <output> |
| 203 | orthoigen --input-proj <input files> <output> |
| 204 | orthoigen --view-template view_template/utm_8.kwl <input files> <output> |
| 205 | }}} |
| 206 | |
| 207 | |
| 208 | == Tiling Template == |
| 209 | |
| 210 | For now we have to enable a view when tiling |
| 211 | |
| 212 | {{{ |
| 213 | orthoigen --utm --tiling-template <template> <input files> <output> |
| 214 | }}} |
| 215 | |
| 216 | |
| 217 | |
| 218 | == Examples == |
| 219 | * ossim-orthoigen --geo -t 512 <sourceFile> <sourceFile_tn>[[BR]] |
| 220 | ''creates an image in geographic projection that is at most 512 pixels on a side (output is tif) - used for thumbnail generation.'' |
| 221 | |
| 222 | * ossim-orthoigen --geo -t 512 --enable-entry-decoding <sourceFile>|<entryNumber> <sourceFile_tn>[[BR]] |
| 223 | ''same as above but used to make a thumbnail for a specific entry in an RPF set.'' |
| 224 | |
| 225 | * ossim-orthoigen <sourceFile>|<band order> <outputFile>[[BR]] |
| 226 | ''creates an image using the specified band order - e.g entering 2,4,6 will create an image using bands 2 4 & 6.'' |
| 227 | |
| 228 | * ossim-orthoigen --writer-prop FORMAT=<format> <sourceFile> <outputFile.kml or kmz>[[BR]] |
| 229 | ''creates a super overlay used by Google Earth.''[[BR]] |
| 230 | ''If no format is specified the default is JPG. Otherwise user can specify "PNG".''[[BR]] |
| 231 | ''keys off file extension - kml or kmz.'' |
| 232 | |
| 233 | * ossim-orthoigen <srcFile> <outputFile>[[BR]] |
| 234 | ''creates a product using the passed in src file.'' |
| 235 | |
| 236 | * ossim-orthoigen --srs <<outputFrame/Projection> <sourceFile> <outputFile>[[BR]] |
| 237 | ''creates a product that specifies an output reference frame/projection'' ''(e.g. "--srs EPSG:4326")'' [[BR]] |
| 238 | |
| 239 | * ossim-orthoigen.exe --cut-bbox-ll <minLat> <minLon> <maxLat> <maxLon> --enable-entry-decoding <"sourceFile|0|1,2,3"> <outputFile> [[BR]] |
| 240 | ''creates a product from image0 that uses bands 1, 2, and 3. Also specifies the bounding box coordinates of the source AOI'' |
| 241 | |
| 242 | * ossim-orthoigen --hist-std-stretch <standardDeviation> <sourceFile> <outputFile> [[BR]] |
| 243 | ''perform a linear contrast stretch using a standard deviation (1, 2, or 3 std deviations).'' |
| 244 | |
| 245 | * orthoigen /data/sanfran_ccf/foo.ccf /data/sanfran_map/sanfran_map.tif output/blend.jpg --combiner-type ossimBlendMosaic -t 512 --utm |
| 246 | ''BLEND thumbnail'' |
| 247 | |
| 248 | * 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/ |
| 249 | ''1024x1024 tiling'' |
| 250 | |
| 251 | * orthoigen --geo --tiling-template tiling_templates/orthoigen_srtm_3arc.kwl /data/ele1/DTED3arc/w100/n40.dt1 output/ |
| 252 | ''SRTM 90 meter tiling'' |
| 253 | |
| 254 | * orthoigen --view-template view_template/utm_8.kwl /data/sanfran_ccf/foo.ccf output/utm8.jpg --thumbnail 1024 |