February 12, 2026

Examples & Live Code

Run real Blaze2D code live in your browser. No install required.

Blaze2D computes the photonic band structure of 2D crystals: you describe a periodic arrangement of dielectric inclusions, and Blaze solves Maxwell’s equations to find the allowed frequencies along a path through the Brillouin zone. The engine is written in Rust for speed, but you’ll almost always drive it from Python. The high-level blaze.solve() function is designed to get you a band diagram in a handful of lines.

There are two ways to run Blaze, and the examples below use both:

Interface	Best for
`blaze.solve(...)` / CLI flags	Quick single runs, scripting, exploring parameters
TOML configs via `BulkDriver`	Reproducible, shareable, version-controllable simulations and richer geometries (e.g. multi-atom bases)

Every example on this page is fully runnable here in the browser. The exact Python snippet you see is compiled to the same Rust engine via WebAssembly, so the numbers you get match what pip install blaze2d produces on your machine. Click any card to open a full-screen runner: press Run, watch the band diagram fill in k-point by k-point, and inspect every field of the returned object in a typed, expandable view.

A note on threads. The browser build is single-threaded (WebAssembly here runs on a single core). Examples that set a worker count still compute correctly, but the thread setting is ignored for live in-browser runs. On the desktop the same code distributes sweep jobs across all your cores.

⌕

Getting Started3

Your first band diagram

Compute the band structure of a simple square-lattice photonic crystal, one crystal, one diagram.

Drive a crystal from a TOML file

Describe the whole simulation once in a reproducible TOML config and run it through BulkDriver.

TM vs TE polarization

Solve both polarizations in one call and compare their band diagrams side by side.

Lattices & Geometry4

Hexagonal lattice

Switch to a triangular (hexagonal) lattice, the Γ to M to K to Γ path is selected automatically.

Honeycomb (two-atom) basis

A hexagonal lattice with two air holes per unit cell, described as a multi-atom TOML config.

Choose a specific k-path

Override the lattice preset and trace your own path through the Brillouin zone.

Two-atom basis (square)

Build a square crystal with two rods per unit cell using a raw TOML configuration.

Parameter Sweeps4

Sweep over rod radius

Pass a [start, stop, step] list to sweep a parameter and get one result per value.

Resolution convergence study

Sweep the grid resolution to watch the band frequencies converge.

Nested sweeps: who is on top?

Sweep epsilon AND radius at once. See how the flat results list is ordered, which sweep is the outer loop and which varies fastest.

2D sweep: radius x epsilon

Sweep two parameters at once, Blaze expands the full grid of configurations.

Performance1

Set the number of workers

Control parallelism across sweep jobs with the threads argument (single-core in the browser).

Streaming & Inspection3

Stream k-points live

Watch each k-point being solved as the band diagram fills in, in real time.

Select specific k-points & bands

Filter the output to just the k-points and bands you care about for a leaner result.

Inspect the full BandResult

Explore every attribute of a BandResult object, arrays, shapes, and metadata.