spiderman.ipynb

Kernel: Python 3 (ipykernel)

Spider-Man

Modeling and Simulation in Python

Copyright 2021 Allen Downey

License: Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International

# install Pint if necessary

try:
    import pint
except ImportError:
    !pip install pint

# download modsim.py if necessary

from os.path import basename, exists

def download(url):
    filename = basename(url)
    if not exists(filename):
        from urllib.request import urlretrieve
        local, _ = urlretrieve(url, filename)
        print('Downloaded ' + local)
    
download('https://github.com/AllenDowney/ModSimPy/raw/master/modsim.py')

# import functions from modsim

from modsim import *

In this case study we'll develop a model of Spider-Man swinging from a springy cable of webbing attached to the top of the Empire State Building. Initially, Spider-Man is at the top of a nearby building, as shown in this diagram.

The origin, O⃗, is at the base of the Empire State Building. The vector H⃗ represents the position where the webbing is attached to the building, relative to O⃗. The vector P⃗ is the position of Spider-Man relative to O⃗. And L⃗ is the vector from the attachment point to Spider-Man.

By following the arrows from O⃗, along H⃗, and along L⃗, we can see that

H⃗ + L⃗ = P⃗

So we can compute L⃗ like this:

L⃗ = P⃗ - H⃗

The goals of this case study are:

1. Implement a model of this scenario to predict Spider-Man's trajectory.

2. Choose the right time for Spider-Man to let go of the webbing in order to maximize the distance he travels before landing.

3. Choose the best angle for Spider-Man to jump off the building, and let go of the webbing, to maximize range.

I'll create a Params object to contain the quantities we'll need:

1. According to the Spider-Man Wiki, Spider-Man weighs 76 kg.

2. Let's assume his terminal velocity is 60 m/s.

3. The length of the web is 100 m.

4. The initial angle of the web is 45 degrees to the left of straight down.

5. The spring constant of the web is 40 N / m when the cord is stretched, and 0 when it's compressed.

Here's a Params object with the parameters of the system.

params = Params(height = 381,    # m,
                g = 9.8,         # m/s**2,
                mass = 75,       # kg,
                area = 1,        # m**2,
                rho = 1.2,       # kg/m**3,
                v_term = 60,     # m / s,
                length = 100,          # m,
                angle = (270 - 45),    # degree,
                k = 40,                # N / m,
                t_0 = 0,               # s,
                t_end = 30,            # s
               )

Compute the initial position

def initial_condition(params):
    """Compute the initial position and velocity.
    
    params: Params object
    """
    H⃗ = Vector(0, params.height)
    theta = np.deg2rad(params.angle)
    x, y = pol2cart(theta, params.length)
    L⃗ = Vector(x, y)
    P⃗ = H⃗ + L⃗
    
    return State(x=P⃗.x, y=P⃗.y, vx=0, vy=0)

initial_condition(params)

Now here's a version of make_system that takes a Params object as a parameter.

make_system uses the given value of v_term to compute the drag coefficient C_d.

def make_system(params):
    """Makes a System object for the given conditions.
    
    params: Params object
    
    returns: System object
    """
    init = initial_condition(params)
    
    mass, g = params.mass, params.g
    rho, area, v_term = params.rho, params.area, params.v_term
    C_d = 2 * mass * g / (rho * area * v_term**2)
    
    return System(params, init=init, C_d=C_d)

Let's make a System

system = make_system(params)

system.init

Drag and spring forces

Here's drag force, as we saw in Chapter 22.

def drag_force(V⃗, system):
    """Compute drag force.
    
    V⃗: velocity Vector
    system: `System` object
    
    returns: force Vector
    """
    rho, C_d, area = system.rho, system.C_d, system.area
    
    mag = rho * vector_mag(V⃗)**2 * C_d * area / 2
    direction = -vector_hat(V⃗)
    f_drag = direction * mag
    return f_drag

V⃗_test = Vector(10, 10)

drag_force(V⃗_test, system)

And here's the 2-D version of spring force. We saw the 1-D version in Chapter 21.

def spring_force(L⃗, system):
    """Compute drag force.
    
    L⃗: Vector representing the webbing
    system: System object
    
    returns: force Vector
    """
    extension = vector_mag(L⃗) - system.length
    if extension < 0:
        mag = 0
    else:
        mag = system.k * extension
        
    direction = -vector_hat(L⃗)
    f_spring = direction * mag
    return f_spring

L⃗_test = Vector(0, -system.length-1)

f_spring = spring_force(L⃗_test, system)
f_spring

Here's the slope function, including acceleration due to gravity, drag, and the spring force of the webbing.

def slope_func(t, state, system):
    """Computes derivatives of the state variables.
    
    state: State (x, y, x velocity, y velocity)
    t: time
    system: System object with g, rho, C_d, area, mass
    
    returns: sequence (vx, vy, ax, ay)
    """
    x, y, vx, vy = state
    P⃗ = Vector(x, y)
    V⃗ = Vector(vx, vy)
    g, mass = system.g, system.mass
    
    H⃗ = Vector(0, system.height)
    L⃗ = P⃗ - H⃗
    
    a_grav = Vector(0, -g)
    a_spring = spring_force(L⃗, system) / mass
    a_drag = drag_force(V⃗, system) / mass
    
    A⃗ = a_grav + a_drag + a_spring
    
    return V⃗.x, V⃗.y, A⃗.x, A⃗.y

As always, let's test the slope function with the initial conditions.

slope_func(0, system.init, system)

And then run the simulation.

results, details = run_solve_ivp(system, slope_func)
details.message

Visualizing the results

We can extract the x and y components as Series objects.

The simplest way to visualize the results is to plot x and y as functions of time.

def plot_position(results):
    results.x.plot(label='x')
    results.y.plot(label='y')

    decorate(xlabel='Time (s)',
             ylabel='Position (m)')
    
plot_position(results)

We can plot the velocities the same way.

def plot_velocity(results):
    results.vx.plot(label='vx')
    results.vy.plot(label='vy')

    decorate(xlabel='Time (s)',
             ylabel='Velocity (m/s)')
    
plot_velocity(results)

Another way to visualize the results is to plot y versus x. The result is the trajectory through the plane of motion.

def plot_trajectory(results, label):
    x = results.x
    y = results.y
    make_series(x, y).plot(label=label)

    decorate(xlabel='x position (m)',
             ylabel='y position (m)')
    
plot_trajectory(results, label='trajectory')

Letting go

Now let's find the optimal time for Spider-Man to let go. We have to run the simulation in two phases because the spring force changes abruptly when Spider-Man lets go, so we can't integrate through it.

Here are the parameters for Phase 1, running for 9 seconds.

params1 = params.set(t_end=9)
system1 = make_system(params1)
results1, details1 = run_solve_ivp(system1, slope_func)
plot_trajectory(results1, label='phase 1')

The final conditions from Phase 1 are the initial conditions for Phase 2.

t_0 = results1.index[-1]
t_0

init = results1.iloc[-1]
init

t_end = t_0 + 10

Here is the System for Phase 2. We can turn off the spring force by setting k=0, so we don't have to write a new slope function.

system2 = system1.set(init=init, t_0=t_0, t_end=t_end, k=0)

Here's an event function that stops the simulation when Spider-Man reaches the ground.

def event_func(t, state, system):
    """Stops when y=0.
    
    state: State object
    t: time
    system: System object
    
    returns: height
    """
    x, y, vx, vy = state
    return y

Run Phase 2.

results2, details2 = run_solve_ivp(system2, slope_func, 
                                   events=event_func)
details2.message

Plot the results.

plot_trajectory(results1, label='phase 1')
plot_trajectory(results2, label='phase 2')

Now we can gather all that into a function that takes t_release and V_0, runs both phases, and returns the results.

def run_two_phase(t_release, params):
    """Run both phases.
    
    t_release: time when Spider-Man lets go of the webbing
    """
    params1 = params.set(t_end=t_release)
    system1 = make_system(params1)
    results1, details1 = run_solve_ivp(system1, slope_func)

    t_0 = results1.index[-1]
    t_end = t_0 + 10
    init = results1.iloc[-1]

    system2 = system1.set(init=init, t_0=t_0, t_end=t_end, k=0)
    results2, details2 = run_solve_ivp(system2, slope_func, 
                                       events=event_func)

    return pd.concat([results1, results2])

And here's a test run.

t_release = 9 
results = run_two_phase(t_release, params)
plot_trajectory(results, 'trajectory')

x_final = results.iloc[-1].x
x_final

Animation

Here's a draw function we can use to animate the results.

from matplotlib.pyplot import plot

xlim = results.x.min(), results.x.max()
ylim = results.y.min(), results.y.max()

def draw_func(t, state):
    plot(state.x, state.y, 'bo')
    decorate(xlabel='x position (m)',
             ylabel='y position (m)',
             xlim=xlim,
             ylim=ylim)

# animate(results, draw_func)

Maximizing range

To find the best value of t_release, we need a function that takes possible values, runs the simulation, and returns the range.

def range_func(t_release, params):
    """Compute the final value of x.
    
    t_release: time to release web
    params: Params object
    """
    results = run_two_phase(t_release, params)
    x_final = results.iloc[-1].x
    print(t_release, x_final)
    return x_final

We can test it.

range_func(9, params)

And run it for a few values.

for t_release in linrange(3, 15, 3):
    range_func(t_release, params)

Now we can use maximize_scalar to find the optimum.

bounds = [6, 12]
res = maximize_scalar(range_func, params, bounds=bounds)

Finally, we can run the simulation with the optimal value.

best_time = res.x
results = run_two_phase(best_time, params)
plot_trajectory(results, label='trajectory')

x_final = results.iloc[-1].x
x_final