This PR introduces a new plotting feature: curved_quiver, a method for drawing curved vector field arrows (streamlines with arrows) for 2D vector fields. This method provides a visually intuitive way to represent vector fields, combining the clarity of streamlines with the directionality of arrows.

Motivation

• Enhanced Visualization: Traditional quiver plots use straight arrows, which can be misleading for complex flows. curved_quiver uses streamlines with arrows, making vector field direction and magnitude easier to interpret.
• User Request: This feature was suggested by user @Yefee, who advocated for a more declarative and modular approach to vector field visualization.
• Consistency: The implementation aligns with the project’s style, using clear, single-responsibility helper functions for maintainability and extensibility.

Attribution

• The core logic of curved_quiver is adapted from the Deltares dfm_tools repository.

Features

• Draws curved arrows along streamlines for 2D vector fields.
• Supports customization of color, linewidth, colormap, arrow size/style, density, and more.
• Accepts user-defined starting points for streamlines.
• Returns a container object (CurvedQuiverSet) with both the line and arrow collections for further manipulation or legend creation.
• Modular implementation: major steps are handled by private, well-documented helper functions.

Usage Example

fig, ax = uplt.subplots()
x = np.linspace(-4, 4, 20)
y = np.linspace(-3, 3, 20)
X, Y = np.meshgrid(x, y)
U = -Y
V = X
speed = np.sqrt(U**2 + V**2)
cq = ax.curved_quiver(X, Y, U, V, color=speed, arrow_at_end=True, scale=2.0, grains=10)
fig.colorbar(cq.lines, ax=ax, label="speed")

Acknowledgement

This feature was suggested by user @Yefee, who requested a declarative, helper-driven approach for curved vector field arrows.

Impact

• Adds a new, powerful visualization tool for vector fields.
• No breaking changes; fully additive.
• Comprehensive tests included for all helper functions and main plotting logic.