klayout_gds_import

What problem does it solve?

Import a GDS file into the running KLayout session in a way that avoids the well-known Layout.read pitfalls documented in CLAUDE.md: cell-name collisions between the destination layout and the imported GDS, orphaned cell index slots, and dangling CellView.cell pointers, as well as confusing multi-top-cell states.

Core Features & Use Cases

• Reads a GDS file into the current layout and binds to a stable top cell
• Flattens hierarchy to ensure a single top cell and consistent cell indexing
• Merges or isolates content with options to merge into current layout or open a new tab
• Rebinds the active CellView to the canonical top and refreshes the view for immediate use

Quick Start

Run the GDS import script with an absolute --filepath and optional --flatten and --merge-into-current flags to load the GDS into the current KLayout session or a new tab.