geobubble - Standalone geographic bubble chart - MATLAB (original) (raw)
Standalone geographic bubble chart
Syntax
Description
Table Data
geobubble([tbl](#d126e628122),[latvar](#mw%5Fbc79c7a4-d117-4bb4-8db6-f3c9dff63b4b),[lonvar](#mw%5Fc4a06acd-14e7-4d2b-a460-f23282c59290)) creates a standalone geographic bubble chart from the specified latitude and longitude coordinates. The tbl argument indicates the table that contains the coordinates. The latvar argument indicates the table variables that contains latitudes. The lonvar argument indicates the table variables that contains longitudes. By default, all the bubbles are the same size and color.
Vector Data
geobubble([lat](#bvkoscj-1-lat),[lon](#bvkoscj-1-lon)) creates a geographic bubble chart from the latitudes in lat and the longitudes in lon. By default, all the bubbles are the same size and color.
geobubble([lat](#bvkoscj-1-lat),[lon](#bvkoscj-1-lon),[sizedata](#bvkoscj-1-sizedata)) scales the areas of the bubbles according to the numeric values insizedata.
geobubble([lat](#bvkoscj-1-lat),[lon](#bvkoscj-1-lon),[sizedata](#bvkoscj-1-sizedata),[colordata](#bvkoscj-1-colordata)) specifies the colors of the bubbles using the categorical values incolordata. The function chooses a color for each category incolordata, plus one additional color for any elements ofcolordata that are undefined. The function selects colors from an ordered list of seven standard colors. If your data specifies more than seven categories, then the function cyclically repeats the colors.
Additional Options
geobubble(___,[Name=Value](#namevaluepairarguments)) specifies GeographicBubbleChart properties using name-value arguments. Specify the properties after all other input arguments. For example, theSizeVariable and ColorVariable properties enable you to specify table variables that determine the sizes and colors of the bubbles. For a list of properties, see GeographicBubbleChart Properties.
geobubble([parent](#bvkoscj-1%5Fsep%5Fmw%5F58c53d12-c3c1-4fe8-b606-f6a109982a64),___) creates the geographic bubble chart in the figure, panel, tab, or tiled chart layout specified byparent.
[gb](#mw%5F88714294-5a55-44ce-8c51-e6ca3196e29e) = geobubble(___) returns theGeographicBubbleChart object. Use gb to modify properties of the chart after creating it. For a list of properties, see GeographicBubbleChart Properties.
Examples
Read data about tsunamis into the workspace as a table. The table rows represent individual tsunami occurrences. The table variables include data about the tsunamis, such as the latitudes, longitudes, causes, and wave heights.
tsunamis = readtable("tsunamis.xlsx");
Prepare to color the bubbles according to the causes of the tsunamis. The Cause variable attributes a cause to each tsunami, such as 'Earthquake', 'Volcano', or 'Earthquake and Landslide'. Convert the Cause variable from a cell array of character vectors to a categorical vector.
tsunamis.Cause = categorical(tsunamis.Cause);
Create a geographic bubble chart from the table. Specify the tsunami locations using the Latitude and Longitude table variables. Specify the sizes of the bubble using the wave heights stored in the MaxHeight table variable. Specify the colors of the bubbles using the categories stored in the Cause table variable. When you create a geographic bubble chart from table data and specify the SizeVariable and ColorVariable arguments, the size and color legends display the names of the associated table variables.
geobubble(tsunamis,"Latitude","Longitude", ... SizeVariable="MaxHeight",ColorVariable="Cause")
Read data about tsunamis into the workspace as a table. The table rows represent individual tsunami occurrences. The table variables include data about the tsunamis, such as the latitudes, longitudes, causes, and wave heights.
tsunamis = readtable("tsunamis.xlsx");
Extract the latitudes, longitudes, and wave heights from the table.
lat = tsunamis.Latitude; lon = tsunamis.Longitude; sizedata = tsunamis.MaxHeight;
Create a geographic bubble chart from the latitudes, longitudes, and wave heights. Specify the bubble sizes using the wave heights. The geobubble function uses sizedata to control the relative distribution of the bubble sizes.
geobubble(lat,lon,sizedata)
Read data about tsunamis into the workspace as a table. The table rows represent individual tsunami occurrences. The table variables include data about the tsunamis, such as the latitudes, longitudes, causes, and wave heights.
tsunamis = readtable("tsunamis.xlsx");
Extract the latitudes, longitudes, wave heights, and causes from the table.
lat = tsunamis.Latitude; lon = tsunamis.Longitude; sizedata = tsunamis.MaxHeight; colordata = tsunamis.Cause;
The colordata variable categorizes the tsunamis by seven criteria: Earthquake, Earthquake and Landslide, Volcano, Volcano and Landslide, Landslide, Meteorological, and Unknown Cause. Convert colordata to a categorical vector.
colordata = categorical(colordata);
Create a geographic bubble chart from the latitudes, longitudes, wave heights, and causes. Specify the bubble sizes using the wave heights. Specify the bubble colors using the causes.
geobubble(lat,lon,sizedata,colordata)
When you create geographic bubble charts from vector data, the legends do not have titles. Add legend titles by specifying properties of the geographic bubble chart.
Read data about tsunamis into the workspace as a table. The table rows represent individual tsunami occurrences. The table variables include data about the tsunamis, such as the latitudes, longitudes, causes, and wave heights.
tsunamis = readtable("tsunamis.xlsx");
Extract the latitudes, longitudes, wave heights, and causes from the table.
lat = tsunamis.Latitude; lon = tsunamis.Longitude; sizedata = tsunamis.MaxHeight; colordata = tsunamis.Cause;
The colordata variable categorizes the tsunamis by seven criteria: Earthquake, Earthquake and Landslide, Volcano, Volcano and Landslide, Landslide, Meteorological, and Unknown Cause. Convert colordata to a categorical vector.
colordata = categorical(colordata);
Create a geographic bubble chart from the data. Return the GeographicBubbleChart object as gb.
gb = geobubble(lat,lon,sizedata,colordata);
Add a title and legend titles by setting the Title, SizeLegendTitle, and ColorLegendTitle properties.
gb.Title = "Tsunamis"; gb.SizeLegendTitle = "Max Height"; gb.ColorLegendTitle = "Cause";
Input Arguments
Source table, specified as a table or a timetable.
You can import data as a table by using the readtable function. You can also create a table from workspace variables by using the table function or create a timetable from workspace variables by using the timetable function.
The SourceTable property of theGeographicBubbleChart object stores the table that contains the plotted data.
Table variable containing the latitude coordinates, specified using one of these indexing schemes.
| Indexing Scheme | Examples |
|---|---|
| Variable name:A string scalar or character vector.A pattern object. The pattern object must refer to only one variable. | "A" or 'A' — A variable named A"Var"+digitsPattern(1) — The variable with the name "Var" followed by a single digit |
| Variable index:An index number that refers to the location of a variable in the table.A logical vector. Typically, this vector is the same length as the number of variables, but you can omit trailing 0 or false values. | 3 — The third variable from the table[false false true] — The third variable |
| Variable type:A vartype subscript that selects a table variable of a specified type. The subscript must refer to only one variable. | vartype("double") — The variable containing double values |
Regardless of the variable name, the axis label on the plot is alwaysLatitude.
The variable you specify must contain numeric data of type single or double. The data must be in the range [–90, 90].
Example: geobubble(tbl,"lat1","lon") specifies the table variable named lat1 for the latitude coordinates.
Example: geobubble(tbl,2,"lon") specifies the second variable for the latitude coordinates.
Example: geobubble(tbl,vartype("numeric"),"lon") specifies a numeric variable for the latitude coordinates.
Table variable containing the longitude coordinates, specified using one of these indexing schemes.
| Indexing Scheme | Examples |
|---|---|
| Variable name:A string scalar or character vector.A pattern object. The pattern object must refer to only one variable. | "A" or 'A' — A variable named A"Var"+digitsPattern(1) — The variable with the name "Var" followed by a single digit |
| Variable index:An index number that refers to the location of a variable in the table.A logical vector. Typically, this vector is the same length as the number of variables, but you can omit trailing 0 or false values. | 3 — The third variable from the table[false false true] — The third variable |
| Variable type:A vartype subscript that selects a table variable of a specified type. The subscript must refer to only one variable. | vartype("double") — The variable containing double values |
Regardless of the variable name, the axis label on the plot is alwaysLongitude.
The variables you specify must contain numeric data of typesingle or double.
Example: geobubble(tbl,"lat","lon1") specifies the table variable named lon1 for the longitude coordinates.
Example: geobubble(tbl,"lat",2) specifies the second variable for the longitude coordinates.
Example: geobubble(tbl,"lat",vartype("numeric")) specifies a numeric variable for the longitude coordinates.
Latitude coordinates in degrees, specified as vector with elements in the range [–90, 90]. The vector can contain NaN values.
The sizes of lat and lon must match.
Example: [43.0327 38.8921 44.0435]
Data Types: single | double
Longitude coordinates in degrees, specified as a vector. The vector can containNaN values.
The sizes of lon and lat must match.
Example: [-107.5556 -77.0269 -72.5565]
Data Types: single | double
Relative bubble sizes, specified as a scalar, a vector, or an empty array ([]). Vector inputs can include NaN values.
sizedata controls the relative distribution of the bubble sizes. By default, geobubble linearly maps a range of bubble areas across the range of the sizedata values.
If sizedata is a vector, the sizes ofsizedata, lat, and lon must match.
Example: [99 133 150]
Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
Categories that determine the bubble colors, specified as a categorical scalar or categorical vector. The categories are typically bins that data fall into.
Data Types: categorical
Parent container, specified as a Figure, Panel,Tab, TiledChartLayout, or GridLayout object.
Name-Value Arguments
Specify optional pairs of arguments asName1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.
Example: geobubble(tbl,latvar,lonvar,SizeVariable="MaxHeight",ColorVariable="Cause") specifies the table variables that contain bubble size data and bubble color data.
Before R2021a, use commas to separate each name and value, and enclose Name in quotes.
Example: geobubble(tbl,latvar,lonvar,"SizeVariable","MaxHeight","ColorVariable","Cause") specifies the table variables that contain bubble size data and bubble color data.
Note
Use name-value arguments to specify values for the properties of theGeographicBubbleChart objects created by this function. The properties listed here are only a subset. For a complete list, see GeographicBubbleChart Properties.
Map on which to plot data, specified as one of the values listed in the table. Six of the basemaps are tiled data sets created using Natural Earth. Five of the basemaps are high-zoom-level maps hosted by Esri®.
 |
'streets-light' (default)Map designed to provide geographic context while highlighting user data on a light background.Hosted by Esri. |  |
'streets-dark'Map designed to provide geographic context while highlighting user data on a dark background.Hosted by Esri. |
|---|---|---|---|
 |
'streets'General-purpose road map that emphasizes accurate, legible styling of roads and transit networks.Hosted by Esri. |  |
'satellite'Full global basemap composed of high-resolution satellite imagery.Hosted by Esri. |
 |
'topographic'General-purpose map with styling to depict topographic features.Hosted by Esri. |  |
'landcover'Map that combines satellite-derived land cover data, shaded relief, and ocean-bottom relief. The light, natural palette is suitable for thematic and reference maps.Created using Natural Earth. |
 |
'colorterrain'Shaded relief map blended with a land cover palette. Humid lowlands are green and arid lowlands are brown.Created using Natural Earth. |  |
'grayterrain'Terrain map in shades of gray. Shaded relief emphasizes both high mountains and micro-terrain found in lowlands. Created usingNatural Earth. |
 |
'bluegreen'Two-tone, land-ocean map with light green land areas and light blue water areas.Created using Natural Earth. |  |
'grayland'Two-tone, land-ocean map with gray land areas and white water areas.Created using Natural Earth. |
 |
'darkwater'Two-tone, land-ocean map with light gray land areas and dark gray water areas. This basemap is installed with MATLAB®.Created using Natural Earth. | 'none'Blank background that plots your data with a latitude-longitude grid, ticks, and labels. |
All basemaps except 'darkwater' require Internet access. The'darkwater' basemap is included with MATLAB.
If you do not have consistent access to the Internet, you can download the basemaps created using Natural Earth onto your local system by using the Add-On Explorer. The five high-zoom-level maps are not available for download. For more about downloading basemaps and changing the default basemap on your local system, see Access Basemaps for Geographic Axes and Charts.
The basemaps hosted by Esri update periodically. As a result, you might see differences in your visualizations over time.
Alignment of boundaries and region labels are a presentation of the feature provided by the data vendors and do not imply endorsement by MathWorks®.
Data Types: char | string
Layout of the map, including the insets and decorations, specified as'normal' or 'maximized'.
| Value | Description | Illustration |
|---|---|---|
| 'normal' | Map is inset from the edges of the chart, as defined by itsOuterPosition property. The axes labels, ticks, and tick labels are visible. The title is visible, when specified. Legends, when present, appear outside and to the right of the map. |  |
| 'maximized' | Map fills the entire space, as defined by theOuterPosition property. The axes labels, ticks, and tick labels are hidden. The title is hidden, even when specified. The grid is hidden, even when the GridVisible property has a value of 'on'. Legends, when present, appear within the map, toward the upper-right corner. |  |
Data Types: char | string
Table variable containing the bubble size data, specified using one of these indexing schemes.
| Indexing Scheme | Examples |
|---|---|
| Variable name:A string scalar or character vector.A pattern object. The pattern object must refer to only one variable. | "A" or 'A' — A variable named A"Var"+digitsPattern(1) — The variable with the name "Var" followed by a single digit |
| Variable index:An index number that refers to the location of a variable in the table.A logical vector. Typically, this vector is the same length as the number of variables, but you can omit trailing 0 or false values. | 3 — The third variable from the table[false false true] — The third variable |
| Variable type:A vartype subscript that selects a table variable of a specified type. The subscript must refer to only one variable. | vartype("double") — The variable containing double values |
The variable you specify can contain any numeric type. When you set the SizeVariable property, MATLAB updates the SizeData property.
Table variable containing the bubble color data, specified using one of these indexing schemes.
| Indexing Scheme | Examples |
|---|---|
| Variable name:A string scalar or character vector.A pattern object. The pattern object must refer to only one variable. | "A" or 'A' — A variable named A"Var"+digitsPattern(1) — The variable with the name "Var" followed by a single digit |
| Variable index:An index number that refers to the location of a variable in the table.A logical vector. Typically, this vector is the same length as the number of variables, but you can omit trailing 0 or false values. | 3 — The third variable from the table[false false true] — The third variable |
| Variable type:A vartype subscript that selects a table variable of a specified type. The subscript must refer to only one variable. | vartype("double") — The variable containing double values |
The variable you specify must contain categorical values. When you set the ColorVariable property, MATLAB updates the ColorData property.
Output Arguments
Geographic bubble chart, returned as a GeographicBubbleChart object. The geographic bubble chart created by the geobubble function is a standalone visualization. Use gb to set properties of the geographic bubble chart after creating it.
More About
A geographic bubble chart displays your data on a map with a basemap that provides geographic context for your data. Initially, the chart sets the geographic limits of the map to encompass all of your data. The map is live, so you can pan the basemap to view other geographic locations. You can also zoom in and out on the map to view regions in more detail. The chart updates the map as you pan and zoom.
A standalone visualization is a chart designed for a special purpose that works independently from other charts. Unlike other charts such as plot and surf, a standalone visualization has a preconfigured axes object built into it, and some customizations are not available. A standalone visualization also has these characteristics:
- It cannot be combined with other graphics elements, such as lines, patches, or surfaces. Thus, the
holdcommand is not supported. - The
gcafunction can return the chart object as the current axes. - You can pass the chart object to many MATLAB functions that accept an axes object as an input argument. For example, you can pass the chart object to the
titlefunction.
Tips
- If you create a geographic bubble chart from a table, then you can customize its data tips.
- To add or remove a row from the data tip, right-click anywhere on the chart and point to . Then, select or deselect a variable.
- To add or remove multiple rows, right-click on the chart, point to , and select . Then, add variables by clicking>> or remove them by clicking**<<**.
- To programmatically bring focus to a geographic bubble chart, use the
axesfunction, for exampleaxes(gb). - When you plot on geographic axes, the
geobubblefunction assumes that coordinates are referenced to the WGS84 coordinate reference system. If you plot using coordinates that are referenced to a different coordinate reference system, then the coordinates might appear misaligned.
Alternative Functionality
- Geographic bubble charts do not support customizations such as changing the line width of bubbles, changing the transparency of bubbles, or adding text and line annotations. To create a similar chart that supports more customizations, create a bubble chart in a geographic axes by using the
geoaxesandbubblechartfunctions. For an example that shows how to create such a chart, see Combine Bubble Chart with Other Graphics in Geographic Axes. - To create a bubble chart in a map axes object (Mapping Toolbox™), use the bubblechart function.
Version History
Introduced in R2017b