Agisoft Metashape Python Scripting: 5 Ready-to-Use Automation Scripts to Speed Up Your Workflow
News

Agisoft Metashape Python Scripting: 5 script di automazione pronti all’uso per velocizzare il tuo flusso di lavoro

Pubblicato il da admin

Agisoft Metashape include una potente API Python che consente agli utenti di automatizzare complesse attività di fotogrammetria. Che tu stia lavorando alla mappatura con il drone, all’architettura o alla documentazione archeologica, gli script di Metashape possono farti risparmiare ore di clic manuali. In questo articolo condivideremo cinque script Python pronti all’uso che possono semplificare notevolmente il tuo flusso di lavoro.

Perché usare lo scripting Python in Metashape?

Lo scripting ti permette di avere il pieno controllo sulla pipeline di Metashape: elaborazione in batch, flussi di lavoro personalizzati, controllo dei parametri e integrazione con piattaforme GIS o di dati.

  • Elabora in batch centinaia di set di dati senza bisogno di input manuali
  • Automatizzare l’esportazione di ortofoto, modelli o nuvole di punti
  • Genera automaticamente rapporti o registri di errori
  • Integrazione con cloud storage o app esterne

Come eseguire uno script in Metashape

Vai su Strumenti → Esegui script o utilizza la console Python integrata. Puoi anche eseguire gli script dalla riga di comando in modalità headless (senza interfaccia grafica):

metashape.sh -r script.py

Assicurati che il tuo script importi Metashape:

importare Metashape

1. Allinea automaticamente le foto in un pezzo

Questo script allinea le foto in un gruppo selezionato utilizzando un’elevata precisione e disabilitando la preselezione generica per ottenere risultati migliori.

import Metashape
doc = Metashape.app.document
chunk = doc.chunk
chunk.matchPhotos(accuracy=Metashape.HighAccuracy, generic_preselection=False)
chunk.alignCameras()

Opzionale: aggiungi l’ottimizzazione della telecamera o l’adattamento del modello della telecamera dopo l’allineamento.

2. Costruisce automaticamente una nuvola densa e una rete

chunk.buildDepthMaps(quality=Metashape.MediumQuality, filter=Metashape.AggressiveFiltering)
chunk.buildDenseCloud()
chunk.buildModel(surface_type=Metashape.Arbitrary, interpolation=Metashape.EnabledInterpolation)

Questo script funziona bene dopo l’allineamento delle foto e ti fa risparmiare tempo nei lavori più lunghi.

3. Esportazione automatica dell’ortofoto

output_path = "C:/exports/orthophoto.tif"
chunk.buildOrthomosaic(surface_data=Metashape.ModelData, blending_mode=Metashape.MosaicBlending)
chunk.exportRaster(output_path, image_format=Metashape.ImageFormatTIFF)

Questo esempio esporta l’ortomosaico come GeoTIFF. Puoi aggiungere parametri di proiezione utilizzando projection=.

4. Esportazione della nuvola di punti in formato LAS

output_las = "C:/exports/dense_cloud.las"
chunk.exportPoints(output_las, source_data=Metashape.DenseCloudData, format=Metashape.PointsFormatLAS)

Puoi cambiare il formato in Metashape.PointsFormatPLY o XYZ a seconda della piattaforma che stai utilizzando.

5. Generazione automatica di un rapporto PDF

report_path = "C:/exports/project_report.pdf"
chunk.exportReport(report_path)

Include le statistiche di allineamento della telecamera, gli errori GCP e le fasi di elaborazione: un documento perfetto per i clienti.

Bonus: Pipeline di automazione completa

Per progetti di grandi dimensioni, combina tutti i passaggi precedenti in un unico script Python ed esegui Metashape in modalità headless tramite terminale:

metashape.sh -platform offscreen -r full_pipeline.py

Include la logica dei percorsi di input/output e l’analisi dei nomi dei file per creare un sistema di elaborazione batch per le cartelle di immagini.

Dove saperne di più

Conclusione

Gli script Python sbloccano il vero potenziale di Agisoft Metashape, soprattutto per gli utenti che hanno a che fare con grandi set di dati o lavori frequenti. I cinque script condivisi in questo articolo automatizzeranno le tue attività principali di fotogrammetria, facendoti risparmiare tempo, riducendo gli errori e garantendo la coerenza. Che tu stia creando ortofoto, nuvole di punti o modelli texturizzati, lo scripting è la chiave per scalare i tuoi flussi di lavoro 3D in modo efficiente.

Inizia con poco, personalizza gli script in base alle tue esigenze e costruisci la tua libreria di automazione per diventare un utente potente di Metashape nel 2025.