Change Log

Ipkiss 3.2

The main feature of this release is the automated 3D virtual fabrication and link from IPKISS to physical device simulation tools. Support for CST Studio Suite and Lumerical FDTD Solutions is built-in, i.e., users don’t need to install any additional packages. It also introduces generation of circuit models based on S-matrix data (simulation or measurement-based).

Get started here: physical device simulation, and here: models from S-parameters.


In this release we fixed two small layout bugs that may affect layout generation:

  • ShapeArc
  • route_to_parallel_line

Please check the layout changes in 3.2.0 for more details, or the changelog below.


  • Added the joblib package. Amongst others this package makes it easy to save and load data to file with support for large (numpy) matrices and file compression. See e.g. Saving and loading S-parameter data.


  • New feature: physical device simulation link with CST Studio Suite and Lumerical FDTD Solutions. Tutorial link: physical device simulation.
  • New feature: Layers can now be subtracted from each other (Layer1 - Layer2) to form new generated layers (e.g. for virtual fabrication definition).
  • New feature: VFabricationProcessFlow has a new property process_layer_map which can be used to explicitly map process layers to generated mask layers.
  • New feature: Support for reading S-parameters from/to Touchstone files (Touchstone version 1). Use i3.circuit_sim.SMatrix1DSweep.from_touchstone.
  • New feature: i3.circuit_sim.SMatrix1DSweep now has a passivity and reciprocity check.
  • Improvement: The virtual fabrication does not depend on the undocumented ‘ALL’ property of ProcessPurposeLayers. For backwards compatibility reasons, if ‘ALL’ is present it will be used for constructing the process_layer_map property of VFabricationProcessFlow. As a result, it has become easier to write virtual fabrication process definitions which are independent of the TECH tree.
  • Improvement: Added support for importing GDSII properties, silently ignoring them. As a result Ipkiss now has improved compatibility with GDSII files exported from certain 3rd party tools.
  • Improvement: Port labels are now properly visualized when they fall at the edge of the layout.
  • Improvement: Ipkiss is now able to read and work with GDSII files that contain PCell context from KLayout.
  • Improvement: Ipkiss can now merge multiple GDS files that have identical PDK cells, these cells are now identified and reused without renaming them with a prefix.
  • Bugfix: SizeInfo.expand_to_grid() works again.
  • Bugfix: the .visualize() method of a LayoutView now correctly accepts the canvas_size argument when no box argument is specified.
  • Bugfix: In ShapeArc: if end_angle < start_angle, and the angle difference is not a multiple of angle_step, the final calculated path did not perfectly cover the full arc. The bugfix results in a slightly different calculation of curves which could cause a small numeric deviation in your designs drawn in a previous version of Ipkiss. Please check if your designs still behave correctly.
  • Bugfix: ShapeRoundAdiabaticSpline could not cope with straight angles.
  • Bugfix: route_to_parallel_line: the maximum s-bend angle (max_s_bend_angle) was never used to route between two parallel lines - a slightly smaller value was erroneously used instead. The bugfix results in a slightly different calculation of routes. Please check if your designs still behave correctly.
  • Bugfix: In ElectricalWireTraceTemplate, the width of the wire is no longer hard-coded, it can now be chosen.
  • Bugfix: If 2 MaterialStacks have a common base but a different number of layers, they are not considered equal anymore.
  • Bugfix: Boolean operations between a Boundary and a Path or between two Paths yielded the wrong result.
  • Bugfix: Virtual fabrication could generate sub-grid slivers for certain complex layouts, e.g. in AWG star couplers.


  • Improvement: Documentation generation: correctly identify required/optional/locked properties. They are ordered: first required properties, then optional ones, then locked ones.


  • New feature: A generic circuit simulation model to build 1D univariate B-spline models: i3.circuit_sim.BSplineSModel. Tutorial link: circuit models based on S-parameter data. See also BSplineSModel.from_smatrix.
  • Improvement: Numba bumped from 0.38 to to 0.43. More numpy functions can now be used in circuit models (as explained in the circuit models tutorial) and many other small enhancements. Non-exhaustive list of new functions available: str.join, str.split, np.roll, np.ptp, np.trapz, np.interp, np.corrcoeff, np.cov, np.partition, np.fill_diagonal, np.unique
  • Bugfix: smat_transient parameter not passed when in ‘python’ mode.

Luceda control center

  • Launching of PyCharm uses the default IDE settings. This results in more predictable behavior: PyCharm will behave the same, whether started from the control center, or from another location (start menu/terminal/…). Users will need to set up the IPKISS Python interpreter so PyCharm can find it. Once set up it can be made available for all projects. See setting up a Python editor.


  • Bugfix: A StringProperty with a RestrictValueList restriction can now correctly be used in IPKISS.eda (OpenAccess and L-Edit).
  • Improvement: The L-Edit launch script has been improved, to make it more reliable.


  • New: Tutorial on physical device simulation.
  • New: Tutorial on circuit model generation from existing S-parameter data.
  • New: Guide on boolean operations.
  • General cleanup.

Ipkiss 3.1.3

This release features an updated syntax and backend for defining circuit simulation models for simulation with our circuit simulator Caphe. Get started here: circuit model tutorial. For more details check the Caphe section below.


This release is fully compatible with Ipkiss 3.1.2, with two small exceptions:

  • the straight_extension property on transitions between different types of waveguides was previously not correctly handled.
  • waveguide lengths are now taken directly from the layout without having to set the view to ‘CapheModelFromLayout’.

Please check the known backwards incompatibilities in 3.1.3.


  • The Luceda Control Center has been refreshed, and includes a PyCharm launcher. The PyCharm IDE (Python editor) is used for setting up design projects and writing IPKISS code.
  • PyCharm IDE support: when launched from the Luceda Control Center, the IPKISS / Python interpreter is set up for the user. For more info, please follow the PyCharm tutorial.
  • Samples: The samples are now by default installed in the folder <USER_HOME>/luceda/samples/ipkiss_version. PyCharm suggests new projects to be created in the <USER_HOME>/luceda/projects folder.
  • Samples: demolib contains a list of compact models, as an illustration for the new features in Ipkiss 3.1.3.
  • Doc: several improvements in the reference / API documentation.


  • Bugfix in documentation generation: running compile_doc twice caused the doc to contain two sections of ‘Parameters’. With the latest numpydoc this is not allowed.


  • Improvement: Path elements with a variable extension are now supported and read from or written to GDSII: e.g. Path(…, path_type=PATH_TYPE.VARIABLE, extension=(1.0, 2.0)).
  • Improvement for Label elements exported to and imported from GDSII, for better interoperability with third party tools.
    • Before, Ipkiss exported and imported Label elements to GDSII TEXT elements with ‘texttype’ (layer datatype) fixed to 0. This works fine when only using Ipkiss but could give problems when combining multiple tools.
    • The GDSII layer datatype is now preserved during export and import of Label elements to GDSII file TEXT elements.
    • Label element height is now handled identically during GDSII export and import: specified as a magnification on the GDSII TEXT element. Note that not all third party tools support this, since this is just an interpretation of GDSII.
  • Bugfix: the straight_extension property of ShapeWindowTraceTransition is now reversed if the start and end trace templates are reversed, so the first value always refers to the start point and the second value to the end point.
  • Bugfix: GDSII STRCLASS records (used by Calma/Cadence only) are now ignored without raising an exception.
  • Improvement: in GDSCell it is now possible to ignore undefined layers in the technology’s import layer map. This is controlled with the ignore_undefined_layers property of GDSCell.Layout.
  • Bugfix: TraceTransitionFromPort wrongly swapped the trace templates of the input and output port if reverse_templates=True
  • Bugfix: you can now properly compare pplayers, for example, if my_layer is TECH.PPLAYER.WG.CORE (this was previously not possible as layers could be created twice when the tech is not fully setup).
  • Explicitly set edgecolor during visualization of layout primitives. This fixes layout visualization for recent versions of matplotlib.
  • Improvement: pysics.basics.environment.Environment is now available from ipkiss3.all.
  • Improvement: ConnectComponents can now be imported with a minimal technology tree. It’s now also available from ipkiss3.all.
  • Internal refactoring: CapheModelInstance is removed in favor of ModelInstance. ModelInstance can refer both to a CapheModelView and to a CircuitModelView.
  • Waveguide models by default take their length from the layout.


  • Strongly improved syntax for defining compact models. See the circuit model tutorial to get started.
  • Proper multimode support. See also the tutorial on how to define multimode models.
  • We use the numba package for compilation of new style models. As a result, model compilation is much faster and robust, it accelerates a subset of Python and Numpy.
  • The simulation and model syntax are better separated from the simulation engine. This results in improved maintenance, robustness and performance.
  • Debug mode for debugging compact models interactively.
  • Better exception handling, causing no crashes when interrupting a simulation.
  • Reduced message verbosity when compiling models.
  • Backward compatibility has been ensured as much as possible, allowing for an easy transition from the old to the new style models. See also porting from 3.1.2 to 3.1.3.


  • Bugfix: the straight_extension parameter of the transitions between different trace templates (WireWaveguideTemplate->RibWaveguideTemplate, WireWaveguideTemplate->SocketWaveguideTemplate, WireWaveguideTemplate->ThinnedWireWaveguideTemplate) is now reversed if the trace templates were specified in reverse order.
  • Bugfix: the straight_extension parameter was not taken into account in SlottedWireWaveguideTransitionLinear and SlottedWireWaveguideTransitionLinearFromPort.
  • Bugfix: The width property trace templates that refer to other templates raised an exception.
  • Bugfix: PlaceAndConnect can now correctly identify broken links in circuits with links between electrical ports
  • Bugfix: in the containers that add rounded waveguides (FanoutPorts, RoutePortsEastWest, RoutePortsAroundCorner): the angle_step is now applied to the generated waveguides correctly, instead of defaulting to the technology value.
  • The bugfix on TraceTransitionFromPort (see above) corrects the ports of WireRibWaveguideTransitionFromPortLinear, WireRibWireWaveguideTransitionFromPortLinear, SlottedWireWaveguideTransitionFromPortLinear, WireSocketWaveguideTransitionFromPortLinear, ThinnedWireWireWaveguideTransitionFromPortLinear.
  • Remove absolute imports throughout picazzo, which caused some user code to fail if it has similar named Python files (


  • Improvement: A PDK is now allowed more fine-grained control over the way waveguides are generated inside the EDA tool (triggered when using the ‘generate all waveguides’ macro). The existing TECH.ROUTING.WAVEGUIDE_GENERATION_GUIDE_LAYERS (typically in the ipkiss/pdk_name/technology/ part of the PDK) now accepts a {layer: (routing_fn, wg_generation_fn)} item. layer is the IPKISS layer used for drawing the waveguide control shape. routing_fn is a function that transforms a start + end port into a shape, and wg_generation_fn returns an IPKISS layout view based on the shape (either calculated using the routing_fn, or manually drawn by the user on the waveguide control shape layer).
  • Bugfix (regression between 3.1.1 and 3.1.2): Label elements could not be exported anymore to OpenAccess.
  • Bugfix: openaccess libraries that refer to a technology now always load the technologies in the correct order. Previously, this could lead to problems when working with multiple open libraries, where pcell evaluation / waveguide generation would fail.
  • Improvement: Spaces and parentheses are filtered from Ipkiss color names upon export to display.drf files. Colors and stipples are now sorted by name.
  • Improvement: Waveguide routing layers (TECH.ROUTING.WAVEGUIDE_GENERATION_GUIDE_LAYERS) can now use reserved purposes (DRAWING, …)

Ipkiss 3.1.2

This is a minor release featuring bugfixes and small improvements.


This release is fully compatible with Ipkiss 3.1.1, with one small exception: previously one could override a ChildCellProperty in a derived class with a LockedProperty, now this is not possible anymore; instead it will raise an exception. Please check the known backwards incompatibilities in 3.1.2. Upgrading is recommended.

Installation & Getting Started

  • Most of the packages that are bundled with IPKISS have received small updates. Ipkiss now ships with numpy 1.11.3 and scipy 0.19. One major update is conda (the package manager used to install / update packages), which is now version 4.3.
  • When configuring your code editor, you’re no longer required to set the ‘PATH’ environment variable.


  • Many improvements and bugfixes to the internal caching. These also result in an average performance increase of 25% in Ipkiss.


  • Bugfix: apply_to_angle_rad and reverse_on_angle_rad failures due to missing symbols.
  • Bugfix: equality check of Library objects (Library.__eq__ operator, e.g. lib1==lib2) is fixed.
  • Bugfix: missing imports for compiled ShapeWaveguideTransition.CapheModel (numpy exp and pi).
  • Bugfix: SizeInfo.snap_to_grid contained dysfunctional code, raising an exception.
  • Bugfix: importing ipkiss no longer modifies PYTHONPATH (it removed the string ‘.’, which changes the behavior of scripts which rely on packages / modules being present in the current working directory).
  • Improvement: snap the virtual fabrication canvas to the technology grid, to avoid small slivers at the edge of the simulation window.
  • Improvement: GDSCell is now available in ipkiss3.all and does not need to be imported separately anymore.
  • Bugfix: virtual fabrication: fix error message when a material stack cannot be found.
  • Bugfix: Boundaries with coincidal edges can now be virtually fabricated.
  • Bugfix: MRef.size_info was dysfunctional (using SizeInfo without importing it).
  • Improvement: visualizations no longer specify the matplotlib figure number, this enables the use of %matplotlib notebook magic in notebooks and using matplotlib interactive mode.
  • Improvement: not operation on layers is now supported in virtual fabrication.


  • Bugfix: MaterialStackGeometry2D.consolidate() was dysfunctional (typo fixed).


  • Bugfix: ThinnedWireWireWaveguideTransitionLinear was not always using the correct start trace template.
  • Bugfix: Ring resonators could raise a validation error even if a valid value was specified for coupler_spacings.


  • Bugfix: The transformation of Group and PolygonText elements is now taken into account when exporting to OpenAccess.
  • Bugfix: The transformation of a Path element is now taken into account when exporting to OpenAccess.

Ipkiss 2.4 Compatibility

  • Bugfix: technologies.compat24.picazzo24 could not be imported if a technology already contained TECH.PURPOSE.NO_FILL.


  • Added a guide on waveguides, which explains the basic concept and how to use them.
  • Added examples for ChildCellProperty and ChildCellListProperty.

Ipkiss 3.1.1

This is a minor release featuring bugfixes and small improvements.


  • New feature: shapes for performing spline fitting of a control shape: ShapeFitClampedCubicSpline and ShapeFitClampedCubicSpline. See Spline Shapes.
  • Improvement: extra type check when adding transitions to an AutoTransitionDatabase.
  • Improvement: You can now label ports in the visualization of the Layout. The Layout visualize method has a new keyword annotate (default: False).
  • Improvement: AutoTransitionDatabase can now resolve multiple ‘aliases’ of trace templates. This makes it much easier to define customized trace templates that are a variation of existing trace templates. The transitions will be correctly resolved.
  • The Layout view of a TraceTemplate now has a method cross_section() which returns a 2D geometry of the waveguide cross section.
  • Change: cross section geometries now have a method visualize(). Use this instead of figure_2d().show() (which will still work).
  • Bugfix: the interface with the Caphe circuit simulator can now handle electrical ports.
  • Bugfix: fixed RadialLine.
  • Bugfix: a component with a SMatrixView can now be simulated repeatedly.
  • Bugfix: StrongPropertyInitializer objects, and in particular PCells and Views, can now be pickled.
  • Bugfix: Views with properties that have a numpy array as value can now be properly compared (view1 == view2).
  • Bugfix: When the original shape is an empty shape or a shape with length == 0.0, shape modifiers now return an empty points array instead of raising an exception.
  • Improvement: Our packages are now compatible with numpy 1.11, this is now the default numpy shipped with the installer. If you have your own packages that are compiled against an older numpy version, you might have to reinstall a version for numpy 1.11.
  • Improvement: The example silicon_photonics technology now uses an improved color scheme for materials (when using visualize_2d).

Ipkiss-caphe interface

  • Bugfix: calculating the S-matrix of circuits containing nonlinear models no longer fails. The result will be the linear contribution of the scattering matrix (i.e., defined by _calculate_S in each CapheModel).
  • Bugfix: CapheModelFromSMatrix accidentally reset the view of the associated PCell, resulting in an empty smatrix or an infinite recursion, depending on the model. This no longer happens.
  • Bugfix: Testbenches that have no terms in the top-level netlist can now also be converted to a native caphe circuit.


  • Improvement: PlaceAndConnect draws flylines for logical connections that are not properly connected in the layout. Flylines are drawn on the TECH.PPLAYER.ERROR.GENERIC layer.
  • Bugfix: thinned waveguide templates (ThinnedWaveguideTemplate) and rib waveguide templates (RibWaveguideTemplate) are correctly identified when using automated transitions such as with AutoTransitionPorts.
  • Bugfix: thinned waveguide templates (ThinnedWaveguideTemplate) now correctly interprete and pass along their properties.
  • Bugfix: IoFibcoup now raises a proper exception when a fiber coupler without an East Port is used.
  • Bugfix: IoFibcoup now handles fiber couplers with multiple waveguide ports (e.g. 2D couplers) correctly.

Samples & documentation

  • Added MMIs to demolib (samples\demo\libraries).
  • Docfix: Layout elements like Circle and Rectangle only accept Layer objects for the layer argument, not an integer.

Ipkiss 3.1.0

There are a few changes in Ipkiss 3.1 that that introduce a backward incompatibility with Ipkiss 3.0.1. These are explained in more detail in Porting from Ipkiss 3.0.1 to Ipkiss 3.1.


  • The installer now works correctly on Windows 10

Samples & documentation

  • New demonstration library (including a technology setup) + associated demonstration projects (samples/demo).
  • Small updates to the trainings and samples (samples/ipkiss3/training and samples/ipkiss3/getting_started).
  • Improved sample for GDSII import in the documentation.
  • Sample on how to find cells in a layout which have a label inside (with a given text). See samples/ipkiss3/samples/advanced/label_layers.
  • Guide on technology: this guide explains you how to build your own technology with Ipkiss.
  • visualize_2d() does not display the image twice anymore in notebooks.


  • Added the decorator @lock_properties() to make all properties of a StrongPropertyInitializer class read-only. See the PCell guide in the documentation for usage.
  • Improvement: RestrictTypeList now has a proper string representation (__str__).
  • Improvement: RestrictRange can now handle float values, even when the range bounds were specified as integers.


  • New functionality: Added capability to specify Caphe time domain models: pure input/output behavior, Ordinary Differential Equations (ODE) and Coupled Mode Theory (CMT) models can be specified. Note: this is still in an early stage. Simulation models are already defined in IPKISS, but the simulation setup is still done in native Caphe and not in Ipkiss.
  • New functionality: Added BoundaryPath element. It is a boundary which keeps a reference to its centre line.
  • Fix: Views (Layout, Netlist) are now compared based on overridden properties, but also overridden view data.
  • Fix: Net is now available in ipkiss3.all.
  • Fix: Automatic transitioning between waveguides is now based on a detailed comparison of the waveguide windows. Note: this may change your design. For example, a PlaceAndAutoRoute component (which uses Connector) may now have less unnecessary transitions.
  • Fix: RouteManhattan will no longer yield solutions with bend radii that are too small. However, this could in some cases lead to a waveguide crossing.
  • Bugfix: Shapes defined with integer coordinates are now converted to float coordinates to avoid rounding errors.
  • Bugfix: ShapeVariableOffset now works properly on simple shapes.
  • Bugfix: Boolean operations on Boundary now correctly take a transformation into account.
  • Bugfix: Layer filters (LayerFilterAllow, LayerFilterDelete) are fixed. They no longer functioned because the class __LayerElement__ was renamed to _LayerElement.
  • Bugfix: Label.size_info() now returns a new empty SizeInfo object (previously, it returned the global EMPTY_SIZE_INFO object).
  • Bugfix: The cross section visualization of a layout view now correctly takes the hierarchy into account.
  • Bugfix: Trace transitions with zero length now have the correct port angles.
  • Bugfix: Rounded waveguides where there is not enough bend space in the first and last section will now throw an error. Previously, this was ignored, which resulted in too small bend radii.
  • Bugfix: ElectricalPort is now correctly transformed if you manually set the angle.
  • Bugfix: Making a copy of a port also copies the position into a separate coordinate object.
  • Bugfix: Small code refactoring to Port, Group, _GroupElement. As a result, a port no longer contains a portlist itself (which is logical).
  • Bugfix: The process parameter was not passed in IoColumn.add_blocktitle. The pattern purpose for the text was hardcoded and is now a parameter as well.
  • Improvement: NameProperty now prints a valid error message when a non-string is assigned.
  • Improvement: Transformable and NoDistortTransformable do no longer take positional arguments (i.e. the __init__ has been removed). This is very unlikely to affect any user code.
  • Improvement: Trace transitions originating from a port now have default zero length. This default behavior keeps containers more compact when no transitions are needed.
  • Improvement: ShapeProperty is now a class, rather than a shortcut function. This should normally not introduce any compatibility problems, unless you have used the internal_member_name attribute.
  • Improvement: The comparison of Trace Templates (and Ipkiss 2.4 Waveguide Definitions) is now more rigorous. As a result, there might be occurences where tapers are removed where trace templates are identical. Also, WgMziGeneric in Picazzo will now add tapers in a more reliable way.
  • Improvement: Waveguides and traces now have a default shape: [(0.0, 0.0), (TECH.WG.SHORT_STRAIGHT, 0.0)].
  • Improvement: the template property of a templated Waveguide now has a default value. More specifically:
    • _TemplatedWaveguide: TECH.PCELLS.WG.DEFAULT.
    • TemplatedWindowsOnWaveguide: WindowsOnWaveguideTemplate(trace_template=TECH.PCELLS.WG.DEFAULT).
  • [Backward incompatible] Change: environment variable IPKISS_LOG_LEVEL has been renamed to LUCEDA_LOG_LEVEL.


  • All Picazzo components now have sensible default values.
  • Added waveguide connectors (picazzo3.wg.connector).
  • Added inline waveguide gratings (picazzo3.wg.grating).
  • Added a logical inline reflector with a Fresnel reflection model (picazzo3.logical.reflector).
  • Added StraightGratingLine for simple grating couplers.
  • Fix: MziWithCells now calculates the combiner transformation taking into account tapering, and the transformations for splitters and combiners can also be manually overruled.
  • Bugfix: MziWithCells now generates a valid MZI arm when the child cell in the arm is specified through inheritance (as a _default_arm1_contents or _default_arm2_contents method)
  • Bugfix: angle_step is now correctly passed in the ring resonators (picazzo.filters.ring), from the ring cell to its constituting waveguides.
  • Bugfix: get_ring_length() of RingRect.Layout and derived ring resonators now reports the complete ring length instead of one quarter of the ring
  • Bugfix: IoFibcoup can now handle west ports routed to east and vice versa, when port labels ("E0", "W1", …) are used
  • Bugfix: Use of predefined columns from will now work. There was a syntax error before.
  • Bugfix: MMIIdentical now has 3 inputs and 3 outputs by default. There was a circular dependence before.
  • Bugfix: RibMMI classes now use the default rib waveguide templates, instead of the default strip waveguides.
  • Bugfix: Transition of slot waveguides now adjusts to the layers of the slot waveguide template. Before, these layers were hardcoded.
  • Bugfix: Transitions created with AutoTraceTransitionFromPort now have unique names. As a result names of transitions in your design might have changed.
  • Bugfix: RoutePortsAroundCorner now has a one-to-one correspondence between the waveguide instances in Netlist and Layout. Before, the waveguide instances were reordered in the layout, which could lead to a mismatch between layotu and netlist.
  • Bugfix: Trace chains and Spirals were incorrectly connected on netlist level.
  • [Backward incompatible] Improvement: Wire waveguide transitions WireWaveguideTransitionFromPortLinear now have an adaptive length with a minimum of TECH.WG.SHORT_TRANSITION_LENGTH. Note: This will have an effect on your design if you used short tapers between a very wide and a very narrow waveguide. Such short tapers can introduce a large loss, and therefore an adaptive length was introduced: The larger the width mismatch between the two waveguide cores, the longer the taper will be.
  • [Backward incompatible] Added property purpose to ElectricalWireTemplate, with default value TECH.PURPOSE.DRAWING. The original purpose that was used was TECH.PURPOSE.DF.LINE. If your technology used TECH.PURPOSE.DF.LINE for drawing electrical wires, you need to change this default.
  • Improvements to PlaceAndAutoRoute:
    • Added transitions when ports don’t match the trace template.
    • Added automatic detection and highlighting of crossing waveguides using the highlight_waveguide_crossings flag.
    • Added the method get_waveguide_crossing_points() on the Layout view.
    • Added the possibility to manually override individual waveguide routes
    • Added min_straight, start_straight, end_straight properties on the Layout view. These influence the behavior of the routing.
    • The links property has a proper restriction. It checks if it’s a list, with tuples, and each tuple is exactly size 2.
  • Improvement: in FanoutPorts: When no reference coordinate is specified, the first route will follow a more natural shape. Note: this may change behavior of FanoutPorts. It will only occur when you perform a FanoutPorts on a component where the first ports (the reference port) is at an angle with the output direction, and no reference_coordinate is specified. Now the shortest route to the output direction is used, while originally the waveguide could make a somewhat awkward bend. If you manually specify the reference_coordinate, there is no difference.
  • Improvement: RoutePortsAroundCorner will now sort the ports before generating the routes.
  • Improvement: StraightWgSocket for fiber couplers is now centered around (0,0), rather than starting at (0,0). By default, it now overlays correctly on a straight grating.
  • Improvement: MMI and RibMMI classes now have more sensible defaults for widths and input/output positions.
  • Improvement: Generic ring resonators (RingShape and RingTraces) now have a default circular shape instead of an empty shape.
  • Improvement: ContactHole and Via12 now use "CONTACT" and "VIA12" as name prefix - therefore autogenerated names will change when the name was not manually set.
  • Improvement: PlaceandConnect can now logically connect components with electrical as well as optical terms.
  • Improvement: The ParabolicCrossing has no hard-coded layer purposes anymore. These can now be set using the properties core_purpose, strip_purpose, cladding_purpose and strip_cladding_purpose.
  • Improvement: The generic TraceChain classes now, by default, concatenate 3 right-angle bends. This illustrates the functionality better.
  • Improvement: The default width of the intermediate wire of a Rib-to-Wire transition (WireRibWireWaveguideTransitionLinear) is narrower, resulting in a smoother transition.
  • Improvements to Spirals:
    • The East output section of DoubleSpiralWithIncoupling does not extend as far east as it used to be. It default to TECH.WG.SHORT_STRAIGHT.
    • Spiral loops are now cut in 2 to avoid self-intersecting polygons on export.

Picazzo 2.4

  • Bugfix: TaperDeepPorts and TaperShallowPorts had wrong port names: multiple ports with the same name could result. The port names of the tapered structure are now identical to the port names of the original structure.
  • Removed InWaveguideHeaterDefinition from picazzo.modulators.window_waveguides.

Ipkiss 2.4

  • Bugfix: the ipkiss.plugins.electronics.port package could not be imported anymore. This is now fixed (for designers that need to run old 2.4 code that uses electronic ports).


  • Small syntax fix in SimulationParameterContainer.

Ipkiss 3.0.1

Changes that introduce a backward incompatibility are explained in more detail in Porting from Ipkiss 3.0 to Ipkiss 3.0.1 .


  • Improved error message when a property is not valid.
  • BoolProperty and RESTRICT_BOOL now accept int and numpy booleans (numpy.bool_). BoolProperty now stores its value as a python bool.
  • Small, but important change in the behavior of number properties:
    • Basic type (bool, int, float, complex) properties (such as BoolProperty, IntProperty, NumberProperty and ComplexNumberProperty) always cast the value to the correct type. For example, when 1 is passed to a NumberProperty, it is converted to 1.0.
    • [Backward incompatible] FloatProperty now accepts integer values (this means now NumberProperty and FloatProperty are equivalent). The preferred usage is NumberProperty, as it is used in most places. This casting is done to ensure a consistent user experience. It might, in some very specific cases in your code, result in a changed behavior or a warning.
  • [Backward incompatible] The set method (or _set_bulk) now only accept keyword arguments that correspond to properties of the component. Originally unknown keywords were ignored, but now unknown keywords will raise an exception. This reduces the chances of obscure bugs due to small programming typos.


  • Trace transitions describe the interface between two different kinds of trace templates (ipkiss3.pcell.trace.transition). This is an improvement on the Tapers in Ipkiss 2.4. Linear and Parabolic transitions are available. Trace transitions are stored in a database (TECH.PCELLS.TRANSITION.AUTO_TRANSITION_DATABASE). Transitions cannot be mixed with ‘tapers’ from Ipkiss 2.4.
  • vector_match_transform now has a parameter mirrored to introduce a mirroring operation.
  • In a hierarchical PCell with childcells , it was often needed to explicitly evaluate the child views (or perform visualize). This has now been fixed. See the porting guide for more details.
  • A wrapper GDSCell to import external GDS files has been added (ipkiss3.pcell.gdscell).
  • Adding electrical traces and ports (ipkiss3.pcell.wiring).
  • Routes have been ported from Ipkiss 2.4 to Ipkiss 3 (ipkiss3.pcell.routing) * Also available for electrical traces and ports. * Added support for manual routing angles. This can be useful for electrical routing.
  • [Future Deprecation] PortList now has dict-like methods keys, values and items. This makes it similar in use as TermDict. Use those methods wherever possible to avoid future deprecation.
  • Bugfix: Port.invert() did not return an object.
  • Bugfix in OutputGdsii, FileOutputGdsii and write_gdsii: grid and unit arguments were ignored and technology defaults taken. The grid and unit arguments are used now upon GDSII export.
  • Bugfix in GDSII export: entities with a fixed timestamp (library, structure) can now have a timezone west of UTC. Upon import, any year xx<=69 is converted to 20xx (Y2K handling) - was xx<=70 before, which includes the unix epoch.
  • Bugfix in NewlineStringCollector: += did not properly support a list of items (


  • [Backward incompatible] All occurences of LayerProperty have been removed on picazzo components - the process and purpose properties should be used instead. This affects trace templates, photonic crystals, MMIs and grating couplers.
  • [Backward incompatible] Cleanup of technology. Importing the technology is now done using from technologies import silicon_photonics.
    • If you have designs/scripts in IPKISS 3.0 syntax that uses si_photonics, please change your script to use silicon_photonics
    • If you have a custom technology that is based on si_photonics, it will still work with components based on IPKISS 2.4 syntax (in backward compatibility mode). But if you want to use your custom technology in IPKISS3, it is better to base it on the silicon_photonics technology files.
  • Added trace bundles and waveguide bundles, which group a set of traces/waveguides routed together. The layout can have a covering hull.
  • Added electrical wires (traces.electrical_wire) and contact vias (
  • The Y splitters in picazzo3.wg.splitters now have a Caphe model (transmission + 3 reflection parameters)
  • Added TerminatePorts, ExtendPorts, FanoutPorts, TransitionPorts, RoutePortsEastWest, RoutePortAroundCorner. Added a notebook on containers (samples/notebook3/containers). Each type of container also has a ‘generic’ version where the properties of each port can be adjusted.
  • Refactored PlaceAndAutoRoute: the functionality has been separated into individual PCells: PlaceComponents, ConnectComponents, and PlaceAndConnect. You can now use this functionality in a granular way. Also, it is now possible to explicitly name the external ports.
  • Added MMI filters, models have been added. ‘Shallow’ (picazzo2) has been renamed to ‘Rib’. For example, ShallowMMI2x2Tapered is now called RibMMI2x2Tapered.
  • Added Mach-Zehnder Interferometers. A set of circuit simulation samples for the picazzo MZIs can be found under samples/ipkiss3/picazzo3/mzi.
  • Added Curved Grating Couplers. There are 2 classes (FiberCouplerCurvedGratingGeneric and FiberCouplerCurvedGrating). All the functionality previously accessible in picazzo2 is accessible from these 2 classes. Examples in the picazzo reference documentation. There is also a dedicated notebook (ipkiss3\Curved Grating Couplers.ipynb).
  • Added reflection to grating coupler models. The fiber port is now called vertical_in by default.
  • Added Spirals. Includes a bugfix where expanding the spiral in the vertical direction would sometimes be wrong. Please check the reference documentation, and the dedicated notebook (ipkiss3\Waveguide spirals.ipynb)
  • Added IOFibCoup adapter, which allows to automatically connect fiber couplers to a PCell. Many improvements compared to picazzo in 2.4 were added, including better architecture, improved error handling. For an overview of the features, please check the reference documentation, or the notebook (ipkiss3/IOFibcoup - Routing to fibercouplers.ipynb).
  • The models for the directional couplers now include the phase propagation of the arms. Please check the reference documentation for more information.
  • Added phase modulator waveguide templates: P(I)N junction based phase modulator, lateral and longitudinal, and a generic base class.
  • Added a phase modulator PCell.


  • CAMFR: Removed hard-coded wavelength restriction.
  • Caphe: fixed bug where setup time for a complex circuit with many levels of hierarchy and many number of ports took a lot of time to load (exponential with the number of hierarchy levels). This is now linear in time.
  • Caphe: throw an exception if the type of a property value of a CapheModel changes. Make sure to always use strongly typed properties such as IntProperty and NumberProperty, or ensure that a DefinitionProperty of a CapheModel always returns a value of the same type.

i-Python notebooks

  • [Backward incompatible] The IPython Notebooks are now based on version 3 of the notebook framework. Your old notebooks should work fine when you load them, but you will have to add %pylab inline at the beginning. when saved, they will be in the new format.
  • Added several new demonstration notebooks on containers, grating couplers, IoFibcoup, …

Ipkiss 2.4 compatibility

  • Ipkiss 2.4 Structures now automatically get a netlist, deriving terms for the Structure’s ports. This makes it easier to use a library with Ipkiss 2.4 Structures as children in Ipkiss 3 PCells.
  • New technologies (like silicon_photonics) will only support Ipkiss 3 PCells. If you want to use Ipkiss 2.4 Structures with a new-style technology you need to import the compat24 technology immediately after you have imported your technology.
  • Trace transitions should not be mixed with waveguide tapers from Ipkiss 2.4.

Ipkiss 3.0

Most parts of IPKISS are rewritten in IPKISS 3.0, and new functionality has been added. The most notable changes are summarized below:


  • The Caphe circuit solver is now integrated, and circuit simulations can be launched from within Ipkiss
  • A new framework for describing PCells and their Views has been written
  • Parametric cells can now also contain netlist and circuit model information
  • A number of components from the picazzo library were ported to the new syntax and have a netlist and circuit model (picazzo3 library)
  • A backward compatibility layer with 2.4 has been foreseen. There are a few Backward incompatible changes (documented).

User experience

  • The installation infrastructure has been revamped. On Windows, a self-contained installer is available, on Linux packages are available.
  • The documentation has been revamped and sufficiently expanded.

Under the hood

  • A new property framework (strong typing/caching) was adopted.