Metadata-Version: 2.4
Name: beamz
Version: 0.5.2
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Dist: numpy>=1.24.4
Requires-Dist: scipy>=1.10.1
Requires-Dist: shapely>=2.0.6
Requires-Dist: jax>=0.4.0
Requires-Dist: optax>=0.1.0
Requires-Dist: matplotlib>=3.8.0
Requires-Dist: scikit-image>=0.21.0
Requires-Dist: xarray>=2024.0.0
Requires-Dist: ipykernel>=6.29.0 ; extra == 'dev'
Requires-Dist: maturin>=1.9,<2 ; extra == 'dev'
Requires-Dist: meshio>=5.3 ; extra == 'dev'
Requires-Dist: nbconvert>=7.16.0 ; extra == 'dev'
Requires-Dist: trimesh>=4.5 ; extra == 'dev'
Requires-Dist: pytest>=7.0.0 ; extra == 'dev'
Requires-Dist: pytest-cov>=7.0.0 ; extra == 'dev'
Requires-Dist: myst-parser>=2.0.0 ; extra == 'dev'
Requires-Dist: mkdocs>=1.5.0 ; extra == 'dev'
Requires-Dist: mkdocs-material>=9.0.0 ; extra == 'dev'
Requires-Dist: pyright>=1.1.400 ; extra == 'dev'
Requires-Dist: ruff>=0.14.0 ; extra == 'dev'
Requires-Dist: vulture>=2.14 ; extra == 'dev'
Requires-Dist: gdsfactory>=8.0 ; python_full_version < '3.14' and extra == 'gds'
Requires-Dist: gdsfactory>=9.0 ; python_full_version >= '3.14' and extra == 'gds'
Requires-Dist: gdsfactory>=8.0 ; python_full_version < '3.14' and extra == 'gdsfactory'
Requires-Dist: gdsfactory>=9.0 ; python_full_version >= '3.14' and extra == 'gdsfactory'
Requires-Dist: pyright>=1.1.400 ; extra == 'lint'
Requires-Dist: ruff>=0.14.0 ; extra == 'lint'
Requires-Dist: vulture>=2.14 ; extra == 'lint'
Requires-Dist: meshio>=5.3 ; extra == 'mesh'
Requires-Dist: trimesh>=4.5 ; extra == 'mesh'
Requires-Dist: pytest>=7.0.0 ; extra == 'test'
Requires-Dist: pytest-cov>=7.0.0 ; extra == 'test'
Requires-Dist: pytest-randomly>=3.0.0 ; extra == 'test'
Requires-Dist: hypothesis>=6.100.0 ; extra == 'test'
Requires-Dist: diff-cover>=9.0.0 ; extra == 'test'
Requires-Dist: gdsfactory>=8.0 ; python_full_version < '3.14' and extra == 'ubc'
Requires-Dist: gdsfactory>=9.0 ; python_full_version >= '3.14' and extra == 'ubc'
Requires-Dist: ubcpdk==2.7.0 ; python_full_version < '3.14' and extra == 'ubc'
Provides-Extra: dev
Provides-Extra: gds
Provides-Extra: gdsfactory
Provides-Extra: lint
Provides-Extra: mesh
Provides-Extra: test
Provides-Extra: ubc
License-File: LICENSE
Summary: Open GPU-accelerated FDTD for photonic chip designers.
Keywords: computational physics,electromagnetics,photonics,inverse design,simulation
Author-email: Quentin Wach <quentin.wach+beamz@gmail.com>
Requires-Python: >=3.10, <3.15
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Bug Tracker, https://github.com/beamzorg/beamz/issues
Project-URL: Documentation, https://www.beamz.tech/docs/index
Project-URL: Homepage, https://github.com/beamzorg/beamz
Project-URL: Repository, https://github.com/beamzorg/beamz

<div align="center">
  <picture style="padding-right: 0px; padding-bottom: 7px;">
    <source media="(prefers-color-scheme: light)" srcset="docs/assets/beamz_logo_black.png">
    <img alt="BeamZ logo" src="docs/assets/beamz_logo_white.png" width="130">
  </picture>

  <strong>BeamZ</strong> is a differentiable, <strong>GPU-accelerated</strong> <strong><a href="https://en.wikipedia.org/wiki/Electromagnetism">electromagnetic</a> simulation</strong> framework for photonic chip designers using the <strong><a href="https://en.wikipedia.org/wiki/Finite-difference_time-domain_method">FDTD</a> method</strong>. Its engine enables fast, large-scale simulations and offers a <strong>familiar, high-level API</strong> for fast prototyping with just a few lines of code as well as an <strong>inverse design module</strong> for gradient-based optimization.

  <h3>

  [Homepage](https://www.beamz.tech) / [Documentation](https://www.beamz.tech/docs/getting-started/) / [Example Library](https://www.beamz.tech/simulation-examples)
  
  </h3>

  [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](https://github.com/beamzorg/beamz/blob/main/LICENSE)
  [![Tests](https://github.com/beamzorg/beamz/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/beamzorg/beamz/actions/workflows/tests.yml)
  [![Coverage](https://raw.githubusercontent.com/beamzorg/beamz/main/.github/badges/coverage.svg)](https://github.com/beamzorg/beamz/actions/workflows/tests.yml)
</div>



## Core Features
- **Python-first** with an intuitive and **familiar API**.
- **Free and open-source** FDTD simulation in **true 2D and 3D**.
- **GPU-accelerated**, achieving high **GCUPS performance**.
- **Multi-GPU** runs, handling **large-scale simulations** with _billions of cells_.
- CPU-capable for **fast prototyping**, even on your laptop.
- Dedicated CUDA-backend for acceleration beyond default Jax.
- **CPML**, absorbing layers and PEC boundaries.
- **Unidirectional mode sources** (single freq. and broadband, Huygens fields + TFSF, TE/TM).
- **3D Gaussian sources**, e.g. for grating coupler simulations.
- **DFT monitors** and S-parameter extraction workflow for compact modeling.
- Integrated **FDFD mode solver** and **rasterization module**.
- Regular and **rectilinear meshing**.
- Full-tensor and diagonal Farjadpour (polarized averaging) **subpixel-smoothing**.
- Simple **GDS**, **GMSH** and **STL** import and export.
- Streamlined, integrated **parametric design** module.
- Projection kernels and utilies for inverse design via **auto-diff and adjoint-method** workflow.


## Examples

Try out notebooks from our growing **[example library](https://beamz.tech/simulation-examples/)**. It includes:

- [1) Mode Sources and Monitors (3D)](https://beamz.tech/examples/modal_sources_monitors)
- [2) Waveguide Crossing with Cosine Tapers (3D)](https://beamz.tech/examples/cosine_waveguide_crossing)
- [3) Grating Coupler (3D)](https://www.beamz.tech/examples/grating_coupler)
- [4) Microring Resooator (3D)](https://www.beamz.tech/examples/ring_resonator_add_drop)
- [5) 1x4 MMI Powersplitter (3D)](https://www.beamz.tech/examples/mmi1x4_power_splitter)
- [6) Topology Optimized 90° Bend (2D)](https://beamz.tech/examples/ceviche_bend)
- [7) GDSFactory PDK 1x2 MMI (3D)](https://www.beamz.tech/examples/gdsfactory_component_sparameters)


## Integration 

BeamZ is used by several other OSS packages as an FDTD engine and integrates with workflows across the open-source photonics ecosystem:
+ [SiEPIC's GDS FDTD](https://github.com/SiEPIC/gds_fdtd), an EDA- and solver-agnostic 3D FDTD compact modeling framework using BeamZ as the default engine.
+ [Lumix](https://github.com/amiskandarmuda/lumix), a research codebase for optical neural networks and matrix inverse design, using BeamZ as the main solver.
+ [GDSFactory](https://github.com/gdsfactory/gdsfactory), the most popular open-source layout package for chip design for which BeamZ provides a simple workflow from PDK import to compact modeling.


## Installation

Install BeamZ using pip:

```bash
pip install beamz
```

Development uses [uv](https://docs.astral.sh/uv/). Clone the repository and sync
the package with its contributor dependencies:

```bash
git clone https://github.com/beamzorg/beamz
cd beamz
uv sync --extra dev --extra test
```

For a ready-to-use CUDA and Jupyter development environment, see the
[Docker and RunPod guide](docker/runpod/README.md).


## Mission

BeamZ aims to become the FDTD engine of choice for **photonic simulations** in industry and research, including photonic circuits, inverse design, metamaterials, fiber optics, nanophotonics, sensors (planned), active photonic devices (planned), and RF (planned), focusing on **streamlined workflows** and bringing multi-physics GPU-acceleration for **maximum performance in large-scale simulations** to everyone. - [_Detailed roadmap coming soon_.](www.beamz.tech/roadmap)


## Contributing

**We appreciate all contributions.** If you are planning to contribute bug-fixes, please do so without any further discussion. If you would like to add new features, please first open an issue and discuss the feature with us. There may be ongoing work that could conflict with your changes, or we may be heading in a different direction and we don't want to waste your time working on something that might be rejected. - You can find [more information here](CONTRIBUTING.md).

The simplest way to support the project of course is by **giving this repo a star.** Thank you!


## Citation

If you use BeamZ in your research, please cite:

Quentin Wach. *BeamZ: CUDA-accelerated Differentiable FDTD for Photonics*.
https://github.com/beamzorg/beamz

```bibtex
@software{wach_beamz,
  author = {Wach, Quentin},
  title = {{BeamZ}: {CUDA}-accelerated Differentiable {FDTD} for Photonics},
  url = {https://github.com/beamzorg/beamz}
}
```

Citation metadata is available in [CITATION.cff](CITATION.cff). Please also
report the version or commit used in your work. Zenodo archiving is planned
to begin with the next release; its DOI and a DOI badge will be added once
the archive is published. For reproducible research, use the DOI of the
specific release you used.

---

Copyright © 2026 Quentin Wach — [Apache-2.0](https://github.com/beamzorg/beamz/blob/HEAD/LICENSE)

