Skip to content

gdsfactory/gplugins

Repository files navigation

gplugins 1.2.3

docs PyPI PyPI Python MIT codecov

GDSFactory plugins:

  • Device simulators
    • Meshing
    • FDTD
      • Ansys Lumerical
      • tidy3d
      • Luminescent
      • FDTDz
      • MEEP
    • FEM
      • femwell Finite Element Method Solver (heaters, modes, TCAD, RF waveguides).
      • elmer for electrostatic (capacitive) simulations.
      • palace for full-wave driven (S parameter) and electrostatic (capacitive) simulations.
    • EME
      • meow Eigen Mode Expansion (EME).
    • Mode Solver
      • Tidy3d
      • Femwell
      • MPB
    • TCAD
      • devsim TCAD device simulator.
  • Circuit simulations
    • sax S-parameter circuit solver.
    • vlsir for parsing GDS-extracted circuit netlists into Cadence Spectre, NgSpice and Xyce Schematic File formats.

Installation

You can install most plugins with:

pip install "gdsfactory[full]" --upgrade

or

pip install "gplugins[devsim,femwell,gmsh,schematic,meow,meshwell,ray,sax,tidy3d]" --upgrade

Or install only the plugins you need. For example:

pip install "gplugins[schematic,femwell,meow,sax,tidy3d]" --upgrade

Non-pip plugins

The following plugins require special installation as they can't be installed with pip:

  • For Meep and MPB you need to use conda or mamba on MacOS, Linux or Windows WSL (Windows Subsystem for Linux) with conda install pymeep=*=mpi_mpich_* -c conda-forge -y
  • For Elmer, refer to Elmer FEM – Installation for installation or compilation instructions each platform. Gplugins assumes ElmerSolver, ElmerSolver_mpi, and ElmerGrid are available in your PATH environment variable.
  • For Palace, refer to Palace – Installation for compilation instructions using Spack or Singularity. Gplugins assumes palace is available in your PATH environment variable.

Installation for contributors

We recommend uv for installing GDSFactory:

# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh
# On Windows.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Then you can install gdsfactory with:

uv venv --python 3.11
uv sync --extra docs --extra dev

Getting started