= band_merge =

Merges multiple image files into a single band merged file.

== Usage ==
{{{
band_merge [-h][-o][-w tile_width] <output_type> <input_file1> <input_file2> ... <output_file>
}}}

== Options ==
{{{
  --disable-elev    Will disable the elevation
  --disable-notify  Takes an argument. Arguments are ALL, WARN, NOTICE,
                          INFO, FATAL, DEBUG.  If you want multiple disables
                          then just do multiple --disable-notify on the command
                          line.  All argument are case insensitive.  Default is
                          all are enabled.
  --ossim-logfile         takes a logfile as an argument.  All output messages
                          are redirected to the specified log file.  By default
                          there is no log file and all messages are enabled.
  -K                     specify individual keywords to add to the preferences
                          keyword list: name=value
  -P                     specify a preference file to load
  -T                     specify the classes to trace, ex:
                          ossimInit|ossimImage.* 
                          will trace ossimInit and all ossimImage classes
  -h or --help       Display this information
  -o or --create-overiew  Creates and overview for the output image
  -w or --tile-width      Defines the tile width for the handlers that support
                          tiled output
}}}

{{{
NOTES:
"-w" option only valid with tiff type.
"Tile width must be a multiple of 32.
Valid output writer types:
        tiff_strip
        tiff_strip_band_separate
        tiff_tiled
        tiff_tiled_band_separate
        general_raster_bip
        general_raster_bil
        general_raster_bsq
        jpeg
}}}


This is a "how to" on using ossim-band-merge command line application to merge image files that represent individual bands into a single file.

Prerequisite: Typically all images have the same dimensions and are relative to the same projection.

Given you have band1.tif, band2.tif and band3.tif you can do:

ossim-band-merge tiff_tiled_band_separate band1.tif band2.tif band3.tif rgb.tif

Where "tiff_tiled_band_separate" is the output file type. You can do: ossim-band-merge by itself to get the usage with valid output image types.

NOTE: The ossim library likes "tiled" image types as ossim is tiled in nature. So if you are going to feed the output file to another ossim application you should choose a tiled output format for speed.