Changes between Version 1 and Version 2 of orthoigen


Ignore:
Timestamp:
Oct 14, 2010, 1:51:14 PM (14 years ago)
Author:
pborissow
Comment:

Initial commit

Legend:

Unmodified
Added
Removed
Modified

  • orthoigen

    v1 v2  
    11= orthoigen =
    22
    3 Orthorectifies an image and is built on top of igen.  It is better suited for scripting as many settings can be passed in as parameters and it supports but doesn’t require a keyword list.
    4 For orthoigen you must at a minimum specify an input and an output.  This would actually be equivalent to an image copy.
    5 Currently the ouptut writer type is specified by the extension of the filename.  In most cases you will also be specifying a
    6 view.
    7 
    8 {{{
    9 SIMPLE
    10 
    11 orthoigen <input> <output>
    12 
    13 Assume we have input foo.tif  and we wish to convert it to foo.jpg:
    14 
    15 orthoigen foo.tif foo.jpg
    16 
    17 
    18 
    19 PROJECTION
    20 
     3orthoigen is a command line application used to orthorectify, mosaic, and convert raster data between different formats. It provides a number of operations including subsetting, resampling, histogram matching, and reprojection of data. orthoigen is built on top of igen but it doesn't require a keyword list.
     4
     5
     6== Usage ==
     7{{{
     8ossim-orthoigen [options] <sourceFiles> <outputFile>
     9}}}
     10
     11For 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{{{
     13ossim-orthoigen C:\input.tif D:\output.jpg
     14}}}
     15
     16Users can specify multiple input files like this:
     17{{{
     18ossim-orthoigen C:\input.tif C:\input2.tif C:\input3.tif D:\output.jpg
     19}}}
     20
     21Alternatively, you can pass in a text file with a ".src" extension with a list of file paths separated by a newline. Example:
     22{{{
     23ossim-orthoigen image.src output.ntf
     24}}}
     25
     26The corresponding image.src file would be as simple as this:
     27{{{
     28image0.file: C:\input1.tif
     29image1.file: C:\input2.tif
     30image2.file: C:\input3.tif
     31}}}
     32
     33
     34
     35== Output Format ==
     36By 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{{{
     38ossim-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 ==
     43orthoigen 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{{{
     47orthoigen --srs EPSG:26912 <input files> <output>
     48}}}
     49 * '''geo''': Sets the output projection to WGS84. This is identical to "--srs EPSG:4326". Example:
     50{{{
     51orthoigen --geo <input files> <output>
     52}}}
     53 * Other methods:
     54{{{
    2155orthoigen --utm <input files> <output>
    22 orthoigen --geo <input files> <output>
    2356orthoigen --geo-scaled <latitude> <input files> <output>
    2457orthoigen --input-proj <input files> <output>
    25 
    2658orthoigen --view-template view_template/utm_8.kwl <input files> <output>
    27 
    28 
    29 TILING_TEMPLATE
     59}}}
     60
     61
     62== Tiling Template ==
    3063
    3164For now we have to enable a view when tiling
    3265
     66{{{
    3367orthoigen --utm --tiling-template <template> <input files> <output>
    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}}}