geobubble

Визуализируйте значения данных в определенных географических точках

Синтаксис

gb = geobubble(tbl,latvar,lonvar)
gb = geobubble(tbl,latvar,lonvar,Name,Value)
gb = geobubble(lat,lon)
gb = geobubble(lat,lon,sizedata)
gb = geobubble(lat,lon,sizedata,colordata)
gb = geobubble(___,Name,Value)
gb = geobubble(parent,___)

Описание

gb = geobubble(tbl,latvar,lonvar) создает географическую пузырьковую диаграмму с заполненными кругами (“пузыри”), представляющие географические точки, заданные в таблице tbl, отображенной на карте. latvar идентифицирует табличную переменную (столбец), который задает пузырьковые широты. lonvar идентифицирует табличную переменную, которая задает пузырьковые долготы. По умолчанию пузыри являются всеми одинаковыми размер и тот же цвет. Функция возвращает gb, объект GeographicBubbleChart. Чтобы изменить этот объект, используйте свойства, описанные в GeographicBubbleChart Properties.

Географическая пузырьковая диаграмма отображает ваши данные по карте, названной basemap. Первоначально, график устанавливает географические пределы графика, чтобы охватить все ваши данные. Карта жива, то есть, можно панорамировать основную карту, чтобы просмотреть другие географические точки. Можно также увеличить и уменьшить масштаб на карте, чтобы просмотреть области более подробно. График обновляет карту, когда вы панорамируете и масштабируете. Для получения дополнительной информации о географических пузырьковых диаграммах и basemaps, см. Обзор Географических пузырьковых диаграмм.

пример

gb = geobubble(tbl,latvar,lonvar,Name,Value) дополнительные опции использования, заданные одним или несколькими аргументами пары "имя-значение", чтобы установить значения свойств географической пузырьковой диаграммы. Двумя ключевыми свойствами является 'SizeVariable' и 'ColorVariable', которые задают табличные переменные, которые определяют размер и цвет пузырей.

gb = geobubble(lat,lon) создает географическую пузырьковую диаграмму, где lat и lon задают географические точки. По умолчанию пузыри являются всеми одинаковыми размер и цвет.

пример

gb = geobubble(lat,lon,sizedata) масштабирует области пузырей согласно числовым значениям в sizedata.

пример

gb = geobubble(lat,lon,sizedata,colordata) использует категориальные данные в colordata, чтобы определить цвет пузырей. geobubble выбирает цвет для каждой категории в colordata плюс один дополнительный цвет, если какой-либо элемент colordata не определен. Цвета чертятся из упорядоченного списка 7 стандартных цветов. Если существует больше чем семь категорий (больше чем шесть, если неопределенные значения присутствуют), цвета повторяются циклически.

пример

gb = geobubble(___,Name,Value) задает дополнительные опции для географической пузырьковой диаграммы с помощью одного или нескольких аргументов пары "имя-значение". Задайте опции после всех других входных параметров. Для списка свойств смотрите GeographicBubbleChart Properties.

gb = geobubble(parent,___) создает географическую пузырьковую диаграмму в фигуре, панели или вкладке, заданной parent.

Примеры

свернуть все

Считайте данные о цунами в рабочую область как таблица. Строки представляют отдельные случаи цунами. Столбцы представляют данные о наборе переменных для каждого цунами, таких как их местоположения (широта и долгота), причины и высоты волны.

tsunamis = readtable('tsunamis.xlsx');

Преобразуйте одну из табличных переменных в категориальную переменную, чтобы задать цвет пузырей. Переменная Cause приписывает причину каждому цунами, такой как, 'Earthquake', 'Volcano' или 'Earthquake and Landslide'. Преобразуйте переменную Cause из массива ячеек из символьных векторов в категориальную переменную.

tsunamis.Cause = categorical(tsunamis.Cause);

Создайте географическую пузырьковую диаграмму, строя местоположения цунами на карте. Задайте имена табличных переменных, которые содержат информацию местоположения: Latitude и Longitude. Используйте табличную переменную MaxHeight, чтобы задать размер пузырей. Пример использует переменную Cause, преобразованную ранее в категориальную переменную, чтобы задать цвет пузырей.

gb = geobubble(tsunamis,'Latitude','Longitude', ...
    'SizeVariable','MaxHeight','ColorVariable','Cause')

gb = 
  GeographicBubbleChart with properties:

              Basemap: 'darkwater'
            MapLayout: 'normal'
          SourceTable: [162x20 table]
     LatitudeVariable: 'Latitude'
    LongitudeVariable: 'Longitude'
         SizeVariable: 'MaxHeight'
        ColorVariable: 'Cause'

  Show all properties

Считайте данные о цунами в рабочую область как таблица. Строки представляют отдельные случаи цунами. Столбцы представляют данные о наборе переменных для каждого цунами, таких как их местоположения (широта и долгота), причины и высоты волны.

tsunamis = readtable('tsunamis.xlsx');

Создайте географическую пузырьковую диаграмму, строя местоположения цунами на карте. Используйте данные из переменной MaxHeight, чтобы задать размер пузыря. В этом примере вы передаете данные непосредственно geobubble. Также можно также передать geobubble имя таблицы и затем задать данные именами табличной переменной.

gb = geobubble(tsunamis.Latitude,tsunamis.Longitude,tsunamis.MaxHeight)

gb = 
  GeographicBubbleChart with properties:

          Basemap: 'darkwater'
        MapLayout: 'normal'
     LatitudeData: [162x1 double]
    LongitudeData: [162x1 double]
         SizeData: [162x1 double]
        ColorData: []

  Show all properties

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

tsunamis = readtable('tsunamis.xlsx');

Создайте категориальную переменную, потому что данные, которые управляют цветом пузырей, должны быть категориальной переменной. Табличная переменная цунами Cause уже категоризирует цунами по семи критериям: Землетрясение, Землетрясение и Оползень, Вулкан, Вулкан и Оползень, Оползень, Метеорологическая, и Неизвестная Причина. Поместите данные о переменной Cause в категориальную переменную.

cause = categorical(tsunamis.Cause);

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

gb = geobubble(tsunamis.Latitude,tsunamis.Longitude,tsunamis.MaxHeight,cause)

gb = 
  GeographicBubbleChart with properties:

          Basemap: 'darkwater'
        MapLayout: 'normal'
     LatitudeData: [162x1 double]
    LongitudeData: [162x1 double]
         SizeData: [162x1 double]
        ColorData: [162x1 categorical]

  Show all properties

Считайте данные о цунами в рабочую область как таблица. Строки представляют отдельные случаи цунами. Столбцы представляют данные о наборе переменных для каждого цунами, таких как его местоположение (широта и долгота), причина и максимальная высота волны.

tsunamis = readtable('tsunamis.xlsx');

Превратите одну из табличных переменных в категориальную переменную, чтобы задать цвет пузырей. Переменная Cause приписывает причину каждому цунами, такой как, 'Earthquake', 'Volcano' или 'Earthquake and Landslide'. Преобразуйте переменную Cause из массива ячеек из символьных векторов в категориальную переменную.

colordata = categorical(tsunamis.Cause);

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

gb = geobubble(tsunamis.Latitude,tsunamis.Longitude,tsunamis.MaxHeight,colordata,'Title','Tsunamis')

gb = 
  GeographicBubbleChart with properties:

          Basemap: 'darkwater'
        MapLayout: 'normal'
     LatitudeData: [162x1 double]
    LongitudeData: [162x1 double]
         SizeData: [162x1 double]
        ColorData: [162x1 categorical]

  Show all properties

Используйте свойства географической пузырьковой диаграммы изменить график. Например, добавьте заголовки на размер и цветные легенды. (Если вы задаете таблицу в качестве аргумента, geobubble добавляет заголовки легенды автоматически, с помощью имен табличных переменных.)

gb.SizeLegendTitle = 'Max Height';
gb.ColorLegendTitle = 'Cause'

gb = 
  GeographicBubbleChart with properties:

          Basemap: 'darkwater'
        MapLayout: 'normal'
     LatitudeData: [162x1 double]
    LongitudeData: [162x1 double]
         SizeData: [162x1 double]
        ColorData: [162x1 categorical]

  Show all properties

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

свернуть все

Таблица, содержащая данные, которые будут построены, задала как таблица или расписание. Можно импортировать данные, когда таблица с помощью readtable функционирует или составляет таблицу от переменных рабочей области с помощью функции table. Можно создать расписание из переменных рабочей области с помощью функции timetable.

Свойство SourceTable объектно-ориентированной памяти GeographicBubbleChart таблица, содержащая данные, которые будут построены.

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

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

  • Представьте в виде строки скаляр или вектор символов, задающий одно из имен табличной переменной. Например, geobubble(tbl,'Latitude','Longitude') выбирает переменную под названием 'Latitude' для latvar.

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

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

Свойство LatitudeVariable объектно-ориентированной памяти GeographicBubbleChart выбранная переменная.

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

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

  • Представьте в виде строки скаляр или вектор символов, задающий одно из имен табличной переменной. Например, geobubble(tbl,'Latitude','Longitude') выбирает переменную под названием 'Longitude' для lonvar.

  • Числовой скаляр, указывающий на индекс табличной переменной. Например, geobubble(tbl,1,2) выбирает вторую переменную в таблице для долготы.

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

Свойство LongitudeVariable объектно-ориентированной памяти GeographicBubbleChart выбранная переменная.

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

Широта координирует в градусах, заданный как действительный, числовой, конечный вектор в области значений [-90 90]. Вектор может содержать, встроил NaN s. lat должен быть одного размера как lon.

Пример: [43.0327 38.8921 44.0435]

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

Долгота координирует в градусах, заданный как действительный, числовой, конечный вектор. Вектор может содержать, встроил NaN s. lon должен быть одного размера как lat.

Пример: [-107.5556 -77.0269 -72.5565]

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

Данные, которые определяют пузырьковый размер, заданный как действительный, числовой, конечный вектор или скаляр или пустое ([]) массив. Если вы задаете вектор, sizedata должен быть одного размера как lat и lon. Если вы задаете скалярное значение, географическая пузырьковая диаграмма обрабатывает значение со скалярным расширением. sizedata может содержать NaN s.

Пример: [99 133 150]

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

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

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

Родительский контейнер, в котором можно построить географическую пузырьковую диаграмму, заданную как фигура, панель или объект вкладки.

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

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

Пример: p = geobubble(tbl,latvar,lonvar,'SizeVariable','MaxHeight','ColorVariable','Cause')

Примечание

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

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

MathWorks® предлагает шесть basemaps для использования с географическими осями и графиками. basemaps обеспечивают множество параметров экрана из двухцветных, океанских землей растровых карт, чтобы окрасить карты ландшафта. По умолчанию географические оси или графики используют основную карту 'darkwater', которая установлена с продуктом. Если вы выбираете один из других basemaps, географические оси или график получает доступ к карте по Интернету.

Если у вас нет сопоставимого доступа к Интернету, можно загрузить basemaps, размещенный MathWorks на локальную систему. Для получения дополнительной информации о загрузке basemaps, см. Доступ к базовым картам в MATLAB.

Если вы задаете 'none', географические оси или график отображает ваши данные на графике с сеткой долготы широты, метками деления и метками, но не включает карту.

Basemaps

'darkwater' (значение по умолчанию)

Контактные площадки: серый свет-к-умеренному

Океанские и водные области: более темно-серый

Размещенный MathWorks.

'colorterrain'

Теневая вспомогательная карта смешивается с палитрой растительного покрова. Влажная низменность является зеленой и засушливой коричневой низменностью.

Размещенный MathWorks.

'grayland'

Контактные площадки: свет-к-умеренному серая земля

Океанские и водные области: белый

Размещенный MathWorks.

'grayterrain'

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

Размещенный MathWorks.

'bluegreen'

Контактные площадки: светло-зеленый

Океанские и водные области: голубой

Размещенный MathWorks.

'landcover'

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

Размещенный MathWorks.

Пример: gx = geoaxes(__,'Basemap','bluegreen')

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

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

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

  • Скаляр строки или вектор символов, задающий имя табличной переменной, вы хотите использовать для получения информации о цвете. Например, 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

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

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

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

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

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

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

  • Скаляр строки или вектор символов, задающий имя табличной переменной, вы хотите использовать для получения информации о размере. Например, 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', и устанавливает свойство на только для чтения.

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

свернуть все

Географическая пузырьковая диаграмма, возвращенная как объект GeographicBubbleChart.

Советы

  • Чтобы принести особое внимание на географическую пузырьковую диаграмму программно, используйте функцию axes, axes(gb).

Введенный в R2017b