Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Update art3d.py to address strange behavior of depthshading on 3D scatterplots with close points #23085

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 18 commits into from
Closed

Update art3d.py to address strange behavior of depthshading on 3D scatterplots with close points #23085

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
00d5d05
Update art3d.py
May 21, 2022
af2e2a2
Update art3d.py
May 21, 2022
1ed4648
Update art3d.py
May 21, 2022
ca24aae
Updated art3d.py per feedback
May 21, 2022
2ef7284
Update art3d.py
May 21, 2022
c085f47
Update art3d.py
May 21, 2022
6bb3cd5
Update art3d.py per reviewer feedback
Jun 1, 2022
2458402
Update art3d.py per reviewer feedback
Aug 22, 2022
bc4b40a
Merge branch 'matplotlib:main' into 22861_bugfix
nhansendev Nov 29, 2023
52ad303
Improvements for depth-shading
nhansendev Nov 29, 2023
968047b
Added kwargs for depth-shading
nhansendev Nov 29, 2023
8657a07
Create depthshading_improvement.rst
nhansendev Nov 29, 2023
b32d00b
Update depthshading_improvement.rst
nhansendev Dec 17, 2023
ea4fff7
Merge branch 'main' into 22861_bugfix
nhansendev Dec 17, 2023
25d0e22
Update art3d.py formatting
nhansendev Dec 17, 2023
cfc05aa
Update axes3d.py formatting
nhansendev Dec 17, 2023
dfb395c
Update depthshading_improvement.rst formatting
nhansendev Dec 17, 2023
dc80ea0
Update depthshading_improvement.rst formatting
nhansendev Dec 17, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 53 additions & 0 deletions doc/users/next_whats_new/depthshading_improvement.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
Depth-shading fix and more depth-shading options
--------------------------------------------------------------

New options have been added which allow users to modify the behavior of
depth-shading while addressing a visual bug.

Previously, a slightly buggy method of estimating the "depth" of plotted
items could lead to sudden and unexpected changes in transparency as the
plot orientation changed.

Now, the behavior has been made smooth and predictable, and the user is
provided with three new options: whether to invert the shading, setting the
lowest acceptable alpha value (highest transparency), and whether to use
the old algorithm.

The default behavior visually matches the old algorithm: items that appear to be
"deeper" into the screen will become increasingly transparent (up to the now
user-defined limit). If the inversion option is used then items will start
at maximum transparency and become gradually opaque with increasing depth.

Note 1: depth-shading applies to Patch3DCollections and Path3DCollections,
including scatter plots.

Note 2: "depthshade=True" must still be used to enable depth-shading

A simple example:

.. plot::
:include-source: true
:alt: A simple example showing different behavior of depthshading, which can be modified using the provided kwargs.

import matplotlib.pyplot as plt

fig = plt.figure()
ax = fig.add_subplot(projection="3d")

X = [i for i in range(10)]
Y = [i for i in range(10)]
Z = [i for i in range(10)]
S = [(i + 1) * 400 for i in range(10)]

ax.scatter(
xs=X,
ys=Y,
zs=Z,
s=S,
depthshade=True,
depthshade_minalpha=0.1,
depthshade_inverted=True,
depthshade_legacy=True,
)

plt.show()
Loading