mapshow

Отобразите данные о карте без проекции

Описание

пример

mapshow(x,y) отображает координатные векторы x и y как линии. Можно опционально отобразить координатные векторы как точки или многоугольники при помощи DisplayType аргумент пары "имя-значение".

mapshow(S) отображает векторные географические особенности, сохраненные в географической структуре данных S как точки, мультиточки, линии или многоугольники согласно 'Geometry' поле S.

  • Если S содержит 'X' и 'Y' поля, затем эти поля используются непосредственно, чтобы построить функции в координатах карты.

  • Если S содержит 'Lat' и 'Lon' поля, затем координаты спроектированы с Пластиной, проекция Carrée и предупреждение выпущены.

Можно опционально задать правила изображения условными знаками с помощью SymbolSpec аргумент пары "имя-значение".

mapshow(x,y,Z) отображает определенную геолокацию сетку данных, Z. Можно опционально отобразить данные как поверхность, mesh, текстурную карту, или очертить при помощи DisplayType аргумент пары "имя-значение".

пример

mapshow(Z,R) отображает обычную сетку данных, Z, с объектом привязки R. Можно опционально отобразить данные как поверхность, mesh, текстурную карту, или очертить при помощи DisplayType аргумент пары "имя-значение". Если DisplayType 'texturemap', затем mapshow отображает изображение как текстурную карту на поверхности нулевого вертикального изменения (установкой ZData значения к 0).

mapshow(x,y,I) и

mapshow(x,y,X,cmap) отобразите определенное геолокацию изображение как текстурную карту на поверхности нулевого вертикального изменения. Определенное геолокацию изображение может быть истинным цветом, шкалой полутонов, или бинарным изображением, I, или индексируемое изображение X с палитрой cmapX и y массивы геолокации в координатах карты. Примеры определенных геолокацию изображений включают цветной составной объект от спутникового swath или изображения, на которое первоначально ссылаются к различной системе координат.

пример

mapshow(I,R) и

mapshow(X,cmap,R) отобразите изображение, на которое геоссылаются, чтобы сопоставить координаты через объект привязки R. mapshow функционируйте создает объект изображения, если геометрия отображения разрешает. В противном случае, mapshow отображает изображение как текстурную карту на поверхности нулевого вертикального изменения (установкой ZData значения к 0).

mapshow(filename) данные об отображениях из файла заданы согласно типу формата файла.

пример

mapshow(___,Name,Value) изменяет отображенную карту при помощи аргументов пары "имя-значение", чтобы установить DisplayType и SymbolSpec параметры. Можно также использовать пары "имя-значение", чтобы установить любые свойства графики MATLAB®. Названия параметра могут быть сокращены, и случай не имеет значения.

mapshow(ax,___) устанавливает родительские оси на ax.

h = mapshow(___) возвращает указатель на графический объект MATLAB.

Примеры

свернуть все

Наложите Бостонские дороги на ортофотографии. Обратите внимание на то, что mapshow чертит новый слой в осях вместо замены его содержимого.

Отобразите изображение.

figure
mapshow boston.tif
axis image off manual

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

Преобразуйте Бостонские дороги к модулям ног обзора и наложения на ортофотографии.

S = shaperead('boston_roads.shp');
surveyFeetPerMeter = unitsratio('sf','meter');
x = surveyFeetPerMeter * [S.X];
y = surveyFeetPerMeter * [S.Y];
mapshow(x,y)

Figure contains an axes. The axes contains 2 objects of type image, line.

Считайте векторные данные и отобразите их с помощью пунктирной линии.

roads = shaperead('boston_roads.shp');
figure
mapshow(roads,'LineStyle',':');

Figure contains an axes. The axes contains 2795 objects of type line.

Создайте спецификацию символа, чтобы различать различные типы дорог. Например, можно скрыть очень незначительные дороги (CLASS=6) путем выключения их видимости и сделать главные дороги (CLASS=1-4) более видимый путем увеличения их ширин линии. Эта спецификация символа также использует цвет, чтобы различать типы дорог.

roadspec = makesymbolspec('Line',...
                          {'ADMIN_TYPE',0,'Color','cyan'}, ...
                          {'ADMIN_TYPE',3,'Color','red'},...
                          {'CLASS',6,'Visible','off'},...
                          {'CLASS',[1 4],'LineWidth',2});

Отобразите векторные данные с помощью спецификации символа.

figure
mapshow('boston_roads.shp','SymbolSpec',roadspec);

Figure contains an axes. The axes contains 2461 objects of type line.

Создайте спецификацию символа и задайте цвет по умолчанию, используемый для линий. Как замечено в предыдущем примере, значение по умолчанию является синим. Этот пример устанавливает значение по умолчанию на черный цвет.

roadspec = makesymbolspec('Line',...
                              {'Default', 'Color', 'black'}, ...
                              {'ADMIN_TYPE',0,'Color','c'}, ...
                              {'ADMIN_TYPE',3,'Color','r'},...
                              {'CLASS',6,'Visible','off'},...
                              {'CLASS',[1 4],'LineWidth',2});

Отобразите векторные данные, с помощью спецификации символа. Отметьте, как главные дороги, отображенные в синем в предыдущем примере, являются теперь черными.

figure
mapshow('boston_roads.shp','SymbolSpec',roadspec);

Figure contains an axes. The axes contains 2461 objects of type line.

Создайте спецификацию символа, установив различные свойства.

roadspec = makesymbolspec('Line',...
                              {'Default', 'Color', 'yellow'}, ...
                              {'ADMIN_TYPE',0,'Color','c'}, ...
                              {'ADMIN_TYPE',3,'Color','r'},...
                              {'CLASS',6,'Visible','off'},...
                              {'CLASS',[1 4],'LineWidth',2});

Отобразите векторные данные, задав цвет на командной строке.

figure
mapshow('boston_roads.shp', 'Color', 'black', 'SymbolSpec', roadspec);

Figure contains an axes. The axes contains 2461 objects of type line.

Импортируйте ортофотографию Согласия, MA, наряду с объектом ссылки ячеек карты и палитрой. Отобразите ортофотографию с помощью mapshow функция.

[ortho,R,cmap] = readgeoraster('concord_ortho_w.tif');
mapshow(ortho,cmap,R) 

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

Импортируйте файл форм, содержащий координаты береговой линии водоема в середине ортофотографии. Проверьте, что данные представляют многоугольник путем запроса его Geometry поле .

pond = shaperead('concord_hydro_area.shp','RecordNumbers',14);
pond.Geometry
ans = 
'Polygon'

Отобразите многоугольник по ортофотографии. Внешний контур обрисовывает в общих чертах водоем, и внутренние контуры обрисовывают в общих чертах острова.

mapshow(pond,'FaceColor','c')

Figure contains an axes. The axes contains 2 objects of type patch, image.

Считайте данные о ландшафте SDTS для Горы Вашингтон. Получите информацию, такую как индикаторы недостающих данных с помощью georasterinfo. Замените недостающие данные на NaN значения с помощью standardizeMissing.

[Z,R] = readgeoraster('sdts/9129CATD.DDF','OutputType','double');
info = georasterinfo('sdts/9129CATD.DDF');
Z = standardizeMissing(Z,info.MissingDataIndicator);

Просмотрите данные о ландшафте как mesh. Примените палитру, подходящую для данных о ландшафте с помощью demcmap.

figure
mapshow(Z,R,'DisplayType','mesh');
demcmap(Z)

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

Просмотрите данные о ландшафте как поверхность.

figure
mapshow(Z,R,'DisplayType','surface');
demcmap(Z)

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

Просмотрите данные о ландшафте как 3-D поверхность.

view(3);
axis normal

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

Считайте файлы данных ландшафта для Горы Вашингтон и Смонтируйте Дартмут. Отображать данные на графике как поверхность с помощью mapshow, растр должен иметь тип single или double. Задайте тип данных для растра с помощью 'OutputType' пара "имя-значение".

[ZWash,RWash] = readgeoraster('MtWashington-ft.grd','OutputType','double');
[ZDart,RDart] = readgeoraster('MountDartmouth-ft.grd','OutputType','double');

Найдите недостающие данные с помощью georasterinfo функция. Функция возвращает объект с MissingDataIndicator свойство, которое указывает, какое значение представляет недостающие данные. Замените недостающие данные на NaN значения с помощью standardizeMissing функция.

infoWash = georasterinfo('MtWashington-ft.grd');
ZWash = standardizeMissing(ZWash,infoWash.MissingDataIndicator);

infoDart = georasterinfo('MountDartmouth-ft.grd');
ZDart = standardizeMissing(ZDart,infoDart.MissingDataIndicator);

Отобразите данные о ландшафте под линиями контура и метками путем определения 'ZData' пара "имя-значение" как матрица нулей. Примените палитру, подходящую для данных о ландшафте с помощью demcmap.

hold on
mapshow(ZWash,RWash,'DisplayType','surface','ZData',zeros(RWash.RasterSize))
mapshow(ZDart,RDart,'DisplayType','surface','ZData',zeros(RDart.RasterSize))
axis equal
demcmap(ZWash)

Figure contains an axes. The axes contains 2 objects of type surface.

Наложите черные линии контура и метки.

mapshow(ZWash,RWash,'DisplayType','contour',...
    'LineColor','k','ShowText','on');
mapshow(ZDart,RDart,'DisplayType','contour',...
    'LineColor','k','ShowText','on');

Figure contains an axes. The axes contains 4 objects of type surface, contour.

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

свернуть все

x- или y координирует в виде числового вектора или M-by-N числовую матрицу. x и y должен быть одного размера. Если x и y матрицы, они представляют координатные массивы или массив геолокации в координатах карты. x и y может содержать встроил NaNs, чтобы разграничить отдельные линии или части многоугольника.

Географические особенности в виде географической структуры данных или динамического вектора.

Сетка данных в виде M-by-N массив, который может содержать NaN значения. Z или сетка геосправочных данных или обычная сетка данных, сопоставленная с географическим ссылочным R. Размер x и y должен совпадать с размером Z.

Типы данных: double

Ссылка карты в виде одного из следующих. Для получения дополнительной информации о ссылке на матрицы, смотрите Растровые Данные, на Которые геоссылаются.

ВводОписание
Сопоставьте объект растровой привязки

MapCellsReference или MapPostingsReference или GeographicPostingsReference сопоставьте объект растровой привязки, который связывает индексы Z сопоставлять координаты. RasterSize свойство должно быть сопоставимо с размером сетки данных, size(Z).

Если R MapPostingsReference объект, затем 'image' и 'texturemap' значения DisplayType не приняты.

Матрица

3 2 числовая матрица, которая преобразовывает растровые индексы строки и столбца к или от координат карты согласно:

[x y] = [row col 1] * R

Истинный цвет, шкала полутонов или бинарное изображение в виде M-by-N-by-3 массив для изображений истинного цвета или M-by-N массив для полутоновых или бинарных изображений. x и y должен быть M-by-N массивы.

Индексируемое изображение с картой цветов, заданной cmapВ виде M-by-N массив. x и y должен быть M-by-N массивы.

Карта цветов индексируемого изображения XВ виде c-by-3 числовая матрица. Существует c, раскрашивает карту цветов, каждый представленный красным, зеленым, и синим пиксельным значением.

Имя файла в виде строкового скаляра или вектора символов. mapshow автоматически устанавливает DisplayType параметр согласно формату данных.

ФорматDisplayType
Файл форм'point', 'multipoint'строка, или 'polygon'
GeoTIFF'image'
TIFF/JPEG/PNG с файлом привязки 'image'
СЕТКА ASCII ДУГИ'surface' (может быть заменен),
Растр SDTS'surface' (может быть заменен),

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

Родительские оси в виде объекта осей.

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

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

Пример: 'DisplayType','point'

Тип графического дисплея для данных в виде разделенной запятой пары, состоящей из 'DisplayType' и одно из следующих значений.

Формат данныхТип дисплеяТип свойства
Вектор'point'маркер линии
'multipoint'маркер линии
'line'строка
'polygon'закрашенная фигура
Изображение'image'поверхность
Сетка'surface'поверхность
'mesh'поверхность
'texturemap'поверхность
'contour'контур

Допустимые значения DisplayType зависьте от формата данных о карте. Например, если данные о карте являются определенным геолокацию изображением или изображением, на которое геоссылаются, то единственное допустимое значение DisplayType 'image'.

Различные типы дисплея поддерживают различные типы классов данных о карте:

Тип дисплеяПоддерживаемые типы классов
Изображение 
Поверхностьsingle и double
Текстурная картаВсе числовые типы и logical

Изображение условными знаками управляет, чтобы использоваться для отображения векторных данных в виде symbolSpec структура, возвращенная makesymbolspec. Когда оба SymbolSpec и одно или несколько графических свойств заданы, графические свойства заменят любые настройки в symbolSpec структура.

Изменить правило изображения условными знаками по умолчанию для Name,Value пара в symbolSpec структура, снабдите префиксом слово 'Default' к графическому имени свойства.

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

свернуть все

Родительские оси, возвращенные как указатель на графический объект MATLAB или, в случае многоугольников, модифицированного объекта закрашенной фигуры. Если имя mapstruct или файла форм вводится, mapshow возвращает указатель на hggroup объект с одним дочерним элементом на функцию в mapstruct или файле форм. В случае многоугольника mapstruct или файла форм, каждый дочерний элемент является модифицированным объектом закрашенной фигуры; в противном случае это - объект линии.

Советы

  • Если вы не хотите mapshow чтобы чертить сверху существующей карты, создайте новую фигуру или подграфик прежде, чем вызвать его.

  • Можно использовать mapshow отобразить векторные данные в axesm фигура. Однако вы не должны впоследствии изменять проекцию карты с помощью setm.

  • Если вы отображаете многоугольник, не устанавливайте 'EdgeColor' к любому 'flat' или 'interp'. Эта комбинация может привести к предупреждению.

  • Если S геоstruct (имеет 'Lat' и 'Lon' поля), может быть более уместно использовать geoshow отобразить их. Можно спроектировать значения координаты широты и долготы, чтобы сопоставить координаты путем отображения с geoshow на карте оси.

Представлено до R2006a