siliconcompiler 0.29.4__py3-none-any.whl → 0.31.0__py3-none-any.whl

siliconcompiler/schema/schema_cfg.py

@@ -6,23 +6,22 @@ import json
 # (such as KLayout) directly importing the schema package. However, the fallback
 # allows running this script directly to generate defaults.json.
 try:
-    from .utils import trim
+    from .utils import trim, Scope, PerNode
 except ImportError:
-    from siliconcompiler.schema.utils import trim
+    from siliconcompiler.schema.utils import trim, Scope, PerNode
+
+SCHEMA_VERSION = '0.50.0'
 
-SCHEMA_VERSION = '0.48.6'
 
 #############################################################################
 # PARAM DEFINITION
 #############################################################################
-
-
 def scparam(cfg,
             keypath,
             sctype=None,
             require=False,
             defvalue=None,
-            scope='job',
+            scope=Scope.JOB,
             copy=False,
             lock=False,
             hashalgo='sha256',
@@ -34,7 +33,7 @@ def scparam(cfg,
             example=None,
             schelp=None,
             enum=None,
-            pernode='never'):
+            pernode=PerNode.NEVER):
 
     # 1. descend keypath until done
     # 2. create key if missing
@@ -79,19 +78,19 @@ def scparam(cfg,
                 defvalue = []
 
         # mandatory for all
-        cfg['type'] = sctype
-        cfg['scope'] = scope
-        cfg['require'] = require
-        cfg['lock'] = lock
+        cfg['type'] = str(sctype)
+        cfg['scope'] = Scope(scope).value
+        cfg['require'] = bool(require)
+        cfg['lock'] = bool(lock)
         if switch and not isinstance(switch, list):
             switch = [switch]
-        cfg['switch'] = switch
-        cfg['shorthelp'] = shorthelp
-        cfg['example'] = example
-        cfg['help'] = schelp
-        cfg['notes'] = notes
+        cfg['switch'] = [str(s) for s in switch] if switch else None
+        cfg['shorthelp'] = str(shorthelp) if shorthelp else None
+        cfg['example'] = [str(e) for e in example] if example else None
+        cfg['help'] = str(schelp) if schelp else None
+        cfg['notes'] = str(notes) if notes else None
         # never, optional, required
-        cfg['pernode'] = pernode
+        cfg['pernode'] = PerNode(pernode).value
         cfg['node'] = {}
         cfg['node']['default'] = {}
         cfg['node']['default']['default'] = {}
@@ -99,26 +98,22 @@ def scparam(cfg,
         cfg['node']['default']['default']['signature'] = signature
 
         if enum is not None:
-            cfg['enum'] = enum
+            cfg['enum'] = [str(e) for e in enum]
 
         # unit for floats/ints
         if unit is not None:
-            cfg['unit'] = unit
+            cfg['unit'] = str(unit)
+
+        if 'dir' in sctype or 'file' in sctype:
+            cfg['hashalgo'] = str(hashalgo)
+            cfg['copy'] = bool(copy)
+            cfg['node']['default']['default']['filehash'] = []
+            cfg['node']['default']['default']['package'] = []
 
         # file only values
         if 'file' in sctype:
-            cfg['hashalgo'] = hashalgo
-            cfg['copy'] = copy
             cfg['node']['default']['default']['date'] = []
             cfg['node']['default']['default']['author'] = []
-            cfg['node']['default']['default']['filehash'] = []
-            cfg['node']['default']['default']['package'] = []
-
-        if 'dir' in sctype:
-            cfg['hashalgo'] = hashalgo
-            cfg['copy'] = copy
-            cfg['node']['default']['default']['filehash'] = []
-            cfg['node']['default']['default']['package'] = []
 
 
 #############################################################################
@@ -142,7 +137,7 @@ def schema_cfg():
 
     scparam(cfg, ['schemaversion'],
             sctype='str',
-            scope='global',
+            scope=Scope.GLOBAL,
             defvalue=SCHEMA_VERSION,
             require=True,
             shorthelp="Schema version number",
@@ -154,7 +149,7 @@ def schema_cfg():
     # Design topmodule/entrypoint
     scparam(cfg, ['design'],
             sctype='str',
-            scope='global',
+            scope=Scope.GLOBAL,
             require=True,
             shorthelp="Design top module name",
             switch="-design <str>",
@@ -173,7 +168,7 @@ def schema_cfg():
     for item, val in io.items():
         scparam(cfg, [item, fileset, filetype],
                 sctype='[file]',
-                pernode='optional',
+                pernode=PerNode.OPTIONAL,
                 copy=val[1],
                 shorthelp=f"{val[0]} files",
                 switch=f"-{item} 'fileset filetype <file>'",
@@ -228,13 +223,13 @@ def schema_schematic(cfg, name='default'):
     ''' Schematic
     '''
 
-    scparam(cfg, ['schematic', 'component', name, 'model'],
+    scparam(cfg, ['schematic', 'component', name, 'partname'],
             sctype='str',
             shorthelp="Schematic: component model",
-            switch="-schematic_component_model 'name <str>'",
-            example=["cli: -schematic_component_model 'B0 NAND2X1'",
-                     "api: chip.set('schematic', 'component', 'B0, 'model', 'NAND2X1')"],
-            schelp="""Model of a component, specified on a per instance basis.""")
+            switch="-schematic_component_partname 'name <str>'",
+            example=["cli: -schematic_component_partname 'B0 NAND2X1'",
+                     "api: chip.set('schematic', 'component', 'B0, 'partname', 'NAND2X1')"],
+            schelp="""Component part-name ("aka cell-name") specified on a per instance basis.""")
 
     scparam(cfg, ['schematic', 'pin', name, 'dir'],
             sctype='enum',
@@ -326,7 +321,7 @@ def schema_fpga(cfg):
 
     scparam(cfg, ['fpga', partname, 'file', key],
             sctype='[file]',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="FPGA: file",
             switch="-fpga_file 'partname key <file>'",
             example=["cli: -fpga_file 'fpga64k file archfile my_arch.xml'",
@@ -359,7 +354,7 @@ def schema_pdk(cfg, stackup='default'):
 
     scparam(cfg, ['pdk', pdkname, 'foundry'],
             sctype='str',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="PDK: foundry name",
             switch="-pdk_foundry 'pdkname <str>'",
             example=["cli: -pdk_foundry 'asap7 virtual'",
@@ -371,7 +366,7 @@ def schema_pdk(cfg, stackup='default'):
 
     scparam(cfg, ['pdk', pdkname, 'node'],
             sctype='float',
-            scope='global',
+            scope=Scope.GLOBAL,
             unit='nm',
             shorthelp="PDK: process node",
             switch="-pdk_node 'pdkname <float>'",
@@ -386,7 +381,7 @@ def schema_pdk(cfg, stackup='default'):
 
     scparam(cfg, ['pdk', pdkname, 'version'],
             sctype='str',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="PDK: version",
             switch="-pdk_version 'pdkname <str>'",
             example=["cli: -pdk_version 'asap7 1.0'",
@@ -399,7 +394,7 @@ def schema_pdk(cfg, stackup='default'):
 
     scparam(cfg, ['pdk', pdkname, 'stackup'],
             sctype='[str]',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="PDK: metal stackups",
             switch="-pdk_stackup 'pdkname <str>'",
             example=["cli: -pdk_stackup 'asap7 2MA4MB2MC'",
@@ -419,7 +414,7 @@ def schema_pdk(cfg, stackup='default'):
 
     scparam(cfg, ['pdk', pdkname, 'minlayer', stackup],
             sctype='str',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="PDK: minimum routing layer",
             switch="-pdk_minlayer 'pdk stackup <str>'",
             example=[
@@ -431,7 +426,7 @@ def schema_pdk(cfg, stackup='default'):
 
     scparam(cfg, ['pdk', pdkname, 'maxlayer', stackup],
             sctype='str',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="PDK: maximum routing layer",
             switch="-pdk_maxlayer 'pdk stackup <str>'",
             example=[
@@ -443,7 +438,7 @@ def schema_pdk(cfg, stackup='default'):
 
     scparam(cfg, ['pdk', pdkname, 'wafersize'],
             sctype='float',
-            scope='global',
+            scope=Scope.GLOBAL,
             unit='mm',
             shorthelp="PDK: wafer size",
             switch="-pdk_wafersize 'pdkname <float>'",
@@ -458,7 +453,7 @@ def schema_pdk(cfg, stackup='default'):
 
     scparam(cfg, ['pdk', pdkname, 'panelsize'],
             sctype='[(float,float)]',
-            scope='global',
+            scope=Scope.GLOBAL,
             unit='mm',
             shorthelp="PDK: panel size",
             switch="-pdk_panelsize 'pdkname <(float,float)>'",
@@ -471,7 +466,7 @@ def schema_pdk(cfg, stackup='default'):
 
     scparam(cfg, ['pdk', pdkname, 'unitcost'],
             sctype='float',
-            scope='global',
+            scope=Scope.GLOBAL,
             unit='USD',
             shorthelp="PDK: unit cost",
             switch="-pdk_unitcost 'pdkname <float>'",
@@ -483,7 +478,7 @@ def schema_pdk(cfg, stackup='default'):
 
     scparam(cfg, ['pdk', pdkname, 'd0'],
             sctype='float',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="PDK: process defect density",
             switch="-pdk_d0 'pdkname <float>'",
             example=["cli: -pdk_d0 'asap7 0.1'",
@@ -498,7 +493,7 @@ def schema_pdk(cfg, stackup='default'):
 
     scparam(cfg, ['pdk', pdkname, 'scribe'],
             sctype='(float,float)',
-            scope='global',
+            scope=Scope.GLOBAL,
             unit='mm',
             shorthelp="PDK: horizontal scribe line width",
             switch="-pdk_scribe 'pdkname <(float,float)>'",
@@ -513,7 +508,7 @@ def schema_pdk(cfg, stackup='default'):
 
     scparam(cfg, ['pdk', pdkname, 'edgemargin'],
             sctype='float',
-            scope='global',
+            scope=Scope.GLOBAL,
             unit='mm',
             shorthelp="PDK: wafer edge keep-out margin",
             switch="-pdk_edgemargin 'pdkname <float>'",
@@ -529,7 +524,7 @@ def schema_pdk(cfg, stackup='default'):
     simtype = 'default'
     scparam(cfg, ['pdk', pdkname, 'devmodel', tool, simtype, stackup],
             sctype='[file]',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="PDK: device models",
             switch="-pdk_devmodel 'pdkname tool simtype stackup <file>'",
             example=[
@@ -549,7 +544,7 @@ def schema_pdk(cfg, stackup='default'):
     corner = 'default'
     scparam(cfg, ['pdk', pdkname, 'pexmodel', tool, stackup, corner],
             sctype='[file]',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="PDK: parasitic TCAD models",
             switch="-pdk_pexmodel 'pdkname tool stackup corner <file>'",
             example=[
@@ -568,7 +563,7 @@ def schema_pdk(cfg, stackup='default'):
     dst = 'default'
     scparam(cfg, ['pdk', pdkname, 'layermap', tool, src, dst, stackup],
             sctype='[file]',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="PDK: layer map file",
             switch="-pdk_layermap 'pdkname tool src dst stackup <file>'",
             example=[
@@ -589,7 +584,7 @@ def schema_pdk(cfg, stackup='default'):
 
     scparam(cfg, ['pdk', pdkname, 'display', tool, stackup],
             sctype='[file]',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="PDK: display file",
             switch="-pdk_display 'pdkname tool stackup <file>'",
             example=[
@@ -604,7 +599,7 @@ def schema_pdk(cfg, stackup='default'):
     libarch = 'default'
     scparam(cfg, ['pdk', pdkname, 'aprtech', tool, stackup, libarch, filetype],
             sctype='[file]',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="PDK: APR technology files",
             switch="-pdk_aprtech 'pdkname tool stackup libarch filetype <file>'",
             example=[
@@ -628,7 +623,7 @@ def schema_pdk(cfg, stackup='default'):
     for item in checks:
         scparam(cfg, ['pdk', pdkname, item, 'runset', tool, stackup, name],
                 sctype='[file]',
-                scope='global',
+                scope=Scope.GLOBAL,
                 shorthelp=f"PDK: {item.upper()} runset files",
                 switch=f"-pdk_{item}_runset 'pdkname tool stackup name <file>'",
                 example=[
@@ -639,7 +634,7 @@ def schema_pdk(cfg, stackup='default'):
 
         scparam(cfg, ['pdk', pdkname, item, 'waiver', tool, stackup, name],
                 sctype='[file]',
-                scope='global',
+                scope=Scope.GLOBAL,
                 shorthelp=f"PDK: {item.upper()} waiver files",
                 switch=f"-pdk_{item}_waiver 'pdkname tool stackup name <file>'",
                 example=[
@@ -655,7 +650,7 @@ def schema_pdk(cfg, stackup='default'):
     key = 'default'
     scparam(cfg, ['pdk', pdkname, 'file', tool, key, stackup],
             sctype='[file]',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="PDK: custom file",
             switch="-pdk_file 'pdkname tool key stackup <file>'",
             example=[
@@ -668,7 +663,7 @@ def schema_pdk(cfg, stackup='default'):
 
     scparam(cfg, ['pdk', pdkname, 'dir', tool, key, stackup],
             sctype='[dir]',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="PDK: custom directory",
             switch="-pdk_dir 'pdkname tool key stackup <dir>'",
             example=[
@@ -682,7 +677,7 @@ def schema_pdk(cfg, stackup='default'):
 
     scparam(cfg, ['pdk', pdkname, 'var', tool, key, stackup],
             sctype='[str]',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="PDK: custom, variable",
             switch="-pdk_var 'pdkname tool stackup key <str>'",
             example=[
@@ -700,7 +695,7 @@ def schema_pdk(cfg, stackup='default'):
     doctype = 'default'
     scparam(cfg, ['pdk', pdkname, 'doc', doctype],
             sctype='[file]',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="PDK: documentation",
             switch="-pdk_doc 'pdkname doctype <file>'",
             example=["cli: -pdk_doc 'asap7 reference reference.pdf'",
@@ -713,7 +708,7 @@ def schema_pdk(cfg, stackup='default'):
 ###############################################################################
 # Datasheet ("specification/contract")
 ###############################################################################
-def schema_datasheet(cfg, name='default', mode='default'):
+def schema_datasheet(cfg, partname='default', mode='default'):
 
     # Part type
     scparam(cfg, ['datasheet', 'type'],
@@ -901,7 +896,7 @@ def schema_datasheet(cfg, name='default', mode='default'):
     # IO
     ######################
 
-    scparam(cfg, ['datasheet', 'io', name, 'arch'],
+    scparam(cfg, ['datasheet', 'io', partname, 'arch'],
             sctype='enum',
             enum=['spi', 'uart', 'i2c', 'pwm', 'qspi', 'sdio', 'can', 'jtag',
                   'spdif', 'i2s',
@@ -919,7 +914,7 @@ def schema_datasheet(cfg, name='default', mode='default'):
                   '10gbase-kr', '25gbase-kr', 'xfi', 'cei28g',
                   'jesd204', 'cpri'],
             shorthelp="Datasheet: io standard",
-            switch="-datasheet_io_arch 'name <str>'",
+            switch="-datasheet_io_arch 'partname <str>'",
             example=[
                 "cli: -datasheet_io_arch 'pio spi'",
                 "api: chip.set('datasheet', 'io', 'pio', 'arch', 'spi')"],
@@ -932,14 +927,14 @@ def schema_datasheet(cfg, name='default', mode='default'):
                }
 
     for i, v in metrics.items():
-        scparam(cfg, ['datasheet', 'io', name, i],
+        scparam(cfg, ['datasheet', 'io', partname, i],
                 unit=v[3],
                 sctype=v[2],
                 shorthelp=f"Datasheet: io {v[0]}",
-                switch=f"-datasheet_io_{i} 'name <{v[2]}>'",
+                switch=f"-datasheet_io_{i} 'partname <{v[2]}>'",
                 example=[
-                    f"cli: -datasheet_io_{i} 'name {v[1]}'",
-                    f"api: chip.set('datasheet', 'io', name, '{i}', {v[1]})"],
+                    f"cli: -datasheet_io_{i} 'partname {v[1]}'",
+                    f"api: chip.set('datasheet', 'io', partname, '{i}', {v[1]})"],
                 schelp=f"""Datasheet: IO {v[1]} metrics specified on a per IO port basis.
                 """)
 
@@ -947,31 +942,31 @@ def schema_datasheet(cfg, name='default', mode='default'):
     # Processor
     ######################
 
-    scparam(cfg, ['datasheet', 'proc', name, 'arch'],
+    scparam(cfg, ['datasheet', 'proc', partname, 'arch'],
             sctype='str',
             shorthelp="Datasheet: processor architecture",
-            switch="-datasheet_proc_arch 'name <str>'",
+            switch="-datasheet_proc_arch 'partname <str>'",
             example=[
                 "cli: -datasheet_proc_arch '0 RV64GC'",
-                "api: chip.set('datasheet', 'proc', name, 'arch', 'openfpga')"],
+                "api: chip.set('datasheet', 'proc', partname, 'arch', 'openfpga')"],
             schelp="""Processor architecture specified on a per core basis.""")
 
-    scparam(cfg, ['datasheet', 'proc', name, 'features'],
+    scparam(cfg, ['datasheet', 'proc', partname, 'features'],
             sctype='[str]',
             shorthelp="Datasheet: processor features",
-            switch="-datasheet_proc_features 'name <str>'",
+            switch="-datasheet_proc_features 'partname <str>'",
             example=[
                 "cli: -datasheet_proc_features '0 SIMD'",
                 "api: chip.set('datasheet','proc','cpu','features', 'SIMD')"],
             schelp="""List of maker specified processor features specified on a per core basis.""")
 
-    scparam(cfg, ['datasheet', 'proc', name, 'datatypes'],
+    scparam(cfg, ['datasheet', 'proc', partname, 'datatypes'],
             sctype='[enum]',
             enum=['int4', 'int8', 'int16', 'int32', 'int64', 'int128',
                   'uint4', 'uint8', 'uint16', 'uint32', 'uint64', 'uint128',
                   'bfloat16', 'fp16', 'fp32', 'fp64', 'fp128'],
             shorthelp="Datasheet: processor datatypes",
-            switch="-datasheet_proc_datatypes 'name <str>'",
+            switch="-datasheet_proc_datatypes 'partname <str>'",
             example=[
                 "cli: -datasheet_proc_datatypes '0 int8'",
                 "api: chip.set('datasheet', 'proc', 'cpu', 'datatypes', 'int8')"],
@@ -991,11 +986,11 @@ def schema_datasheet(cfg, name='default', mode='default'):
                'nvm': ['local non-volatile memory', 128, 'KB']}
 
     for i, v in metrics.items():
-        scparam(cfg, ['datasheet', 'proc', name, i],
+        scparam(cfg, ['datasheet', 'proc', partname, i],
                 unit=v[2],
                 sctype='int',
                 shorthelp=f"Datasheet: processor {v[0]}",
-                switch=f"-datasheet_proc_{i} 'name <int>'",
+                switch=f"-datasheet_proc_{i} 'partname <int>'",
                 example=[
                     f"cli: -datasheet_proc_{i} 'cpu {v[1]}'",
                     f"api: chip.set('datasheet', 'proc', 'cpu', '{i}', {v[1]})"],
@@ -1005,37 +1000,37 @@ def schema_datasheet(cfg, name='default', mode='default'):
     # Memory
     ######################
 
-    scparam(cfg, ['datasheet', 'memory', name, 'bits'],
+    scparam(cfg, ['datasheet', 'memory', partname, 'bits'],
             sctype='int',
             shorthelp="Datasheet: memory total bits",
-            switch="-datasheet_memory_bits 'name <int>'",
+            switch="-datasheet_memory_bits 'partname <int>'",
             example=[
                 "cli: -datasheet_memory_bits 'm0 1024'",
                 "api: chip.set('datasheet', 'memory', 'm0', 'bits', 1024)"],
             schelp="""Memory total number of bits specified on a per memory basis.""")
 
-    scparam(cfg, ['datasheet', 'memory', name, 'width'],
+    scparam(cfg, ['datasheet', 'memory', partname, 'width'],
             sctype='int',
             shorthelp="Datasheet: memory width",
-            switch="-datasheet_memory_width 'name <int>'",
+            switch="-datasheet_memory_width 'partname <int>'",
             example=[
                 "cli: -datasheet_memory_width 'm0 16'",
                 "api: chip.set('datasheet', 'memory', 'm0', 'width', 16)"],
             schelp="""Memory width specified on a per memory basis.""")
 
-    scparam(cfg, ['datasheet', 'memory', name, 'depth'],
+    scparam(cfg, ['datasheet', 'memory', partname, 'depth'],
             sctype='int',
             shorthelp="Datasheet: memory depth",
-            switch="-datasheet_memory_depth 'name <int>'",
+            switch="-datasheet_memory_depth 'partname <int>'",
             example=[
                 "cli: -datasheet_memory_depth 'm0 128'",
                 "api: chip.set('datasheet', 'memory', 'm0', 'depth', 128)"],
             schelp="""Memory depth specified on a per memory basis.""")
 
-    scparam(cfg, ['datasheet', 'memory', name, 'banks'],
+    scparam(cfg, ['datasheet', 'memory', partname, 'banks'],
             sctype='int',
             shorthelp="Datasheet: memory banks",
-            switch="-datasheet_memory_banks 'name <int>'",
+            switch="-datasheet_memory_banks 'partname <int>'",
             example=[
                 "cli: -datasheet_memory_banks 'm0 4'",
                 "api: chip.set('datasheet', 'memory', 'm0', 'banks', 4)"],
@@ -1056,14 +1051,14 @@ def schema_datasheet(cfg, name='default', mode='default'):
                }
 
     for i, v in metrics.items():
-        scparam(cfg, ['datasheet', 'memory', name, i],
+        scparam(cfg, ['datasheet', 'memory', partname, i],
                 unit=v[2],
                 sctype='(float,float,float)',
                 shorthelp=f"Datasheet: memory {v[0]}",
-                switch=f"-datasheet_memory_{i} 'name <(float,float,float)>'",
+                switch=f"-datasheet_memory_{i} 'partname <(float,float,float)>'",
                 example=[
-                    f"cli: -datasheet_memory_{i} 'name {v[1]}'",
-                    f"api: chip.set('datasheet', 'memory', name, '{i}', {v[1]})"],
+                    f"cli: -datasheet_memory_{i} 'partname {v[1]}'",
+                    f"api: chip.set('datasheet', 'memory', partname, '{i}', {v[1]})"],
                 schelp=f"""Memory {v[1]} specified on a per memory basis.""")
 
     # Latency (cycles)
@@ -1074,24 +1069,24 @@ def schema_datasheet(cfg, name='default', mode='default'):
                }
 
     for i, v in metrics.items():
-        scparam(cfg, ['datasheet', 'memory', name, i],
+        scparam(cfg, ['datasheet', 'memory', partname, i],
                 unit=v[2],
                 sctype='(int,int,int)',
                 shorthelp=f"Datasheet: memory {v[0]}",
-                switch=f"-datasheet_memory_{i} 'name <(int,int,int)>'",
+                switch=f"-datasheet_memory_{i} 'partname <(int,int,int)>'",
                 example=[
-                    f"cli: -datasheet_memory_{i} 'name {v[1]}'",
-                    f"api: chip.set('datasheet', 'memory', name, '{i}', {v[1]})"],
+                    f"cli: -datasheet_memory_{i} 'partname {v[1]}'",
+                    f"api: chip.set('datasheet', 'memory', partname, '{i}', {v[1]})"],
                 schelp=f"""Memory {v[1]} specified on a per memory basis.""")
 
     ######################
     # FPGA
     ######################
 
-    scparam(cfg, ['datasheet', 'fpga', name, 'arch'],
+    scparam(cfg, ['datasheet', 'fpga', partname, 'arch'],
             sctype='str',
             shorthelp="Datasheet: fpga architecture",
-            switch="-datasheet_fpga_arch 'name <str>'",
+            switch="-datasheet_fpga_arch 'partname <str>'",
             example=[
                 "cli: -datasheet_fpga_arch 'i0 openfpga'",
                 "api: chip.set('datasheet', 'fpga', 'i0', 'arch', 'openfpga')"],
@@ -1107,11 +1102,11 @@ def schema_datasheet(cfg, name='default', mode='default'):
                'blockram': ['block ram', 128, 'Kb']}
 
     for i, v in metrics.items():
-        scparam(cfg, ['datasheet', 'fpga', name, i],
+        scparam(cfg, ['datasheet', 'fpga', partname, i],
                 unit=v[2],
                 sctype='int',
                 shorthelp=f"Datasheet: fpga {v[0]}",
-                switch=f"-datasheet_fpga_{i} 'name <int>'",
+                switch=f"-datasheet_fpga_{i} 'partname <int>'",
                 example=[
                     f"cli: -datasheet_fpga_{i} 'i0 {v[1]}'",
                     f"api: chip.set('datasheet', 'fpga', 'i0', '{i}', {v[1]})"],
@@ -1121,19 +1116,19 @@ def schema_datasheet(cfg, name='default', mode='default'):
     # Analog
     ######################
 
-    scparam(cfg, ['datasheet', 'analog', name, 'arch'],
+    scparam(cfg, ['datasheet', 'analog', partname, 'arch'],
             sctype='str',
             shorthelp="Datasheet: analog architecture",
-            switch="-datasheet_analog_arch 'name <str>'",
+            switch="-datasheet_analog_arch 'partname <str>'",
             example=[
                 "cli: -datasheet_analog_arch 'adc0 pipelined'",
                 "api: chip.set('datasheet', 'analog', 'adc0', 'arch', 'pipelined')"],
             schelp="""Analog component architecture.""")
 
-    scparam(cfg, ['datasheet', 'analog', name, 'features'],
+    scparam(cfg, ['datasheet', 'analog', partname, 'features'],
             sctype='[str]',
             shorthelp="Datasheet: analog features",
-            switch="-datasheet_analog_features 'name <str>'",
+            switch="-datasheet_analog_features 'partname <str>'",
             example=[
                 "cli: -datasheet_analog_features '0 differential input'",
                 "api: chip.set('datasheet','analog','adc0','features', 'differential input')"],
@@ -1143,10 +1138,10 @@ def schema_datasheet(cfg, name='default', mode='default'):
                'channels': ['parallel channels', 8]}
 
     for i, v in metrics.items():
-        scparam(cfg, ['datasheet', 'analog', name, i],
+        scparam(cfg, ['datasheet', 'analog', partname, i],
                 sctype='int',
                 shorthelp=f"Datasheet: analog {v[0]}",
-                switch=f"-datasheet_analog_{i} 'name <int>'",
+                switch=f"-datasheet_analog_{i} 'partname <int>'",
                 example=[
                     f"cli: -datasheet_analog_{i} 'i0 {v[1]}'",
                     f"api: chip.set('datasheet', 'analog', 'abc123', '{i}', {v[1]})"],
@@ -1185,11 +1180,11 @@ def schema_datasheet(cfg, name='default', mode='default'):
                }
 
     for i, v in metrics.items():
-        scparam(cfg, ['datasheet', 'analog', name, i],
+        scparam(cfg, ['datasheet', 'analog', partname, i],
                 unit=v[2],
                 sctype='(float,float,float)',
                 shorthelp=f"Datasheet: analog {v[0]}",
-                switch=f"-datasheet_analog_{i} 'name <(float,float,float)>'",
+                switch=f"-datasheet_analog_{i} 'partname <(float,float,float)>'",
                 example=[
                     f"cli: -datasheet_analog_{i} 'i0 {v[1]}'",
                     f"api: chip.set('datasheet', 'analog', 'abc123', '{i}', {v[1]})"],
@@ -1252,165 +1247,142 @@ def schema_datasheet(cfg, name='default', mode='default'):
     # Package Description
     #########################
 
-    scparam(cfg, ['datasheet', 'package', name, 'type'],
+    scparam(cfg, ['datasheet', 'package', partname, 'type'],
             sctype='enum',
             enum=['bga', 'lga', 'csp', 'qfn', 'qfp', 'sop', 'die', 'wafer'],
             shorthelp="Datasheet: package type",
-            switch="-datasheet_package_type 'name <str>'",
+            switch="-datasheet_package_type 'partname <str>'",
             example=[
                 "cli: -datasheet_package_type 'abcd bga'",
                 "api: chip.set('datasheet', 'package', 'abcd', 'type', 'bga')"],
-            schelp="""Package type specified on a named package basis.""")
+            schelp="""Package type.""")
 
-    scparam(cfg, ['datasheet', 'package', name, 'footprint'],
-            sctype='str',
+    scparam(cfg, ['datasheet', 'package', partname, 'footprint'],
+            sctype='[file]',
             shorthelp="Datasheet: package footprint",
-            switch="-datasheet_package_footprint 'name <str>'",
+            switch="-datasheet_package_footprint 'partname <file>'",
             example=[
-                "cli: -datasheet_package_footprint 'abcd soic8'",
-                "api: chip.set('datasheet', 'package', 'abcd', 'footprint', 'soic8')"],
-            schelp="""Package footprint name. The name of the footprint can be a standard
-            footprint name or a reference designator from a footprint library.""")
+                "cli: -datasheet_package_footprint 'abcd ./soic8.kicad_mod'",
+                "api: chip.set('datasheet', 'package', 'abcd', 'footprint', './soic8.kicad_mod')"],
+            schelp="""Package footprint file. Supported 3D model file formats include:
+
+            * (KICAD_MOD) KiCad Standard Footprint Format
+
+            """)
 
-    scparam(cfg, ['datasheet', 'package', name, 'drawing'],
+    scparam(cfg, ['datasheet', 'package', partname, '3dmodel'],
             sctype='[file]',
-            shorthelp="Datasheet: package drawing",
-            switch="-datasheet_package_drawing 'name <file>'",
+            shorthelp="Datasheet: package 3D model",
+            switch="-datasheet_package_3dmodel 'partname <file>'",
             example=[
-                "cli: -datasheet_package_drawing 'abcd p484.pdf'",
-                "api: chip.set('datasheet', 'package', 'abcd', 'drawing', 'p484.pdf')"],
-            schelp="""Mechanical package outline for documentation purposes.
-            Common file formats include PDF, DOC, SVG, and PNG.""")
+                "cli: -datasheet_package_3dmodel 'abcd ./soic8.step'",
+                "api: chip.set('datasheet', 'package', 'abcd', '3dmodel', './soic8.step')"],
+            schelp="""Package 3D model file. Supported 3D model file formats include:
 
-    scparam(cfg, ['datasheet', 'package', name, 'pincount'],
-            sctype='int',
-            shorthelp="Datasheet: package total pincount",
-            switch="-datasheet_package_pincount 'name <int>'",
-            example=[
-                "cli: -datasheet_package_pincount 'abcd 484'",
-                "api: chip.set('datasheet', 'package', 'abcd', 'pincount', '484')"],
-            schelp="""Total number package pins of the named package.""")
+            * (STEP) Standard for the Exchange of Product Data Format
+            * (STL) Stereolithography Format
+            * (WRL) Virtually Reality Modeling Language Format
 
-    scparam(cfg, ['datasheet', 'package', name, 'anchor'],
-            sctype='(float,float)',
-            defvalue=(0.0, 0.0),
-            unit='um',
-            shorthelp="Datasheeet: package anchor",
-            switch="-datasheet_package_anchor 'name <(float,float)>'",
+            """)
+
+    scparam(cfg, ['datasheet', 'package', partname, 'drawing'],
+            sctype='[file]',
+            shorthelp="Datasheet: package drawing",
+            switch="-datasheet_package_drawing 'partname <file>'",
             example=[
-                "cli: -datasheet_package_anchor 'i0 (3.0,3.0)'",
-                "api: chip.set('datasheet', 'package', 'i0', 'anchor', (3.0, 3.0))"],
-            schelp="""
-            Package anchor point with respect to the lower left corner of the package.
-            When placing a component on a substrate, the placement location specifies
-            the distance from the substrate origin to the anchor point of the placed
-            object.""")
+                "cli: -datasheet_package_drawing 'abcd p484.pdf'",
+                "api: chip.set('datasheet', 'package', 'abcd', 'drawing', 'p484.pdf')"],
+            schelp="""Mechanical drawing for documentation purposes.
+            Supported file formats include: PDF, DOC, SVG, and PNG.""")
 
-    # critical dimensions
+    # key package metrics
     metrics = {'length': ['length', (4000, 4000, 4000), 'um'],
                'width': ['width', (4000, 4000, 4000), 'um'],
                'thickness': ['thickness', (900, 1000, 1100), 'um'],
-               'pitch': ['pitch', (800, 850, 900), 'um']
+               'pinpitch': ['pin pitch', (800, 850, 900), 'um']
                }
 
     for i, v in metrics.items():
-        scparam(cfg, ['datasheet', 'package', name, i],
+        scparam(cfg, ['datasheet', 'package', partname, i],
                 unit=v[2],
                 sctype='(float,float,float)',
                 shorthelp=f"Datasheet: package {v[0]}",
-                switch=f"-datasheet_package_{i} 'name <(float,float,float)>'",
+                switch=f"-datasheet_package_{i} 'partname <(float,float,float)>'",
                 example=[
                     f"cli: -datasheet_package_{i} 'abcd {v[1]}'",
                     f"api: chip.set('datasheet', 'package', 'abcd', '{i}', {v[1]}"],
-                schelp=f"""Datasheet: package {v[0]}. Values are tuples of
+                schelp=f"""Package {v[0]}. Values are tuples of
                 (min, nominal, max).""")
 
-    # pinout diagram
-    pinnumber = 'default'
-    scparam(cfg, ['datasheet', 'package', name, 'pin', pinnumber, 'shape'],
-            sctype='enum',
-            enum=['circle', 'rectangle', 'square', 'octagon'],
-            shorthelp="Datasheet: package pin shape",
-            switch="-datasheet_package_pin_shape 'name pinnumber <str>'",
+    # pin
+    scparam(cfg, ['datasheet', 'package', partname, 'pincount'],
+            sctype='int',
+            shorthelp="Datasheet: package pin count",
+            switch="-datasheet_package_pincount 'partname <int>'",
             example=[
-                "cli: -datasheet_package_pin_shape 'abcd B1 circle'",
-                "api: chip.set('datasheet', 'package', 'abcd', 'pin', 'B1', 'shape', 'circle')"],
-            schelp="""Datasheet: package pin shape specified on a per package
-            and per pin number basis.""")
-
-    metrics = {'width': ['width', (200, 250, 300), 'um'],
-               'length': ['length', (200, 250, 300), 'um']
-               }
+                "cli: -datasheet_package_pincount 'abcd 484'",
+                "api: chip.set('datasheet', 'package', 'abcd', 'pincount', '484')"],
+            schelp="""Total number package pins.""")
 
-    for i, v in metrics.items():
-        scparam(cfg, ['datasheet', 'package', name, 'pin', pinnumber, i],
-                unit=v[2],
-                sctype='(float,float,float)',
-                shorthelp=f"Datasheet: package pin {v[0]}",
-                switch=f"-datasheet_package_pin_{i} 'name pinnumber <(float,float,float)>'",
-                example=[
-                    f"cli: -datasheet_package_pin_{i} 'abcd B1 {v[1]}'",
-                    f"api: chip.set('datasheet', 'package', 'abcd', 'pin', 'B1', '{i}', {v[1]}"],
-                schelp=f"""Datsheet: {v[0]} specified on a per package and per pin number
-                basis. Values are tuples of (min, nominal, max).""")
+    number = 'default'
+    scparam(cfg, ['datasheet', 'package', partname, 'pin', number, 'signal'],
+            sctype='str',
+            shorthelp="Datasheet: package pin signal map",
+            switch="-datasheet_package_pin_signal 'partname number <str>'",
+            example=[
+                "cli: -datasheet_package_pin_signal 'abcd B1 clk'",
+                "api: chip.set('datasheet', 'package', 'abcd', 'pin', 'B1', 'signal', 'clk')"],
+            schelp="""Mapping between the package physical pin name ("1", "2", "A1", "B3", ...)
+            and the corresponding device signal name ("VDD", "CLK", "NRST") found in the
+            :keypath:`datasheet,pin`.""")
 
-    scparam(cfg, ['datasheet', 'package', name, 'pin', pinnumber, 'loc'],
+    # anchor
+    scparam(cfg, ['datasheet', 'package', partname, 'anchor'],
             sctype='(float,float)',
+            defvalue=(0.0, 0.0),
             unit='um',
-            shorthelp="Datasheet: package pin location",
-            switch="-datasheet_package_pin_loc 'name pinnumber <(float,float)>'",
+            shorthelp="Datasheet: package anchor",
+            switch="-datasheet_package_anchor 'partname <(float,float)>'",
             example=[
-                "cli: -datasheet_package_pin_loc 'abcd B1 (500,500)'",
-                "api: chip.set('datasheet', 'package', 'abcd', 'pin', 'B1', 'loc', (500,500)"],
-            schelp="""Datsheet: Package pin location specified as an (x,y) tuple on a per
-            package and per pin number basis. Locations specify the center of the pin with
-            respect to the center of the package.""")
-
-    scparam(cfg, ['datasheet', 'package', name, 'pin', pinnumber, 'name'],
-            sctype='str',
-            shorthelp="Datasheet: package pin name",
-            switch="-datasheet_package_pin_name 'name pinnumber <str>'",
-            example=[
-                "cli: -datasheet_package_pin_name 'abcd B1 clk'",
-                "api: chip.set('datasheet', 'package', 'abcd', 'pin', 'B1', 'name', 'clk')"],
-            schelp="""Datsheet: Package pin name specified on a per package and per pin
-            number basis. The pin number is generally an integer starting at '1' in the case of
-            packages like qfn, qfp and an array index ('A1', 'A2') in the case of array packages
-            like bgas. The pin name refers to the logical function assigned to the physical
-            pin number (e.g clk, vss, in). Details regarding the logical pin is stored in
-            the :keypath:`datasheet,pin`.""")
+                "cli: -datasheet_package_anchor 'i0 (3.0, 3.0)'",
+                "api: chip.set('datasheet', 'package', 'i0', 'anchor', (3.0, 3.0))"],
+            schelp="""
+            Package anchor point with respect to the lower left corner of the package.
+            When placing a component on a substrate, the placement location specifies
+            the distance from the substrate origin to the anchor point of the placed
+            object.""")
 
     ######################
     # Pin Specifications
     ######################
 
     # Pin type
-    scparam(cfg, ['datasheet', 'pin', name, 'type', mode],
+    scparam(cfg, ['datasheet', 'pin', partname, 'type', mode],
             sctype='enum',
             enum=['digital', 'analog', 'clock', 'supply', 'ground'],
             shorthelp="Datasheet: pin type",
-            switch="-datasheet_pin_type 'name mode <str>'",
+            switch="-datasheet_pin_type 'partname mode <str>'",
             example=[
                 "cli: -datasheet_pin_type 'vdd global supply'",
                 "api: chip.set('datasheet', 'pin', 'vdd', 'type', 'global', 'supply')"],
             schelp="""Pin type specified on a per mode basis.""")
 
     # Pin direction
-    scparam(cfg, ['datasheet', 'pin', name, 'dir', mode],
+    scparam(cfg, ['datasheet', 'pin', partname, 'dir', mode],
             sctype='enum',
             enum=['input', 'output', 'inout'],
             shorthelp="Datasheet: pin direction",
-            switch="-datasheet_pin_dir 'name mode <str>'",
+            switch="-datasheet_pin_dir 'partname mode <str>'",
             example=[
                 "cli: -datasheet_pin_dir 'clk global input'",
                 "api: chip.set('datasheet', 'pin', 'clk', 'dir', 'global', 'input')"],
             schelp="""Pin direction specified on a per mode basis.""")
 
     # Pin complement (for differential pair)
-    scparam(cfg, ['datasheet', 'pin', name, 'complement', mode],
+    scparam(cfg, ['datasheet', 'pin', partname, 'complement', mode],
             sctype='str',
             shorthelp="Datasheet: pin complement",
-            switch="-datasheet_pin_complement 'name mode <str>'",
+            switch="-datasheet_pin_complement 'partname mode <str>'",
             example=[
                 "cli: -datasheet_pin_complement 'ina global inb'",
                 "api: chip.set('datasheet', 'pin', 'ina', 'complement', 'global', 'inb')"],
@@ -1418,31 +1390,31 @@ def schema_datasheet(cfg, name='default', mode='default'):
             signals.""")
 
     # Pin standard
-    scparam(cfg, ['datasheet', 'pin', name, 'standard', mode],
+    scparam(cfg, ['datasheet', 'pin', partname, 'standard', mode],
             sctype='[str]',
             shorthelp="Datasheet: pin standard",
-            switch="-datasheet_pin_standard 'name mode <str>'",
+            switch="-datasheet_pin_standard 'partname mode <str>'",
             example=[
                 "cli: -datasheet_pin_standard 'clk def LVCMOS'",
                 "api: chip.set('datasheet', 'pin', 'clk', 'standard', 'def', 'LVCMOS')"],
             schelp="""Pin electrical signaling standard (LVDS, LVCMOS, TTL, ...).""")
 
     # Pin interface map
-    scparam(cfg, ['datasheet', 'pin', name, 'interface', mode],
+    scparam(cfg, ['datasheet', 'pin', partname, 'interface', mode],
             sctype='[str]',
             shorthelp="Datasheet: pin interface map",
-            switch="-datasheet_pin_interface 'name mode <str>'",
+            switch="-datasheet_pin_interface 'partname mode <str>'",
             example=[
                 "cli: -datasheet_pin_interface 'clk0 ddr4 CLKN'",
                 "api: chip.set('datasheet', 'pin', 'clk0', 'interface', 'ddr4', 'CLKN')"],
             schelp="""Pin mapping to standardized interface names.""")
 
     # Pin reset value
-    scparam(cfg, ['datasheet', 'pin', name, 'resetvalue', mode],
+    scparam(cfg, ['datasheet', 'pin', partname, 'resetvalue', mode],
             sctype='enum',
             enum=['weak1', 'weak0', 'strong0', 'strong1', 'highz'],
             shorthelp="Datasheet: pin reset value",
-            switch="-datasheet_pin_resetvalue 'name mode <str>'",
+            switch="-datasheet_pin_resetvalue 'partname mode <str>'",
             example=[
                 "cli: -datasheet_pin_resetvalue 'clk global weak1'",
                 "api: chip.set('datasheet', 'pin', 'clk', 'resetvalue', 'global', 'weak1')"],
@@ -1493,7 +1465,7 @@ def schema_datasheet(cfg, name='default', mode='default'):
                }
 
     for item, val in metrics.items():
-        scparam(cfg, ['datasheet', 'pin', name, item, mode],
+        scparam(cfg, ['datasheet', 'pin', partname, item, mode],
                 unit=val[2],
                 sctype='(float,float,float)',
                 shorthelp=f"Datasheet: pin {val[0]}",
@@ -1516,7 +1488,7 @@ def schema_datasheet(cfg, name='default', mode='default'):
     relpin = 'default'
 
     for i, v in metrics.items():
-        scparam(cfg, ['datasheet', 'pin', name, i, mode, relpin],
+        scparam(cfg, ['datasheet', 'pin', partname, i, mode, relpin],
                 unit=v[2],
                 sctype='(float,float,float)',
                 shorthelp=f"Datasheet: pin {v[0]}",
@@ -1637,7 +1609,7 @@ def schema_tool(cfg, tool='default'):
 
     scparam(cfg, ['tool', tool, 'sbom', version],
             sctype='[file]',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Tool: software BOM",
             switch="-tool_sbom 'tool version <file>'",
             example=[
@@ -1652,7 +1624,7 @@ def schema_tool(cfg, tool='default'):
 
     scparam(cfg, ['tool', tool, 'path'],
             sctype='dir',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Tool: executable path",
             switch="-tool_path 'tool <dir>'",
             example=[
@@ -1689,7 +1661,7 @@ def schema_tool(cfg, tool='default'):
 
     scparam(cfg, ['tool', tool, 'version'],
             sctype='[str]',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Tool: version",
             switch="-tool_version 'tool <str>'",
             example=["cli: -tool_version 'openroad >=v2.0'",
@@ -1719,7 +1691,7 @@ def schema_tool(cfg, tool='default'):
     key = 'default'
     scparam(cfg, ['tool', tool, 'licenseserver', key],
             sctype='[str]',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Tool: license servers",
             switch="-tool_licenseserver 'name key <str>'",
             example=[
@@ -1742,7 +1714,7 @@ def schema_task(cfg, tool='default', task='default', step='default', index='defa
 
     scparam(cfg, ['tool', tool, 'task', task, 'warningoff'],
             sctype='[str]',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Task: warning filter",
             switch="-tool_task_warningoff 'tool task <str>'",
             example=[
@@ -1757,7 +1729,7 @@ def schema_task(cfg, tool='default', task='default', step='default', index='defa
 
     scparam(cfg, ['tool', tool, 'task', task, 'regex', suffix],
             sctype='[str]',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Task: regex filter",
             switch="-tool_task_regex 'tool task suffix <str>'",
             example=[
@@ -1793,7 +1765,7 @@ def schema_task(cfg, tool='default', task='default', step='default', index='defa
     # Configuration: cli-option, tcl var, env var, file
     scparam(cfg, ['tool', tool, 'task', task, 'option'],
             sctype='[str]',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Task: executable options",
             switch="-tool_task_option 'tool task <str>'",
             example=[
@@ -1807,7 +1779,7 @@ def schema_task(cfg, tool='default', task='default', step='default', index='defa
 
     scparam(cfg, ['tool', tool, 'task', task, 'var', key],
             sctype='[str]',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Task: script variables",
             switch="-tool_task_var 'tool task key <str>'",
             example=[
@@ -1820,7 +1792,7 @@ def schema_task(cfg, tool='default', task='default', step='default', index='defa
 
     scparam(cfg, ['tool', tool, 'task', task, 'env', key],
             sctype='str',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Task: environment variables",
             switch="-tool_task_env 'tool task env <str>'",
             example=[
@@ -1833,14 +1805,14 @@ def schema_task(cfg, tool='default', task='default', step='default', index='defa
 
     scparam(cfg, ['tool', tool, 'task', task, 'file', key],
             sctype='[file]',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             copy=True,
             shorthelp="Task: custom setup files",
             switch="-tool_task_file 'tool task key <file>'",
             example=[
                 "cli: -tool_task_file 'openroad floorplan macroplace macroplace.tcl'",
                 "api: chip.set('tool', 'openroad', 'task', 'floorplan', 'file', 'macroplace', "
-                    "'macroplace.tcl')"],
+                "'macroplace.tcl')"],
             schelp="""
             Paths to user supplied files mapped to keys. Keys and filetypes must
             match what's expected by the task/reference script consuming the
@@ -1849,14 +1821,14 @@ def schema_task(cfg, tool='default', task='default', step='default', index='defa
 
     scparam(cfg, ['tool', tool, 'task', task, 'dir', key],
             sctype='[dir]',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             copy=True,
             shorthelp="Task: custom setup directories",
             switch="-tool_task_dir 'tool task key <dir>'",
             example=[
                 "cli: -tool_task_dir 'verilator compile cincludes include'",
                 "api: chip.set('tool', 'verilator', 'task', 'compile', 'dir', 'cincludes', "
-                    "'include')"],
+                "'include')"],
             schelp="""
             Paths to user supplied directories mapped to keys. Keys must match
             what's expected by the task/reference script consuming the
@@ -1866,13 +1838,13 @@ def schema_task(cfg, tool='default', task='default', step='default', index='defa
     # Definitions of inputs, outputs, requirements
     scparam(cfg, ['tool', tool, 'task', task, 'input'],
             sctype='[file]',
-            pernode='required',
+            pernode=PerNode.REQUIRED,
             shorthelp="Task: input files",
             switch="-tool_task_input 'tool task <file>'",
             example=[
                 "cli: -tool_task_input 'openroad place place 0 oh_add.def'",
                 "api: chip.set('tool', 'openroad', 'task', 'place', 'input', 'oh_add.def', "
-                    "step='place', index='0')"],
+                "step='place', index='0')"],
             schelp="""
             List of data files to be copied from previous flowgraph steps 'output'
             directory. The list of steps to copy files from is defined by the
@@ -1882,13 +1854,13 @@ def schema_task(cfg, tool='default', task='default', step='default', index='defa
 
     scparam(cfg, ['tool', tool, 'task', task, 'output'],
             sctype='[file]',
-            pernode='required',
+            pernode=PerNode.REQUIRED,
             shorthelp="Task: output files",
             switch="-tool_task_output 'tool task <file>'",
             example=[
                 "cli: -tool_task_output 'openroad place place 0 oh_add.def'",
                 "api: chip.set('tool', 'openroad', 'task', 'place', 'output', 'oh_add.def', "
-                    "step='place', index='0')"],
+                "step='place', index='0')"],
             schelp="""
             List of data files written to the 'output' directory of the
             tool/task/step/index used in the keypath. All files must be available
@@ -1899,8 +1871,8 @@ def schema_task(cfg, tool='default', task='default', step='default', index='defa
             sctype='enum',
             enum=dest_enum,
             defvalue='log',
-            scope='job',
-            pernode='optional',
+            scope=Scope.JOB,
+            pernode=PerNode.OPTIONAL,
             shorthelp="Task: destination for stdout",
             switch="-tool_task_stdout_destination 'tool task <str>'",
             example=["cli: -tool_task_stdout_destination 'ghdl import log'",
@@ -1917,8 +1889,8 @@ def schema_task(cfg, tool='default', task='default', step='default', index='defa
     scparam(cfg, ['tool', tool, 'task', task, 'stdout', 'suffix'],
             sctype='str',
             defvalue='log',
-            scope='job',
-            pernode='optional',
+            scope=Scope.JOB,
+            pernode=PerNode.OPTIONAL,
             shorthelp="Task: file suffix for redirected stdout",
             switch="-tool_task_stdout_suffix 'tool task <str>'",
             example=["cli: -tool_task_stdout_suffix 'ghdl import log'",
@@ -1930,8 +1902,8 @@ def schema_task(cfg, tool='default', task='default', step='default', index='defa
             sctype='enum',
             enum=dest_enum,
             defvalue='log',
-            scope='job',
-            pernode='optional',
+            scope=Scope.JOB,
+            pernode=PerNode.OPTIONAL,
             shorthelp="Task: destination for stderr",
             switch="-tool_task_stderr_destination 'tool task <str>'",
             example=["cli: -tool_task_stderr_destination 'ghdl import log'",
@@ -1948,8 +1920,8 @@ def schema_task(cfg, tool='default', task='default', step='default', index='defa
     scparam(cfg, ['tool', tool, 'task', task, 'stderr', 'suffix'],
             sctype='str',
             defvalue='log',
-            scope='job',
-            pernode='optional',
+            scope=Scope.JOB,
+            pernode=PerNode.OPTIONAL,
             shorthelp="Task: file suffix for redirected stderr",
             switch="-tool_task_stderr_suffix 'tool task <str>'",
             example=["cli: -tool_task_stderr_suffix 'ghdl import log'",
@@ -1959,7 +1931,7 @@ def schema_task(cfg, tool='default', task='default', step='default', index='defa
 
     scparam(cfg, ['tool', tool, 'task', task, 'require'],
             sctype='[str]',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Task: parameter requirements",
             switch="-tool_task_require 'tool task <str>'",
             example=[
@@ -1973,20 +1945,20 @@ def schema_task(cfg, tool='default', task='default', step='default', index='defa
     metric = 'default'
     scparam(cfg, ['tool', tool, 'task', task, 'report', metric],
             sctype='[file]',
-            pernode='required',
+            pernode=PerNode.REQUIRED,
             shorthelp="Task: metric report files",
             switch="-tool_task_report 'tool task metric <file>'",
             example=[
                 "cli: -tool_task_report 'openroad place holdtns place 0 place.log'",
                 "api: chip.set('tool', 'openroad', 'task', 'place', 'report', 'holdtns', "
-                    "'place.log', step='place', index='0')"],
+                "'place.log', step='place', index='0')"],
             schelp="""
             List of report files associated with a specific 'metric'. The file path
             specified is relative to the run directory of the current task.""")
 
     scparam(cfg, ['tool', tool, 'task', task, 'refdir'],
             sctype='[dir]',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Task: script directory",
             switch="-tool_task_refdir 'tool task <dir>'",
             example=[
@@ -1998,7 +1970,7 @@ def schema_task(cfg, tool='default', task='default', step='default', index='defa
 
     scparam(cfg, ['tool', tool, 'task', task, 'script'],
             sctype='[file]',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Task: entry script",
             switch="-tool_task_script 'tool task <file>'",
             example=[
@@ -2010,7 +1982,7 @@ def schema_task(cfg, tool='default', task='default', step='default', index='defa
 
     scparam(cfg, ['tool', tool, 'task', task, 'prescript'],
             sctype='[file]',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             copy=True,
             shorthelp="Task: pre-step script",
             switch="-tool_task_prescript 'tool task <file>'",
@@ -2026,7 +1998,7 @@ def schema_task(cfg, tool='default', task='default', step='default', index='defa
 
     scparam(cfg, ['tool', tool, 'task', task, 'postscript'],
             sctype='[file]',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             copy=True,
             shorthelp="Task: post-step script",
             switch="-tool_task_postscript 'tool task <file>'",
@@ -2042,7 +2014,7 @@ def schema_task(cfg, tool='default', task='default', step='default', index='defa
 
     scparam(cfg, ['tool', tool, 'task', task, 'threads'],
             sctype='int',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Task: thread parallelism",
             switch="-tool_task_threads 'tool task <int>'",
             example=["cli: -tool_task_threads 'magic drc 64'",
@@ -2063,7 +2035,7 @@ def schema_arg(cfg):
 
     scparam(cfg, ['arg', 'step'],
             sctype='str',
-            scope='scratch',
+            scope=Scope.SCRATCH,
             shorthelp="ARG: step argument",
             switch="-arg_step <str>",
             example=["cli: -arg_step 'route'",
@@ -2077,7 +2049,7 @@ def schema_arg(cfg):
 
     scparam(cfg, ['arg', 'index'],
             sctype='str',
-            scope='scratch',
+            scope=Scope.SCRATCH,
             shorthelp="ARG: index argument",
             switch="-arg_index <str>",
             example=["cli: -arg_index 0",
@@ -2111,7 +2083,7 @@ def schema_metric(cfg, step='default', index='default'):
                 example=[
                     f"cli: -metric_{item} 'dfm 0 0'",
                     f"api: chip.set('metric', '{item}', 0, step='dfm', index=0)"],
-                pernode='required',
+                pernode=PerNode.REQUIRED,
                 schelp=f"""Metric tracking the total number of {val} on a
                 per step and index basis.""")
 
@@ -2123,7 +2095,7 @@ def schema_metric(cfg, step='default', index='default'):
             example=[
                 "cli: -metric_coverage 'place 0 99.9'",
                 "api: chip.set('metric', 'coverage', 99.9, step='place', index=0)"],
-            pernode='required',
+            pernode=PerNode.REQUIRED,
             schelp="""
             Metric tracking the test coverage in the design expressed as a percentage
             with 100 meaning full coverage. The meaning of the metric depends on the
@@ -2138,7 +2110,7 @@ def schema_metric(cfg, step='default', index='default'):
             example=[
                 "cli: -metric_security 'place 0 100'",
                 "api: chip.set('metric', 'security', 100, step='place', index=0)"],
-            pernode='required',
+            pernode=PerNode.REQUIRED,
             schelp="""
             Metric tracking the level of security (1/vulnerability) of the design.
             A completely secure design would have a score of 100. There is no
@@ -2158,7 +2130,7 @@ def schema_metric(cfg, step='default', index='default'):
                 example=[
                     f"cli: -metric_{item} 'place 0 100'",
                     f"api: chip.set('metric', '{item}', 100, step='place', index=0)"],
-                pernode='required',
+                pernode=PerNode.REQUIRED,
                 schelp=f"""
                 Metric tracking the total {val} used by the design as reported
                 by the implementation tool. There is no standardized definition
@@ -2181,7 +2153,7 @@ def schema_metric(cfg, step='default', index='default'):
                 example=[
                     f"cli: -metric_{item} 'place 0 100.00'",
                     f"api: chip.set('metric', '{item}', 100.00, step='place', index=0)"],
-                pernode='required',
+                pernode=PerNode.REQUIRED,
                 schelp=f"""
                 Metric tracking the total {val} occupied by the design.""")
 
@@ -2193,7 +2165,7 @@ def schema_metric(cfg, step='default', index='default'):
             example=[
                 "cli: -metric_utilization 'place 0 50.00'",
                 "api: chip.set('metric', 'utilization', 50.00, step='place', index=0)"],
-            pernode='required',
+            pernode=PerNode.REQUIRED,
             schelp="""
             Metric tracking the area utilization of the design calculated as
             100 * (cellarea/totalarea).""")
@@ -2205,7 +2177,7 @@ def schema_metric(cfg, step='default', index='default'):
             example=[
                 "cli: -metric_logicdepth 'place 0 8'",
                 "api: chip.set('metric', 'logicdepth', 8, step='place', index=0)"],
-            pernode='required',
+            pernode=PerNode.REQUIRED,
             schelp="""
             Metric tracking the logic depth of the design. This is determined
             by the number of logic gates between the start of the critital timing
@@ -2225,7 +2197,7 @@ def schema_metric(cfg, step='default', index='default'):
                 example=[
                     f"cli: -metric_{item} 'place 0 0.01'",
                     f"api: chip.set('metric', '{item}', 0.01, step='place', index=0)"],
-                pernode='required',
+                pernode=PerNode.REQUIRED,
                 schelp=f"""
                 Metric tracking the {val} of the design specified on a per step
                 and index basis. Power metric depend heavily on the method
@@ -2243,7 +2215,7 @@ def schema_metric(cfg, step='default', index='default'):
             example=[
                 "cli: -metric_irdrop 'place 0 0.05'",
                 "api: chip.set('metric', 'irdrop', 0.05, step='place', index=0)"],
-            pernode='required',
+            pernode=PerNode.REQUIRED,
             schelp="""
             Metric tracking the peak IR drop in the design based on extracted
             power and ground rail parasitics, library power models, and
@@ -2262,7 +2234,7 @@ def schema_metric(cfg, step='default', index='default'):
                 example=[
                     f"cli: -metric_{item} 'place 0 10'",
                     f"api: chip.set('metric', '{item}', 10, step='place', index=0)"],
-                pernode='required',
+                pernode=PerNode.REQUIRED,
                 schelp=f"""
                 Metric tracking the total number of timing paths violating {val}
                 constraints.""")
@@ -2285,7 +2257,7 @@ def schema_metric(cfg, step='default', index='default'):
                 example=[
                     f"cli: -metric_{item} 'place 0 0.01'",
                     f"api: chip.set('metric', '{item}', 0.01, step='place', index=0)"],
-                pernode='required',
+                pernode=PerNode.REQUIRED,
                 schelp=f"""
                 Metric tracking the {val} on a per step and index basis.""")
 
@@ -2300,7 +2272,7 @@ def schema_metric(cfg, step='default', index='default'):
                 example=[
                     f"cli: -metric_{item} 'place 0 100e6'",
                     f"api: chip.set('metric', '{item}', 100e6, step='place', index=0)"],
-                pernode='required',
+                pernode=PerNode.REQUIRED,
                 schelp=f"""
                 Metric tracking the {val} on a per step and index basis.""")
 
@@ -2322,7 +2294,7 @@ def schema_metric(cfg, step='default', index='default'):
                 example=[
                     f"cli: -metric_{item} 'place 0 100'",
                     f"api: chip.set('metric', '{item}', 50, step='place', index=0)"],
-                pernode='required',
+                pernode=PerNode.REQUIRED,
                 schelp=f"""
                 Metric tracking the total number of {val} in the design
                 on a per step and index basis.""")
@@ -2336,7 +2308,7 @@ def schema_metric(cfg, step='default', index='default'):
             example=[
                 f"cli: -metric_{item} 'place 0 100.0'",
                 f"api: chip.set('metric', '{item}', 50.0, step='place', index=0)"],
-            pernode='required',
+            pernode=PerNode.REQUIRED,
             schelp=f"""
             Metric tracking the total {item} of the design on a per step
             and index basis.""")
@@ -2349,7 +2321,7 @@ def schema_metric(cfg, step='default', index='default'):
             example=[
                 f"cli: -metric_{item} 'place 0 0'",
                 f"api: chip.set('metric', '{item}', 50, step='place', index=0)"],
-            pernode='required',
+            pernode=PerNode.REQUIRED,
             schelp="""
             Metric tracking the total number of overflow tracks for the routing
             on per step and index basis. Any non-zero number suggests an over
@@ -2361,13 +2333,13 @@ def schema_metric(cfg, step='default', index='default'):
     scparam(cfg, ['metric', item],
             sctype='float',
             unit='B',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp=f"Metric: {item}",
             switch=f"-metric_{item} 'step index <float>'",
             example=[
                 f"cli: -metric_{item} 'dfm 0 10e9'",
                 f"api: chip.set('metric', '{item}', 10e9, step='dfm', index=0)"],
-            pernode='required',
+            pernode=PerNode.REQUIRED,
             schelp="""
             Metric tracking total peak program memory footprint on a per
             step and index basis.""")
@@ -2381,7 +2353,7 @@ def schema_metric(cfg, step='default', index='default'):
             example=[
                 f"cli: -metric_{item} 'dfm 0 10.0'",
                 f"api: chip.set('metric', '{item}', 10.0, step='dfm', index=0)"],
-            pernode='required',
+            pernode=PerNode.REQUIRED,
             schelp="""
             Metric tracking time spent by the EDA executable :keypath:`tool,<tool>,exe` on a
             per step and index basis. It does not include the SiliconCompiler
@@ -2397,7 +2369,7 @@ def schema_metric(cfg, step='default', index='default'):
             example=[
                 f"cli: -metric_{item} 'dfm 0 10.0'",
                 f"api: chip.set('metric', '{item}', 10.0, step='dfm', index=0)"],
-            pernode='required',
+            pernode=PerNode.REQUIRED,
             schelp="""
             Metric tracking the total amount of time spent on a task from
             beginning to end, including data transfers and pre/post
@@ -2412,7 +2384,7 @@ def schema_metric(cfg, step='default', index='default'):
             example=[
                 f"cli: -metric_{item} 'dfm 0 10.0'",
                 f"api: chip.set('metric', '{item}', 10.0, step='dfm', index=0)"],
-            pernode='required',
+            pernode=PerNode.REQUIRED,
             schelp="""
             Metric tracking the total amount of time spent from the beginning
             of the run up to and including the current step and index.""")
@@ -2505,7 +2477,7 @@ def schema_record(cfg, step='default', index='default'):
                 example=[
                     f"cli: -record_{item} 'dfm 0 {val[1]}'",
                     f"api: chip.set('record', '{item}', '{val[1]}', step='dfm', index=0)"],
-                pernode='required',
+                pernode=PerNode.REQUIRED,
                 schelp=f'Record tracking the {val[0]} per step and index basis. {helpext}')
 
     scparam(cfg, ['record', 'toolexitcode'],
@@ -2515,7 +2487,7 @@ def schema_record(cfg, step='default', index='default'):
             example=[
                 "cli: -record_toolexitcode 'dfm 0 0'",
                 "api: chip.set('record', 'toolexitcode', 0, step='dfm', index=0)"],
-            pernode='required',
+            pernode=PerNode.REQUIRED,
             schelp='Record tracking the tool exit code per step and index basis.')
 
     # Non-per-node records.
@@ -2540,7 +2512,7 @@ def schema_record(cfg, step='default', index='default'):
     # flowgraph status
     scparam(cfg, ['record', 'status'],
             sctype='enum',
-            pernode='required',
+            pernode=PerNode.REQUIRED,
             enum=[  # keep in sync with NodeStatus
                 "pending",
                 "queued",
@@ -2559,7 +2531,7 @@ def schema_record(cfg, step='default', index='default'):
     # flowgraph select
     scparam(cfg, ['record', 'inputnode'],
             sctype='[(str,str)]',
-            pernode='required',
+            pernode=PerNode.REQUIRED,
             shorthelp="Record: node inputs",
             switch="-record_inputnode 'step index <(str,str)>'",
             example=[
@@ -2581,7 +2553,7 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'remote'],
             sctype='bool',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Option: enable remote processing",
             switch="-remote <bool>",
             example=[
@@ -2595,7 +2567,7 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'credentials'],
             sctype='file',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Option: user credentials file",
             switch="-credentials <file>",
             example=[
@@ -2617,7 +2589,7 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'cachedir'],
             sctype='file',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Option: user cache directory",
             switch="-cachedir <file>",
             example=[
@@ -2630,8 +2602,8 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'nice'],
             sctype='int',
-            scope='job',
-            pernode='optional',
+            scope=Scope.JOB,
+            pernode=PerNode.OPTIONAL,
             shorthelp="Option: tool scheduling priority",
             switch="-nice <int>",
             example=[
@@ -2645,7 +2617,7 @@ def schema_option(cfg):
     # Compilation
     scparam(cfg, ['option', 'pdk'],
             sctype='str',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Option: PDK target",
             switch="-pdk <str>",
             example=["cli: -pdk freepdk45",
@@ -2655,7 +2627,7 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'stackup'],
             sctype='str',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Option: stackup target",
             switch="-stackup <str>",
             example=["cli: -stackup 2MA4MB2MC",
@@ -2666,7 +2638,7 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'flow'],
             sctype='str',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Option: flow target",
             switch="-flow <str>",
             example=["cli: -flow asicflow",
@@ -2677,8 +2649,8 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'optmode'],
             sctype='str',
-            pernode='optional',
-            scope='job',
+            pernode=PerNode.OPTIONAL,
+            scope=Scope.JOB,
             defvalue='O0',
             shorthelp="Option: optimization mode",
             switch=["-O<str>",
@@ -2700,7 +2672,7 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'cfg'],
             sctype='[file]',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Option: configuration manifest",
             switch="-cfg <file>",
             example=["cli: -cfg mypdk.json",
@@ -2715,7 +2687,7 @@ def schema_option(cfg):
     key = 'default'
     scparam(cfg, ['option', 'env', key],
             sctype='str',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Option: environment variables",
             switch="-env 'key <str>'",
             example=[
@@ -2728,7 +2700,7 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'var', key],
             sctype='[str]',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Option: custom variables",
             switch="-var 'key <str>'",
             example=[
@@ -2742,7 +2714,7 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'file', key],
             sctype='[file]',
-            scope='job',
+            scope=Scope.JOB,
             copy=True,
             shorthelp="Option: custom files",
             switch="-file 'key <file>'",
@@ -2757,7 +2729,7 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'dir', key],
             sctype='[dir]',
-            scope='job',
+            scope=Scope.JOB,
             copy=True,
             shorthelp="Option: custom directories",
             switch="-dir 'key <dir>'",
@@ -2773,8 +2745,8 @@ def schema_option(cfg):
     scparam(cfg, ['option', 'loglevel'],
             sctype='enum',
             enum=["info", "warning", "error", "critical", "debug", "quiet"],
-            pernode='optional',
-            scope='job',
+            pernode=PerNode.OPTIONAL,
+            scope=Scope.JOB,
             defvalue='info',
             shorthelp="Option: logging level",
             switch="-loglevel <str>",
@@ -2786,7 +2758,7 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'builddir'],
             sctype='dir',
-            scope='job',
+            scope=Scope.JOB,
             defvalue='build',
             shorthelp="Option: build directory",
             switch="-builddir <dir>",
@@ -2800,7 +2772,7 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'jobname'],
             sctype='str',
-            scope='job',
+            scope=Scope.JOB,
             defvalue='job0',
             shorthelp="Option: job name",
             switch="-jobname <str>",
@@ -2815,7 +2787,7 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'from'],
             sctype='[str]',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Option: starting step",
             switch="-from <str>",
             example=[
@@ -2827,7 +2799,7 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'to'],
             sctype='[str]',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Option: ending step",
             switch="-to <str>",
             example=[
@@ -2839,7 +2811,7 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'prune'],
             sctype='[(str,str)]',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Option: flowgraph pruning",
             switch="-prune 'node <(str,str)>'",
             example=[
@@ -2851,8 +2823,8 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'breakpoint'],
             sctype='bool',
-            scope='job',
-            pernode='optional',
+            scope=Scope.JOB,
+            pernode=PerNode.OPTIONAL,
             shorthelp="Option: breakpoint list",
             switch="-breakpoint <bool>",
             example=[
@@ -2866,8 +2838,8 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'library'],
             sctype='[str]',
-            scope='job',
-            pernode='optional',
+            scope=Scope.JOB,
+            pernode=PerNode.OPTIONAL,
             shorthelp="Option: library list",
             switch="-library <str>",
             example=["cli: -library lambdalib_asap7",
@@ -2878,7 +2850,7 @@ def schema_option(cfg):
     # Booleans
     scparam(cfg, ['option', 'clean'],
             sctype='bool',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Option: cleanup previous job",
             switch="-clean <bool>",
             example=["cli: -clean",
@@ -2891,7 +2863,7 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'hash'],
             sctype='bool',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Option: file hashing",
             switch="-hash <bool>",
             example=["cli: -hash",
@@ -2903,7 +2875,7 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'nodisplay'],
             sctype='bool',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Option: headless execution",
             switch="-nodisplay <bool>",
             example=["cli: -nodisplay",
@@ -2914,8 +2886,8 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'quiet'],
             sctype='bool',
-            pernode='optional',
-            scope='job',
+            pernode=PerNode.OPTIONAL,
+            scope=Scope.JOB,
             shorthelp="Option: quiet execution",
             switch="-quiet <bool>",
             example=["cli: -quiet",
@@ -2927,7 +2899,7 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'jobincr'],
             sctype='bool',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Option: autoincrement jobname",
             switch="-jobincr <bool>",
             example=["cli: -jobincr",
@@ -2941,9 +2913,9 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'novercheck'],
             sctype='bool',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             defvalue=False,
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Option: disable version checking",
             switch="-novercheck <bool>",
             example=["cli: -novercheck",
@@ -2955,8 +2927,8 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'track'],
             sctype='bool',
-            pernode='optional',
-            scope='job',
+            pernode=PerNode.OPTIONAL,
+            scope=Scope.JOB,
             shorthelp="Option: enable provenance tracking",
             switch="-track <bool>",
             example=["cli: -track",
@@ -2970,7 +2942,7 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'entrypoint'],
             sctype='str',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Option: program entry point",
             switch="-entrypoint <str>",
             example=["cli: -entrypoint top",
@@ -3064,7 +3036,7 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'continue'],
             sctype='bool',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp='Option: continue-on-error',
             switch='-continue <bool>',
             example=["cli: -continue",
@@ -3079,8 +3051,8 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'timeout'],
             sctype='float',
-            pernode='optional',
-            scope='job',
+            pernode=PerNode.OPTIONAL,
+            scope=Scope.JOB,
             unit='s',
             shorthelp="Option: timeout value",
             switch="-timeout <float>",
@@ -3107,8 +3079,8 @@ def schema_option(cfg):
     scparam(cfg, ['option', 'scheduler', 'name'],
             sctype='enum',
             enum=["slurm", "lsf", "sge", "docker"],
-            scope='job',
-            pernode='optional',
+            scope=Scope.JOB,
+            pernode=PerNode.OPTIONAL,
             shorthelp="Option: scheduler platform",
             switch="-scheduler <str>",
             example=[
@@ -3119,14 +3091,14 @@ def schema_option(cfg):
             flowgraph steps. If the parameter is undefined, the steps are executed
             on the same machine that the SC was launched on. If 'slurm' is used,
             the host running the 'sc' command must be running a 'slurmctld' daemon
-            managing a Slurm cluster. Additionally, the build directory ('-dir')
-            must be located in shared storage which can be accessed by all hosts
-            in the cluster.""")
+            managing a Slurm cluster. Additionally, the build directory
+            (:keypath:`option,builddir`) must be located in shared storage which
+            can be accessed by all hosts in the cluster.""")
 
     scparam(cfg, ['option', 'scheduler', 'cores'],
             sctype='int',
-            scope='job',
-            pernode='optional',
+            scope=Scope.JOB,
+            pernode=PerNode.OPTIONAL,
             shorthelp="Option: Scheduler core constraint",
             switch="-cores <int>",
             example=["cli: -cores 48",
@@ -3140,8 +3112,8 @@ def schema_option(cfg):
     scparam(cfg, ['option', 'scheduler', 'memory'],
             sctype='int',
             unit='MB',
-            scope='job',
-            pernode='optional',
+            scope=Scope.JOB,
+            pernode=PerNode.OPTIONAL,
             shorthelp="Option: scheduler memory constraint",
             switch="-memory <int>",
             example=["cli: -memory 8000",
@@ -3154,8 +3126,8 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'scheduler', 'queue'],
             sctype='str',
-            scope='job',
-            pernode='optional',
+            scope=Scope.JOB,
+            pernode=PerNode.OPTIONAL,
             shorthelp="Option: scheduler queue",
             switch="-queue <str>",
             example=["cli: -queue nightrun",
@@ -3168,8 +3140,8 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'scheduler', 'defer'],
             sctype='str',
-            scope='job',
-            pernode='optional',
+            scope=Scope.JOB,
+            pernode=PerNode.OPTIONAL,
             shorthelp="Option: scheduler start time",
             switch="-defer <str>",
             example=["cli: -defer 16:00",
@@ -3184,7 +3156,7 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'scheduler', 'options'],
             sctype='[str]',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Option: scheduler arguments",
             switch="-scheduler_options <str>",
             example=[
@@ -3199,8 +3171,8 @@ def schema_option(cfg):
     scparam(cfg, ['option', 'scheduler', 'msgevent'],
             sctype='[enum]',
             enum=['all', 'summary', 'begin', 'end', 'timeout', 'fail'],
-            scope='job',
-            pernode='optional',
+            scope=Scope.JOB,
+            pernode=PerNode.OPTIONAL,
             shorthelp="Option: message event trigger",
             switch="-msgevent <str>",
             example=[
@@ -3221,8 +3193,8 @@ def schema_option(cfg):
 
     scparam(cfg, ['option', 'scheduler', 'msgcontact'],
             sctype='[str]',
-            scope='job',
-            pernode='optional',
+            scope=Scope.JOB,
+            pernode=PerNode.OPTIONAL,
             shorthelp="Option: message contact",
             switch="-msgcontact <str>",
             example=[
@@ -3255,7 +3227,7 @@ def schema_package(cfg):
 
     scparam(cfg, ['package', 'version'],
             sctype='str',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="Package: version",
             switch="-package_version <str>",
             example=[
@@ -3266,7 +3238,7 @@ def schema_package(cfg):
 
     scparam(cfg, ['package', 'description'],
             sctype='str',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="Package: description",
             switch="-package_description <str>",
             example=[
@@ -3277,7 +3249,7 @@ def schema_package(cfg):
 
     scparam(cfg, ['package', 'keyword'],
             sctype='str',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="Package: keyword",
             switch="-package_keyword <str>",
             example=[
@@ -3286,7 +3258,7 @@ def schema_package(cfg):
             schelp="""Package keyword(s) used to characterize package.""")
     scparam(cfg, ['package', 'doc', 'homepage'],
             sctype='str',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="Package: documentation homepage",
             switch="-package_doc_homepage <str>",
             example=[
@@ -3310,7 +3282,7 @@ def schema_package(cfg):
     for item in doctypes:
         scparam(cfg, ['package', 'doc', item],
                 sctype='[file]',
-                scope='global',
+                scope=Scope.GLOBAL,
                 shorthelp=f"Package: {item} document",
                 switch=f"-package_doc_{item} <file>",
                 example=[
@@ -3320,7 +3292,7 @@ def schema_package(cfg):
 
     scparam(cfg, ['package', 'license'],
             sctype='[str]',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="Package: license identifiers",
             switch="-package_license <str>",
             example=[
@@ -3330,7 +3302,7 @@ def schema_package(cfg):
 
     scparam(cfg, ['package', 'licensefile'],
             sctype='[file]',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="Package: license files",
             switch="-package_licensefile <file>",
             example=[
@@ -3342,7 +3314,7 @@ def schema_package(cfg):
 
     scparam(cfg, ['package', 'organization'],
             sctype='[str]',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="Package: sponsoring organization",
             switch="-package_organization <str>",
             example=[
@@ -3361,7 +3333,7 @@ def schema_package(cfg):
     for item in record:
         scparam(cfg, ['package', 'author', userid, item],
                 sctype='str',
-                scope='global',
+                scope=Scope.GLOBAL,
                 shorthelp=f"Package: author {item}",
                 switch=f"-package_author_{item} 'userid <str>'",
                 example=[
@@ -3374,7 +3346,7 @@ def schema_package(cfg):
 
     scparam(cfg, ['package', 'source', source, 'path'],
             sctype='str',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="Package: data source path",
             switch="-package_source_path 'source <str>'",
             example=[
@@ -3398,7 +3370,7 @@ def schema_package(cfg):
 
     scparam(cfg, ['package', 'source', source, 'ref'],
             sctype='str',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="Package: data source reference",
             switch="-package_source_ref 'source <str>'",
             example=[
@@ -3420,7 +3392,7 @@ def schema_checklist(cfg):
 
     scparam(cfg, ['checklist', standard, item, 'description'],
             sctype='str',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="Checklist: item description",
             switch="-checklist_description 'standard item <str>'",
             example=[
@@ -3431,7 +3403,7 @@ def schema_checklist(cfg):
 
     scparam(cfg, ['checklist', standard, item, 'requirement'],
             sctype='str',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="Checklist: item requirement",
             switch="-checklist_requirement 'standard item <str>'",
             example=[
@@ -3443,7 +3415,7 @@ def schema_checklist(cfg):
 
     scparam(cfg, ['checklist', standard, item, 'dataformat'],
             sctype='str',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="Checklist: item data format",
             switch="-checklist_dataformat 'standard item <str>'",
             example=[
@@ -3455,7 +3427,7 @@ def schema_checklist(cfg):
 
     scparam(cfg, ['checklist', standard, item, 'rationale'],
             sctype='[str]',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="Checklist: item rational",
             switch="-checklist_rationale 'standard item <str>'",
             example=[
@@ -3468,7 +3440,7 @@ def schema_checklist(cfg):
 
     scparam(cfg, ['checklist', standard, item, 'criteria'],
             sctype='[str]',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="Checklist: item criteria",
             switch="-checklist_criteria 'standard item <str>'",
             example=[
@@ -3482,7 +3454,7 @@ def schema_checklist(cfg):
 
     scparam(cfg, ['checklist', standard, item, 'task'],
             sctype='[(str,str,str)]',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="Checklist: item task",
             switch="-checklist_task 'standard item <(str,str,str)>'",
             example=[
@@ -3495,7 +3467,7 @@ def schema_checklist(cfg):
 
     scparam(cfg, ['checklist', standard, item, 'report'],
             sctype='[file]',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="Checklist: item report",
             switch="-checklist_report 'standard item <file>'",
             example=[
@@ -3507,7 +3479,7 @@ def schema_checklist(cfg):
 
     scparam(cfg, ['checklist', standard, item, 'waiver', metric],
             sctype='[file]',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="Checklist: item metric waivers",
             switch="-checklist_waiver 'standard item metric <file>'",
             example=[
@@ -3519,7 +3491,7 @@ def schema_checklist(cfg):
 
     scparam(cfg, ['checklist', standard, item, 'ok'],
             sctype='bool',
-            scope='global',
+            scope=Scope.GLOBAL,
             shorthelp="Checklist: item ok",
             switch="-checklist_ok 'standard item <bool>'",
             example=[
@@ -3541,8 +3513,8 @@ def schema_asic(cfg):
 
     scparam(cfg, ['asic', 'logiclib'],
             sctype='[str]',
-            scope='job',
-            pernode='optional',
+            scope=Scope.JOB,
+            pernode=PerNode.OPTIONAL,
             shorthelp="ASIC: logic libraries",
             switch="-asic_logiclib <str>",
             example=["cli: -asic_logiclib nangate45",
@@ -3553,8 +3525,8 @@ def schema_asic(cfg):
 
     scparam(cfg, ['asic', 'macrolib'],
             sctype='[str]',
-            scope='job',
-            pernode='optional',
+            scope=Scope.JOB,
+            pernode=PerNode.OPTIONAL,
             shorthelp="ASIC: macro libraries",
             switch="-asic_macrolib <str>",
             example=["cli: -asic_macrolib sram64x1024",
@@ -3566,8 +3538,8 @@ def schema_asic(cfg):
 
     scparam(cfg, ['asic', 'delaymodel'],
             sctype='str',
-            scope='job',
-            pernode='optional',
+            scope=Scope.JOB,
+            pernode=PerNode.OPTIONAL,
             shorthelp="ASIC: delay model",
             switch="-asic_delaymodel <str>",
             example=["cli: -asic_delaymodel ccs",
@@ -3593,7 +3565,7 @@ def schema_asic(cfg):
     for item in names:
         scparam(cfg, ['asic', 'cells', item],
                 sctype='[str]',
-                pernode='optional',
+                pernode=PerNode.OPTIONAL,
                 shorthelp=f"ASIC: {item} cell list",
                 switch=f"-asic_cells_{item} '<str>'",
                 example=[
@@ -3607,7 +3579,7 @@ def schema_asic(cfg):
 
     scparam(cfg, ['asic', 'libarch'],
             sctype='str',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="ASIC: library architecture",
             switch="-asic_libarch '<str>'",
             example=[
@@ -3621,7 +3593,7 @@ def schema_asic(cfg):
     libarch = 'default'
     scparam(cfg, ['asic', 'site', libarch],
             sctype='[str]',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="ASIC: library sites",
             switch="-asic_site 'libarch <str>'",
             example=[
@@ -3645,9 +3617,9 @@ def schema_constraint(cfg):
     pin = 'default'
     scparam(cfg, ['constraint', 'timing', scenario, 'voltage', pin],
             sctype='float',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             unit='V',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Constraint: pin voltage level",
             switch="-constraint_timing_voltage 'scenario pin <float>'",
             example=["cli: -constraint_timing_voltage 'worst VDD 0.9'",
@@ -3656,9 +3628,9 @@ def schema_constraint(cfg):
 
     scparam(cfg, ['constraint', 'timing', scenario, 'temperature'],
             sctype='float',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             unit='C',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Constraint: temperature",
             switch="-constraint_timing_temperature 'scenario <float>'",
             example=["cli: -constraint_timing_temperature 'worst 125'",
@@ -3667,8 +3639,8 @@ def schema_constraint(cfg):
 
     scparam(cfg, ['constraint', 'timing', scenario, 'libcorner'],
             sctype='[str]',
-            pernode='optional',
-            scope='job',
+            pernode=PerNode.OPTIONAL,
+            scope=Scope.JOB,
             shorthelp="Constraint: library corner",
             switch="-constraint_timing_libcorner 'scenario <str>'",
             example=["cli: -constraint_timing_libcorner 'worst ttt'",
@@ -3678,8 +3650,8 @@ def schema_constraint(cfg):
 
     scparam(cfg, ['constraint', 'timing', scenario, 'pexcorner'],
             sctype='str',
-            pernode='optional',
-            scope='job',
+            pernode=PerNode.OPTIONAL,
+            scope=Scope.JOB,
             shorthelp="Constraint: pex corner",
             switch="-constraint_timing_pexcorner 'scenario <str>'",
             example=["cli: -constraint_timing_pexcorner 'worst max'",
@@ -3689,8 +3661,8 @@ def schema_constraint(cfg):
 
     scparam(cfg, ['constraint', 'timing', scenario, 'opcond'],
             sctype='str',
-            pernode='optional',
-            scope='job',
+            pernode=PerNode.OPTIONAL,
+            scope=Scope.JOB,
             shorthelp="Constraint: operating condition",
             switch="-constraint_timing_opcond 'scenario <str>'",
             example=["cli: -constraint_timing_opcond 'worst typical_1.0'",
@@ -3701,8 +3673,8 @@ def schema_constraint(cfg):
 
     scparam(cfg, ['constraint', 'timing', scenario, 'mode'],
             sctype='str',
-            pernode='optional',
-            scope='job',
+            pernode=PerNode.OPTIONAL,
+            scope=Scope.JOB,
             shorthelp="Constraint: operating mode",
             switch="-constraint_timing_mode 'scenario <str>'",
             example=["cli: -constraint_timing_mode 'worst test'",
@@ -3712,8 +3684,8 @@ def schema_constraint(cfg):
 
     scparam(cfg, ['constraint', 'timing', scenario, 'file'],
             sctype='[file]',
-            pernode='optional',
-            scope='job',
+            pernode=PerNode.OPTIONAL,
+            scope=Scope.JOB,
             copy=True,
             shorthelp="Constraint: SDC files",
             switch="-constraint_timing_file 'scenario <file>'",
@@ -3727,8 +3699,8 @@ def schema_constraint(cfg):
 
     scparam(cfg, ['constraint', 'timing', scenario, 'check'],
             sctype='[str]',
-            pernode='optional',
-            scope='job',
+            pernode=PerNode.OPTIONAL,
+            scope=Scope.JOB,
             shorthelp="Constraint: timing checks",
             switch="-constraint_timing_check 'scenario <str>'",
             example=[
@@ -3747,7 +3719,7 @@ def schema_constraint(cfg):
 
     scparam(cfg, ['constraint', 'component', inst, 'placement'],
             sctype='(float,float)',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             unit='um',
             shorthelp="Constraint: component placement",
             switch="-constraint_component_placement 'inst <(float,float)>'",
@@ -3762,20 +3734,21 @@ def schema_constraint(cfg):
 
     scparam(cfg, ['constraint', 'component', inst, 'partname'],
             sctype='str',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Constraint: component part name",
             switch="-constraint_component_partname 'inst <str>'",
             example=[
                 "cli: -constraint_component_partname 'i0 filler_x1'",
                 "api: chip.set('constraint', 'component', 'i0', 'partname', 'filler_x1')"],
             schelp="""
-            Part name of the instance. The parameter is required for instances
-            that are not contained within the design netlist (ie. physical only cells).
-            """)
+            Name of the model, type, or variant of the placed component. In the chip
+            design domain, 'partname' is synonymous to 'cellname' or 'cell'. The
+            'partname' is required for instances that are not represented within
+            the design netlist (ie. physical only cells).""")
 
     scparam(cfg, ['constraint', 'component', inst, 'halo'],
             sctype='(float,float)',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             unit='um',
             shorthelp="Constraint: component halo",
             switch="-constraint_component_halo 'inst <(float,float)>'",
@@ -3784,10 +3757,11 @@ def schema_constraint(cfg):
                 "api: chip.set('constraint', 'component', 'i0', 'halo', (1, 1))"],
             schelp="""
             Placement keepout halo around the named component, specified as a
-            (horizontal, vertical) tuple represented in microns.""")
+            (horizontal, vertical) tuple.""")
 
     scparam(cfg, ['constraint', 'component', inst, 'rotation'],
             sctype='enum',
+            pernode=PerNode.OPTIONAL,
             defvalue='R0',
             enum=['R0', 'R90', 'R180', 'R270',
                   'MX', 'MX_R90', 'MX_R180', 'MX_R270',
@@ -3795,7 +3769,6 @@ def schema_constraint(cfg):
                   'MZ', 'MZ_R90', 'MZ_R180', 'MZ_R270',
                   'MZ_MX', 'MZ_MX_R90', 'MZ_MX_R180', 'MZ_MX_R270',
                   'MZ_MY', 'MZ_MY_R90', 'MZ_MY_R180', 'MZ_MY_R270'],
-            pernode='optional',
             shorthelp="Constraint: component rotation",
             switch="-constraint_component_rotation 'inst <str>'",
             example=[
@@ -3829,11 +3802,54 @@ def schema_constraint(cfg):
         * ``MZ_MX_R270``, ``MZ_MY_R90``: Reverse metal stack, flip on x-axis and rotate 270 deg ccw
             """)
 
+    scparam(cfg, ['constraint', 'component', inst, 'substrate'],
+            sctype='str',
+            pernode=PerNode.OPTIONAL,
+            shorthelp="Constraint: component substrate",
+            switch="-constraint_component_substrate 'inst <str>'",
+            example=[
+                "cli: -constraint_component_substrate 'i0 pcb0'",
+                "api: chip.set('constraint', 'component', 'i0', 'substrate', 'pcb0')"],
+            schelp="""
+            Name of physical substrates instance that components are placed upon.
+            Any flat surface can serve as a substrate (eg. wafers, dies, panels, PCBs,
+            substrates, interposers).""")
+
+    scparam(cfg, ['constraint', 'component', inst, 'side'],
+            sctype='enum',
+            enum=['left', 'right', 'front', 'back', 'top', 'bottom'],
+            pernode=PerNode.OPTIONAL,
+            shorthelp="Constraint: component side",
+            switch="-constraint_component_side 'inst <str>'",
+            example=[
+                "cli: -constraint_component_side 'i0 top'",
+                "api: chip.set('constraint', 'component', 'i0', 'side', 'top')"],
+            schelp="""
+            Side of the substrate where the component should be placed. The `side`
+            is defined with respect to a viewer looking sideways at an object.
+            Top is towards the sky, front is the side closest to the viewer, and
+            right is right. The maximum number of sides per substrate is six""")
+
+    scparam(cfg, ['constraint', 'component', inst, 'zheight'],
+            sctype='float',
+            pernode=PerNode.OPTIONAL,
+            unit='um',
+            shorthelp="Constraint: component placement zheight",
+            switch="-constraint_component_zheight 'inst <float>'",
+            example=[
+                "cli: -constraint_component_zheight 'i0 100.0'",
+                "api: chip.set('constraint', 'component', 'i0', 'zheight', 100.0)"],
+            schelp="""
+            Height above the substrate for component placement. The space
+            between the component and substrate is occupied by material,
+            supporting scaffolding, and electrical connections (eg. bumps,
+            vias, pillars).""")
+
     # PINS
     name = 'default'
     scparam(cfg, ['constraint', 'pin', name, 'placement'],
             sctype='(float,float)',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             unit='um',
             shorthelp="Constraint: pin placement",
             switch="-constraint_pin_placement 'name <(float,float)>'",
@@ -3848,22 +3864,74 @@ def schema_constraint(cfg):
             may adjust sizes to meet competing goals such as manufacturing design
             rules and grid placement guidelines.""")
 
+    scparam(cfg, ['constraint', 'pin', name, 'width'],
+            sctype='float',
+            unit='um',
+            pernode=PerNode.OPTIONAL,
+            shorthelp="Constraint: pin width",
+            switch="-constraint_pin_width 'name <float>'",
+            example=[
+                "cli: -constraint_pin_width 'nreset 1.0'",
+                "api: chip.set('constraint', 'pin', 'nreset', 'width', 1.0)"],
+            schelp="""
+            Pin width constraint.  Package pin width is the lateral
+            (side-to-side) thickness of a pin on a physical component.
+            This parameter represents goal/intent, not an exact
+            specification. The layout system may adjust dimensions to meet
+            competing goals such as manufacturing design rules and grid placement
+            guidelines.""")
+
+    scparam(cfg, ['constraint', 'pin', name, 'length'],
+            sctype='float',
+            unit='um',
+            pernode=PerNode.OPTIONAL,
+            shorthelp="Constraint: pin length",
+            switch="-constraint_pin_length 'name <float>'",
+            example=[
+                "cli: -constraint_pin_length 'nreset 1.0'",
+                "api: chip.set('constraint', 'pin', 'nreset', 'length', 1.0)"],
+            schelp="""
+            Pin length constraint.  Package pin length refers to the
+            length of the electrical pins extending out from (or into)
+            a component. This parameter represents goal/intent, not an exact
+            specification. The layout system may adjust dimensions to meet
+            competing goals such as manufacturing design rules and grid placement
+            guidelines.""")
+
+    scparam(cfg, ['constraint', 'pin', name, 'shape'],
+            sctype='enum',
+            enum=['circle', 'rectangle', 'square',
+                  'hexagon', 'octagon', 'oval', 'pill', 'polygon'],
+            pernode=PerNode.OPTIONAL,
+            shorthelp="Constraint: pin shape",
+            switch="-constraint_pin_shape 'name <str>'",
+            example=[
+                "cli: -constraint_pin_shape 'nreset circle'",
+                "api: chip.set('constraint', 'pin', 'nreset', 'shape', 'circle')"],
+            schelp="""
+            Pin shape constraint specified on a per pin basis. In 3D design systems,
+            the pin shape represents the cross section of the pin in the direction
+            orthogonal to the signal flow direction. The 'pill' (aka stadium) shape,
+            is rectangle with semicircles at a pair of opposite sides. The other
+            pin shapes represent common geometric shape definitions.""")
+
     scparam(cfg, ['constraint', 'pin', name, 'layer'],
             sctype='str',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Constraint: pin layer",
             switch="-constraint_pin_layer 'name <str>'",
             example=[
                 "cli: -constraint_pin_layer 'nreset m4'",
                 "api: chip.set('constraint', 'pin', 'nreset', 'layer', 'm4')"],
             schelp="""
-            Pin metal layer specified based on the SC standard layer stack
-            starting with m1 as the lowest routing layer and ending
-            with m<n> as the highest routing layer.""")
+            Pin metal layer constraint specified on a per pin basis.
+            Metal names should either be the PDK specific metal stack name or
+            an integer with '1' being the lowest routing layer.
+            The wildcard character '*' is supported for pin names.""")
 
     scparam(cfg, ['constraint', 'pin', name, 'side'],
             sctype='int',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Constraint: pin side",
             switch="-constraint_pin_side 'name <int>'",
             example=[
@@ -3879,7 +3947,7 @@ def schema_constraint(cfg):
 
     scparam(cfg, ['constraint', 'pin', name, 'order'],
             sctype='int',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Constraint: pin order",
             switch="-constraint_pin_order 'name <int>'",
             example=[
@@ -3895,7 +3963,7 @@ def schema_constraint(cfg):
     # NETS
     scparam(cfg, ['constraint', 'net', name, 'maxlength'],
             sctype='float',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             unit='um',
             shorthelp="Constraint: net max length",
             switch="-constraint_net_maxlength 'name <float>'",
@@ -3903,12 +3971,12 @@ def schema_constraint(cfg):
                 "cli: -constraint_net_maxlength 'nreset 1000'",
                 "api: chip.set('constraint', 'net', 'nreset', 'maxlength', '1000')"],
             schelp="""
-            Maximum total length of a net, specified in microns.
-            Wildcards ('*') can be used for net names.""")
+            Maximum total length of a net. Wildcards ('*') can be used for
+            net names.""")
 
     scparam(cfg, ['constraint', 'net', name, 'maxresistance'],
             sctype='float',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             unit='ohm',
             shorthelp="Constraint: net max resistance",
             switch="-constraint_net_maxresistance 'name <float>'",
@@ -3921,7 +3989,7 @@ def schema_constraint(cfg):
 
     scparam(cfg, ['constraint', 'net', name, 'ndr'],
             sctype='(float,float)',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             unit='um',
             shorthelp="Constraint: net routing rule",
             switch="-constraint_net_ndr 'name <(float,float)>'",
@@ -3930,13 +3998,12 @@ def schema_constraint(cfg):
                 "api: chip.set('constraint', 'net', 'nreset', 'ndr', (0.4, 0.4))"],
             schelp="""
             Definitions of non-default routing rule specified on a per
-            net basis. Constraints are entered as a (width, space) tuples
-            specified in microns. Wildcards ('*') can be used
-            for net names.""")
+            net basis. Constraints are entered as a (width, space) tuples.
+            Wildcards ('*') can be used for net names.""")
 
     scparam(cfg, ['constraint', 'net', name, 'minlayer'],
             sctype='str',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Constraint: net minimum routing layer",
             switch="-constraint_net_minlayer 'name <str>'",
             example=[
@@ -3950,7 +4017,7 @@ def schema_constraint(cfg):
 
     scparam(cfg, ['constraint', 'net', name, 'maxlayer'],
             sctype='str',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Constraint: net maximum routing layer",
             switch="-constraint_net_maxlayer 'name <str>'",
             example=[
@@ -3964,7 +4031,7 @@ def schema_constraint(cfg):
 
     scparam(cfg, ['constraint', 'net', name, 'shield'],
             sctype='str',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Constraint: net shielding",
             switch="-constraint_net_shield 'name <str>'",
             example=[
@@ -3976,7 +4043,7 @@ def schema_constraint(cfg):
 
     scparam(cfg, ['constraint', 'net', name, 'match'],
             sctype='[str]',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Constraint: net matched routing",
             switch="-constraint_net_match 'name <str>'",
             example=[
@@ -3989,7 +4056,7 @@ def schema_constraint(cfg):
 
     scparam(cfg, ['constraint', 'net', name, 'diffpair'],
             sctype='str',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Constraint: net diffpair",
             switch="-constraint_net_diffpair 'name <str>'",
             example=[
@@ -4001,7 +4068,7 @@ def schema_constraint(cfg):
 
     scparam(cfg, ['constraint', 'net', name, 'sympair'],
             sctype='str',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             shorthelp="Constraint: net sympair",
             switch="-constraint_net_sympair 'name <str>'",
             example=[
@@ -4015,9 +4082,9 @@ def schema_constraint(cfg):
     # AREA
     scparam(cfg, ['constraint', 'outline'],
             sctype='[(float,float)]',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             unit='um',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Constraint: layout outline",
             switch="-constraint_outline <(float,float)>",
             example=["cli: -constraint_outline '(0,0)'",
@@ -4029,9 +4096,9 @@ def schema_constraint(cfg):
 
     scparam(cfg, ['constraint', 'corearea'],
             sctype='[(float,float)]',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             unit='um',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Constraint: layout core area",
             switch="-constraint_corearea <(float,float)>",
             example=["cli: -constraint_corearea '(0,0)'",
@@ -4043,9 +4110,9 @@ def schema_constraint(cfg):
 
     scparam(cfg, ['constraint', 'coremargin'],
             sctype='float',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             unit='um',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Constraint: layout core margin",
             switch="-constraint_coremargin <float>",
             example=["cli: -constraint_coremargin 1",
@@ -4056,8 +4123,8 @@ def schema_constraint(cfg):
 
     scparam(cfg, ['constraint', 'density'],
             sctype='float',
-            pernode='optional',
-            scope='job',
+            pernode=PerNode.OPTIONAL,
+            scope=Scope.JOB,
             shorthelp="Constraint: layout density",
             switch="-constraint_density <float>",
             example=["cli: -constraint_density 30",
@@ -4071,9 +4138,9 @@ def schema_constraint(cfg):
 
     scparam(cfg, ['constraint', 'aspectratio'],
             sctype='float',
-            pernode='optional',
+            pernode=PerNode.OPTIONAL,
             defvalue='1.0',
-            scope='job',
+            scope=Scope.JOB,
             shorthelp="Constraint: layout aspect ratio",
             switch="-constraint_aspectratio <float>",
             example=["cli: -constraint_aspectratio 2.0",