mapshow

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

Синтаксис

mapshow(x,y)
mapshow(S)
mapshow(x,y,Z)
mapshow(Z,R)
mapshow(x,y,I)
mapshow(x,y,X,cmap)
mapshow(I,R)
mapshow(X,cmap,R)
mapshow(filename)
mapshow(___,Name,Value)
mapshow(ax,___)
h = 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 отображает изображение как texturemap на поверхности нулевого повышения (значениями установки ZData к 0).

mapshow(x,y,I) и

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

пример

mapshow(I,R) и

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

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

пример

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

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

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

Примеры

свернуть все

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

Изображение на дисплее.

figure
mapshow boston.tif
axis image off manual

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

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

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

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

Создайте спецификацию символа, чтобы различать различные типы дорог. Например, можно скрыть очень незначительные дороги (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);

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

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);

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

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);

Считайте ортофотографию.

[ortho, cmap] = imread('concord_ortho_w.tif');

Считайте векторные данные.

R = worldfileread('concord_ortho_w.tfw', 'planar', size(ortho));

Отобразите ортофотографию с векторными данными.

figure
mapshow(ortho,cmap,R)

Читайте данные о векторе полигона, представляющие водоем с тремя островами (покажите 14 в файле). Обратите внимание на то, что острова видимы на ортофотографии через три "дыры" в полигоне водоема.

pond = shaperead('concord_hydro_area.shp', 'RecordNumbers', 14);
mapshow(pond, 'FaceColor', [0.3 0.5 1], 'EdgeColor', 'black')

Наложите дорожные векторные данные в той же фигуре.

mapshow('concord_roads.shp', 'Color', 'red', 'LineWidth', 1);

Считайте данные о ландшафте SDTS DEM для Горы Вашингтон.

[Z, R] = sdtsdemread('9129CATD.DDF');

Просмотрите данные о ландшафте как mesh.

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

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

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

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

view(3);
axis normal

Считайте файлы данных ландшафта для Горы Вашингтон и Смонтируйте Дартмут.

[Z_W, R_W] = arcgridread('MtWashington-ft.grd');
[Z_D, R_D] = arcgridread('MountDartmouth-ft.grd');

Отобразите данные о ландшафте как поверхность в z == 0 плоскостей, так, чтобы лежание над линиями контура и метками было видимо.

figure
hold on
mapshow(zeros(size(Z_W)),R_W,'CData',Z_W,'DisplayType','surface')
mapshow(zeros(size(Z_D)),R_D,'CData',Z_D,'DisplayType','surface')
axis equal

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

cW = mapshow(Z_W, R_W, 'DisplayType', 'contour', ...
   'LineColor','black', 'ShowText', 'on');
cD = mapshow(Z_D, R_D, 'DisplayType', 'contour', ...
   'LineColor','black', 'ShowText', 'on');

Установите палитру, соответствующую повышению ландшафта.

demcmap(Z_W)

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

свернуть все

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

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

Сетка данных, заданная как 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', 'line' или 'polygon'
GeoTIFF'image'
TIFF/JPEG/PNG с мировым файлом 'image'
СЕТКА ASCII ДУГИ'surface' (может быть заменен),
Растр SDTS'surface' (может быть заменен),

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

Родительские оси, заданные как объект осей.

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

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (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