def iconviz(ax,
points,
bounding_box,
icon_path,
coordinate_system='EPSG:3857',
**extra_contextily_params):
"""
Plots an icon map in Matplotlib.
Parameters
----------
ax : matplotlib.axes.Axes
Axes where geometries will be plotted.
points : GeoSeries
Sequence of points.
bounding_box : list
Bounding box of the map. For example, [west, south, east, north].
icon_path : str
Absolute path to icon file.
coordinate_system : str, optional
The Coordinate Reference System (CRS) set to all geometries, by default 'EPSG:3857'.
Only supports SRID as a WKT representation of CRS by now.
**extra_contextily_params: dict
Extra parameters passed to `contextily.add_basemap. <https://contextily.readthedocs.io/en/latest/reference.html>`_
Examples
-------
>>> import pandas as pd
>>> import numpy as np
>>> import arctern
>>> import matplotlib.pyplot as plt
>>> # read from test_data.csv
>>> # Download link: https://raw.githubusercontent.com/arctern-io/arctern-resources/benchmarks/benchmarks/dataset/layer_rendering_test_data/test_data.csv
>>> df = pd.read_csv("/path/to/test_data.csv", dtype={'longitude':np.float64, 'latitude':np.float64, 'color_weights':np.float64, 'size_weights':np.float64, 'region_boundaries':np.object}, nrows=10)
>>> points = arctern.GeoSeries.point(df['longitude'], df['latitude'])
>>> # plot icon visualization
>>> # Download icon-viz.png : https://raw.githubusercontent.com/arctern-io/arctern-docs/master/img/icon/icon-viz.png
>>> fig, ax = plt.subplots(figsize=(10, 6), dpi=200)
>>> arctern.plot.iconviz(ax, points, bounding_box=[-74.01424568752932, 40.72759334104623, -73.96056823889673, 40.76721122683304], icon_path='/path/to/icon-viz.png', coordinate_system='EPSG:4326')
>>> plt.show()
"""
from matplotlib import pyplot as plt
import contextily as cx
bbox = _transform_bbox(bounding_box, coordinate_system, 'epsg:3857')
w, h = _get_recom_size(bbox[2] - bbox[0], bbox[3] - bbox[1])
vega = vega_icon(w,
h,
bounding_box=bounding_box,
icon_path=icon_path,
coordinate_system=coordinate_system)
hexstr = arctern.icon_viz_layer(vega, points)
f = io.BytesIO(base64.b64decode(hexstr))
img = plt.imread(f)
ax.set(xlim=(bbox[0], bbox[2]), ylim=(bbox[1], bbox[3]))
cx.add_basemap(ax, **extra_contextily_params)
ax.imshow(img,
alpha=img[:, :, 3],
extent=(bbox[0], bbox[2], bbox[1], bbox[3]))
ax.axis('off')
def test_icon_viz():
x_data = []
y_data = []
x_data.append(-73.96524)
x_data.append(-73.96118)
x_data.append(-73.97324)
x_data.append(-73.98456)
y_data.append(40.73747)
y_data.append(40.74507)
y_data.append(40.75890)
y_data.append(40.77654)
arr_x = pandas.Series(x_data)
arr_y = pandas.Series(y_data)
points = arctern.ST_Point(arr_x, arr_y)
import os
dir_path = os.path.dirname(os.path.realpath(__file__))
png_path = dir_path + "/../images/taxi.png"
vega = vega_icon(
1024,
896,
bounding_box=[-73.998427, 40.730309, -73.954348, 40.780816],
icon_path=png_path,
coordinate_system="EPSG:4326")
icon_buf = arctern.icon_viz_layer(vega, points)
save_png(icon_buf, "/tmp/test_icon_viz.png")
def iconviz(ax,
points,
bounding_box,
icon_path,
coordinate_system='EPSG:3857',
**extra_contextily_params):
"""
:type ax: AxesSubplot
:param ax: Matplotlib axes object on which to add the basemap.
:type points: Series(dtype: object)
:param points: Points in WKB form
:type bounding_box: (float, float, float, float)
:param bounding_box: The bounding rectangle, as a [left, upper, right, lower]-tuple.
value should be of :coordinate_system:
:type coordinate_system: str
:param coordinate_system: either 'EPSG:4326' or 'EPSG:3857'
:type extra_contextily_params: dict
:param extra_contextily_params: extra parameters for contextily.add_basemap.
See https://contextily.readthedocs.io/en/latest/reference.html
"""
from matplotlib import pyplot as plt
import contextily as cx
bbox = _transform_bbox(bounding_box, coordinate_system, 'epsg:3857')
w, h = _get_recom_size(bbox[2] - bbox[0], bbox[3] - bbox[1])
vega = vega_icon(w,
h,
bounding_box=bounding_box,
icon_path=icon_path,
coordinate_system=coordinate_system)
hexstr = arctern.icon_viz_layer(vega, points)
f = io.BytesIO(base64.b64decode(hexstr))
img = plt.imread(f)
ax.set(xlim=(bbox[0], bbox[2]), ylim=(bbox[1], bbox[3]))
cx.add_basemap(ax, **extra_contextily_params)
ax.imshow(img,
alpha=img[:, :, 3],
extent=(bbox[0], bbox[2], bbox[1], bbox[3]))
def iconviz(ax,
points,
bounding_box,
icon_path,
coordinate_system='EPSG:3857',
**extra_contextily_params):
"""
Plot points as icons on map in Matplotlib
:type ax: AxesSubplot
:param ax: Matplotlib axes object on which to add the basemap.
:type points: GeoSeries
:param points: Sequence of Points
:type bounding_box: list
:param bounding_box: Specify the bounding rectangle [west, south, east, north].
:type icon_path: str
:param icon_path: Absolute path to icon file
:type coordinate_system: str
:param coordinate_system: Coordinate Reference System of the geometry objects.
Must be SRID formed, e.g. 'EPSG:4326' or 'EPSG:3857'
Default as 'EPSG:3857'
:type extra_contextily_params: dict
:param extra_contextily_params: Extra parameters will be passed to contextily.add_basemap.
See https://contextily.readthedocs.io/en/latest/reference.html for details
:example:
>>> import pandas as pd
>>> import numpy as np
>>> import arctern
>>> import matplotlib.pyplot as plt
>>> # read from test_data.csv
>>> # Download link: https://raw.githubusercontent.com/arctern-io/arctern-resources/benchmarks/benchmarks/dataset/layer_rendering_test_data/test_data.csv
>>> df = pd.read_csv("/path/to/test_data.csv", dtype={'longitude':np.float64, 'latitude':np.float64, 'color_weights':np.float64, 'size_weights':np.float64, 'region_boundaries':np.object}, nrows=10)
>>> points = arctern.GeoSeries.point(df['longitude'], df['latitude'])
>>> # plot icon visualization
>>> # Download icon-viz.png : https://raw.githubusercontent.com/arctern-io/arctern-docs/master/img/icon/icon-viz.png
>>> fig, ax = plt.subplots(figsize=(10, 6), dpi=200)
>>> arctern.plot.iconviz(ax, points, bounding_box=[-74.01424568752932, 40.72759334104623, -73.96056823889673, 40.76721122683304], icon_path='/path/to/icon-viz.png', coordinate_system='EPSG:4326')
>>> plt.show()
"""
from matplotlib import pyplot as plt
import contextily as cx
bbox = _transform_bbox(bounding_box, coordinate_system, 'epsg:3857')
w, h = _get_recom_size(bbox[2] - bbox[0], bbox[3] - bbox[1])
vega = vega_icon(w,
h,
bounding_box=bounding_box,
icon_path=icon_path,
coordinate_system=coordinate_system)
hexstr = arctern.icon_viz_layer(vega, points)
f = io.BytesIO(base64.b64decode(hexstr))
img = plt.imread(f)
ax.set(xlim=(bbox[0], bbox[2]), ylim=(bbox[1], bbox[3]))
cx.add_basemap(ax, **extra_contextily_params)
ax.imshow(img,
alpha=img[:, :, 3],
extent=(bbox[0], bbox[2], bbox[1], bbox[3]))
ax.axis('off')
def iconviz(point, conf=vega):
from arctern import icon_viz_layer
return icon_viz_layer(conf, point, False)