Skip to content

Standardize figure/map/plot terminology in codes and docs [Part 1]#4418

Open
Copilot wants to merge 17 commits intomainfrom
copilot/update-figure-map-usage
Open

Standardize figure/map/plot terminology in codes and docs [Part 1]#4418
Copilot wants to merge 17 commits intomainfrom
copilot/update-figure-map-usage

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Feb 14, 2026

Partially address #2437.

Copilot AI and others added 2 commits February 14, 2026 10:31
- Change "plot or map" to "plot" in examples and tutorials
- Change "Map Boundary" to "Plot Boundary" in figure elements example
- Change "Plotting map elements" to "Plotting embellishments" in API docs
- Change "geographical maps" to "geographic maps" for consistency
- Update "map boundary" to "plot boundary" in decorators and rose module

Co-authored-by: seisman <3974108+seisman@users.noreply.github.com>
- Change "geographical tick annotations" to "geographic tick annotations"
- Change "map frame" to "plot frame" in 3D perspective documentation

Co-authored-by: seisman <3974108+seisman@users.noreply.github.com>
Copilot AI changed the title [WIP] Clarify usage of figure vs map and plot Standardize figure/map/plot terminology across documentation Feb 14, 2026
Copilot AI requested a review from seisman February 14, 2026 10:35
Co-authored-by: seisman <3974108+seisman@users.noreply.github.com>
Copilot AI changed the title Standardize figure/map/plot terminology across documentation Fix terminology: use "plot dimensions" instead of "map dimensions" in 3D scatter example Feb 14, 2026
- examples/projections/nongeo/polar.py: Changed "Set map limits" to "Set plot limits" and "Set map width" to "Set plot width" (12 instances)
- pygmt/src/contour.py: Changed "on a map" to "on a plot"
- pygmt/src/image.py: Changed "on a map" to "on a plot"
- pygmt/src/text.py: Changed "on the map" to "on the plot" and "of the map" to "of the plot"

Co-authored-by: seisman <3974108+seisman@users.noreply.github.com>
Copilot AI changed the title Fix terminology: use "plot dimensions" instead of "map dimensions" in 3D scatter example Standardize "figure"/"map"/"plot" terminology across codebase Feb 14, 2026
…→ "plot region"

- pygmt/src/plot.py line 199: Changed "clipped to the map region" to "clipped to the plot region"
- pygmt/src/plot3d.py line 174: Changed "clipped to the map region" to "clipped to the plot region"
- pygmt/src/grdimage.py line 72: Changed "select a map region" to "select a plot region"

Co-authored-by: seisman <3974108+seisman@users.noreply.github.com>
Copilot AI and others added 2 commits February 25, 2026 03:28
Deep search revealed additional terminology issues:
- pygmt/src/grdproject.py: "map region large" → "plot region larger" (also fixed typo)
- pygmt/src/plot.py: "on a map" → "on a plot"
- pygmt/src/velo.py: "on a map" → "on a plot"

Co-authored-by: seisman <3974108+seisman@users.noreply.github.com>
Deep search found three more instances in subplot.py where "map" was used in contexts that apply to all plot types (not just geographic maps):
- Line 248: "main map plotting" → "main plotting"
- Line 378: "dimensions of the map" → "dimensions of the plot"
- Line 410: "main map plotting" → "main plotting"

Co-authored-by: seisman <3974108+seisman@users.noreply.github.com>
Copilot AI changed the title Standardize "figure"/"map"/"plot" terminology across codebase Standardize figure/map/plot terminology in source docstrings Feb 25, 2026
- doc/api/index.rst: "Plotting figure elements" → "Plotting embellishments" (consistent with gallery and techref usage)
- pygmt/src/image.py: "plot it on a plot" → "plots it" (fix awkward phrasing)
- pygmt/tests/test_image.py: "Place images on map" → "Place images on the figure"
- pygmt/tests/test_subplot.py: "map frame setting" → "plot frame setting", "all subplot figures" → "all subplot panels", "Plot map elements" → "Plot elements"

Agent-Logs-Url: https://github.com/GenericMappingTools/pygmt/sessions/ec6d8067-efa4-4bd0-ad87-85456d70041c

Co-authored-by: seisman <3974108+seisman@users.noreply.github.com>
@seisman seisman changed the title Standardize figure/map/plot terminology in source docstrings Standardize figure/map/plot terminology in codes and docs [Part 1] Apr 9, 2026
@seisman seisman added this to the 0.19.0 milestone Apr 9, 2026
@seisman seisman added maintenance Boring but important stuff for the core devs skip-changelog Skip adding Pull Request to changelog labels Apr 9, 2026
@seisman seisman marked this pull request as ready for review April 9, 2026 00:15
@seisman seisman requested a review from yvonnefroehlich April 9, 2026 00:15
@seisman
Copy link
Copy Markdown
Member

seisman commented Apr 9, 2026

@yvonnefroehlich It's likely that this PR doesn't fix all inconsistencies, but I feel it's a good start and already contains enough changes. So please review.

@seisman seisman added the needs review This PR has higher priority and needs review. label Apr 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

maintenance Boring but important stuff for the core devs needs review This PR has higher priority and needs review. skip-changelog Skip adding Pull Request to changelog

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants