# Part 1: The Foward Problem¶

In this exercise, you will implement a solver for the 1D scalar acoustic wave equation with absorbing boundary conditions,

where the middle two equations are the absorbing boundary conditions, the last equation gives initial conditions, \(x \in [0,1]\), and \(t \in [0,T]\). The model velocity is given by the function \(c(x)\).

In our notation, we write that solving this PDE is equivalent to applying a nonlinear operator \(\mathcal{F}\) to a model parameter \(m\), where \(m(x) = \frac{1}{c(x)^2}\) for the scalar acoustics problem.

We then write that \(\mathcal{F}[m] = u\).

## Seismic Sources¶

Before we can solve the equation, we need to define our source function.

We define our source functions as \(f(x,t) = w(t)\delta(x-x_s)\), where \(\ w\) is the time profile, \(\delta\) indicates that we will use point sources, and the source location is \(x_0\). In real world applications, the time profile is not known and is estimated as part of the inverse problem. However, it is common to model source signals with the negative second derivative of a Gaussian, also known as the Ricker Wavelet,

where \(\nu_0\) is known as the characteristic or peak frequency (in Hz), because the magitude of \(w\)’s Fourier transform \(|\hat w|\) attains its maximum at that frequency. It is also important that this function is causal (\(w(t) = 0\) for \(t\le 0\)), so we introduce a time shift \(t_0\),

Problem 1.1

Write a Python function `ricker(t, config)`

which implements the Ricker
Wavelet, taking a time `t`

in seconds and your configuration dictionary.
This function should assume that your configuration dictionary has a key
`nu0`

representing the peak frequency, in Hz. Your function should
returns the value of the wavelet at time `t`

.

You can guarantee causality by setting \(t_0= 6\sigma\) for \(\sigma = \tfrac{1}{\pi\nu_0\sqrt{2}}\), the standard deviation of the underlying Gaussian. You may also want to implement an optional threshold to prevent excessively small numbers.

Plot your function for \(t = 0, \dots, T=0.5\) at \(\nu_0 = 10\textrm{Hz}\) and label the plot.

```
# In fwi.py
def ricker(t, config):
nu0 = config['nu0']
# implementation goes here
return w
# Configure source wavelet
config['nu0'] = 10 #Hz
# Evaluate wavelet and plot it
ts = np.linspace(0, 0.5, 1000)
ws = ricker(ts, config)
plt.figure()
plt.plot(ts, ws,
color='green',
label=r'$\nu_0 =\,{0}$Hz'.format(config['nu0']),
linewidth=2)
plt.xlabel(r'$t$', fontsize=18)
plt.ylabel(r'$w(t)$', fontsize=18)
plt.title('Ricker Wavelet', fontsize=22)
plt.legend();
```

Problem 1.2

Write a Python function `point_source(value, position, config)`

which
takes a value `value`

, a source location `position`

, and uses the
range of the spatial domain `config['x_limits']`

, and the number of
points `config['nx']`

from the configuration to implement a numerical
approximation to the \(\delta\). This function should return a numpy
array with `value`

at the correct index, correctly evaluating
\(w(t)\delta(x-x_s)\) for `value = ricker(t)`

. Be careful with your
implementation of the numerical delta, as \(\int
\delta(x-x_s)\textrm{d}x = 1\).

To implement `point_source`

, we need to discretize the problem domain. This is stored in the configuration as follows:

```
# Domain parameters
config['x_limits'] = [0.0, 1.0]
config['nx'] = 201
config['dx'] = (config['x_limits'][1] - config['x_limits'][0]) / (config['nx']-1)
```

For later, we also specify the location of the source:

```
# Source parameter
config['x_s'] = 0.1
```

Note

Your function should take a `position`

as a separate parameter and
not automatically extract the source location from `config`

because
we will re-use this function later.

## Wave Solver¶

The scalar acoustic wave equation can be written as

where \(K = K_x + K_{xx}\) is called the stiffness matrix and contains the spatial derivatives, \(A\) is the attenuation matrix and relates to the first time derivatives in the boundary conditions, and \(M\) is the mass matrix and relates to the second time derivatives in the bulk.

Problem 1.3

Write a Python function which `construct_matrices(C, config)`

which
constructs the matrices \(M\), \(A\), \(K\) for a given model
velocity `C`

. Use a second order accurate finite difference for the
second spatial derivative and and use an ‘upwinded’ forward or backward
first order difference scheme for the first spatial derivatives.

Hint

It may be helpful to write down precisely what the differential equation looks like at the each interesting point (the two boundaries and some point in the middle of the domain) for your discretized wavefield \(u(j\Delta x, n \Delta t)\).

Hint

The matrices are not time dependent, so \(n\) is fixed. Which \(j\) are relevant at each of the spatial points?

```
# Load the model
C, C0 = basic_model(config)
# Build an example set of matrices
M, A, K = construct_matrices(C, config)
```

We can discretize the time derivatives using the usual second-order accurate finite difference approximation,

which will result in the explicit ‘leap-frog’ scheme for computing \(u(x,t+\Delta t)\). For explicit methods, the stability of the scheme is restricted by the Courant-Friedrichs-Lewy (CFL) condition,

Problem 1.4

Write a Python function `leap_frog(C, sources, config)`

which takes a
velocity `C`

, a list of source wavefields `sources`

(one element for
each time step), and through the `config`

, takes a time step `dt`

, and
a number of time steps `nt`

and returns the time series of wavefields
\(u\). Use \(\alpha = \dfrac{1}{6}\) and \(x_s = 0.1\).

Hint

Your `leap_frog`

function should use your `construct_matrices`

function.

```
# Set CFL safety constant
config['alpha'] = 1.0/6.0
# Define time step parameters
config['T'] = 3 # seconds
config['dt'] = config['alpha'] * config['dx'] / C.max()
config['nt'] = int(config['T']/config['dt'])
# Generate the sources
sources = list()
for i in xrange(config['nt']):
t = i*config['dt']
f = point_source(ricker(t, config), config['x_s'], config)
sources.append(f)
# Generate wavefields
us = leap_frog(C, sources, config)
```

At this point, it is important to visualize the wavefield (and the medium the waves are propagating in). One way to look at the wavefield of a 1D problem is to consider a plot of its space-time diagram.

Problem 1.5

Write a Python function `plot_space_time(us, config)`

, using the
matplotlib command `imshow`

, to plot and label the space-time diagram
for a wavefield \(u(x,t)\).

Hint

The matplotlib `xticks`

and `yticks`

functions will be useful. Try
to use a gray-scale color map and consider an optional argument to
set the title.

```
plot_space_time(us, config, title=r'u(x,t)')
```

## Data and Sampling¶

A *receiver* (a seismometer, hydrophone, or geophone) at spatial position
\(x_r\) records the value of the true wavefield (or a function of it) at a
point, and is written mathematically as

For 2D and 3D seismic imaging problems there are multiple receivers at different spatial positions recording data for a single ‘shot’ (instance of a source). This ‘sampling’ can be denoted with the operator \(\mathbf{S}\) and is written as

Your `point_source`

function implements the adjoint operation of sampling,
\(\mathbf{S^*}\).

Problem 1.6

Write a function `record_data(u, config)`

, which takes a single
wavefield `u`

and, as part of the configuration, a receiver position in
`config['x_r']`

and returns the measured data. When combined, data from
all time steps form a *trace*.

Use \(x_r = 0.15\).

```
# Receiver position
config['x_r'] = 0.15
```

## Forward Operator¶

At this point, you have all of the routines necessary to solve the forward problem,

It will be useful to put the necessary steps into a function, as we will want to solve this problem many times, perhaps on different problems. Additionally, we will frequently want to solve the sampled forward problem,

Problem 1.7

Write a Python function `forward_operator(C, config)`

which returns a
tuple containing the wavefields and the sampled data. This function should
utilize the functions you have written in the previous exercises.

Plot and label the trace. Use \(x_r = 0.15\).

## Bonus Problems¶

**Bonus Problem 1.8:** Derive how you might use your `leap_frog`

function and
periodic boundary conditions to design a 4th order accurate, in both space
and time, scheme for solving the wave equation.

**Bonus Problem 1.9:** The implementation of time stepping used in this exercise
is not the most efficient approach for implementing time stepping,
particularly in higher dimensions. Why? What might be a faster way to
implement the time stepping?

**Bonus Problem 1.10:** The wave equation can be solved using an ODE integrator.
Change the formulation of the wave equation so that this is possible. Write a
function that uses the built-in SciPy ODE integrator
to do your time stepping.