Agisoft Metashape incluye una potente API de Python que permite a los usuarios automatizar complejas tareas de fotogrametría. Tanto si trabajas en cartografía con drones, arquitectura o documentación arqueológica, los scripts en Metashape pueden ahorrarte horas de clics manuales. En este artículo, compartiremos cinco scripts de Python listos para usar que pueden agilizar drásticamente tu flujo de trabajo.
¿Por qué utilizar secuencias de comandos Python en Metashape?
Las secuencias de comandos te dan un control total sobre el procesamiento por lotes de Metashape, los flujos de trabajo personalizados, el control de parámetros y la integración con SIG o plataformas de datos.
- Procesa por lotes cientos de conjuntos de datos sin introducirlos manualmente
- Automatiza la exportación de ortofotos, modelos o nubes de puntos
- Genera informes o registros de errores automáticamente
- Integrar con almacenamiento en la nube o apps externas
Cómo ejecutar un script en Metashape
Ve a Herramientas → Ejecutar Script o utiliza la consola integrada de Python. También puedes ejecutar scripts desde la línea de comandos en modo headless (sin GUI):
metashape.sh -r script.py
Asegúrate de que tu script importa Metashape:
importar Metashape
1. Autoalinear fotos en un trozo
Este script alinea las fotos en un trozo seleccionado utilizando Alta precisión y desactiva la preselección genérica para obtener mejores resultados.
import Metashape doc = Metashape.app.document chunk = doc.chunk chunk.matchPhotos(accuracy=Metashape.HighAccuracy, generic_preselection=False) chunk.alignCameras()
Opcional: añade la optimización de la cámara o el ajuste adaptativo del modelo de cámara después de la alineación.
2. Construye nubes densas y mallas automáticamente
chunk.buildDepthMaps(quality=Metashape.MediumQuality, filter=Metashape.AggressiveFiltering) chunk.buildDenseCloud() chunk.buildModel(surface_type=Metashape.Arbitrary, interpolation=Metashape.EnabledInterpolation)
Este script funciona bien después de alinear las fotos y te ahorra tiempo en los trabajos largos.
3. Exportar ortofoto automáticamente
output_path = "C:/exports/orthophoto.tif" chunk.buildOrthomosaic(surface_data=Metashape.ModelData, blending_mode=Metashape.MosaicBlending) chunk.exportRaster(output_path, image_format=Metashape.ImageFormatTIFF)
Este ejemplo exporta el ortomosaico como un GeoTIFF. Puedes añadir parámetros de proyección utilizando projection=
.
4. Exportar nube de puntos en formato LAS
output_las = "C:/exports/dense_cloud.las" chunk.exportPoints(output_las, source_data=Metashape.DenseCloudData, format=Metashape.PointsFormatLAS)
Puedes cambiar el formato a Metashape.PointsFormatPLY
o XYZ
según la plataforma que estés utilizando.
5. Autogenerar informe PDF
ruta_del_informe = "C:/informes/informe_del_proyecto.pdf" chunk.exportReport(ruta_del_informe)
Incluye las estadísticas de alineación de la cámara, los errores del GCP y los pasos de procesamiento: un entregable perfecto para los clientes.
Bonificación: Automatización completa
Para proyectos grandes, combina todos los pasos anteriores en un único script de Python y ejecuta Metashape en modo headless a través del terminal:
metashape.sh -plataforma offscreen -r full_pipeline.py
Incluye lógica de rutas de entrada/salida y análisis sintáctico de nombres de archivo para crear un sistema de procesamiento por lotes de carpetas de imágenes.
Dónde obtener más información
- Referencia oficial de la API Python de Metashape
- Repositorio GitHub de Agisoft Metashape
- Guiones de la comunidad en los foros de Agisoft y GIS Stack Exchange
Conclusión
Los scripts de Python liberan el verdadero potencial de Agisoft Metashape, especialmente para los usuarios que trabajan con grandes conjuntos de datos o con trabajos frecuentes. Los cinco scripts que compartimos en este artículo automatizarán tus principales tareas de fotogrametría, ahorrando tiempo, reduciendo errores y garantizando la coherencia. Tanto si estás creando ortofotos, nubes de puntos o modelos texturizados, los scripts son la clave para escalar tus flujos de trabajo 3D de forma eficiente.
Empieza poco a poco, personaliza los scripts según tus necesidades y crea tu propia biblioteca de automatización para convertirte en un usuario avanzado de Metashape en 2025.