Figure.choropleth: Plot a choropleth map.

[seisman]

This issue serves as the central place for discussing and tracking the implementation of the choropleth method in PyGMT, which is a thin wrapper for plot. The issue will be closed when the initial implementation is complete. Progress is tracked at PyGMT: Wrapping GMT modules.

Documentation

• GMT: https://docs.generic-mapping-tools.org/dev/plot.html
• GMT.jl: https://www.generic-mapping-tools.org/GMTjl_doc/documentation/modules/plot
• PyGMT: https://www.pygmt.org/dev/api/generated/pygmt.Figure.choropleth.html

GMT Option Flags and Modifiers

☑️: Implemented; ⬜: To be implemented/discussed; Strikethrough: Won't implement.

• data
• -C: cmap
• column: specify the column name used for filling
• Need to document the valid parameters that can passed to Figure.plot

Notes on Input Formats

• Accepts geo-like objects implementing __geo_interface__ (e.g., GeoDataFrame) or OGR_GMT files.
• Uses aspatial to map the column to Z for fill.

Linked Pull Requests

• Initial feature implementation Add Figure.choropleth to plot choropleth maps #2798
• Add a tutorial or gallery example #choropleth

Related Issues and Discussions

• Add links to related wrapper discussions, API design threads, or upstream GMT changes here.