{"id":23806,"library":"gplugins","title":"gplugins","description":"Plugins for gdsfactory, a Python library for photonic chip design. Provides simulation (meep, tidy3d), netlist extraction, and DFM checks. Current stable version: 2.0.1, release cadence is irregular. Requires Python >=3.11.","status":"active","version":"2.0.1","language":"python","source_language":"en","source_url":"https://github.com/gdsfactory/gplugins","tags":["photonic-design","gdsfactory","simulation"],"install":[{"cmd":"pip install gplugins","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Primary dependency; gplugins extends gdsfactory.","package":"gdsfactory","optional":false},{"reason":"For FDTD simulations via the meep plugin.","package":"meep","optional":true},{"reason":"For FDTD simulations via the tidy3d plugin.","package":"tidy3d","optional":true},{"reason":"For TCAD device simulation.","package":"devsim","optional":true},{"reason":"For material dispersion fitting.","package":"nk","optional":true}],"imports":[{"wrong":"import gplugins.meep as gm","symbol":"meep","correct":"import gplugins"}],"quickstart":{"code":"import gdsfactory as gf\nimport gplugins.meep as gm\n\nc = gf.c.straight_heater_metal(length=5, width=0.5)\n\n# Simulate using meep\nsim_settings = {\n    \"resolution\": 20,\n    \"wavelength\": 1.55,\n    \"duration\": 1e-12,\n}\ngm.write_sparameters_meep(c, filepath=\"sparams.h5\", **sim_settings)\n","lang":"python","description":"Basic meep simulation using gplugins. Requires gdsfactory and meep installed."},"warnings":[{"fix":"Update imports: `import gplugins.meep as gm` instead of `from gplugins import meep`. Use submodule-specific aliases.","message":"Version 2.0.0 renamed all submodules (e.g., 'meep' became 'gplugins.meep') and removed top-level imports. Old code using `from gplugins import *` or `import gplugins.meep as meep` will break.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Call `c.write_gds('temp.gds')` before simulation or provide a component that is already linked to a file.","message":"The `write_sparameters_meep` function requires the component to be a full path to a GDS file or a Component with a GDS file written. In-memory components not written to file cause silent errors.","severity":"gotcha","affected_versions":"all"},{"fix":"Set environment variable `TIDY3D_API_KEY` or configure tidy3d via `tidy3d.config.api_key = '...'` before using the plugin.","message":"Tidy3d plugin requires an API key set via `TIDY3D_API_KEY` environment variable or tidy3d config. Simulation will fail with a vague authentication error if missing.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'2.0.1':24 '3.11':31 'cadenc':26 'check':20 'chip':10 'current':21 'design':11,34 'dfm':19 'extract':17 'gdsfactori':4,35 'gplugin':1 'irregular':28 'librari':7 'meep':14 'netlist':16 'photon':9,33 'photonic-design':32 'plugin':2 'provid':12 'python':6,30 'releas':25 'requir':29 'simul':13,36 'stabl':22 'tidy3d':15 'version':23","created_at":"2026-05-01T08:09:44.174740+00:00","updated_at":"2026-05-01T08:09:44.174740+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"2.1.0","cli_name":"","cli_version":null,"type":"library","homepage":"https://gdsfactory.com","github":null,"docs":null,"changelog":null,"pypi":"https://pypi.org/project/gplugins/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["data"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-08-02","install_tag":null}}