calculate_magnus_force
Calculate the Magnus force on a spinning ball to determine its curved trajectory in sports like soccer or baseball. Input velocity, spin, radius, and fluid density to get the force vector and magnitude.
Instructions
Calculate Magnus force on a spinning ball.
The Magnus force is perpendicular to both velocity and spin axis.
Causes curve balls in sports.
Args:
velocity: Ball velocity [x, y, z] in m/s (or JSON string)
angular_velocity: Angular velocity [x, y, z] in rad/s (or JSON string)
radius: Ball radius in meters
fluid_density: Fluid density in kg/m³ (air=1.225)
Returns:
Dict containing:
- magnus_force: Magnus force vector [x, y, z] in Newtons
- magnus_force_magnitude: Force magnitude in Newtons
- spin_rate: Spin rate (angular velocity magnitude) in rad/s
Example - Soccer ball curve:
result = await calculate_magnus_force(
velocity=[20, 0, 0], # 20 m/s forward
angular_velocity=[0, 0, 50], # 50 rad/s topspin
radius=0.11, # Soccer ball
fluid_density=1.225
)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| velocity | Yes | ||
| angular_velocity | Yes | ||
| radius | Yes | ||
| fluid_density | No |