pdaOPSselectLayer

Store part of object layer definition.
This is a complex operation that stores the covered objects contour for the list of In layers.
You can use the elements doc and tex to document the operation. This is often useful for later changes as the logic behind complex chains of operations is often not easy to follow by colleques and/or partners.
Sub elements:
In is the list of input layers.
Compare is the list of cover layers.
how defines the style (covering | in | inside | interacting | not_covering | not_in | not_inside | not_interacting | not_outside | not_overlapping | outside | overlapping); default is covering.
healOutput defines whether a heal operation should be done or not to keep the individual pieces.

Structure

The attributes and elements are shown below, in a sorted per type fashion.
In case a list is printed after an element, it indicates that you can have many, otherwise it should be a single element. With a optional it tells the element is not required.

<layerSelect  
pdaDrcGeneralRule:DFM="..."  pdaDrcGeneralRule:drcExclude="..."  pdaDrcGeneralRule:level="..."  pdaDrcGeneralRule:rule="..." ... > ...
  <Compare> ... </Compare>
  <In> ... </In>
  <healOutput> ... </healOutput>    optional
  <how> ... </how>    optional
  <pdaDrcGeneralRule:doc> ... </doc>    optional
  <pdaDrcGeneralRule:groupRef> ... </groupRef>   list
  <pdaDrcGeneralRule:msg> ... </msg>    optional
  <pdaDrcGeneralRule:tex> ... </tex>    optional
  <pdaDrcGeneralRule:ticket> ... </ticket>   list
</layerSelect>

XSD

The schema file can be downloaded or viewed at xPDK_Layout.

Details

Type pdaDrcGeneralRule

Define a design rule that is not layer or "polygon" / "geometric" based.
Design rules are available in different flavors, some of which can not be associated with layers; for example the name of the GDS cell that is required to be used for the design.
The rule is described in text and software may (or not) be able to implement them. Using the rule field gives designers an easy way to find more information on the DRC fail if it appears.

Compare

The list of cover layers. Type pdaGDSlayerReferenceList documentation:

In

The list of input layers. Type pdaGDSlayerReferenceList documentation:

healOutput

Different grow shapes determine the outer contour.

how

Select the layer compare operation (covering | in | inside | interacting | not_covering | not_in | not_inside | not_interacting | not_outside | not_overlapping | outside | overlapping). Type pdaOPSselectLayerSelection documentation: Define the 'compare' operation.

The operation uses the definition from klayout to be defined in open-source naming scheme, see KLayout API. In short:

DFM

Type pdaExpression documentation:
Expression need to be commonly evaluated by many software, so having a restricted set of math / types and so on is key. In PDAFlow lib2/expr there is a yacc/lex parser available with some unit support as well as double / complex expressions. An alternative is tinyexpr, but this is more restrictive, so may be very unhandy for things like waveguide model expressions.

doc

Short documentation on the why of the rule.
This information is useful for a design manual but can also be used in the user interface as additional information, like a 'on-hoover mouse move'. Type pdaDocumentation documentation:
This field allows some (short, few lines) documentation to be written. It can be a long string, but the idea is not to replace a design manual.
This fields is like tex which allows documentation in LaTex format; doc is restricted to plain text.

drcExclude

Type pdaGDSlayerReference documentation:

groupRef

Use this field to combined related topics into groups. Type pdaIdentifier documentation:
Identifiers are used in the Python library for the getName() and setName() function and can thus be used to identify the different elements in list s.
In text the specification is a letter, followed by letters, numbers, underscore. The XSD schema validation is a regular expression: [A-Za-z]([A-Za-z0-9_])*

level

Type pdaDrcWarningLevel documentation: Error/warning level for a DRC message.
Normal use is: warning / error.

msg

DRC message to display in the user interface.
It is recommended that this is a short text as it may appear many times in the display (so much shorter then the 'doc' field).

rule

tex

Possibly long documentation on the why of the rule in LaTeX format. Type pdaTexDocumentation documentation: doc , but tex can be a long text in LaTex format to document the layer in more detail if needed.

You can document anything relevant for the topic you want to define.

Multiple paragraphs is fine. Format is Latex, so more complex content is possible.

ticket

Type pdaTicket documentation: