gplately.PygmtPlotEngine

class gplately.PygmtPlotEngine[source]

Bases: PlotEngine

Use PyGMT for map plotting.

__init__()[source]

Methods

`__init__`()
`plot_geo_data_frame`(ax_or_fig, gdf, **kwargs)	Use PyGMT to plot geometries in a GeoDataFrame object onto a map.
`plot_grid`(ax_or_fig, grid[, projection, ...])	Use PyGMT to plot a grid onto a map.
`plot_plate_motion_vectors`(ax_or_fig, ...[, ...])	Plot plate motion vectors (abstract method)
`plot_pole`(ax_or_fig, lon, lat, a95[, color])	Plot a paleomagnetic pole onto a map using PyGMT.
`plot_pygplates_features`(ax_or_fig, features, ...)	Use PyGMT to plot one or more pygplates features onto a map.
`plot_subduction_zones`(ax_or_fig, ...[, color])	Use PyGMT to plot subduction zones with "teeth"

plot_geo_data_frame(ax_or_fig, gdf: GeoDataFrame, **kwargs)[source]

Use PyGMT to plot geometries in a GeoDataFrame object onto a map.

Parameters:

ax_or_fig (pygmt.Figure()) – pygmt Figure object
gdf (GeoDataFrame) – GeoPandas GeoDataFrame object
edgecolor (str) – For polygons, it is the border colour. For polylines, it is the line colour. Currently, only colour names are tested and officially supported, for example, “red”, “blue”, etc.
facecolor (str) – The colour used to fill the polygon.
fill (str) – GMT “fill” parameter
pen (str) – GMT “pen” parameter
style (str) – GMT “style” parameter
gmtlabel (str) – GMT “label” parameter for lines and polygons
pointlabel (str) – Optional label applied only to point geometries.

plot_grid(ax_or_fig, grid, projection=None, extent=(-180, 180, -90, 90), cmap='gmt/geo', nan_transparent=False, shading=None, **kwargs)[source]

Use PyGMT to plot a grid onto a map.

Parameters:

ax_or_fig (pygmt.Figure()) – A PyGMT Figure object.
grid (Raster) – A gplately Raster object or 2D array-like grid data.
projection (str) – Not used currently.
extent (str or tuple) – (xmin, xmax, ymin, ymax). See details at https://www.pygmt.org/dev/tutorials/basics/regions.html
cmap (str) – A built-in GMT colormaps name or a CPT file path.
nan_transparent (bool) – If True, NaN values in the grid will be plotted as transparent.
shading (bool, str, or grid-like, optional) –
Apply illumination/hillshading to the grid image. Accepted values are:
- True: use default shading parameters (equivalent to GMT -I+d).
- A string such as "+a315+ne0.6" to pass directly as the GMT -I option (azimuth and intensity specification).
- An xarray.DataArray, the pygmt.grdgradient() will be called upon this DataArray inside this function to compute the illumination grid from the provided data array.
- Full file path pointing to a grid which will be used for illumination. The pygmt.grdgradient() will be called upon the grid inside this function.
- None (default): no shading is applied.
**kwargs – Additional keyword arguments.

plot_plate_motion_vectors(ax_or_fig, gdf_motion_vectors: GeoDataFrame, projection=None, scale_factor=1.0, color='black', **kwargs)[source]: Plot plate motion vectors (abstract method)

plot_pole(ax_or_fig, lon, lat, a95, color='green')[source]: Plot a paleomagnetic pole onto a map using PyGMT.

plot_pygplates_features(ax_or_fig, features, **kwargs)[source]

Use PyGMT to plot one or more pygplates features onto a map.

Parameters:

ax_or_fig (pygmt.Figure()) – pygmt Figure object
features (pygplates.Feature or list of pygplates.Feature) – One or more pygplates.Feature objects to be plotted.
edgecolor (str) – For polygons, it is the border colour. For polylines, it is the line colour.
facecolor (str) – The colour used to fill the polygon.
fill (str) – GMT “fill” parameter
pen (str) – GMT “pen” parameter

Warning

This method will not check features’ valid time. It just simply plots all the geometries in the features. You need to filter features by valid time yourself before passing them to this method if you want to plot features at a specific time.