René's URL Explorer Experiment

Title: ENH: add geometric axlim clipping for 3D surfaces and line collections by DanielBetschinske · Pull Request #31732 · matplotlib/matplotlib · GitHub

Open Graph Title: ENH: add geometric axlim clipping for 3D surfaces and line collections by DanielBetschinske · Pull Request #31732 · matplotlib/matplotlib

X Title: ENH: add geometric axlim clipping for 3D surfaces and line collections by DanielBetschinske · Pull Request #31732 · matplotlib/matplotlib

Description: PR summary Related to #25804. This PR adds an opt-in geometric axes-limit clipping mode for selected mplot3d polygon and line artists. Currently, axlim_clip=True hides/masks surface patches or line segments when vertices fall outside the current 3D axes view limits. For surfaces and wireframes this can leave visible gaps at the axes-limit boundary. This PR keeps the existing behavior as the default: ax.plot_surface(..., axlim_clip=True) ax.plot_wireframe(..., axlim_clip=True) and adds a new explicit mode: ax.plot_surface(..., axlim_clip=True, axlim_clip_mode="clip") ax.plot_wireframe(..., axlim_clip=True, axlim_clip_mode="clip") With axlim_clip_mode="clip", surface polygons and wireframe line segments are geometrically clipped to the six planes of the current 3D axes view-limit box. The implementation adds private clipping helpers in mpl_toolkits.mplot3d.art3d for: clipping 3D polygons against an axis-aligned box, clipping 3D line segments against an axis-aligned box. The new keyword is forwarded from Axes3D.plot_surface and Axes3D.plot_wireframe to the underlying Poly3DCollection and Line3DCollection. This PR intentionally keeps the scope limited to surfaces and line collections. Point-like artists such as scatter and text continue to use the existing hide/mask behavior, because they do not have 3D geometry that can be meaningfully cut. Minimum example: import numpy as np import matplotlib.pyplot as plt from matplotlib import cm fig, axs = plt.subplots( 1, 3, subplot_kw={"projection": "3d"}, figsize=(10, 4), layout="constrained", ) x = np.arange(-5, 5, 0.25) y = np.arange(-5, 5, 0.25) X, Y = np.meshgrid(x, y) Z = np.sin(np.hypot(X, Y)) cases = [ ("unclipped", dict(axlim_clip=False)), ('axlim_clip_mode="hide"', dict(axlim_clip=True, axlim_clip_mode="hide")), ('axlim_clip_mode="clip"', dict(axlim_clip=True, axlim_clip_mode="clip")), ] for ax, (title, clip_kwargs) in zip(axs, cases): ax.plot_surface( X, Y, Z, cmap=cm.coolwarm, linewidth=0, antialiased=False, **clip_kwargs, ) ax.set_title(title) ax.set_xlim(-3.2, 3.2) ax.set_ylim(-3.0, 2.6) ax.set_zlim(-0.45, 0.85) plt.show() AI Disclosure I used ChatGPT to help prototype the clipping approach, identify edge cases, draft tests and gallery-example text, and iterate on implementation details. I reviewed and tested the resulting changes locally before submitting this PR. PR checklist [N/A] "closes #0000" is in the body of the PR description to link the related issue new and changed code is tested Plotting related features are demonstrated in an example New Features and API Changes are noted with a directive and release note Documentation complies with general and docstring guidelines

Open Graph Description: PR summary Related to #25804. This PR adds an opt-in geometric axes-limit clipping mode for selected mplot3d polygon and line artists. Currently, axlim_clip=True hides/masks surface patches or line...

X Description: PR summary Related to #25804. This PR adds an opt-in geometric axes-limit clipping mode for selected mplot3d polygon and line artists. Currently, axlim_clip=True hides/masks surface patches or line...

Opengraph URL: https://github.com/matplotlib/matplotlib/pull/31732

X: @github

direct link

Domain: github.com

Links:

Viewport: width=device-width