# geobubble
以可视方式呈现特定地理位置的数据值
函数库: TyGeoGraphics
# 语法
geobubble(lat,lon,sizedata)
geobubble(lat,lon,sizedata,colordata)
geobubble(___,Key=Value)
gb = geobubble(___)
# 说明
geobubble(lat,lon,sizedata)创建一个地理气泡图，其中lat和lon指定地理位置,并根据sizedata中的数值缩放气泡的区域。示例
geobubble(lat,lon,sizedata,colordata)使用colordata中的分类数据来确定气泡的颜色。geobubble为colordata中的每个类别选择一种颜色，如果colordata中有任何未定义的元素，则再加上一种颜色。颜色是从包含7种标准颜色的有序列表中选取的。在超过七个类别时，颜色会循环重复。示例
geobubble(___,Key=Value)使用一个或多个名称-值对组参数指定地理气泡图的其他选项。请在所有其他输入参数之后指定这些选项。有关属性列表，请参阅PathCollection属性。示例
gb = geobubble(___) 返回 PathCollection 对象。创建图后，使用 gb 修改图属性。有关属性列表，请参阅 PathCollection 属性。
# 示例
显示海啸数据并利用气泡大小指示海啸大小
将海啸数据读入工作区。
using TyGeoGraphics
pkg_dir = pkgdir(TyGeoGraphics)
source_path = pkg_dir * "/examples/geobubble/0-tsunami.jl"
include(source_path)
geoaxes()
创建一个地理气泡图，在地图上绘制海啸的位置。使用 maxheight 变量中的数据指定气泡的大小。
geobubble(lat, lon, MaxHeight; edgecolors = [1, 1, 1], alpha = 0.7, linewidths = 0.5)
显示海啸数据并利用气泡颜色指示海啸原因
将海啸数据读入工作区。
using TyGeoGraphics
pkg_dir = pkgdir(TyGeoGraphics)
source_path = pkg_dir * "/examples/geobubble/0-tsunami.jl"
include(source_path)
geoaxes()
创建一个地理气泡图，在地图上绘制海啸的位置。使用气泡大小指示海浪大小，使用气泡颜色指示原因。
geobubble(lat, lon, MaxHeight, Cause; edgecolors = [1, 1, 1], alpha = 0.7, linewidths = 0.5)
使用地理气泡图属性添加图例
将海啸数据读入工作区。
using TyGeoGraphics
using TyPlot
pkg_dir = pkgdir(TyGeoGraphics)
source_path = pkg_dir * "/examples/geobubble/0-tsunami.jl"
include(source_path)
geoaxes()
创建一个地理气泡图，在地图上绘制海啸的位置。使用气泡大小指示海浪大小，使用气泡颜色指示海啸原因。
geobubble(lat, lon, MaxHeight, Cause; edgecolors = [1, 1, 1], alpha = 0.7, linewidths = 0.5)
使用地理气泡图属性修改图。
title("Tsunamis")
legend("on", title = "Cause", title_fontsize = "large")
# 输入参数
lat - 以度为单位的纬度坐标[-90 90] 范围内的有限实数数值向量
以度为单位的纬度坐标，指定为 [-90 90] 范围内的有限实数数值向量。lat 的大小必须与 lon 相同。
示例： [43.0327 38.8921 44.0435]
lon - 以度为单位的经度坐标[-180 180] 范围内的有限实数数值向量
以度为单位的经度坐标，指定为[-180 180] 范围内的有限实数数值向量。lon 的大小必须与 lat 相同。
示例： [-107.5556 -77.0269 -72.5565]
sizedata - 决定气泡大小的数据有限实数数值向量
决定气泡大小的数据，指定为有限实数数值向量,sizedata 的大小必须与 lat 和 lon 相同。
示例： [99 133 150]
数据类型： Int8 | Int16 | Int32 | Int64 | UInt8 | UInt16 | UInt32 | UInt64
colordata - 决定气泡颜色的数据类别字符串向量
决定气泡颜色的数据类别，指定为字符串向量。类别通常是数据可归入的分组。
数据类型： String
# 名称-值对组参数
指定可选的 Key=Value 对组参数。Key 为参数名称，Value 为对应的值。您可采用任意顺序指定多个名称-值对组参数，如 Key1=Value1,...,KeyN=ValueN 所示。
edgecolors - 线条颜色[1,1,1] （默认） | RGB 三元组 | 十六进制颜色代码 | | "r" | "g" | "b" | ...
线条颜色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。默认的 RGB 三元组值 [0,0,0] 与黑色对应。
对于自定义颜色，请指定 RGB 三元组或十六进制颜色代码。
- RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内，例如 [0.4, 0.6, 0.7]。
- 十六进制颜色代码是字符向量或字符串标量，以井号 (#) 开头，后跟三个或六个十六进制数字，范围可以是 0 到 F。 这些值不区分大小写。因此，颜色代码 "#FF8800" 与 "#ff8800"、"#F80" 与 "#f80" 是等效的。
此外，还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。
| 颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
|---|---|---|---|---|
| "red" | "r" | [1, 0, 0] | "#FF0000" |  |
| "green" | 不适用 | [0, 0.5019607843137255, 0] | "#008000" |  |
| 不适用 | "g" | [0, 0.5, 0] | "#007F00" | |
| 不适用 | 不适用 | [0, 1, 0] | "#00FF00" |  |
| "blue" | "b" | [0, 0, 1] | "#0000FF" |  |
| "cyan" | 不适用 | [0, 1, 1] | "#00FFFF" |  |
| 不适用 | "c" | [0, 0.75, 0.75] | "#00BFBF" |  |
| "magenta" | 不适用 | [1, 0, 1] | "#FF00FF" |  |
| 不适用 | "m" | [0.75, 0, 0.75] | "#BF00BF" |  |
| "yellow" | 不适用 | [1, 1, 0] | "#FFFF00" |  |
| 不适用 | "y" | [0.75, 0.75, 0] | "#BFBF00" |  |
| "black" | "k" | [0, 0, 0] | "#000000" |  |
| "white" | "w" | [1, 1, 1] | "#FFFFFF" |  |
| "none" | 不适用 | 不适用 | 不适用 | 无颜色 |
以下是 Syslab 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。
| RGB 三元组 | 十六进制颜色代码 | 外观 |
|---|---|---|
| [0, 0.4470, 0.7410] | "#0072BD" |  |
| [0.8500, 0.3250, 0.0980] | "#D95319" |  |
| [0.9290, 0.6940, 0.1250] | "#EDB120" |  |
| [0.4940, 0.1840, 0.5560] | "#7E2F8E" |  |
| [0.4660, 0.6740, 0.1880] | "#77AC30" |  |
| [0.3010, 0.7450, 0.9330] | "#4DBEEE" |  |
| [0.6350, 0.0780, 0.1840] | "#A2142F" |  |
markerfacecolor - 标记填充颜色"nothing" | "auto" | RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ...
标记填充颜色，指定为 "auto"、RGB 三元组、十六进制颜色代码、颜色名称或短名称。"auto" 选项使用与坐标区的 color 属性相同的颜色。
对于自定义颜色，请指定 RGB 三元组或十六进制颜色代码。
- RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内，例如 [0.4, 0.6, 0.7]。
- 十六进制颜色代码是字符向量或字符串标量，以井号 (#) 开头，后跟三个或六个十六进制数字，范围可以是 0 到 F。 这些值不区分大小写。因此，颜色代码 "#FF8800" 与 "#ff8800"、"#F80" 与 "#f80" 是等效的。
此外，还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。
| 颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
|---|---|---|---|---|
| "red" | "r" | [1, 0, 0] | "#FF0000" | |
| "green" | 不适用 | [0, 0.5019607843137255, 0] | "#008000" | |
| 不适用 | "g" | [0, 0.5, 0] | "#007F00" | |
| 不适用 | 不适用 | [0, 1, 0] | "#00FF00" | |
| "blue" | "b" | [0, 0, 1] | "#0000FF" | |
| "cyan" | 不适用 | [0, 1, 1] | "#00FFFF" | |
| 不适用 | "c" | [0, 0.75, 0.75] | "#00BFBF" | |
| "magenta" | 不适用 | [1, 0, 1] | "#FF00FF" | |
| 不适用 | "m" | [0.75, 0, 0.75] | "#BF00BF" | |
| "yellow" | 不适用 | [1, 1, 0] | "#FFFF00" | |
| 不适用 | "y" | [0.75, 0.75, 0] | "#BFBF00" | |
| "black" | "k" | [0, 0, 0] | "#000000" | |
| "white" | "w" | [1, 1, 1] | "#FFFFFF" | |
| "none" | 不适用 | 不适用 | 不适用 | 无颜色 |
以下是 Syslab 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。
| RGB 三元组 | 十六进制颜色代码 | 外观 |
|---|---|---|
| [0, 0.4470, 0.7410] | "#0072BD" | |
| [0.8500, 0.3250, 0.0980] | "#D95319" | |
| [0.9290, 0.6940, 0.1250] | "#EDB120" | |
| [0.4940, 0.1840, 0.5560] | "#7E2F8E" | |
| [0.4660, 0.6740, 0.1880] | "#77AC30" | |
| [0.3010, 0.7450, 0.9330] | "#4DBEEE" | |
| [0.6350, 0.0780, 0.1840] | "#A2142F" | |
示例： [0.3,0.2,0.1]
示例： "green"
示例： "#D2F9A7"
alpha - 透明度1 （默认） | 范围 [0,1] 中的标量
透明度，指定为下列值之一：
- 范围 [0,1] 中的标量 - 在所有图形对象上使用统一的透明度。值为 1 时完全不透明，值为 0 时完全透明。介于 0 和 1 之间的值表示半透明。
linewidths - 线条宽度0.5 （默认） | 正值
等高线宽度，指定为以磅为单位的正值。一磅等于 1/72 英寸。
# 另请参阅
# 函数
geobasemap | geodensityplot | geolimits | geoplot | geoscatter