readgeoraster

Чтение геопространственных растровых файлов данных

Описание

пример

[A,R] = readgeoraster(filename) создает массив путем считывания географических или проективных растровых данных из файла. Выходной аргумент R содержит пространственную ссылочную информацию для массива. Поддерживаемые форматы файлов включают Esri Binary Grid, Esri GridFloat, GeoTIFF и DTED. Полный список поддерживаемых форматов см. в Поддерживаемые Форматы и Расширения.

пример

[A,R] = readgeoraster(___,Name,Value) задает опции с использованием одного или нескольких Name,Value аргументы в виде пар.

пример

[___,cmap] = readgeoraster(___) также возвращает палитру A.

Примеры

свернуть все

Считайте изображение Бостона в GeoTIFF как массив и карту камер справочного объекта. Массив имеет размер 2881 на 4481 на 3 и задает красные, зеленые и синие компоненты изображения. Отобразите изображение с помощью mapshow функция.

[A,R] = readgeoraster('boston.tif');
mapshow(A,R)

Данные, используемые в этом примере, включают материал, защищенный авторским правом Геоглаз, все права защищены.

Прочитайте и отобразите классификацию типа поверхности Оаху, Гавайи.

Сначала считайте данные типы поверхности как массив, карту камер ссылки объект и палитру. Элементы A индекс в палитру. Каждая строка палитры определяет красный, зеленый и синий компоненты одного цвета. Затем отобразите данные типы поверхности.

[A,R,cmap] = readgeoraster('oahu_landcover.img');
mapshow(A,cmap,R)

Figure contains an axes. The axes contains an object of type image.

Данные, используемые в этом примере, предоставлены Национальным управлением океанических и атмосферных исследований (NOAA).

Считывайте и отображайте данные о повышении для области вокруг Саут-Боулдер-Пик в Колорадо.

Сначала считайте данные повышения как массив и объект ссылки географических проводок. Чтобы отобразить данные как поверхность, geoshow функция требует данных типа double или single. В этом случае сохраните точность путем определения типа выхода как 'double'.

[A,R] = readgeoraster('n39_w106_3arc_v2.dt1','OutputType','double');

Создайте карту. Во-первых, создайте оси карты путем определения пределов широты и долготы данных. Затем отобразите данные как поверхность с помощью geoshow функция. Применить палитру, подходящую для данных о повышении, используя demcmap функция.

latlim = R.LatitudeLimits;
lonlim = R.LongitudeLimits;
usamap(latlim,lonlim)
geoshow(A,R,'DisplayType','surface')
demcmap(A)

Данные по повышению, используемые в этом примере, предоставлены Геологической службой США.

Растровые наборы данных иногда указывают на отсутствующие значения данных с использованием большого отрицательного числа. Импортируйте растровые данные, найдите индикатор недостающих данных, а затем замените отсутствующие данные на NaN значения.

Импорт растровых данных и ссылочного объекта с помощью readgeoraster функция. Найдите индикатор недостающих данных с помощью georasterinfo функция.

[A,R] = readgeoraster('MtWashington-ft.grd');
info = georasterinfo('MtWashington-ft.grd');
m = info.MissingDataIndicator
m = -32766

Проверьте, что растровые данные содержат отсутствующие данные, используя ismember функция. The ismember функция возвращает логический 1 (true), если растр содержит индикатор недостающих данных.

ismember(m,A)
ans = logical
   1

Замените отсутствующие данные на NaN значения с использованием standardizeMissing функция.

A = standardizeMissing(A,m);

Входные параметры

свернуть все

Имя считываемого файла, заданное как вектор символов или строковый скаляр. Форма filename зависит от местоположения файла.

  • Если файл находится в текущей папке или в папке на MATLAB® путь затем укажите имя файла, например 'myFile.dem'.

  • Если файл находится не в текущей папке или в папке на пути MATLAB, задайте полное или относительное имя пути, например 'C:\myfolder\myFile.tif' или 'dataDir\myFile.dat'.

Список поддерживаемых форматов файлов см. в разделе Поддерживаемые форматы и расширения.

Типы данных: char | string

Аргументы в виде пар имя-значение

Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

Пример: 'OutputType','double','Bands',1:2

Тип данных для A, заданная как разделенная разделенными запятой парами, состоящая из 'OutputType' и вектор символов или строковый скаляр, содержащий одно из следующих значений: 'native', 'single', 'double', 'int16', 'int32', 'int64', 'uint8', 'uint16', 'uint32', 'uint64', или 'logical'.

Значение по умолчанию для 'OutputType' является 'native', который возвращает A использование собственного типа данных, встроенного в filename. Использование типа данных, отличного от 'native' может привести к потере точности.

Пример: 'OutputType','double'

Типы данных: char | string

Полосы для чтения, заданные как разделенная разделенными запятой парами, состоящая из 'Bands' и 'all', положительное целое число или вектор положительных целых чисел. Для примера, если вы задаете значение 3, readgeoraster считывает третью полосу в файле. Полосы данных возвращаются в указанном порядке.

Значение по умолчанию для 'Bands' является 'all', где readgeoraster считывает все полосы в файле.

Пример: 'Bands',3

Тип системы координат для R, заданное как одно из следующих значений:

  • 'auto' - Возвращает R как объект растровой привязки, определяемое содержимым файла.

  • 'geographic' - Возвращает R как географические камеры или проводки ссылки объекта.

  • 'planar' - Возвращает R как камеры карты или проводки ссылки объекта.

Задайте тип системы координат, когда данные не содержат информацию о проекции.

Пример: 'CoordinateSystemType','geographic'

Выходные аргументы

свернуть все

Изображение или сетка данных, возвращенные как числовой массив M-на-N или M-на-N-на-P.

По умолчанию тип данных A соответствует собственному типу данных, встроенному в filename. Задайте тип данных используя 'OutputType' Пара "имя-значение".

Независимо от того, как данные закодированы, первая строка A представляет самые северные данные и последнюю строку A представляет самые южные данные.

Пространственная ссылка для A, возвращается как GeographicCellsReference объект, GeographicPostingsReference объект, MapCellsReference объект, или MapPostingsReference объект. Значение R зависит от данных в filename:

  • Если данные в filename ссылается на географическую систему координат, затем R является GeographicCellsReference объект или GeographicPostingsReference объект.

  • Если данные в filename ссылка на проективную систему координат, затем R является MapCellsReference объект или MapPostingsReference объект.

Если файл не содержит достаточной информации, чтобы определить, являются ли данные проективными или географическими, то R является MapCellsReference или MapPostingsReference объект. Если файл не содержит действительной пространственной справочной информации, то R пуст. Можно задать пространственную ссылку следующим 'geographic' или 'planar' использование 'CoordinateSystemType' Пара "имя-значение".

Палитра, сопоставленная с индексированным изображением, возвращается как числовая матрица n на 3 со значениями в области значений [0,1]. Каждая строка cmap - трехэлементный триплет RGB, который задает красный, зеленый и синий компоненты одного цвета в палитре. Значение cmap пуст, если A является индексированным изображением.

Подробнее о

свернуть все

Поддерживаемые форматы и расширения

readgeoraster и georasterinfo функции поддерживают эти форматы файлов и расширения. В некоторых случаях можно считать поддерживаемые форматы файлов, используя расширения, отличные от перечисленных таковых.

Формат файлаРасширение

GeoTIFF

.tif или .tiff

Двоичная сетка ESRI

.adf

Сетка ESRI ASCII

.asc или .grd

Esri GridFloat

.flt

DTED

.dt0, .dt1, или .dt2

SDTS

.DDF

USGS DEM

.dem

Сопоставители ER

.ers

ENVI

.dat

ЭРДОГАС ПРЕДСТАВЬТЕ

.img

Числовая сетка преобразователя по вертикали

.grd

Классифицированная сетка преобразователя по вертикали

.grc

Некоторые форматы файлов состоят из файла данных и нескольких вспомогательных файлов. Например, файлы Esri GridFloat могут иметь поддерживающие файлы заголовков (.hdr). Когда вы читаете файл данных с вспомогательными файлами, используя readgeoraster или georasterinfo, задайте расширение файла данных.

На форматы файлов можно ссылаться с использованием различных имен. Для примера формат Esri GridFloat также может называться Esri .hdr Маркированные или ITT ESRI .hdr RAW Raster. Формат двоичной сетки Esri может также называться ArcGrid Binary, Esri ArcGIS Binary Grid или Esri ArcInfo Grid.

Совет

  • Некоторые функции требуют входных параметров типа single или double, таких как geoshow функция для отображения поверхностей. Чтобы использовать выход readgeoraster с помощью этих функций задайте тип выхода следующим 'single' или 'double' использование 'OutputType' Пара "имя-значение".

  • Независимо от формата файла, массив возвращается readgeoraster имеет столбцы, начиная с севера и ColumnsStartFrom свойство опорного объекта имеет значение 'north'.

Введенный в R2020a