DOC: Add an example for 2D images in 3D plots #28280
Conversation
| A fundamental limitation of the 3D plotting engine is that intersecting objects cannot | ||
| be drawn correctly. One object will always be drawn after the other. Therefore, | ||
| multiple image planes can well be used in the background as shown in this example. | ||
| But this approach is not suitable if the planes intersect. |
There was a problem hiding this comment.
I think this is a good paragraph to include, this "2.5D" renderer behavior is non-obvious, and we should mention it as often as possible IMO.
There was a problem hiding this comment.
Yeah, I also think this is great - it explains why this needs to be a separate example and so will be nice to link to off the intersecting example (and they can all have the same tag https://matplotlib.org/devdocs/devel/tag_guidelines.html )
| imshow3d(ax, data_yz, value_direction='x', cmap='magma') | ||
| imshow3d(ax, data_zx, value_direction='y', pos=ny, cmap='plasma') | ||
|
|
||
| plt.show() |
There was a problem hiding this comment.
Image from the built docs:
It may be more impactful if you manually set the axlims so the images line up with the backing planes, but your call. Can self merge if you prefer as-is.
There was a problem hiding this comment.
I slightly favor leaving it as is:
- Less optional configuration code keeps the example more readable
- I like that the planes are floating above the axes cube. This is a slight visual hint that the images are not tied to the cube and can theoretically be anywhere.
…280-on-v3.9.x Backport PR #28280 on branch v3.9.x (DOC: Add an example for 2D images in 3D plots)
Serving
Originally posted by @story645 in #28239 (comment)