GeographicBubbleChart Properties

Управляйте внешним видом и поведением географической пузырьковой диаграммы

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

tsunamis = readtable('tsunamis.xlsx');
tsunamis.Cause = categorical(tsunamis.Cause);
figure
gb = geobubble(tsunamis,'Latitude','Longitude', ...
        'SizeVariable','MaxHeight','ColorVariable','Cause', ...
        'Basemap','colorterrain')
geolimits([10 65],[-180 -80])
title 'Tsunamis in North America';
gb.SizeLegendTitle = 'Maximum Height';

Расположение пузыря

расширить все

Координаты широты расположений пузыря, заданные как действительный, конечный, числовой вектор значений в области значений [-90,90], или как пустой ([]) массив. LatitudeData должен быть того же размера, что и LongitudeData и может содержать NaNс.

Пузыри с широтами, выходящими за приблизительные пределы [-85 85], за которые плитки основной карты не выходят, допустимы. Однако эти значения обычно не видны, если экстент карты не управляется вручную с помощью MapCenter и ZoomLevel свойства. Кроме того, пузыри, очень близкие к 90 степеням и -90 степеням, никогда не могут быть замечены, потому что они отображаются на бесконечные или почти бесконечные y значения.

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

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

  • Строковый скаляр или вектор символов, указывающий имя табличной переменной, которое вы хотите использовать для широты. Для примера, geobubble(__,'LatitudeVariable','Latitude') задает переменную с именем 'Latitude'.

  • Числовой скаляр, указывающий индекс табличной переменной. Для примера, geobubble(__,'LatitudeVariable',1) задает первую переменную в таблице для широт.

  • Логический вектор, содержащий один true элемент.

Значения, связанные с этой табличной переменной, должны быть числовыми. Вы можете использовать это свойство только при указании таблицы в качестве входов. geobubble сохраняет значение этой переменной в 'LatitudeData' свойство и устанавливает 'LatitudeData' свойство только для чтения.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string

Координаты долготы расположения пузыря, заданные как действительный, конечный, числовой вектор значений в области значений (-Inf,Inf), или как пустой ([]) массив. LongitudeData должен быть того же размера, что и LatitudeData и может содержать NaNс.

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

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

  • Строковый или символьный вектор, задающий имя табличной переменной, которую вы хотите использовать для информации о долготе. Для примера, geobubble(__,'LongitudeVariable','Longitude') задает табличную переменную с именем 'Longitude'.

  • Числовой скаляр, указывающий индекс табличной переменной. Для примера, geobubble(__,'LongitudeVariable',16) задает шестнадцатую переменную в таблице для долготы.

  • Логический вектор, содержащий один true элемент.

Значения, связанные с этой табличной переменной, должны быть числовыми. Вы можете использовать это свойство только при указании таблицы в качестве входов. geobubble сохраняет значение этой переменной в 'LongitudeData' свойство и устанавливает 'LongitudeData' свойство только для чтения.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string

Размер пузыря

расширить все

Минимальная и максимальная ширина пузырей, измеренная в точках, задается как числовой скаляр или числовой вектор 1 на 2. Значения должны быть не нисходящими. Используйте скаляр, когда вы хотите, чтобы все пузыри имели одинаковый (равномерный) размер. Значения должны находиться в области значений [1 100].

Пример: [4 10]

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Данные, управляющие размером пузыря, задаются в виде числового вектора или скаляра в области значений (-Inf,Inf), или как пустой ([]) массив. Если вы задаете вектор, SizeData должен быть того же размера, что и LatitudeData и LongitudeData. Если вы задаете скалярное значение, географическая пузырьковая диаграмма обрабатывает это значение скалярным расширением. sizedata может содержать NaNс.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Пределы для отображения SizeData значения ширины пузыря, заданные как вектор 1 на 2 вещественных, конечных, числовых значений или как пустой ([]) матрица. Значения должны быть не нисходящими. Чтобы создать пузыри, которые имеют одинаковый размер, задайте одно и то же значение для каждого элемента.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Табличная переменная, используемая для определения размера пузыря, заданная в одной из следующих форм:

  • Строковый скаляр или вектор символов, задающий имя табличной переменной, которую вы хотите использовать для информации о размере. Для примера, geobubble(__,'SizeVariable','MaxHeight') задает переменную с именем 'MaxHeight'.

  • Числовой скаляр, указывающий индекс табличной переменной. Для примера, geobubble(__,'SizeVariable',16) задает шестнадцатую переменную в таблице.

  • Логический вектор, содержащий один true элемент. Для примера, sizevar = logical([0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1]) задает 16-ю переменную в таблице.

Это свойство может использоваться только при указании таблицы в качестве входов. Значения, сопоставленные с этой табличной переменной, должны быть числового типа. Когда вы задаете эту переменную, geobubble сохраняет значения данных, сопоставленные с этой переменной, в 'SizeData' и устанавливает свойство только для чтения.

Цвет пузыря

расширить все

The BubbleColorList свойство контролирует цвета, используемые для пузырей. Значение является массивом m -by-3, где каждая строка является цветовым триплетом RGB, где m равняется числовым категориям в ColorData вектор, или количество категорий плюс 1, если какие-либо элементы ColorData являются неопределенными, или 1 если ColorData пуст. По умолчанию geobubble выбирает цвета из упорядоченного списка из 7 стандартных цветов. Если m больше 7, цвета повторяются циклически. Чтобы изменить используемые цвета, используйте одну из функций палитры MATLAB, таких как parula или jetили укажите пользовательский список собственных значений RGB.

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

Данные, управляющие цветом пузыря, задаются как категориальный вектор или как пустой массив ([]). Пузыри, присвоенные той же категории, имеют одинаковый цвет на карте. Для каждой категории географической пузырьковой диаграммы присваивает цвет с помощью цветов, перечисленных в BubbleColorList свойство. Размер ColorData должен соответствовать LatitudeData и LongitudeData, кроме тех случаев, когда задается пустой массив.

При использовании цветовой легенды в географическую пузырьковую диаграмму отображаются значения категорий в легенде. Если какое-либо из значений содержит символы разметки TeX, такие как символ подчеркивания (_), вы можете увидеть неожиданное форматирование в вашей легенде цвета. MATLAB ® использует подмножество разметки TeX для текста, отображаемого в легендах. Чтобы использовать символ разметки TeX в обычном тексте, отредактируйте имя категории ( используяrenamecats) и вставьте escape-символ TeX, обратную косую черту (\), перед символом, который вы хотите включить. Для получения информации об использовании разметки TeX для добавления суперскриптов и индексов, изменения типа и цвета шрифта и включения специальных символов в текст, смотрите свойство Interpreter текстового объекта.

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

Табличная переменная, используемая для определения цвета пузыря, заданная в одной из следующих форм:

  • Строковый скаляр или вектор символов, указывающий имя табличной переменной, которое вы хотите использовать для информации о цвете. Для примера, geobubble(__,'ColorVariable','Cause') задает переменную с именем 'Cause'.

  • Числовой скаляр, указывающий индекс табличной переменной. Для примера, geobubble(__,'ColorVariable',12) задает 12-ю переменную в таблице.

  • Логический вектор, содержащий один true элемент. Для примера, sizevar = logical([0 0 0 0 0 0 0 0 0 0 0 1]) задает 12-ю переменную в таблице.

Вы можете использовать это свойство только при указании таблицы в качестве входов. Значения, связанные с этой табличной переменной, должны быть категориальными. Когда вы задаете цветовую переменную, geobubble сохраняет значения данных, сопоставленные с этой переменной, в ColorData свойство и устанавливает ColorData свойство только для чтения.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string

Метки

расширить все

Заголовок географической пузырьковой диаграммы, заданная как вектор символов, массив ячеек векторов символов, скаляра строка, строковые массивы, числовое значение или categorical значение. Если вы задаете это свойство как categorical array, MATLAB использует значения в массиве, а не категории. Вы также можете использовать title функция, чтобы задать это значение.

По умолчанию MATLAB ® поддерживает подмножество разметки TeX для заданного текста. Чтобы добавить верхние и нижние индексы, измените тип и цвет шрифта и включите в текст специальные символы, используйте разметку TeX. Чтобы использовать символ разметки TeX в обычном тексте, таком как символ подчеркивания (_), вставьте символа побега TeX обратную косую черту (\), перед символом, который вы хотите включить. Для получения дополнительной информации см. свойство Interpreter текстового объекта.

Текст для отображения в виде заголовка цветовой легенды, заданный как вектор символов, строковый скаляр, строковые массивы, массив ячеек из векторов символов, числовое значение или categorical значение. Если вы задаете это свойство как categorical array, MATLAB использует значения в массиве, а не категории.

По умолчанию MATLAB ® поддерживает подмножество разметки TeX для заданного текста. Чтобы добавить верхние и нижние индексы, измените тип и цвет шрифта и включите в текст специальные символы, используйте разметку TeX. Чтобы использовать символ разметки TeX в обычном тексте, таком как символ подчеркивания (_), вставьте символ побега TeX, обратную косую черту (\), перед символом, который вы хотите включить. Для получения дополнительной информации см. свойство Interpreter текстового объекта.

Типы данных: char | cell | string | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical

Размер заголовка легенды, заданный как вектор символов, строковый скаляр, строковые массивы, массив ячеек векторов символов, числовое значение или categorical значение. Если вы задаете это свойство как categorical array, MATLAB использует значения в массиве, а не категории.

По умолчанию MATLAB ® поддерживает подмножество разметки TeX для заданного текста. Чтобы добавить верхние и нижние индексы, измените тип и цвет шрифта и включите в текст специальные символы, используйте разметку TeX. Чтобы использовать символ разметки TeX в обычном тексте, таком как символ подчеркивания (_), вставьте символа побега TeX обратную косую черту (\), перед символом, который вы хотите включить. Для получения дополнительной информации см. свойство Interpreter текстового объекта.

Видимость размера пузыря и цветовых легенд, заданная как 'on' или 'off' или логических значений true или false. Можно также переключить видимость легенд при помощи legend функция.

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

Шрифт

расширить все

Шрифт, используемый в географической пузырьковой диаграмме виде строкового скаляра или вектора символов. Для правильного отображения и печати название шрифта должно быть шрифтом, поддерживаемым системой. Шрифт по умолчанию зависит от конкретной операционной системы и локали. Чтобы использовать шрифт фиксированной ширины, который хорошо выглядит в любой локали, используйте 'FixedWidth'. The 'FixedWidth' значение зависит от корня FixedWidthFontName свойство. Установка корневого FixedWidthFontName свойство приводит к немедленному обновлению отображения, чтобы использовать новый шрифт.

Пример: 'Cambria'

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

Размер шрифта, используемый в географической пузырьковой диаграмме, задается как действительный, конечный, положительный, числовой скаляр. Значение находится в единицах модулей точки, где одна точка равна 1/72 дюйма.

Карта

расширить все

Карта, на которой можно построить данные, заданная как одно из значений, перечисленных в таблице. Шесть основные карты являются мозаичными наборами данных, созданными с помощью Natural Earth. Пять из основных карт являются картами высокого масштаба, размещенными Esri®.

'streets-light' basemap

'streets-light' (по умолчанию)

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

Организатор - Эсри.

'streets-dark' basemap

'streets-dark'

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

Организатор - Эсри.

'streets' basemap

'streets'

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

Организатор - Эсри.

'satellite' basemap

'satellite'

Полная глобальная основная карта, состоящая из спутниковых снимков с высоким разрешением.

Организатор - Эсри.

'topographic' basemap

'topographic'

Карта общего назначения со стилем для отображения топографических функций.

Организатор - Эсри.

'landcover' basemap

'landcover'

Карта, которая объединяет спутниковые данные о типе поверхности, затененный рельеф и океанический рельеф. Светлая, натуральная палитра подходит для тематических и эталонных карт.

Создан с использованием Natural Earth.

'colorterrain' basemap

'colorterrain'

Заштрихованная карта подреза сопряжена с палитрой типа поверхности. Влажные низменности зелёные, а засушливые - коричневые.

Создан с использованием Natural Earth.

'grayterrain' basemap

'grayterrain'

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

Создан с использованием Natural Earth.

'bluegreen' basemap

'bluegreen'

Двухцветная карта суши и океана со светло-зелеными землями и светло-голубыми акваториями.

Создан с использованием Natural Earth.

'grayland' basemap

'grayland'

Двухцветная карта суши-океана с серыми участками суши и белыми акваториями.

Создан с использованием Natural Earth.

'darkwater' basemap

'darkwater'

Двухцветная карта суши-океана со светло-серыми участками суши и темно-серыми акваториями. Эта основная карта установлена с MATLAB®.

Создан с использованием Natural Earth.

 

'none'

Пустой фон, который строит графики данных с сеткой широта-долгота, тактами и метками.

Все основные карты, кроме 'darkwater' Требуется доступ в Интернет. The 'darkwater' основная карта включен в MATLAB.

Если у вас нет последовательного доступа к Интернету, можно загрузить основные карты, созданные с помощью Natural Earth, в локальную систему с помощью Add-On Explorer. Пять карт высокого масштаба недоступны для загрузки. Для получения дополнительной информации о загрузке основные карты и изменении основной карты по умолчанию в локальной системе, смотрите Access Basemaps для географических осей и графиков.

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

Выравнивание контуров и меток областей является представлением функции, предоставляемой поставщиками данных, и не подразумевает одобрения MathWorks®.

Пример: gb = geobubble(1:10,1:10,'Basemap','bluegreen')

Пример: gb.Basemap = 'bluegreen'

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

Таблица, содержащая данные для построения, заданная как таблица.

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

Видимость линий широты и долготы на карте, заданная как 'on' или 'off', или логические значения true или false. Вы также можете использовать grid функция для переключения видимости сетки.

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

Это свойство доступно только для чтения.

Пределы широты карты, заданные как вектор 1 на 2 вещественных, конечных значений вида [southern_limit northern_limit] в области значений [-90,90]. Чтобы задать пределы широты, используйте geolimits функция.

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

Это свойство доступно только для чтения.

Пределы долготы карты, заданные как вектор 1 на 2 вещественных, конечных значений вида [western_limit eastern_limit]. Значения должны быть в области значений (-Inf, Inf). Чтобы задать пределы долготы, используйте geolimits функция.

Пример: [-100 100]

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

Центральная точка карты в широте и долготе, заданная как двухэлементный вектор вещественных, конечных значений вида [center_latitude center_longitude]. Значения должны быть в области значений [(-90,90),(-Inf, Inf)].

Пример: [38.6292 -95.2520]

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

Размещение карты, включая вставки и украшения, указывается как одно из следующего.

ЗначениеОписаниеРисунок
'normal'Карта вставляется с ребер графика, как определяется ее OuterPosition свойство. Метки осей ('Latitude' и 'Longitude'), такты и метки такта видны. Если на Title задано значение свойства, график включает заголовок. Легенды, если они присутствуют, появляются снаружи и справа от карты.

Geographic bubble chart with a normal layout

'maximized'Карта заполняет все пространство, заданное OuterPosition свойство. Метки осей, такты и метки такта скрыты. Заголовок скрыт, даже если Title задано свойство. Сетка скрыта, даже если GridVisible установлено в 'on'. Легенды, если они присутствуют, появляются внутри карты, к верхнему правому углу.

Geographic bubble charted with a maximized layout

Пример: gb = geobubble(__,'MapLayout','maximized')

Пример: gb.MapLayout = 'maximized'

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

Видимость шкалы на карте, заданная как 'on' или 'off', или логические значения true или false.

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

Уровень увеличения карты, заданный как действительный, конечный, числовой скаляр между 0 и 25 включительно. Значение является логарифмической картой основы 2 шкал. Увеличение ZoomLevel значение на 1 удваивает шкалу карты.

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

Положение

расширить все

Свойство Position, которое остается постоянным при добавлении, удалении или изменении украшений, задается как одно из следующих значений:

  • 'outerposition' - The OuterPosition свойство остается постоянным, когда вы добавляете, удаляете или изменяете украшения, такие как заголовок или подпись по осям. Если необходимы какие-либо корректировки положения, MATLAB настраивает InnerPosition свойство.

  • 'innerposition' - The InnerPosition свойство остается постоянным, когда вы добавляете, удаляете или изменяете украшения, такие как заголовок или подпись по осям. Если необходимы какие-либо корректировки положения, MATLAB настраивает OuterPosition свойство.

Примечание

Установка этого свойства не влияет, когда родительский контейнер является TiledChartLayout.

Размер и положение географической пузырьковой диаграммы в ее родительский элемент, заданные как четырехэлементный числовой вектор вида [left bottom width height]. Значение по умолчанию [0 0 1 1] включает в себя всю внутреннюю часть контейнера.

Этот рисунок показывает области, заданные OuterPosition значения (синий) и InnerPosition значения (красный).

A red box surrounds a map tightly. A larger blue box also includes its title, legends, and axis labels.

Примечание

Установка этого свойства не влияет, когда родительский контейнер является TiledChartLayout.

Внутренний размер и положение географической пузырьковой диаграммы в родительском контейнере (обычно это рисунок, панель или вкладка), возвращенные как четырехэлементный вектор формы [left bottom width height]. Внутреннее положение не содержит заголовок или подписи по осям.

  • The left и bottom элементы определяют расстояние от нижнего левого угла контейнера до нижнего левого угла географической пузырьковой диаграммы.

  • The width и height элементы являются географической пузырьковой диаграммой размерностями.

Этот рисунок показывает области, заданные OuterPosition значения (синий) и InnerPosition значения (красный).

A red box surrounds a map tightly. A larger blue box also includes its title, legends, and axis labels.

Примечание

Установка этого свойства не влияет, когда родительский контейнер является TiledChartLayout.

Внутренний размер и положение географической пузырьковой диаграммы в родительском контейнере (обычно это рисунок, панель или вкладка), возвращенные как четырехэлементный вектор формы [left bottom width height]. Это свойство эквивалентно свойству InnerPosition.

Примечание

Установка этого свойства не влияет, когда родительский контейнер является TiledChartLayout.

Позиционные модули, заданные в качестве одного из следующих значений.

UnitsОписание
'normalized' (по умолчанию)Нормированный относительно контейнера, который обычно является рисунком или панелью. Нижний левый угол контейнера сопоставлен с (0,0), и правый верхний угол преобразуется в (1,1).
'inches'Дюймы
'centimeters'Сантиметры
'characters'

На основе шрифта uicontrol по умолчанию графического корневого объекта:

  • Ширина символа = ширина буквы x.

  • Высота символа = расстояние между базовыми линиями двух строк текста.

'points'Опечатки точек. Одна точка равна 1/72 дюйма.
'pixels'

Пиксели.

Начиная с R2015b, расстояния в пикселях не зависят от вашего системного разрешения в Windows® и системы Macintosh:

  • В системах под управлением Windows пиксель составляет 1/96 дюйма.

  • В системах Macintosh пиксель составляет 1/72 дюйма.

На Linux® систем, размер пикселя определяется вашим системным разрешением.

При определении модулей как пары "имя-значение" во время создания объекта необходимо задать Units свойство перед указанием свойств, которые вы хотите использовать эти модули, таких как OuterPosition.

Опции размещения, заданные как TiledChartLayoutOptions или GridLayoutOptions объект. Это свойство полезно, когда график находится либо в размещении мозаичной диаграммы, либо в размещении сетки.

Чтобы разместить график в сетке размещения мозаичной диаграммы, установите Tile и TileSpan свойства на TiledChartLayoutOptions объект. Для примера рассмотрим плиточный график размещения 3 на 3. Размещение имеет сетку плиток в центре, и четыре плитки по внешним краям. На практике сетка невидима, и внешние плитки не занимают пространства, пока вы не заполняете их осями или графиками.

Diagram of a 3-by-3 tiled chart layout.

Этот код помещает график c в третьей плитке сетки..

c.Layout.Tile = 3;

Чтобы график охватывал несколько мозаик, задайте TileSpan свойство как двухэлементный вектор. Для примера этот график охватывает 2 строки и 3 столбцы плитки.

c.Layout.TileSpan = [2 3];

Чтобы поместить график в один из окружающих плиток, задайте Tile свойство как 'north', 'south', 'east', или 'west'. Для примера установите значение 'east' помещает график в плитку справа от сетки.

c.Layout.Tile = 'east';

Чтобы поместить график в размещение в приложении, задайте это свойство как GridLayoutOptions объект. Для получения дополнительной информации о работе с размещениями сетки в приложениях, см. uigridlayout.

Если график не является дочерним элементом макета мозаичной диаграммы или макета сетки (например, если он является дочерним элементом фигуры или панели), это свойство пустое и не влияет.

Видимость географической пузырьковой диаграммы, заданная как 'on' или 'off', или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.

Родитель/ребенок

расширить все

Родительский контейнер, заданный как Figure, Panel, Tab, TiledChartLayout, или GridLayout объект.

Видимость указателя на объект в Children свойство родительского элемента, заданное в качестве одного из следующих значений:

  • 'on' - указатель на объект всегда отображается.

  • 'off' - указатель на объект всегда невидим. Эта опция используется для предотвращения непреднамеренных изменений другой функцией. Установите HandleVisibility на 'off' временно скрыть указатель во время выполнения этой функции.

  • 'callback' - Указатель на объект виден из коллбэков или функций, вызываемых коллбэками, но не из функций, инициируемых из командной строки. Эта опция блокирует доступ к объекту в командной строке, но позволяет функциям обратного вызова обращаться к нему.

Если объект не указан в Children свойство родительского элемента, тогда функции, которые получают указатели на объекты путем поиска иерархии объектов или запросов свойств указателя, не могут вернуть его. Примеры таких функций включают в себя get, findobj, gca, gcf, gco, newplot, cla, clf, и close функций.

Скрытые указатели на объекты все еще действительны. Установите корневой ShowHiddenHandles свойство к 'on' список всех указателей на объекты независимо от их HandleVisibility настройка свойств.

Вопросы совместимости

расширить все

Не рекомендуемый запуск в R2020a

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