Skip to content

Tutorial:Plotting features on a 3-D surface#4466

Open
Chuan1937 wants to merge 17 commits intomainfrom
topographic
Open

Tutorial:Plotting features on a 3-D surface#4466
Chuan1937 wants to merge 17 commits intomainfrom
topographic

Conversation

@Chuan1937
Copy link
Member

@Chuan1937 Chuan1937 commented Mar 21, 2026

@Chuan1937 Chuan1937 self-assigned this Mar 21, 2026
@Chuan1937 Chuan1937 added the documentation Improvements or additions to documentation label Mar 21, 2026
@Chuan1937 Chuan1937 added this to the 0.19.0 milestone Mar 21, 2026
@seisman seisman requested a review from Copilot March 21, 2026 16:49
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new advanced PyGMT tutorial demonstrating how to overlay additional map features (coastlines, symbols, and text) on top of a 3-D topographic surface created with Figure.grdview, addressing the need described in Issue #3429.

Changes:

  • Introduces a new Sphinx-Gallery tutorial script with three examples: coastlines, plot3d symbols, and text annotations on a 3-D surface.
  • Uses Taiwan earth relief as the common dataset and consistent 3-D perspective settings across examples.
  • Sets a gallery thumbnail selection for the multi-figure tutorial output.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Chuan1937 and others added 7 commits March 22, 2026 11:31
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@Chuan1937
Copy link
Member Author

image Why is the color not the right color. I follow the example below: image

@seisman

@Esteban82
Copy link
Member

Just to confirm: PyGMT uses GMT under the hood for 3D plotting, so it behaves the same way.

It might be worth mentioning that 3D rendering relies on a painter’s algorithm (depth sorting). This means that in some cases the result may not be visually correct. For example, a city or road that should be hidden behind a mountain may still be visible from some viewpoints due to the painter’s algorithm (no true occlusion).

@Chuan1937
Copy link
Member Author

Just to confirm: PyGMT uses GMT under the hood for 3D plotting, so it behaves the same way.

It might be worth mentioning that 3D rendering relies on a painter’s algorithm (depth sorting). This means that in some cases the result may not be visually correct. For example, a city or road that should be hidden behind a mountain may still be visible from some viewpoints due to the painter’s algorithm (no true occlusion).

Thanks, I've add it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants