This page has not been translated yet and is shown in Spanish.

Prefijar los códigos de la geometría seleccionada

Archivo: prefija_cod.py · orden interactiva (PythonCommand) con un parámetro.

La orden antepone un prefijo a los códigos de cada geometría que seleccionas con un dato o con una orden de selección múltiple. Está pensada para los proyectos de actualización cartográfica en los que cada elemento está en uno de estos estados:

Código	Estado
`ORO_01_LN`	Sin cambios respecto a la cartografía original.
`ACT_ORO_01_LN`	Nuevo o modificado tras la fotointerpretación.
`BAI_ORO_01_LN`	Desaparecido tras la fotointerpretación.

Cambiar el código a mano en miles de geometrías es lento. Con esta orden basta con hacer clic en cada geometría.

Cómo se usa

Si tu versión de Digi3D.AI no instala las órdenes del repositorio ComandosDigi3DPython en la carpeta OrdenesPython de su carpeta de instalación, copia prefija_cod.py en el directorio de macroinstrucciones. La página Órdenes en Python del repositorio ComandosDigi3DPython explica en qué carpetas busca Digi3D.AI el archivo y cómo se modifica una orden instalada.
Asigna la orden a dos teclas o a dos botones de una barra de herramientas, con un prefijo distinto en cada tecla o botón:
```
PREFIJA_COD=ACT_
PREFIJA_COD=BAI_
```
Pulsa la tecla o el botón del prefijo que quieras aplicar y haz clic en cada geometría. La orden sigue activa hasta que pulsas reset.
Para cambiar muchas geometrías de una vez, ejecuta con la orden activa SELECCIONA_VENTANA, SELECCIONA_COD o cualquier otra orden de selección: la orden de prefijado antepone el prefijo a todas las geometrías seleccionadas del archivo de dibujo.

La orden no cambia los códigos que ya empiezan por ACT_, por BAI_ o por el prefijo indicado. Si todos los códigos de una geometría tienen ya un prefijo, esa geometría no cambia; si no cambia ninguna, suena el sonido de error. Cada código conserva su tabla y su registro de base de datos. Cada dato y cada selección múltiple quedan en una transacción propia: un UNDO deshace el cambio de la geometría del dato o de todas las geometrías de la selección.

Si no se indica exactamente un parámetro, la orden emite el sonido de error y muestra un cuadro con el mensaje «Falta el prefijo.» y la forma de uso.

La orden necesita una versión de Digi3D.AI con PythonCommand.select_geometry, el evento on_geometries_selected y DrawingView.replace.

El código

import digi3d

USO = 'PREFIJA_COD=[prefijo]'

# Prefijos de los códigos que ya están tratados. El prefijo que recibe la orden se añade a esta lista.
PREFIJOS = ('ACT_', 'BAI_')


def error(mensaje):
    """Emite el sonido de error y muestra el mensaje con la forma de uso de la orden."""
    digi3d.music(digi3d.MusicType.Error)
    digi3d.show_info('{}\n\nUso: {}'.format(mensaje, USO))


class PrefijaCod(digi3d.PythonCommand):
    def __init__(self, prefijo):
        digi3d.PythonCommand.__init__(self, 'prefija_cod')
        self.prefijo = prefijo
        self.prefijos = PREFIJOS + (prefijo,)

    def on_set_focus(self):
        digi3d.print_statusbar('Selecciona la geometría a la que añadir el prefijo {}'.format(self.prefijo))

    # Con cada dato pedimos la geometría más próxima, como hace el pedal de tentativo. Digi3D.AI la entrega en
    # on_geometry_selected. El filtro descarta las geometrías de los archivos de referencia, que no se pueden modificar.
    def on_data_up(self, coordenadas):
        ruta = self.view.drawing_file.path
        self.select_geometry(coordenadas, lambda geometria: geometria.file is not None and geometria.file.path == ruta)
        return True

    def on_geometry_selected(self, geometria, coordenadas, primer_vertice, segundo_vertice):
        self.prefija_geometrias([geometria])

    # Las órdenes de selección múltiple y los paneles entregan aquí la lista de geometrías seleccionadas.
    def on_geometries_selected(self, geometrias):
        self.prefija_geometrias(geometrias)

    def prefija_geometrias(self, geometrias):
        # Solo se modifican las geometrías del archivo de dibujo que no están borradas: el tentativo, las órdenes de
        # selección y los paneles entregan también las de los archivos de referencia y, con BORRADOS=1, las borradas.
        # El editor de base de datos entrega una geometría una vez por cada código enlazado al registro.
        ruta = self.view.drawing_file.path
        vistas = set()
        originales = []
        for geometria in geometrias:
            if id(geometria) in vistas or geometria.deleted or geometria.file is None or geometria.file.path != ruta:
                continue
            vistas.add(id(geometria))
            if not all(codigo.code.startswith(self.prefijos) for codigo in geometria.codes):
                originales.append(geometria)

        if not originales:
            digi3d.music(digi3d.MusicType.Error)
            return

        # Las geometrías del dibujo son de solo lectura: cada original se sustituye por un clon con los códigos nuevos.
        # replace pasa los controles de calidad y avisa a las extensiones, y si Digi3D.AI rechaza el clon deja la
        # original como estaba y devuelve None.
        cambiadas = 0
        for geometria in originales:
            clon = geometria.clone()
            clon.codes = tuple(self.prefija(codigo) for codigo in geometria.codes)
            if self.view.replace(geometria, clon) is not None:
                cambiadas += 1

        self.view.redraw()

        # Una transacción por selección: un UNDO deshace el cambio de todas las geometrías seleccionadas a la vez.
        self.new_transaction()

        if cambiadas == 0:
            digi3d.music(digi3d.MusicType.Error)

    def prefija(self, codigo):
        if codigo.code.startswith(self.prefijos):
            return codigo

        nuevo = digi3d.FeatureCode(self.prefijo + codigo.code)
        nuevo.table = codigo.table
        nuevo.id = codigo.id
        return nuevo


v = digi3d.current_view()
if len(argv) != 1:
    error('Falta el prefijo.')
elif v is None:
    print('No hay ninguna ventana de dibujo abierta')
else:
    # Variable global: el objeto de Python sigue existiendo después de terminar el guion.
    orden = PrefijaCod(argv[0])
    v.add_command(orden)

Cómo funciona

El parámetro: Digi3D.AI deja los parámetros de la orden en la variable global argv. Con PREFIJA_COD=BAI_, argv vale ('BAI_',). Digi3D.AI separa los parámetros por espacios, tabuladores y signos =, así que el prefijo no puede contener ninguno de esos caracteres. Si argv no tiene exactamente un elemento, la función error emite el sonido de error y muestra el motivo y la forma de uso con digi3d.show_info, y el guion no crea la orden.
La selección: en on_data_up la orden llama a select_geometry, que busca la geometría más próxima al dato igual que el pedal de tentativo. Digi3D.AI entrega la geometría encontrada en el evento on_geometry_selected.
El filtro: el segundo argumento de select_geometry es una función que decide qué geometrías se pueden seleccionar. La propiedad file de cada geometría devuelve el archivo que la contiene. La orden solo acepta las geometrías cuyo archivo es el archivo de dibujo activo (self.view.drawing_file), porque las de los archivos de referencia no se pueden modificar.
La selección múltiple: como la orden define on_geometries_selected, las órdenes de selección y la opción Enviar selección a la orden activa de los paneles le entregan una lista de geometrías. Esas geometrías no pasan por el filtro de select_geometry: pueden ser de cualquier archivo cargado, pueden estar borradas si la variable BORRADOS está activada, y el editor de base de datos puede entregar la misma geometría dos veces. prefija_geometrias descarta las de otros archivos, las borradas (propiedad deleted) y las repetidas. La misma función trata la geometría del dato, que on_geometry_selected le pasa en una lista de un elemento: también puede llegar sin filtrar, por ejemplo desde el pedal de tentativo.
Los prefijos: str.startswith admite una tupla y devuelve True si la cadena empieza por cualquiera de sus elementos. La tupla self.prefijos contiene ACT_, BAI_ y el prefijo recibido.
El cambio de códigos: las geometrías del dibujo son de solo lectura. Para cada geometría, la orden crea un clon con clone(), le asigna los códigos nuevos y sustituye la original por el clon con view.replace, que pasa los controles de calidad y avisa a las extensiones. Si Digi3D.AI rechaza el clon, por ejemplo porque el formato del archivo no admite el código con prefijo, replace deja la original como estaba y devuelve None. Cada código nuevo es un FeatureCode con la tabla y el identificador del código original, como en el ejemplo Renombrar un código manteniendo sus atributos.
Deshacer: self.new_transaction() cierra la transacción de deshacer del dato o de la selección múltiple y abre otra para el siguiente dato o selección.
La variable orden: Digi3D.AI ejecuta los guiones en el espacio de nombres de __main__, que se conserva entre ejecuciones. El guion guarda la orden en una variable global para que el objeto de Python siga existiendo mientras la orden está activa, igual que el ejemplo Texto del callejero del Catastro.

Véase también

PythonCommand — select_geometry, on_geometry_selected, on_geometries_selected, new_transaction
FeatureCode
Renombrar un código manteniendo sus atributos