Actualizar los controles de calidad Python de una tabla de códigos

Los controles de calidad Python de las tablas de códigos creadas para versiones anteriores de Digi3D no son compatibles con Digi3D.AI. Al abrir un archivo de dibujo con una de esas tablas, o al analizar el control de calidad, Digi3D.AI muestra un error como este:

ModuleNotFoundError: No module named 'digi3d.relations'; 'digi3d' is not a package

Para resolver este error, sustituye el entorno Python de la tabla de códigos por la última versión de los controles de calidad de Digi21.

Pasos

1. Haz una copia de seguridad del archivo de la tabla de códigos. Los controles nuevos no funcionan con las versiones anteriores de Digi3D: si vas a seguir usando la tabla con versiones anteriores de Digi3D, usa la copia de seguridad.
2. Abre la tabla de códigos con el Editor de tablas de códigos.
3. Selecciona la pestaña Entorno Python.
4. Pulsa el botón Descargar de GitHub la última versión, debajo del editor. El contenido de la pestaña se sustituye por la versión descargada.
5. Pulsa Aplicar.
6. Pulsa Aceptar.

Al abrir de nuevo el archivo de dibujo en Digi3D.AI, los controles de calidad funcionan.

Si habías añadido funciones propias al entorno Python de la tabla, la descarga del paso 4 borra las funciones propias. Copia tus funciones antes de pulsar el botón Descargar de GitHub la última versión y pégalas al final del entorno descargado una vez finalizada la descarga. Si las funciones propias usan módulos o nombres de la versión anterior (como digi3d.relations o g.codes[0].name), tendrás que adaptar las funciones a la interfaz de programación de aplicaciones (API) descrita en la API de Python de Digi3D.AI. La tabla de Nombres de la API de Python que han cambiado indica el sustituto de cada nombre o señala que no tiene equivalente.

Errores después de sustituir el entorno

Digi3D.AI ejecuta el entorno Python de la tabla de códigos en el módulo __main__ del intérprete de Python al abrir el archivo de dibujo. Cuando las órdenes ON_EXPRESION_PYTHON, OFF_EXPRESION_PYTHON, ON_SOLO_EXPRESION_PYTHON y SELECCIONA_EXPRESION_PYTHON se ejecutan desde la línea de comandos, un menú o una macroinstrucción, Digi3D.AI evalúa las expresiones de estas órdenes, incluidas las de las selecciones de la tabla de códigos, en el módulo __main__. Por eso, una expresión puede usar la variable g, las funciones integradas de Python (como len o type) y los nombres que define el entorno. Las expresiones y las funciones propias escritas para la versión anterior producen los errores de esta sección si usan nombres que el entorno descargado no define o que la API de Digi3D.AI ha cambiado.

Cuando una expresión produce un error, Digi3D.AI muestra el error de Python en un cuadro de mensaje y, en el archivo de dibujo en el que falla la expresión, ON_EXPRESION_PYTHON y OFF_EXPRESION_PYTHON no cambian la visibilidad de ninguna geometría por esa expresión (con varios nombres de selecciones indicados con #, aplican las selecciones cuya expresión no falla), ON_SOLO_EXPRESION_PYTHON deja ocultas todas las geometrías, salvo las que cumplen otra selección indicada con # cuya expresión no falla, y SELECCIONA_EXPRESION_PYTHON envía una selección vacía a la orden en curso. Si la orden forma parte de una macroinstrucción (@), Digi3D.AI ejecuta la orden siguiente de la macroinstrucción después de que el usuario cierre el cuadro de mensaje. Por ejemplo, si una macroinstrucción ejecuta OFF_EXPRESION_PYTHON para ocultar los textos y después crea una topología, un error en la expresión de OFF_EXPRESION_PYTHON no detiene la macroinstrucción, y la macroinstrucción crea la topología sin que OFF_EXPRESION_PYTHON haya ocultado los textos de los archivos de dibujo en los que falla la expresión. La página de ON_EXPRESION_PYTHON detalla estos errores.

NameError al usar Text, Line, Point, Polygon o Complex

Digi3D.AI muestra un cuadro de mensaje que empieza por este texto cuando una expresión, o una función del entorno a la que llama la expresión, usa el nombre de un tipo de geometría sin el prefijo digi3d. y el entorno no importa ese nombre:

NameError: name 'Text' is not defined

El nombre entre comillas es el nombre que el entorno no define: Text, Line, Point, Polygon, Complex u otro nombre del módulo digi3d. El entorno de una tabla de códigos creada para Digi3D.NET podía incluir la línea from digi3d import *, que define en el entorno todos los nombres públicos del módulo digi3d. El entorno descargado de GitHub empieza por las líneas import digi3d e import random y no incluye la línea from digi3d import *, así que los nombres del módulo solo están disponibles con el prefijo digi3d.. Esta expresión de la orden OFF_EXPRESION_PYTHON produce el error:

OFF_EXPRESION_PYTHON=type(g) is Text and "_A_" in g.codes[0].name

Corrige el error de una de estas dos formas:

• Añade al entorno, debajo de la primera línea import digi3d, una línea que importe los nombres que usan tus expresiones y tus funciones:

  import digi3d
  from digi3d import Point, Text, Line, Polygon, Complex
  

  Si el error indica otro nombre del módulo digi3d, añade ese nombre a la lista.

• Escribe el prefijo digi3d. delante de los nombres del módulo digi3d que las expresiones y las funciones usan sin prefijo: type(g) is digi3d.Text.

Después de modificar el entorno, pulsa Aplicar y Aceptar en el Editor de tablas de códigos y vuelve a abrir el archivo de dibujo: Digi3D.AI ejecuta el entorno modificado al abrir el archivo.

La línea from digi3d import * también corrige el error, pero define en el entorno el nombre Warning con el valor digi3d.TaskType.Warning: las expresiones y las funciones del entorno que usan el nombre Warning obtienen digi3d.TaskType.Warning en lugar de la excepción Warning de Python. El entorno descargado de GitHub no usa la excepción Warning. Si tus funciones usan la excepción Warning de Python, importa los nombres de digi3d uno a uno.

AttributeError al leer name de un código

Después de corregir el error NameError, la expresión del ejemplo produce un error AttributeError al evaluar g.codes[0].name con el primer texto del archivo de dibujo, si ese texto tiene algún código. El mensaje del error contiene este texto:

object has no attribute 'name'

En las versiones de Digi3D.NET publicadas entre 2023 y 2025, los elementos de g.codes eran objetos digi3d.Code, que guardaban el texto del código en la propiedad name. En Digi3D.AI, los elementos de g.codes son objetos FeatureCode, que guardan el texto del código en la propiedad code. FeatureCode no tiene la propiedad name.

Para corregir el error, sustituye .name por .code en los códigos de la geometría. Con la línea from digi3d import Point, Text, Line, Polygon, Complex en el entorno, la expresión del ejemplo queda así:

OFF_EXPRESION_PYTHON=type(g) is Text and "_A_" in g.codes[0].code

Sustituye .name solo cuando se aplica a un código: las propiedades Command.name y Camera.name siguen existiendo en Digi3D.AI.

Nombres de la API de Python que han cambiado

La tabla enumera los nombres del módulo digi3d de las versiones de Digi3D.NET publicadas entre 2023 y 2025 que no existen en Digi3D.AI e indica su sustituto cuando existe. Los demás nombres de clases, propiedades, métodos, funciones y valores de enumeraciones del módulo digi3d de esas versiones existen en Digi3D.AI con el mismo nombre. La tabla compara nombres; no recoge los cambios de los argumentos de los constructores.

En las versiones de Digi3D.NET publicadas entre 2023 y 2025, el módulo digi3d definía en su nivel superior los valores de las enumeraciones PointLineRelativePosition, TextJustification y CardinalPoint, y la línea from digi3d import * los definía en el entorno sin prefijo (por ejemplo, Inside). El módulo definía CardinalPoint después de TextJustification, así que digi3d.NE, digi3d.NW, digi3d.SE y digi3d.SW eran valores de CardinalPoint. En Digi3D.AI, los valores de PointLineRelativePosition, TextJustification y StandardViewpoint solo existen dentro de su enumeración: se escriben con el nombre de la enumeración delante, como en digi3d.PointLineRelativePosition.Inside.

Relaciones entre geometrías

El submódulo digi3d.relations agrupaba las relaciones en clases según los tipos de las dos geometrías y exponía las relaciones como funciones que recibían las dos geometrías. En Digi3D.AI, cada relación que tiene equivalente se evalúa con un método que se llama sobre la primera geometría y recibe la segunda geometría como argumento: digi3d.relations.LineLine.join(a, b) pasa a ser a.touches(b). La página Geometry describe cada método.

Las clases PointArea, LineArea y AreaArea comparaban como área una línea cerrada (Line). Los métodos de Digi3D.AI eligen la comparación según el tipo de las dos geometrías:

• Comparan como área la Line que reciben como argumento en within, adjacent, terminates_within y completely_within, y en cualquier método que se llama sobre un Polygon.

• Comparan como línea la Line sobre la que se llama el método, y la Line que reciben como argumento en los métodos distintos de within, adjacent, terminates_within y completely_within que no se llaman sobre un Polygon.

• Lanzan un error TypeError si la relación no está definida para los tipos de las dos geometrías. Por ejemplo, linea.overlaps(poligono) produce este error:

  TypeError: La relacion 'overlaps' no esta definida para esa combinacion de tipos de geometria.
  

Para que un método compare como área una línea cerrada que, según estas reglas, compararía como línea, crea antes un polígono con los vértices de la línea y llama al método sobre el polígono, o pasa el polígono como argumento del método:

poligono = digi3d.Polygon((), list(linea))

Véase también

• Controles de calidad
• Pestaña Entorno Python
• Actualizar las expresiones Python de selecciones y órdenes
• Geometry