Skip to content

Latest commit

 

History

History
76 lines (48 loc) · 2.3 KB

README.md

File metadata and controls

76 lines (48 loc) · 2.3 KB

gds_fdtd

alternative text

codecov build

gds_fdtd is a minimal Python module to assist in setting up FDTD simulations for planar nanophotonic devices using FDTD solvers such as Tidy3D.

Features

  • Automated FDTD Setup: Easily set up Tidy3D simulations for devices designed in GDS.
  • Integration with gdsfactory: Generate Tidy3D simulations directly from gdsfactory designs by identifying ports and simulation regions from an input technology stack.
  • S-Parameter Extraction: Automatically generate and export S-parameters of your photonic devices in standard formats.
  • Multimode/Dual Polarization Simulations: Set up simulations that support multimode or dual polarization configurations for advanced device analysis.

Installation

You can install gds_fdtd using the following options:

Option 1: Basic Installation

To install the core functionality of gds_fdtd, clone the repository and install using pip:

git clone [email protected]:mustafacc/gds_fdtd.git
cd gds_fdtd
pip install .

Option 2: Development Installation

For contributing to the development or if you need testing utilities, install with the dev dependencies:

git clone [email protected]:mustafacc/gds_fdtd.git
cd gds_fdtd
pip install -e .[dev]

This will install additional tools like pytest and coverage for testing.

Optional Dependencies

If your workflow includes specific dependencies such as gdsfactory or prefab, you can install those optional extras:

with gdsfactory:

pip install -e .[gdsfactory]

Refer to gdsfactory example for usage.

with prefab:

pip install -e .[prefab]

Refer to prefab example for usage.

If you want everything installed for both development and optional features, run the following command:

pip install -e .[dev,gdsfactory,prefab]

Running tests

If you've installed the dev dependencies, you can run the test suite with:

pytest