{"id":248,"date":"2009-02-06T07:00:12","date_gmt":"2009-02-06T12:00:12","guid":{"rendered":"https:\/\/blogs.mathworks.com\/steve\/2009\/02\/06\/consider-multibandread-for-reading-your-data\/"},"modified":"2019-10-28T15:25:53","modified_gmt":"2019-10-28T19:25:53","slug":"consider-multibandread-for-reading-your-data","status":"publish","type":"post","link":"https:\/\/blogs.mathworks.com\/steve\/2009\/02\/06\/consider-multibandread-for-reading-your-data\/","title":{"rendered":"Consider multibandread for reading your data"},"content":{"rendered":"
\r\n

I've seen several situations recently in which a user couldn't figure out how to get their data into MATLAB, and it turned\r\n out that the data was in a form that could be handled by the MATLAB function multibandread<\/tt><\/a>. So I have a feeling that not enough people know about this useful function.\r\n <\/p>\r\n

There are a lot of relatively simple gridded data file formats in use that follow a common pattern: the format has a fixed-length\r\n header, followed immediately by all the data values, in some defined order. Sometimes the data has multiple bands, in which\r\n case there is some variation from format to format in the ordering of band values in the file. This is the perfect scenario\r\n for using multibandread<\/tt>.\r\n <\/p>\r\n

You can tell multibandread<\/tt> the header size, the data-value precision, the byte order, and how the bands are arranged, and then multibandread<\/tt> can read any band, or all of them, or even a subset of a band.\r\n <\/p>\r\n

Here's an example. The Image Processing Toolbox ships with a few sample .lan files, which are Landsat Thematic Mapper images\r\n in Erdas LAN format. The file paris.lan contains a 7-band 512-by-512 Landsat image. A 128-byte header is followed by the pixel\r\n values, which are band interleaved by line (BIL) in order of increasing band number. They are stored as unsigned 8-bit integers.\r\n The following command reads in bands 4, 3, and 2 from the file.\r\n <\/p>

CIR = multibandread('paris.lan'<\/span>, [512, 512, 7], 'uint8=>uint8'<\/span>,...<\/span>\r\n                    128, 'bil'<\/span>, 'ieee-le'<\/span>, {'Band'<\/span>,'Direct'<\/span>,[4 3 2]});\r\nimshow(CIR)\r\nxlabel('Image courtesy of Space Imaging, LLC'<\/span>)<\/pre> 
And for no extra charge, I'll toss in a quick demo of decorrstretch<\/tt> (decorrelation stretch) from the Image Processing Toolbox.\r\n   <\/p>
decorrCIR = decorrstretch(CIR, 'Tol'<\/span>, 0.01);\r\nimshow(decorrCIR)<\/pre> 
The examples above are from the \"Finding Vegetation in a Multispectral Image\" example<\/a> in the Image Processing Toolbox.\r\n   <\/p>\r\n   
Give multibandread<\/tt> a try. You might find it to be just what you need.\r\n   <\/p>