Changes between Version 2 and Version 3 of orthoigen


Ignore:
Timestamp:
Oct 14, 2010, 3:22:37 PM (14 years ago)
Author:
pborissow
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • orthoigen

    v2 v3  
    99}}}
    1010
    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
    10911
    11012
     
    248150
    249151}}}
     152
     153
     154
     155== Input Files ==
     156
     157For 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{{{
     159ossim-orthoigen C:\input.tif D:\output.jpg
     160}}}
     161
     162Users can specify multiple input files like this:
     163{{{
     164ossim-orthoigen C:\input.tif C:\input2.tif C:\input3.tif D:\output.jpg
     165}}}
     166
     167Alternatively, you can pass in a text file with a ".src" extension with a list of file paths separated by a newline. Example:
     168{{{
     169ossim-orthoigen image.src output.ntf
     170}}}
     171
     172The corresponding image.src file would be as simple as this:
     173{{{
     174image0.file: C:\input1.tif
     175image1.file: C:\input2.tif
     176image2.file: C:\input3.tif
     177}}}
     178
     179
     180
     181== Output Format ==
     182By 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{{{
     184ossim-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 ==
     189orthoigen 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{{{
     193orthoigen --srs EPSG:26912 <input files> <output>
     194}}}
     195 * '''geo''': Sets the output projection to WGS84. This is identical to "--srs EPSG:4326". Example:
     196{{{
     197orthoigen --geo <input files> <output>
     198}}}
     199 * Other methods:
     200{{{
     201orthoigen --utm <input files> <output>
     202orthoigen --geo-scaled <latitude> <input files> <output>
     203orthoigen --input-proj <input files> <output>
     204orthoigen --view-template view_template/utm_8.kwl <input files> <output>
     205}}}
     206
     207
     208== Tiling Template ==
     209
     210For now we have to enable a view when tiling
     211
     212{{{
     213orthoigen --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