Orientar nube contra nube
La herramienta /ORIENTARNUBE calcula cuánto hay que girar y desplazar una nube de puntos desorientada (por ejemplo, un escaneo SLAM, Simultaneous Localization and Mapping) para que coincida con la nube de puntos de un modelo teórico del mismo recinto, y aplica ese giro y ese desplazamiento a la nube.
Para ejecutar esta herramienta desde la línea de comando, escribe la siguiente secuencia:
MDTopX [archivo de entrada] /ORIENTARNUBE
Esta herramienta no acepta un archivo de salida como argumento de la línea de comando. Escribe la ruta completa del archivo de entrada, que puede ir antes o después de la orden. MDTopX busca MDTopX.ini en la carpeta del archivo de entrada.
Archivos
- Archivo de entrada: nube de puntos que quieres orientar. MDTopX aplica la transformación a esta nube y la guarda en este mismo archivo, por lo que sobrescribe el original. Trabaja con una copia si necesitas conservar la nube sin orientar. Si el cálculo falla, MDTopX no modifica el archivo.
- Nube de puntos destino: nube del modelo teórico del recinto, con el suelo y las paredes y sin techos. Se indica en la clave NombreDibujoDestino de MDTopX.ini. MDTopX no modifica este archivo.
- Archivo de transformaciones: archivo de texto con la transformación calculada. MDTopX lo crea si la clave GenerarSalidaConTransformacion vale 1, con el nombre indicado como valor de la clave NombreSalidaConTransformacion. Si escribes un nombre sin carpeta, MDTopX lo crea en el directorio de trabajo del proceso.
MDTopX anota el desarrollo del cálculo en el archivo MDTopX.LOG, que crea en la carpeta del archivo MDTopX.ini.
Licencia
Esta herramienta no exige la licencia de MDTopX: MDTopX no comprueba que haya una llave de protección o una licencia de software de MDTopX antes de ejecutarla. /ACOPIOS, /FILTRADO, /ORIENTARNUBE y /ORIENTARNUBEARCHIVO no comprueban la licencia de MDTopX al iniciarse ni antes de guardar el resultado, y no muestran los avisos de licencia.
Qué calcula MDTopX
- Calcula la cota del suelo de cada nube a partir de sus puntos más bajos.
- Selecciona de cada nube los puntos de tres franjas horizontales situadas a 1, 2 y 3 metros sobre el suelo, cada una de 0.4 metros de espesor, y calcula el contorno de los puntos de cada franja.
- Obtiene la dirección dominante de los contornos de cada nube y calcula, para cada una, el giro que alinea esa dirección con los ejes X e Y.
- Convierte los contornos, ya alineados con los ejes, en imágenes con píxeles de lado SizeCelda y busca el desplazamiento horizontal que más hace coincidir las dos imágenes. Repite la búsqueda con la nube de entrada girada 0, 90, 180 y 270 grados adicionales y se queda con el giro que produce más coincidencia.
- Repite la búsqueda del desplazamiento horizontal con píxeles cuyo lado mide SizeCelda / 2.
- Ajusta la cota Z: proyecta los puntos del suelo de la nube destino sobre la superficie triangulada de los puntos del suelo de la nube de entrada y desplaza la nube de entrada en Z para anular la moda de las diferencias de cota.
- Aplica a la nube de entrada tres operaciones, en este orden: el giro que la alinea con los ejes más el giro adicional elegido en el paso 4 (Giro1), los desplazamientos de los pasos 4, 5 y 6 (Traslacion) y un giro final que lleva la nube desde los ejes hasta la dirección real de la nube destino (Giro2).
Configuración en MDTopX.ini
Para configurar el cálculo, MDTopX.ini debe tener una línea con el texto [UnirNubesDesorientadas] y, a continuación, estas claves. Los nombres de sección y de clave no distinguen mayúsculas de minúsculas. Si omites una clave o le das un valor vacío, MDTopX usa el valor guardado en la configuración del usuario de MDTopX y, si no hay ninguno, el valor predeterminado. Cada valor admite como máximo 255 caracteres.
- NombreDibujoDestino: ruta del archivo con la nube de puntos destino. Es obligatoria. Si el archivo no existe o no contiene puntos, MDTopX no orienta la nube de entrada. Si escribes una ruta sin carpeta, MDTopX la busca en el directorio de trabajo del proceso. Predeterminado: vacío.
- DistanciaMin: longitud mínima, en metros, que debe tener un tramo de contorno, una vez ajustado a una recta, para que MDTopX lo conserve. Predeterminado: 0.1.
- DistanciaMax: distancia máxima, en metros, entre dos tramos de contorno para que MDTopX los una. MDTopX usa también este valor como paso de la malla con la que reduce los puntos del suelo de la nube destino. Predeterminado: 0.5.
- SizeCelda: lado, en metros, de los píxeles de las imágenes de los contornos. Predeterminado: 0.1.
- GenerarSalidaConTransformacion: 0 (no crear el archivo de transformaciones) o 1 (crearlo). Predeterminado: 1.
- NombreSalidaConTransformacion: nombre del archivo de transformaciones. Predeterminado:
Transformaciones.txt. - DibujoDestinoEsTeorico: MDTopX lee esta clave pero la ignora: con esta herramienta siempre trata la nube destino como un modelo teórico con suelo y paredes.
- DibujoDestinoEstaClasificado: MDTopX lee esta clave pero no la usa.
[UnirNubesDesorientadas]
NombreDibujoDestino = C:\Nave\Teorico.las
DistanciaMin = 0.1
DistanciaMax = 0.5
SizeCelda = 0.1
GenerarSalidaConTransformacion = 1
NombreSalidaConTransformacion = C:\Nave\Transformaciones.txt
Archivo de transformaciones
El archivo de transformaciones es un archivo de texto con tres secciones. Giro1 y Giro2 son ángulos en grados, alrededor del eje vertical, con 4 decimales. Traslacion contiene los desplazamientos en X, Y y Z que MDTopX aplica a la nube, en metros y con 3 decimales, separados por un espacio.
[Giro1]
19.0043
[Traslacion]
-16.600 -11.200 0.830
[Giro2]
-0.4032
Orientar con un archivo de orientación
La orden /ORIENTARNUBEARCHIVO aplica a una nube de puntos la transformación que guarda un archivo de transformaciones, sin calcularla. Para ejecutarla, escribe:
MDTopX [archivo de entrada] /ORIENTARNUBEARCHIVO [archivo de orientación]
- Archivo de entrada: nube de puntos que quieres orientar. MDTopX gira la nube con Giro1, la desplaza con Traslacion y la gira con Giro2, en ese orden, y la guarda en este mismo archivo, por lo que sobrescribe el original. Trabaja con una copia si necesitas conservar la nube sin orientar. El archivo de entrada puede ir antes de la orden o después del archivo de orientación.
- Archivo de orientación: archivo de texto con el formato del archivo de transformaciones que escribe
/ORIENTARNUBE. MDTopX toma como archivo de orientación solo el primer argumento que sigue a la orden. El archivo de orientación es obligatorio: si no lo escribes, MDTopX no ejecuta la orden y escribe en MDTopX.LOG el mensaje «La orden /ORIENTARNUBEARCHIVO tiene argumentos obligatorios ausentes o no válidos. MDTopX termina sin procesar el archivo.» (con MDTopX en inglés, «The /ORIENTARNUBEARCHIVO command has missing or invalid required arguments. MDTopX ends without processing the file.»).
Ninguna clave de MDTopX.ini configura esta orden. Como /ORIENTARNUBE, la orden no comprueba la licencia de MDTopX al iniciarse ni antes de guardar el resultado.
Vea también: