kqcircuits.masks.mask_layout

class kqcircuits.masks.mask_layout.MaskLayout(layout, name, version, with_grid, chips_map, face_id, **kwargs)[source]

Bases: object

Class representing the mask for a certain face.

A MaskLayout is used to create the cells for the mask.

layout

pya.Layout for this mask

name

Name of the mask

version

Mask version

with_grid

Boolean determining if ground grid is generated

face_id

face_id of this mask layout, “1t1” | “2b1” | “2t1”

layers_to_mask

dictionary of layers with mask label postfix for mask label and mask covered region creation

covered_region_excluded_layers

list of layers in layers_to_mask for which mask covered region is not created

chips_map

List of lists (2D-array) of strings, each string is a chip name (or — for no chip)

align_to

optional exact point of placement, an (x, y) coordinate tuple. By default the mask is centered.

chips_map_legend

Dictionary where keys are chip names, values are chip cells

wafer_rad

Wafer radius

wafer_center

Wafer center as a pya.DVector

chips_map_offset

Offset to make chips_map centered on wafer

wafer_top_flat_length

length of flat edge at the top of the wafer

wafer_bottom_flat_length

length of flat edge at the bottom of the wafer

dice_width

Dicing width for this mask layout

text_margin

Text margin for this mask layout

chip_size

side width of the chips (assuming square chips)

edge_clearance

minimum clearance of outer chips from the edge of the mask

chip_box_offset

Offset (pya.DVector) from chip origin of the chip frame boxes for this face

chip_trans

DTrans applied to all chips

mask_name_offset

(DEPRECATED) mask name label offset from default position (DPoint)

mask_name_scale

text scaling factor for mask name label (float)

mask_name_box_margin

margin around the mask name that determines the box size around the name (float)

mask_text_scale

text scaling factor for graphical representation layer (float)

mask_markers_dict

dictionary of all markers to be placed and kwargs to determine their position (dict)

mask_marker_offset

offset of mask markers from wafer center in horizontal and vertical directions (float)

mask_export_layers

list of layer names (without face_ids) to be exported as individual mask .oas files

mask_export_density_layers

list of layer names (without face_ids) for which we want to calculate the coverage density

submasks

list of submasks, each element is a tuple (submask mask_layout, submask position)

extra_id

extra string used to create unique name for mask layouts with the same face_id

extra_chips

List of tuples (name, position, trans, position_label) for chips placed outside chips_map trans is an optional transformation to use in place of self.chip_trans position_label is an optional string that overrides the automatic chip position label in the mask grid

top_cell

Top cell of this mask layout

added_chips

List of (chip name, chip position, chip bounding box, chip dtrans, position_label) populated by chips added during build()

add_chips_map(chips_map, align=None, align_to=None, chip_size=None)[source]

Add additional chip maps to the main chip map.

The specified extra chip map, a.k.a. sub-grid, will be attached to the main grid. It may use different chip size than the main grid. For convenience left and rigtht sub-grids will be rotated 90 degrees clockwise.

Parameters
  • chips_map – List of lists (2D-array) of strings, each string is a chip name (or — for no chip)

  • align – to what side of the main grid this sub-grid attaches. Allowed values: top, left, right and bottom.

  • align_to – optional exact point of placement. (x, y) coordinate tuple

  • chip_size – a different chip size may be used in each sub-grid

build(chips_map_legend)[source]

Builds the cell hierarchy for this mask layout.

Inserts cells copied from chips_map_legend to self.top_cell at positions determined by self.chips_map. The copied cells are modified to only have layers corresponding to self.face_id, and they are translated and/or mirrored correctly based on self.face_id. Also inserts cells for mask markers, mask name label, and the circular area covered by the mask.

Parameters

chips_map_legend – Dictionary where keys are chip names, values are chip cells

insert_chip_copy_labels(labels_cell, layers)[source]

Inserts chip copy labels to all chips in this mask layout and its submasks

Parameters
  • labels_cell – Cell to which the labels are inserted

  • layers – list of layer names (without face_ids) where the labels are produced

face()[source]

Returns the face dictionary for this mask layout

../_images/kqcircuits.masks.mask_layout.png