gfp¶Usage:
Options:
--help: Show this message and exit.Commands:
test: Test if the cells in the project can be...build-pdk: Build GDS from PDK.build-pics: Build GDS from pics directory.build-schema: Build a netlist schema for a YAML netlist.configure: Configure a GDSFactory+ API key.doitforme: Writes the GDS bounding box of another GDS...export-spice: Export a .pic.yml netlist to spice.svg: Writes the GDS bounding box of another GDS...init: Create a new project.parse-spice: Convert a spice netlist [.sp] to a...serve: Start the GDSFactory+ background service.settings: Display or modify component arguments and...tree: Get the PDK tree.tree-item: Get a PDK tree item.verify: Verify a GDSFactory+ API key.version: Get the GDSFactory+ version.visualize-3d: Visualize a 3D component.watch: Watch a folder for changes.check: Run a series of verification checks.gfp test¶Test whether or not the cells in the project can be built.
Usage:
Options:
--help: Show this message and exit.gfp bbox¶Writes the GDS bounding box of another GDS file.
Args: path: input gds file. outpath: output gds file. bbox_layer: layer to use for the bounding box. ignore_ports: ignore ports when computing the bounding box.
Usage:
Arguments:
PATH: [required]Options:
--outpath TEXT--bbox-layer <INTEGER INTEGER>...: [default: 99, 0]--ignore-ports / --no-ignore-ports: [default: no-ignore-ports]--help: Show this message and exit.gfp build-pdk¶Build GDS from PDK.
Args: path: path to build directory. pdk: process design kit. on_error: what to do on error. skip_existing: skip already generated files.
Usage:
Arguments:
[PATH]: [default: build]Options:
--pdk TEXT--on-error TEXT: [default: continue]--skip-existing / --no-skip-existing: [default: skip-existing]--help: Show this message and exit.gfp build-pics¶Build GDS from pics directory.
Args: path: path to pics directory (defaults to project name set in pyprojec.toml). pdk: process design kit. on_error: what to do on error. skip_existing: skip already generated files.
Usage:
Arguments:
[PATH]Options:
--pdk TEXT--on-error TEXT: [default: continue]--skip-existing / --no-skip-existing: [default: no-skip-existing]--help: Show this message and exit.gfp build-schema¶Build a netlist schema for a YAML netlist.
Args: path: The path to the .pic.yml file to build the schema for. outpath: The path to save the schema to. pdk: The PDK context for which to build the schema for.
Usage:
Arguments:
PATH: [required]Options:
--outpath TEXT: [default: stdout]--pdk TEXT--help: Show this message and exit.gfp configure¶Configure a GDSFactory+ API key.
Args: api_key: The api key to set. organization: The name of your organization as registered with GDSFactoryplus. uv: Configure uv to use your GDSFactoryplus PyPI index for proprietary packages. force: Force overwriting the api key if an existing key was found.
Usage:
Options:
--api-key TEXT--organization TEXT--uv / --no-uv: [default: no-uv]--force / --no-force: [default: no-force]--help: Show this message and exit.gfp doitforme¶Writes the GDS bounding box of another GDS file.
Args: prompt: The prompt to create a circuit with. outpath: The output file where the netlist gets saved. pdk: The PDK to use to generate the circuit. url: The URL where to send the prompt to. show: If True, will build and show the circuit. interact: If True, will let the user interactively refine the circuit.
Usage:
Arguments:
PROMPT: [required]Options:
--outpath TEXT: [default: stdout]--pdk TEXT--url TEXT: [default: wss://doitforme.gdsfactory.com/ws]--show / --no-show: [default: no-show]--interact / --no-interact: [default: no-interact]--help: Show this message and exit.gfp export-spice¶Export a .pic.yml netlist to spice.
Args: path: The path to the .pic.yml file. outpath: Where to save the spice file to pdk: The PDK context in which to parse the .pic.yml file. flavor: The type of spice to export to
Usage:
Arguments:
PATH: [required]Options:
--outpath TEXT: [default: stdout]--pdk TEXT--flavor TEXT: [default: spectre]--help: Show this message and exit.gfp freeze¶Freeze a python cell as schematic netlist.
Args: cell_name: Name of the cell to freeze. outpath: The path to write the netlist to. kwargs: The JSON-encoded keyword arguments to create the cell with.
Usage:
Arguments:
CELL_NAME: [required]Options:
--outpath TEXT: [default: stdout]--kwargs TEXT--help: Show this message and exit.gfp svg¶Writes the GDS bounding box of another GDS file.
Args:
cell_names: Comma separated list of all cells.
first_cell,second_cell,third_cell,... for which to generate an svg
(omit to generate svgs for all cells).
outdir: Output directory where to save the gds files.
pdk: The PDK for which to generate cells for.
width: The width of the svg (in pixels)
height: The height of the svg (in pixels)
overwrite: By default an svg will not be generated in case it already exists.
Use the overwrite flag to force re-generation.
Usage:
Arguments:
[CELL_NAMES]Options:
--outdir TEXT: [default: .]--pdk TEXT--width INTEGER: [default: 80]--height INTEGER: [default: 80]--overwrite / --no-overwrite: [default: no-overwrite]--help: Show this message and exit.gfp init¶Create a new project.
Args: folder: The folder to initialize the project in (default: current folder). pdk: The PDK to initialize the project for. name: The name of the project (defaults to the folder name). requires_python: The python requirements of your project. This should match The python requirements of the PDK your about to use! dependencies: Comma seperated list of dependencies you want to add to the project (e.g. numpy,pandas). api_key: The api key to pull the PDK with.
Usage:
Arguments:
[FOLDER]: [default: .]Options:
--pdk TEXT--name TEXT--requires-python TEXT: [default: >=3.12]--dependencies TEXT--api-key TEXT--help: Show this message and exit.gfp parse-spice¶Convert a spice netlist [.sp] to a GDSFactory netlist [.pic.yml].
Args: path: Path to convert. outpath: The output path to output the converted netlist to. pdk: PDK to use for the conversion. flavor: The spice flavor to use. Currently only oc is supported.
Usage:
Arguments:
PATH: [required]Options:
--outpath TEXT: [default: stdout]--pdk TEXT--flavor TEXT: [default: oc]--help: Show this message and exit.gfp serve¶Start the GDSFactory+ background service.
Args: port: The port on which to run the background service. host: The host on which to run the background service. workers: The number of workers of the background service. runner: Which server process to use (uvicorn or granian). reload: Run the background service in debug mode (not recommended). max_requests: Maximumamount of requests per worker before restarting (only gunicorn runner).
Usage:
Options:
--port INTEGER: [default: 8787]--host TEXT: [default: localhost]--workers INTEGER: [default: 1]--runner TEXT: [default: uvicorn]--reload / --no-reload: [default: no-reload]--max-requests INTEGER: [default: 200]--help: Show this message and exit.gfp settings¶Display or modify component arguments and their default values.
Args: format: The output format for displaying settings. Options available are TABLE, JSON, YAML, or TOML. key: A specific key to look for within the settings. Supports nested keys separated by dots.
Usage:
Options:
--key TEXT--format TEXT: [default: table]--help: Show this message and exit.gfp show¶Show a cell in layout viewer.
Args: path: Path to the pics directory or the pic file. cellname: Name of the cell to show (if empty: will try to be derived from path). pdk: Path to the PDK.
Usage:
Arguments:
[PATH]Options:
--cellname TEXT--pdk TEXT--help: Show this message and exit.gfp simulate¶Simulate a circuit.
Args: name: Name of the cell. outpath: The output path where to save the plot. pdk: Path to the PDK. op: Output plot. port_in: Input port. wl0: Wavelength start. wl1: Wavelength end. nwl: Number of wavelengths. host: Host for the server. api_key: The api key to access the simulate service.
Usage:
Arguments:
NAME: [required]Options:
--outpath TEXT: [default: stdout]--pdk TEXT--op TEXT: [default: dB]--port-in TEXT--wl0 FLOAT--wl1 FLOAT--nwl INTEGER--host TEXT: [default: http://localhost:8787]--api-key TEXT--help: Show this message and exit.gfp tree¶Get the PDK tree.
Args: path: The path of the folder being watched. pdk: The PDK. by: The way to organize the tree (cell, file, flat). key: Downselect the tree with a dot-separated key. format: How to visualize the tree (YAML, JSON).
Usage:
Arguments:
[PATH]Options:
--pdk TEXT--by TEXT: [default: cell]--key TEXT--format TEXT: [default: YAML]--help: Show this message and exit.gfp tree-item¶Get a PDK tree item.
Args: name: The name of the cell to get the tree item for. path: The path of the folder being watched. pdk: The PDK. key: Downselect the tree with a dot-separeted key. format: How to visualize the tree (YAML, JSON).
Usage:
Arguments:
NAME: [required][PATH]Options:
--pdk TEXT--key TEXT--format TEXT: [default: YAML]--help: Show this message and exit.gfp verify¶Verify a GDSFactory+ API key.
Args: api_key: The api key to verify. pdk: The PDK to verify access for (optional). format: JSON / YAML output format.
Usage:
Options:
--api-key TEXT--pdk TEXT--format TEXT: [default: YMAL]--help: Show this message and exit.gfp version¶Get the GDSFactory+ version.
Usage:
Options:
--help: Show this message and exit.gfp visualize-3d¶Visualize a 3D component.
Args: path: Path to the file containing the cell. name: Name of the cell (optional for YAML paths). pdk: Name of the PDK. Defaults to SETTINGS.pdk.name if not given.
Usage:
Arguments:
PATH: [required]Options:
--name TEXT--pdk TEXT--help: Show this message and exit.gfp watch¶Watch a folder for changes.
Args: path: Path to the folder. server_url: URL where the GDSfactory+ background service is running on.
Usage:
Arguments:
PATH: [required]Options:
--server-url TEXT--help: Show this message and exit.gfp check¶Usage:
Options:
--help: Show this message and exit.Commands:
drc: Check a GDS file for DRC errors.conn: Check a GDS file for DRC errors.lvs: Check a GDS file for LVS errors.gfp check drc¶Check a GDS file for DRC errors.
Args: path: Path to the GDS file to run the check on. outpath: The output path to save the drc results to. pdk: PDK to use for the check. process: The DRC rules might be slightly different depending on the process. timeout: Timeout in seconds for the check (DRC only). host: API host (DRC only). api_key: The API key (DRC only). verbose: If True, print status messages to stderr(Standard Error).
Usage:
Arguments:
PATH: [required]Options:
--outpath TEXT: [default: stdout]--pdk TEXT--process TEXT--timeout INTEGER: [default: 0]--host TEXT--api-key TEXT--verbose / --no-verbose: [default: verbose]--help: Show this message and exit.gfp check conn¶Check a GDS file for DRC errors.
Args: path: Path to the GDS file to run the check on. pdk: PDK to use for the check. outpath: The output path to save the DRC results in. verbose: If True, print status messages to stderr.
Usage:
Arguments:
PATH: [required]Options:
--pdk TEXT--outpath TEXT: [default: stdout]--verbose / --no-verbose: [default: verbose]--help: Show this message and exit.gfp check lvs¶Check a GDS file for LVS errors.
Args: cell: The name of the cell to check. netpath: The path to the reference netlist. pdk: PDK to use for the check. cellargs: JSON-encoded arguments to create the cell with. outpath: The output path to save the DRC results to.
Usage:
Arguments:
CELL: [required]NETPATH: [required]Options:
--outpath TEXT: [default: stdout]--pdk TEXT--cellargs TEXT--help: Show this message and exit.