gplugins 1.2.4#

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#