{ "cells": [ { "cell_type": "markdown", "id": "fd37506b", "metadata": {}, "source": [ "# 11 · A Bragg grating: the stopband, seen in the field\n", "\n", "A waveguide Bragg grating is a strip whose width is corrugated with period\n", "Λ. Each corrugation reflects a sliver of the guided wave; at the **Bragg\n", "wavelength** λ_B = 2·n_eff·Λ the slivers add in phase and the grating turns\n", "into a mirror. Away from λ_B they cancel and the light passes as if the\n", "grating were a plain waveguide.\n", "\n", "That makes a Bragg grating the perfect device to watch **through a field\n", "monitor at two wavelengths**: in-band the field piles up at the entrance and\n", "decays into the grating (reflected); out-of-band it sails through. Both\n", "pictures come from **one simulation** — the monitor records several chosen\n", "wavelengths (`spec.field_monitor_wavelengths`), and the plot selects among\n", "them.\n", "\n", "The device is `bragg_te1550` from the SiEPIC EBeam library (`devices.gds`):\n", "~300 corrugation periods, 95 µm long." ] }, { "cell_type": "code", "execution_count": 1, "id": "1341a580", "metadata": { "execution": { "iopub.execute_input": "2026-07-21T07:26:18.602205Z", "iopub.status.busy": "2026-07-21T07:26:18.601995Z", "iopub.status.idle": "2026-07-21T07:26:20.367000Z", "shell.execute_reply": "2026-07-21T07:26:20.366212Z" } }, "outputs": [ { "data": { "text/html": [ "
00:26:19 PDT WARNING: Using canonical configuration directory at \n", " '/home/mustafa/.config/tidy3d'. Found legacy directory at \n", " '~/.tidy3d', which will be ignored. Remove it manually or run \n", " 'tidy3d config migrate --delete-legacy' to clean up. \n", "\n" ], "text/plain": [ "\u001b[2;36m00:26:19 PDT\u001b[0m\u001b[2;36m \u001b[0m\u001b[31mWARNING: Using canonical configuration directory at \u001b[0m\n", "\u001b[2;36m \u001b[0m\u001b[32m'/home/mustafa/.config/tidy3d'\u001b[0m\u001b[31m. Found legacy directory at \u001b[0m\n", "\u001b[2;36m \u001b[0m\u001b[32m'~/.tidy3d'\u001b[0m\u001b[31m, which will be ignored. Remove it manually or run \u001b[0m\n", "\u001b[2;36m \u001b[0m\u001b[32m'tidy3d config migrate --delete-legacy'\u001b[0m\u001b[31m to clean up. \u001b[0m\n" ] }, "metadata": {}, "output_type": "display_data" }, { "name": "stdout", "output_type": "stream", "text": [ "bragg_te1550: 95.1 x 3.5 um, ports ['opt1', 'opt2']\n" ] }, { "data": { "image/png": "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", "text/plain": [ "