exponenta event banner

Свойства BubureChart

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

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 и может содержать NaNs.

Допустимы пузырьки с широтами, выходящими за приблизительные пределы [-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 и может содержать NaNs.

Типы данных: 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 может содержать NaNs.

Типы данных: 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' и устанавливает свойство только для чтения.

Цвет пузыря

развернуть все

BubbleColorList свойство управляет цветами, используемыми для пузырей. Значение представляет собой массив m-на-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 для добавления надстрочных и подстрочных индексов, изменения типа шрифта и цвета, а также включения специальных символов в текст см. в разделе свойства «Интерпретатор» текстового объекта.

Типы данных: 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 MATLAB использует значения в массиве, а не категории. Вы также можете использовать title для установки этого значения.

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

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

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

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

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

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

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

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

Шрифт

развернуть все

Шрифт, используемый в географической пузырьковой диаграмме, определяемый как строковый скалярный или символьный вектор. Для правильного отображения и печати имя шрифта должно быть шрифтом, поддерживаемым системой. Шрифт по умолчанию зависит от конкретной операционной системы и языка. Чтобы использовать шрифт фиксированной ширины, который хорошо выглядит в любом языковом стандарте, используйте 'FixedWidth'. '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' требуется доступ к Интернету. 'darkwater' базовая карта входит в состав MATLAB.

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

Базовые карты, размещаемые 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'- OuterPosition свойство остается постоянным при добавлении, удалении или изменении декораций, таких как заголовок или метка оси. При необходимости регулировки положения MATLAB корректирует InnerPosition собственность.

  • 'innerposition'- 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]. Внутренняя позиция не включает метки заголовка или оси.

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

  • 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]. Это свойство эквивалентно свойству InivePosition.

Примечание

Установка этого свойства не действует, если родительским контейнером является 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. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл 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