|MATLAB Function Reference|
Write multiband data to a file
data, a two- or three-dimensional numeric or logical array, to the binary file specified by
filename. The length of the third dimension of
data determines the number of bands written to the file. The bands are written to the file in the form specified by
interleave. See Interleave Methods for more information about this argument.
If filename already exists,
multibandwrite overwrites it unless you specify the optional
offset parameter. See the last alternate syntax for
multibandwrite for information about other optional parameters.
data to the binary file,
filename, in chunks. In this syntax,
data is a subset of the complete data set.
start is a 1-by-3 array
[firstrow firstcolumn firstband] that specifies the location to start writing data.
firstcolumn specify the location of the upper left image pixel.
firstband gives the index of the first band to write. For example,
data(I,J,K) contains the data for the pixel at [
firstrow+I-1, firstcolumn+J-1] in the
totalsize is a 1-by-3 array,
[totalrows,totalcolumns,totalbands], which specifies the full, three-dimensional size of the data to be written to the file.
In this syntax, you must call |
writes the multiband data to a file, specifying any of these optional parameter/value pairs.
||A string specifying the form and size of each element written to the file. See the help for
||The number of bytes to skip before the first data element. If the file does not already exist,
This option is useful when writing a header to the file before or after writing the data. When writing the header to the file after the data is written, open the file with
||A string to control the format in which the data is written to the file. Typical values are
||A number specifying the value to use in place of missing data.
interleave is a string that specifies how
multibandwrite interleaves the bands as it writes data to the file. If
data is two-dimensional, multibandwrite ignores the
interleave argument. The following table lists the supported methods and uses this example multiband file to illustrate each method.
Supported methods of interleaving bands include those listed below.
||Write an entire row from each band
||Write a pixel from each band
||Write each band in its entirety
In this example, all the data is written to the file with one function call. The bands are interleaved by line.
This example uses
multibandwrite in a loop to write each band to a file separately.
In this example, only a subset of each band is available for each call to
multibandwrite. For example, an entire data set may have three bands with 1024-by-1024 pixels each (a 1024-by-1024-by-3 matrix). Only 128-by-128 chunks are available to be written to the file with each call to