Python quality control repository
The public repository Guiones-Control-Calidad-Python-Digi3D contains one file, guiones.py, with two function groups:
- Quality controls:
@quality_control()functions assigned to codes. Quality controls explains declaration and error reporting. - Dynamic representation rules:
@dynamic_representation_rule()functions changing a geometry's drawing color, fill color or width.
Uses digi3d, available only inside Digi3D.AI.
Installing the file in a codes table
Digi3D.AI loads Python environment whenever the table changes. To install guiones.py:
- Open the table with Code table editor.
- Select Python environment.
- Click Download the latest version from GitHub. Downloads
guiones.pyfrommain, replacing all tab contents. - Click OK.
Offline, download guiones.py from GitHub (Download raw file), copy its contents and paste them into Python environment.
Step 3 deletes custom functions. Copy them before downloading guiones.py, then append them to the downloaded contents. For earlier Digi3D tables, see Update a code table's Python quality controls.
Assigning a quality control to a code
- Select a code on the editor's codes tab.
- Click Quality controls to apply to open Quality controls.
- Select a control in Available quality controls and click Add.
- Enter any parameters in Quality control parameters, then click OK.
- Click OK in Quality controls and the editor.
Run assigned controls with QUALITY_CONTROL_COD, QUALITY_CONTROL_VISIBLE_ENTITIES and QUALITY_CONTROL_SELECTION. With QUALITY_CONTROL_ON_ENTITY_END and Analyze quality control when digitizing enabled, also runs them when digitizing finishes, before file storage.
Writing parameters
Quality control parameters stores values as a Python dictionary. Integers without leading zeros, all-zero values (0, 00) and numbers containing a decimal point (0.5, .5, 020.) become numbers; other values become text. See the full rule in Quality control parameters dialog.
Numeric codes without leading zeros, such as 120400, become numbers. Controls convert parameters to text before code matching, so 120400 also works as a numeric value. Leading-zero codes such as 020123 remain text. Python number formatting can change the original: 00 becomes 0, 12. becomes 12.0, .5 becomes 0.5, and 1.10 becomes 1.1. These codes no longer match the entered text.
Codes, wildcards and tags
Parameters starting with código_o_etiqueta accept space-separated words. A geometry matches if any code matches any word:
?replaces one character:0201?3matches020123and020133.*accepts the remaining code:0201*matches020123and0201ABC, but not0201: at least one character is required at the*position.- A word starting with
#is a tag:#edificiosmatches codes taggededificiosin the active table.
Matching uses compara_codigos_con_comodines:
def compara_codigos_con_comodines(codigo_a, codigo_b):
tamanoCodigoA = len(codigo_a)
tamanoCodigoB = len(codigo_b)
for i in range(min(tamanoCodigoA, tamanoCodigoB)):
if codigo_a[i] == '*' or codigo_b[i] == '*':
return True
if codigo_a[i] == '?' or codigo_b[i] == '?':
continue
if codigo_a[i] != codigo_b[i]:
return False
if tamanoCodigoA == tamanoCodigoB:
return True
return False
The analyzed geometry is not compared with itself
Relationship controls iterate nondeleted geometries from every loaded drawing and reference file using alguna_geometria, which skips the analyzed geometry:
for g in no_eliminadas(digi3d.current_view()):
# Exclude the geometry being analyzed
if g == geometría_analizando:
continue
With quality control commands, the analyzed geometry already belongs to the drawing file. Even when its code matches código_o_etiqueta_..., it is not compared with itself. For example, si_es_punto_debe_estar_separado_de_punto using that point's own code fails only if another point with the code is not disjoint from it.
Pages in this section
- Geometry relationship controls: areas, lines and points that must touch, cross, contain one another or be disjoint.
- Type and measurement controls: geometry type, area, perimeter, dimensions and point distance.
- Z coordinate controls: constant, increasing or decreasing Z, index and intermediate contours, DTM differences and intersection Z differences.
- Attribute controls: geometry and database attributes.
- Dynamic representation rules: color, fill and width according to code, attributes or measurements.
See also
- Quality controls
- Exceptions:
GeometryError,GeometryRelationError,GeometryWarningandDatabaseFieldError. - Python environment tab