mapshow

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

Описание

пример

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

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

Можно опционально задать правила изображения условными знаками с помощью 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® graphics Properties. Названия параметра могут быть сокращены, и случай не имеет значения.

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

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

Примеры

свернуть все

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

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

figure
mapshow boston.tif
axis image off manual

Figure contains an axes object. The axes object 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 object. The axes object contains 2 objects of type image, line.

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

roads = readgeotable("boston_roads.shp");
figure
mapshow(roads,"LineStyle",":")

Figure contains an axes object. The axes object 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 object. The axes object 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 object. The axes object 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 object. The axes object contains 2461 objects of type line.

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

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

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

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

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

hydro = readgeotable("concord_hydro_area.shp");
pond = hydro(14,:);
pond.Shape
ans = 
  mappolyshape with properties:

              NumRegions: 1
                NumHoles: 3
                Geometry: "polygon"
    CoordinateSystemType: "planar"
            ProjectedCRS: [1x1 projcrs]

Отобразите многоугольник по ортофотографии.

mapshow(pond,"FaceColor","c")

Figure contains an axes object. The axes object 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 object. The axes object contains an object of type surface.

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

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

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

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

view(3);
axis normal

Figure contains an axes object. The axes object 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 object. The axes object 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 object. The axes object contains 4 objects of type surface, contour.

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

свернуть все

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

Географические особенности в виде одного из следующего:

  • Геопространственная таблица. Shape переменная таблицы должна содержать mappointshape, maplineshape, или mappolyshape объекты. mapshow функция не поддерживает геопространственные таблицы, содержащие больше чем один тип объекта фигуры. Для получения дополнительной информации о геопространственных таблицах, смотрите, Составляют Геопространственные Таблицы.

  • mappoint вектор.

  • mapshape вектор.

  • Массив структур карты (mapstruct) с X и Y координатные поля.

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

Если вы задаете geopoint вектор, geoshape вектор или географический массив структур (geostruct) с Lat и Lon координатные поля, затем mapshow функциональные проекты координаты с помощью Пластины проекция Carrée и выдают предупреждение. Если вы задаете геопространственную таблицу, содержащую geopointshape, geolineshape, или geopolyshape объекты, затем mapshow функционируйте выдает ошибку. В этих случаях используйте geoshow функцию вместо этого.

Сетка данных в виде 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 имя аргумента и 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'. Эта комбинация может привести к предупреждению.

Представлено до R2006a
Для просмотра документации необходимо авторизоваться на сайте