Information about geospatial raster data file
RasterInfo
objects contain information about geographic or
projected raster data files, such as their file format, their native data type, and how they
represent missing data.
Create a RasterInfo
object using georasterinfo
.
Filename
— Path to data filestring
arrayThis property is read-only.
Path to data file and any supporting files, returned as a string
array.
Data Types: string
FileModifiedDate
— Modification date of filesdatetime
arrayThis property is read-only.
Modification date of the data file and any supporting files, returned as a
datetime
array. The order of modification dates in
FileModifiedDate
corresponds to the order of files in
Filename
.
Data Types: datetime
FileSize
— File sizeThis property is read-only.
File size of the data file and any supporting files, returned as an array. The order
of file sizes in FileSize
corresponds to the order of files in
Filename
.
Data Types: double
FileFormat
— File format namestring
scalarThis property is read-only.
File format name, returned as a string
scalar. For a list of
supported file formats, see georasterinfo
.
Data Types: string
RasterSize
— Dimensions of raster dataThis property is read-only.
Dimensions of the raster data embedded in the file, returned as a two-element
vector, [m n]
, where m
is the number of rows and
n
is the number of columns.
Data Types: double
NumBands
— Number of bandsThis property is read-only.
Number of bands, returned as a positive integer.
When you read raster data using the readgeoraster
function, the array it returns is of size
M-by-N-by-P, where
P is the value of NumBands
.
Data Types: double
NativeFormat
— Data type embedded in filestring
scalarThis property is read-only.
Data type of the data embedded in the file, returned as a string
scalar. To read data using a different data type, call readgeoraster
and specify the 'OutputType'
name-value pair.
Data Types: string
MissingDataIndicator
— Value indicating missing dataThis property is read-only.
Value indicating missing data, returned as an integer. You can replace missing data
with NaN
values using the standardizeMissing
function.
[A,R] = readgeoraster('MtWashington-ft.grd'); info = georasterinfo('MtWashington-ft.grd'); m = info.MissingDataIndicator; A = standardizeMissing(A,m);
Data Types: double
Categories
— Category namesstring
arrayThis property is read-only.
Category names, returned as a string
array.
The value of Categories
may be empty, even when the data is
grouped into categories.
Data Types: string
ColorType
— Color type of image'indexed'
| 'grayscale'
| 'truecolor'
| 'CMYK'
| 'HSL'
| 'unknown'
This property is read-only.
Color type of image, returned as one of these values:
'indexed'
– Indexed image.
'grayscale'
– Grayscale intensity image.
'truecolor'
– True color image using RGB color
space.
'CMYK'
– Image using CMYK color space.
'HSL'
– Image using HSL color space.
'unknown'
– Unknown color type, or raster data does not
represent an image.
Data Types: string
Colormap
— ColormapThis property is read-only.
Colormap associated with an indexed image, returned as a n-by-3
matrix with values in the range [0,1]. Each row of Colormap
is a
three-element RGB triplet that specifies the red, green, and blue components of a single
color of the colormap. The value of Colormap
is empty unless the
value of ColorType
is 'indexed'
.
Data Types: double
RasterReference
— Spatial referenceGeographicCellsReference
object | GeographicPostingsReference
object | MapCellsReference
object | MapPostingsReference
objectThis property is read-only.
Spatial reference for the raster data, returned as a GeographicCellsReference
object, GeographicPostingsReference
object, MapCellsReference
object, or MapPostingsReference
object. The value of
RasterReference
depends on the raster data contained in the file:
If the raster data is referenced to a geographic coordinate system, then
RasterReference
is a
GeographicCellsReference
object or
GeographicPostingsReference
object.
If the raster data is referenced to a projected coordinate system, then
RasterReference
is a MapCellsReference
object or MapPostingsReference
object.
If the file does not contain enough information to determine whether the data is
projected or geographic, then RasterReference
is a
MapCellsReference
or MapPostingsReference
object. If
a file contains no valid spatial reference information, then
RasterReference
is empty.
Regardless of the file format, the ColumnsStartFrom
property of
the reference object returned by RasterReference
has a value of
'north'
.
CoordinateReferenceSystem
— Coordinate reference system[]
(default) | projcrs
object | geocrs
objectThis property is read-only.
Coordinate reference system (CRS), returned as a geocrs
or
projcrs
object.
The value of CoordinateReferenceSystem
depends on the raster data
contained in the file:
If the raster data is referenced to a geographic coordinate system, then
CoordinateReferenceSystem
is a geocrs
object.
If the raster data is referenced to a projected coordinate system, then
CoordinateReferenceSystem
is a projcrs
object.
If the file does not contain valid coordinate reference system information, then
CoordinateReferenceSystem
is empty.
Metadata
— Metadatastruct
This property is read-only.
Metadata, returned as a struct
of additional information that is
specific to the data file. Each field of Metadata
is returned as a
string. The formatting of field names and values is dependent on the data contained in
the file.
This property only applies to file formats that have metadata. For example, DTED files may contain metadata such as the datum, coordinates of the data origin, and absolute accuracy.
Get information about a GeoTIFF image by creating a RasterInfo
object. Find the native data type embedded in the file by accessing the NativeFormat
property of the RasterInfo
object.
info = georasterinfo('boston.tif');
info.NativeFormat
ans = "uint8"
The data used in this example includes material copyrighted by GeoEye, all rights reserved.
You have a modified version of this example. Do you want to open this example with your edits?