class jj_dolan(design: QDesign, name: str = None, options: Dict = None, make=True, component_template: Dict = None)[source]

The base “JJ_Dolan” inherits the “QComponent” class.

NOTE TO USER: Please be aware that when designing with this qcomponent, one must take care in accounting for the junction qgeometry when exporting to to GDS and/or to a simulator. This qcomponent should not be rendered for EM simulation.

This creates a “Dolan”-style Josephson Junction consisting of two non-overlapping metal rectangles each connected to a larger rectangular pad. There is also a second, smaller rectangle drawn on a different metal level which overlaps part of one of the rectangular fingers.

Default Options:
  • JJ_pad_lower_width: ‘25um’ – width of lower JJ metal region

  • JJ_pad_lower_height: ‘10um’ – height of lower JJ metal region

  • JJ_pad_lower_pos_x: ‘0um’ – the initial x-coord of the lower JJ pad

  • JJ_pad_lower_pos_y: ‘0um’ – the initial y-coord of the lower JJ pad

  • finger_lower_width: ‘1um’ – the width of the rectangular finger(s)

  • finger_lower_height: ‘20um’ – the length of the rectangular finger(s)

  • extension: ‘1um’ – the amount of rectangle extending beyond X-point

  • offset: ‘2um’ – the separation between finger and the 2nd metal level

  • second_metal_length: ‘5um’ – the length of the 2nd metal level

  • second_metal_width: ‘1um’ – the width of the 2nd metal level

Create a new Metal component and adds it’s default_options to the design.

  • design (QDesign) – The parent design.

  • name (str) – Name of the component. Auto-named if possible.

  • options (dict) – User options that will override the defaults. Defaults to None.

  • make (bool) – True if the make function should be called at the end of the init. Options be used in the make function to create the geometry. Defaults to True.

  • component_template (dict) – User can overwrite the template options for the component that will be stored in the design, in design.template, and used every time a new component is instantiated. Defaults to None.


ValueError – User supplied design isn’t a QDesign

Note: Information copied from QDesign class.

self._design.overwrite_enabled (bool): When True - If the string name, used for component, already exists in the design, the existing component will be deleted from design, and new component will be generated with the same name and newly generated component_id, and then added to design.

When False - If the string name, used for component, already exists in the design, the existing component will be kept in the design, and current component will not be generated, nor will be added to the design. The variable design.self.status will still be NotBuilt, as opposed to Initialization Successful.

Either True or False - If string name, used for component, is NOT being used in the design, a component will be generated and added to design using the name.




the full module name with the class name.


Component metadata


Default drawing options


Return a reference to the parent design object.


The unique id of component within a design.


The Qiskit Metal Logger.


Name of the component.


A dictionary of the component-designer-defined options.


The names of the pins.


Get a list of the names of the element tables.


Dictionary of pins.


Metadata allows a designer to store extra information or analysis results.


Stores the latest status of the component.


jj_dolan.add_dependency(parent, child)

Add a dependency between one component and another.

jj_dolan.add_pin(name, points, width[, ...])

Adds a pin from two points which are normal/tangent to the intended plane of the pin.

jj_dolan.add_qgeometry(kind, geometry[, ...])

Add QGeometry.


WARNING: Do NOT use this method during generation of component instance.


Delete the QComponent.


Interface for components to get pin data.

jj_dolan.get_template_options(design[, ...])

Creates template options for the Metal Component class required for the class to function, based on the design template; i.e., be created, made, and rendered.


Convert self.options into QGeometry.


Parse the options, converting string into interpreted values.


Parse a string, mappable (dict, Dict), iterable (list, tuple) to account for units conversion, some basic arithmetic, and design variables.


Use the element_handler to get a list of all the table names used in QGeometry.


Fetched the component bound dict_value.


Returns a dict of element qgeometry (shapely geometry) of the component as a python dict, where the dict keys are the names of the qgeometry and the corresponding values are the shapely geometries.


Returns a list of element qgeometry (shapely geometry) of the component as a python list of shapely geometries.

jj_dolan.qgeometry_plot([ax, plot_kw])

Draw all the qgeometry of the component (polys and path etc.)


Returns the entire element table for the component.


Builds the QComponent.

jj_dolan.to_script([thin, is_part_of_chip])

param thin:

If true then any key in the QComponent's options whose value