Usage¶
KQCircuits objects, such as elements and chips, can be viewed and manipulated in the KLayout Editor GUI. More complicated tasks in KLayout Editor can be done by writing KLayout macros, which use the KQCircuits library. The code runs within KLayout’s built-in Python interpreter, so debugging must be done in KLayout’s macro IDE if using KLayout GUI. Note that the macros can also be run from the command line without GUI (-z and -r) switches, which allows using other debugging tools.
To use KQC in KLayout, open KLayout in
editing mode (go to
File->Setup->Application->Editing mode
, check use editing mode by
default
and restart, or launch KLayout(Editor) application if on Windows).
If KQC was installed successfully, you should then see KQC libraries such as
Element library
and Chip library
in KLayout’s library browser. The
elements can then be dragged and dropped from there to the layout.
The parameters of an element in the layout can be changed by double-clicking
it. For more detailed instructions, see the User Guide.
Modifying or Creating Elements or Chips¶
KLayout Salt packages are read-only. The user may open a chosen chip (say, [Package
KQCircuits]/kqcircuits/chips/simple
) with the embedded macro editor (F5
) but it can not be
directly changed here. Of course, external code editors may be used to change these files or their
copies. On the downside, package upgrades may override these changes.
An other option is to copy (drag-and-drop) the Simple chip to the [Local]
folder with the
embedded macro editor. This copy may be freely changed with the macro editor. First suggested change
would be to rename the chip. This is still not part of KQC. To
make it visible in KLayout we need to create a symbolic link to it from the designated chip folder
in [Package KQCircuits]/kqcircuits/chips/
. Finally, KLayout should re-read the now update KQC
library, this may be achieved by restarting or with the Edit -> KQCircuits Library -> Reload
libraries
menu entry.
It may take a bit of effort to find where these folders are in a particular OS, in Linux:
cd $HOME/.klayout/salt/KQCircuits/python/kqcircuits/chips
ln -s $HOME/.klayout/pymacros/simple.py simpler.py
or in Windows:
cd %HOME%/KLayout/salt/KQCircuits/python/kqcircuits/chips
mklink simpler.py "%HOME%/KLayout/pymacros/simple.py"
Naturally, the same approach would work to copy/create other elements, qubits etc. Creating macros or
masks is even easier, no need to fumble with external editors or symlinks the default [Local]
folder may be directly used to run the copied and modified macro or mask generation script. But for
serious development work we suggest following the Developer Setup.