Adjoint Plugin: 2 Checking Gradients
Contents
Adjoint Plugin: 2 Checking Gradients#
In this notebook, we will show how to use the adjoint plugin for DiffractionMonitor
outputs and also check the gradient values against gradients obtained using transfer matrix method (TMM) to validate their accuracy for a multilayer slab problem.
[1]:
import numpy as np
import jax.numpy as jnp
import jax
import tmm
import matplotlib.pyplot as plt
from typing import Tuple, List
import tidy3d as td
from tidy3d.web import run as run_sim
from tidy3d.plugins.adjoint import JaxSimulation, JaxBox, JaxMedium, JaxStructure, JaxSimulationData
from tidy3d.plugins.adjoint.web import run as run_adjoint
[14:48:02] INFO Using client version: 1.9.0rc1 __init__.py:121
First, we define some global parameters describing the transmission through a multilayer slab with some spacing between each slab.
The layout is diagrammed below.
[2]:
# frequency we want to simulate at
freq0 = 2.0e14
k0 = 2 * np.pi * freq0 / td.C_0
freqs = [freq0]
wavelength = td.C_0 / freq0
# background permittivity
bck_eps = 1.3**2
# space between each slab
spc = 0.1
# slab permittivities and thicknesses
slab_eps0 = [2.**2, 1.8**2, 1.5**2, 1.9**2]
slab_ds0 = [0.5, 0.25, 0.5, 0.5]
# incidence angle
theta = np.pi/8
# resolution
dl = 0.01
Transfer Matrix Method (Ground Truth)#
Next we use the tmm
package to write a function to return the transmission T
of p
polarized light given a set of slab permittivities and thicknesses. We’ll also write a function to compute the numerical gradient using TMM and will take these to be our “ground truths” when evaluating the accuracy of our values obtained through FDTD and the adjoint plugin.
Transmission Calculation with TMM#
First, we write a function to compute transmission.
[3]:
def compute_T_tmm(slab_eps=slab_eps0, slab_ds=slab_ds0) -> float:
"""Get transmission as a function of slab permittivities and thicknesses."""
# construct lists of permittivities and thicknesses including spaces between
new_slab_eps = []
new_slab_ds = []
for eps, d in zip(slab_eps, slab_ds):
new_slab_eps.append(eps)
new_slab_eps.append(bck_eps)
new_slab_ds.append(d)
new_slab_ds.append(spc)
slab_eps = new_slab_eps[:-1]
slab_ds = new_slab_ds[:-1]
# add the input and output spaces to the lists
eps_list = [bck_eps] + slab_eps + [bck_eps]
n_list = np.sqrt(eps_list)
d_list = [np.inf] + slab_ds + [np.inf]
# compute transmission with TMM
return tmm.coh_tmm("p", n_list, d_list, theta, wavelength)["T"]
We run this function with our starting parameters and see that we get a transmission of about 98% for the set of input parameters.
[4]:
T_tmm = compute_T_tmm(slab_eps=slab_eps0, slab_ds=slab_ds0)
print(f"T (tmm) = {T_tmm:.3f}")
T (tmm) = 0.997
Numerical Gradient with TMM#
Next, we will use our compute_T_tmm()
function to compute the “numerical” gradient to use as comparison against our adjoint results with FDTD.
The derivative of a function \(f(x)\) w.r.t. \(x\) can be approximated using finite differences as
with a small step \(\Delta\).
To compute the gradient of our transmission with respect to each of the slab thicknesses and permittivities, we need to repeat this step for each of the values. Luckily, since TMM is very fast, we can compute these quantities quite quickly compared to if we were using FDTD.
Here we write a function to return this gradient.
[5]:
def compute_grad_tmm(slab_eps=slab_eps0, slab_ds=slab_ds0) -> Tuple[List[float], List[float]]:
"""Compute numerical gradient of transmission w.r.t. each of the slab permittivities and thicknesses using TMM."""
delta = 1e-4
# set up containers to store gradient and perturbed arguments
num_slabs = len(slab_eps)
grad_tmm = np.zeros((2, num_slabs), dtype=float)
args = np.stack((slab_eps, slab_ds), axis=0)
# loop through slab index and argument index (eps, d)
for arg_index in range(2):
for slab_index in range(num_slabs):
grad = 0.0
# perturb the argument by delta in each + and - direction
for pm in (-1, +1):
args_num = args.copy()
args_num[arg_index][slab_index] += delta * pm
# compute argument perturbed T and add to finite difference gradient contribution
T_tmm = compute_T_tmm(slab_eps=args_num[0], slab_ds=args_num[1])
grad += pm * T_tmm / 2 / delta
grad_tmm[arg_index][slab_index] = grad
grad_eps, grad_ds = grad_tmm
return grad_eps, grad_ds
Let’s run this function and observe the gradients. These will be saved later to compare against our adjoint plugin results.
[6]:
grad_eps_tmm, grad_ds_tmm = compute_grad_tmm()
print(f"gradient w.r.t. eps (tmm) = {grad_eps_tmm}")
print(f"gradient w.r.t. ds (tmm) = {grad_ds_tmm}")
gradient w.r.t. eps (tmm) = [ 0.00353246 0.0255666 0.02079163 -0.00767556]
gradient w.r.t. ds (tmm) = [ 0.12389213 0.27248157 0.14586663 -0.02167071]
FDTD (Using adjoint plugin)#
Next, we will implement the same two functions using Tidy3D’s adjoint plugin.
Transmission Calculation with FDTD#
We first write a function to compute the transmission of a multilayer slab using Tidy3D.
As discussed in the previous adjoint tutorial notebook, we need to use jax
-compatible components from the tidy3d subclass for any structures that may depend on the parameters. In this case, this means that the slabs must be JaxStructures
containing JaxBox
and JaxMedium
and must be added to JaxSimulation.input_structures
.
We use a DiffractionMonitor
to measure our transmission amplitudes. As the data corresponding to this monitor will be used in the differentiable function return value, we must add it to JaxSimulation.output_monitors
.
Below, we break up the transmission calculation into a few functions to make it easier to read and re-use later.
[7]:
def make_sim(slab_eps=slab_eps0, slab_ds=slab_ds0) -> JaxSimulation:
"""Create a JaxSimulation given the slab permittivities and thicknesses."""
# frequency setup
wavelength = td.C_0 / freq0
fwidth = freq0 / 10.0
freqs = [freq0]
# geometry setup
bck_medium = td.Medium(permittivity=bck_eps)
space_above = 2
space_below = 2
length_x = 0.1
length_y = 0.1
length_z = space_below + sum(slab_ds0) + space_above + (len(slab_ds0) - 1) * spc
sim_size = (length_x, length_y, length_z)
# make structures
slabs = []
z_start = -length_z/2 + space_below
for (d, eps) in zip(slab_ds, slab_eps):
slab = JaxStructure(
geometry=JaxBox(center=[0, 0, z_start + d / 2], size=[td.inf, td.inf, d]),
medium=JaxMedium(permittivity=eps),
)
slabs.append(slab)
z_start += d + spc
# source setup
gaussian = td.GaussianPulse(freq0=freq0, fwidth=fwidth)
src_z = -length_z/2 + space_below/2.0
source = td.PlaneWave(
center=(0, 0, src_z),
size=(td.inf, td.inf, 0),
source_time=gaussian,
direction="+",
angle_theta=theta,
angle_phi=0,
pol_angle=0,
)
# boundaries
boundary_x = td.Boundary.bloch_from_source(
source=source, domain_size=sim_size[0], axis=0, medium=bck_medium
)
boundary_y = td.Boundary.bloch_from_source(
source=source, domain_size=sim_size[1], axis=1, medium=bck_medium
)
boundary_spec = td.BoundarySpec(x=boundary_x, y=boundary_y, z=td.Boundary.pml(num_layers=40))
# monitors
mnt_z = length_z/2 - space_above/2.0
monitor_1 = td.DiffractionMonitor(
center=[0.0, 0.0, mnt_z],
size=[td.inf, td.inf, 0],
freqs=freqs,
name="diffraction",
normal_dir="+",
)
# make simulation
return JaxSimulation(
size=sim_size,
grid_spec=td.GridSpec.auto(min_steps_per_wvl=100),
input_structures=slabs,
sources=[source],
output_monitors=[monitor_1],
run_time= 10 / fwidth,
boundary_spec=boundary_spec,
medium=bck_medium,
subpixel=True,
shutoff=1e-8,
)
Let’s generate a simulation and plot it to make sure it looks reasonable.
[8]:
sim = make_sim()
f, ax = plt.subplots(1, 1, figsize=(10, 10))
sim.plot(y=0, ax=ax)
plt.show()
INFO Auto meshing using wavelength 1.4990 defined from sources. grid_spec.py:510
Now we write a function to post process some run results to get the transmission we are after.
[9]:
def post_process_T(sim_data: JaxSimulationData) -> float:
"""Given some JaxSimulationData from the run, return the transmission of "p" polarized light."""
amps = sim_data.output_monitor_data["diffraction"].amps.sel(polarization="p")
return jnp.sum(abs(amps.values)**2)
And finally, put everything together in a single function that relates the permittivities and thicknesses of each slab to the transmission, through a JaxSimulation
run using the adjoint plugin.
[10]:
def compute_T_fdtd(slab_eps=slab_eps0, slab_ds=slab_ds0) -> float:
"""Given the slab permittivities and thicknesses, compute T, making sure to use `tidy3d.plugins.adjoint.web.run_adjoint`."""
sim = make_sim(slab_eps=slab_eps, slab_ds=slab_ds)
sim_data = run_adjoint(sim, task_name='slab')
return post_process_T(sim_data)
Computing T and Gradient with FDTD#
Now that we have this function defined, we are ready to compute our transmission and gradients using Tidy3d.
We first call jax.value_and_grad()
on our transmission calculation function, which returns a function that will give us both T
and the gradient of T
with respect to the input parameters in one shot. For more details, see the previous tutorial.
[11]:
compute_T_and_grad_fdtd = jax.value_and_grad(compute_T_fdtd, argnums=(0, 1))
Next, we call this function on our starting parameters, which will kick off the original (fwd
) T transmission simulation and then the reverse (adj
) simulation, which is used in combination with fwd
for the gradient calculation.
[12]:
T_fdtd, (grad_eps_fdtd, grad_ds_fdtd) = compute_T_and_grad_fdtd(slab_eps0, slab_ds0)
[14:48:03] INFO Remote TPU is not linked into jax; skipping remote TPU. xla_bridge.py:160
INFO Unable to initialize backend 'tpu_driver': Could not initialize backend xla_bridge.py:333 'tpu_driver'
INFO Unable to initialize backend 'cuda': module 'jaxlib.xla_extension' has no xla_bridge.py:333 attribute 'GpuAllocatorConfig'
INFO Unable to initialize backend 'rocm': module 'jaxlib.xla_extension' has no xla_bridge.py:333 attribute 'GpuAllocatorConfig'
INFO Unable to initialize backend 'tpu': module 'jaxlib.xla_extension' has no xla_bridge.py:333 attribute 'get_tpu_client'
INFO Auto meshing using wavelength 1.4990 defined from sources. grid_spec.py:510
[14:48:29] INFO Auto meshing using wavelength 1.4990 defined from sources. grid_spec.py:510
[14:48:52] WARNING 'JaxSimulation.input_structures' elements 0 and 1 are overlapping or simulation.py:131 touching. Geometric gradients for overlapping structures may contain errors.
Checking Accuracy of TMM (Numerical) vs FDTD (Adjoint)#
Let’s convert these from jax types to numpy arrays to work with them easier, and then display the results compared to TMM.
[13]:
grad_eps_fdtd = np.array(grad_eps_fdtd)
grad_ds_fdtd = np.array(grad_ds_fdtd)
[14]:
print(f"T (tmm) = {T_tmm:.5f}")
print(f"T (FDTD) = {T_fdtd:.5f}")
T (tmm) = 0.99731
T (FDTD) = 0.99713
We see that the transmission results match very well with TMM, giving us a lot of confidence that our set up is correct.
Let’s look at the gradients now.
[15]:
print("un-normalized:")
print(f"\tgrad_eps (tmm) = {grad_eps_tmm}")
print(f"\tgrad_eps (FDTD) = {grad_eps_fdtd}")
print(80*'-')
print(f"\tgrad_ds (tmm) = {grad_ds_tmm}")
print(f"\tgrad_ds (FDTD) = {grad_ds_fdtd}")
rms_eps = np.linalg.norm(grad_eps_tmm - grad_eps_fdtd) / np.linalg.norm(grad_eps_tmm)
rms_ds = np.linalg.norm(grad_ds_tmm - grad_ds_fdtd) / np.linalg.norm(grad_ds_tmm)
print(f"RMS error = {rms_eps * 100} %")
print(f"RMS error = {rms_ds * 100} %")
un-normalized:
grad_eps (tmm) = [ 0.00353246 0.0255666 0.02079163 -0.00767556]
grad_eps (FDTD) = [ 0.00351275 0.02560841 0.02075933 -0.00766569]
--------------------------------------------------------------------------------
grad_ds (tmm) = [ 0.12389213 0.27248157 0.14586663 -0.02167071]
grad_ds (FDTD) = [ 0.12433368 0.2717824 0.1460508 -0.02059105]
RMS error = 0.1682669588192957 %
RMS error = 0.41128200939768944 %
The gradients match to < 1% of their respective norms, which is very good agreement.
If we only care about the error in the “directions” of the gradients, we can compare their normalized versions to each other.
[16]:
def normalize(arr):
return arr / np.linalg.norm(arr)
grad_eps_tmm_norm = normalize(grad_eps_tmm)
grad_ds_tmm_norm = normalize(grad_ds_tmm)
grad_eps_fdtd_norm = normalize(grad_eps_fdtd)
grad_ds_fdtd_norm = normalize(grad_ds_fdtd)
rms_eps = np.linalg.norm(grad_eps_tmm_norm - grad_eps_fdtd_norm) / np.linalg.norm(grad_eps_tmm_norm)
rms_ds = np.linalg.norm(grad_ds_tmm_norm - grad_ds_fdtd_norm) / np.linalg.norm(grad_ds_tmm_norm)
[17]:
print("normalized:")
print(f"\tgrad_eps (tmm) = {grad_eps_tmm_norm}")
print(f"\tgrad_eps (FDTD) = {grad_eps_fdtd_norm}")
print(f"\tRMS error = {rms_eps * 100} %")
print(80*'-')
print(f"\tgrad_ds (tmm) = {grad_ds_tmm_norm}")
print(f"\tgrad_ds (FDTD) = {grad_ds_fdtd_norm}")
print(f"\tRMS error = {rms_ds * 100} %")
normalized:
grad_eps (tmm) = [ 0.10383603 0.75152497 0.61116552 -0.22562138]
grad_eps (FDTD) = [ 0.10323393 0.75258896 0.61008249 -0.22528199]
RMS error = 0.1668163643627526 %
--------------------------------------------------------------------------------
grad_ds (tmm) = [ 0.37129054 0.81659613 0.43714562 -0.06494463]
grad_ds (FDTD) = [ 0.37305433 0.81546366 0.438215 -0.06178198]
RMS error = 0.39419938518606473 %
In which case we see slight improvement, but the unnormalized gradients already match quite well before this.