DOC: Add examples to broadcasting documentation for 2D and 3D array cases #28891
Conversation
jorenham
changed the title
There was a problem hiding this comment.
Hi @yamato1936 - thanks for the contribution! I think these examples belong right before the Vector Quantization example, actually - that's where we have general numerical examples of broadcasting. We could have a subsection called "Additional examples" and move them there. What do you think?
|
Hi @melissawm -Thanks for the feedback! That makes sense — placing them before the Vector Quantization example under a new "Additional examples" subsection sounds like a cleaner structure. Just to confirm — would it be alright if I go ahead and make that change myself, or would you prefer to handle the restructuring on your end? Let me know if you have any suggestions on naming or formatting as well! |
|
Yes please go ahead and make the changes in your next commit to this same branch, and that's what we'll merge. Thanks! |
This pull request adds two new examples to
doc/source/user/basics.broadcasting.rstto provide additional clarity on how broadcasting works in NumPy.Added Examples:
Broadcasting (3, 1) and (1, 4)
Demonstrates how arrays with shapes (3, 1) and (1, 4) broadcast to shape (3, 4).
Broadcasting (2, 3, 1) and (3, 4)
Explains how a (2, 3, 1) array and a (3, 4) array broadcast to shape (2, 3, 4).
Purpose:
These examples are intended to help users—especially those new to broadcasting—better understand how NumPy's broadcasting rules apply in practical scenarios.
Notes: