ON_EXPRESION_PYTHON

Muestra las geometrías para las que una expresión Python devuelve verdadero. La orden evalúa la expresión con cada geometría de todos los archivos de dibujo cargados y quita la marca de oculta a las que la cumplen.

Parámetros

La orden usa nombres de selecciones solo si el primer parámetro empieza por #. En ese caso ignora los parámetros que no empiezan por #. Los nombres no distinguen mayúsculas de minúsculas. Un nombre que no existe en la tabla de códigos se ignora sin aviso. Si el nombre lleva espacios, se escribe entre comillas: ON_EXPRESION_PYTHON="#Zonas verdes".

La expresión

• Es una única expresión de Python 3, no un guion: no admite import, asignaciones ni bloques. Python 3 no admite el operador <>: usa !=.
• La variable g contiene la geometría que se está evaluando. Es un objeto Geometry cuyo tipo concreto es Point, Text, Line, Polygon o Complex.
• No se crea ninguna variable por atributo. Los atributos de base de datos del primer código están en el diccionario g.codes[0].attributes (nombre del campo → valor). Si los atributos aún no se han leído, leer attributes consulta la base de datos.
• La expresión debe devolver True o False. También se acepta None (falso) o un número (verdadero si es distinto de 0). Una cadena, una lista u otro tipo produce un error.
• La expresión puede usar las funciones integradas de Python (como len o type) y los nombres que define el entorno Python de la tabla de códigos, incluidas sus funciones. Digi3D.AI ejecuta el entorno en el módulo __main__ del intérprete de Python al abrir el archivo de dibujo y, cuando la orden se ejecuta desde la línea de comandos, un menú o una macroinstrucción, evalúa la expresión en ese mismo módulo.
• Si la evaluación de la expresión consulta un nombre que no está definido en el módulo __main__ (la variable g y los nombres del entorno) ni entre los nombres integrados de Python, Python lanza un error NameError. Por ejemplo, el entorno que se descarga de GitHub contiene la línea import digi3d, así que la expresión puede usar digi3d.Text; para escribir Text sin el prefijo digi3d., el entorno debe importar ese nombre con una línea como from digi3d import Text.

Cuadro de diálogo

El cuadro de diálogo es el mismo para OFF_EXPRESIÓN_PYTHON, ON_SOLO_EXPRESIÓN_PYTHON y SELECCIONA_EXPRESION_PYTHON. Escribe la expresión en el campo que sigue a return. El cuadro de diálogo no recuerda la expresión de la vez anterior.

Para insertar un fragmento, elígelo en el desplegable Fragmentos de código y pulsa Añadir fragmento. El fragmento se añade al final de la expresión. Los fragmentos son:

Sustituye code y field por el código y el campo reales.

Errores

Si la expresión tiene un error de sintaxis, o lanza una excepción con alguna geometría, Digi3D.AI muestra un cuadro de mensaje que empieza por el tipo y el texto del error de Python, por ejemplo NameError: name 'Text' is not defined. Lanzan una excepción, por ejemplo, g.area en un punto y attributes['campo'] si el campo no existe.

Después del error, la orden deja de evaluar la expresión en el archivo de dibujo en el que se ha producido el error y no muestra ninguna geometría de ese archivo por esa expresión, aunque la expresión haya devuelto verdadero al evaluar otras geometrías del mismo archivo antes del error. Con varios nombres de selecciones (#), la orden muestra las geometrías que cumplen las selecciones cuya expresión no falla. Si quedan otros archivos de dibujo cargados, la orden evalúa la expresión en el siguiente archivo, así que el cuadro de mensaje aparece una vez por cada archivo de dibujo en el que falla la expresión. Con nombres de selecciones (#), aparece una vez por cada selección y cada archivo de dibujo en los que falla la expresión.

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.

La página Actualizar los controles de calidad Python de una tabla de códigos explica los errores NameError y AttributeError de las expresiones escritas para versiones anteriores de Digi3D.

Para evitar errores:

• Comprueba antes el tipo. and solo evalúa la segunda condición si la primera es verdadera: type(g).__name__ == 'Line' and g.area > 100.
• Lee los campos con .get('campo'), que devuelve None si el campo no existe.

Ejemplos

Para mostrar las geometrías que tienen exactamente 3 vértices:

ON_EXPRESION_PYTHON=len(g) == 3

Para mostrar las geometrías cuyo primer código es '010101', que tienen 7 vértices y cuyo campo Propietario de la base de datos vale 'Dylan':

ON_EXPRESION_PYTHON=g.codes[0].code == '010101' and len(g) == 7 and g.codes[0].attributes.get('Propietario') == 'Dylan'

Para mostrar las geometrías que cumplen la selección "Edificios" de la tabla de códigos:

ON_EXPRESION_PYTHON=#Edificios

Para mostrar las geometrías que cumplen la selección "Edificios" o la selección "Deportivo":

ON_EXPRESION_PYTHON=#Edificios #Deportivo

Observaciones

• La orden actúa sobre todas las geometrías de todos los archivos de dibujo cargados, incluidas las borradas.
• Mostrar u ocultar por expresión es una marca de cada geometría. Es independiente de la visibilidad por código: una geometría cuyo código está apagado sigue sin dibujarse.
• Las geometrías ocultas no se dibujan en la ventana de dibujo ni en la ventana fotogramétrica. VER_TODAS_ENTIDADES quita la marca de oculta a todas las geometrías.

Características de la orden