# fancompute/workshop-invdesign architecture

> Architecture diagram of the GitHub repository fancompute/workshop-invdesign, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/fancompute/workshop-invdesign
- Repository: https://github.com/fancompute/workshop-invdesign

## Overview

This repository is a notebook-based workshop on optical inverse design with automatic differentiation. Learners can follow a progression from finite-difference frequency-domain simulation, to mode-converter optimization, to parameterization strategies, and finally wavelength-multiplexer design with optimizer scheduling. The README documents these capabilities and recommends following the numbered notebooks; notebook internals were not available in the sampled source, so the graph does not infer their code-level calls or data flow.

Main entry points: [`02_Invdes_intro.ipynb`](https://github.com/fancompute/workshop-invdesign/blob/master/02_Invdes_intro.ipynb) (Mode Converter), [`03_Invdes_parameterization.ipynb`](https://github.com/fancompute/workshop-invdesign/blob/master/03_Invdes_parameterization.ipynb) (Parameterization), [`01_First_simulation.ipynb`](https://github.com/fancompute/workshop-invdesign/blob/master/01_First_simulation.ipynb) (FDFD Basics), [`04_Invdes_wdm_scheduling.ipynb`](https://github.com/fancompute/workshop-invdesign/blob/master/04_Invdes_wdm_scheduling.ipynb) (WDM Scheduling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulation["Optical Simulation"]
  node_simulation_notebook["FDFD Basics"]
end

subgraph group_design["Inverse Design"]
  node_mode_converter["Mode Converter"]
  node_parameterization["Parameterization"]
end

subgraph group_advanced["Advanced Topics"]
  node_wdm["WDM Scheduling"]
end

node_learner(("Learner"))

node_learner -->|"studies first"| node_simulation_notebook
node_learner -->|"studies"| node_mode_converter
node_learner -->|"studies"| node_parameterization
node_learner -->|"studies"| node_wdm
node_mode_converter -->|"expanded by"| node_parameterization

click node_simulation_notebook "https://github.com/fancompute/workshop-invdesign/blob/master/01_First_simulation.ipynb"
click node_mode_converter "https://github.com/fancompute/workshop-invdesign/blob/master/02_Invdes_intro.ipynb"
click node_parameterization "https://github.com/fancompute/workshop-invdesign/blob/master/03_Invdes_parameterization.ipynb"
click node_wdm "https://github.com/fancompute/workshop-invdesign/blob/master/04_Invdes_wdm_scheduling.ipynb"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_simulation_notebook toneBlue
class node_mode_converter,node_parameterization toneAmber
class node_wdm toneMint
class node_learner toneIndigo
```

## Components

### Optical Simulation

- [FDFD Basics](https://github.com/fancompute/workshop-invdesign/blob/master/01_First_simulation.ipynb): `01_First_simulation.ipynb`

### Inverse Design

- [Mode Converter](https://github.com/fancompute/workshop-invdesign/blob/master/02_Invdes_intro.ipynb): `02_Invdes_intro.ipynb`
- [Parameterization](https://github.com/fancompute/workshop-invdesign/blob/master/03_Invdes_parameterization.ipynb): `03_Invdes_parameterization.ipynb`

### Advanced Topics

- [WDM Scheduling](https://github.com/fancompute/workshop-invdesign/blob/master/04_Invdes_wdm_scheduling.ipynb): `04_Invdes_wdm_scheduling.ipynb`

### Other components

- **Learner**

## Connections

- Learner → FDFD Basics: studies first (evidence: `README.md`)
- Learner → Mode Converter: studies (evidence: `README.md`)
- Learner → Parameterization: studies (evidence: `README.md`)
- Learner → WDM Scheduling: studies (evidence: `README.md`)
- Mode Converter → Parameterization: expanded by (evidence: `README.md`)
