Agisoft Metashape comprend une puissante API Python qui permet aux utilisateurs d’automatiser des tâches complexes de photogrammétrie. Que vous travailliez sur la cartographie par drone, l’architecture ou la documentation archéologique, l’utilisation de scripts dans Metashape peut vous épargner des heures de travail manuel. Dans cet article, nous allons partager cinq scripts Python prêts à l’emploi qui peuvent considérablement rationaliser votre flux de travail.
Pourquoi utiliser les scripts Python dans Metashape ?
Les scripts vous permettent de contrôler entièrement le pipeline de Metashape : traitement par lots, flux de travail personnalisés, contrôle des paramètres et intégration avec les SIG ou les plates-formes de données.
- Traitement par lots de centaines d’ensembles de données sans saisie manuelle
- Automatiser l’exportation d’orthophotos, de modèles ou de nuages de points
- Générer automatiquement des rapports ou des journaux d’erreurs
- Intégrer le stockage en nuage ou les applications externes
Comment exécuter un script dans Metashape
Allez dans Outils → Exécuter un script ou utilisez la console Python intégrée. Vous pouvez également exécuter des scripts à partir de la ligne de commande en mode headless (sans interface graphique) :
metashape.sh -r script.py
Assurez-vous que votre script importe Metashape :
import Metashape
1. Alignement automatique des photos dans un groupe
Ce script aligne les photos d’un groupe sélectionné avec une grande précision et désactive la présélection générique pour de meilleurs résultats.
import Metashape doc = Metashape.app.document chunk = doc.chunk chunk.matchPhotos(accuracy=Metashape.HighAccuracy, generic_preselection=False) chunk.alignCameras()
Facultatif : ajoutez l’optimisation de la caméra ou l’ajustement du modèle de caméra adaptatif après l’alignement.
2. Créez automatiquement un nuage et un maillage denses
chunk.buildDepthMaps(quality=Metashape.MediumQuality, filter=Metashape.AggressiveFiltering) chunk.buildDenseCloud() chunk.buildModel(surface_type=Metashape.Arbitrary, interpolation=Metashape.EnabledInterpolation)
Ce script fonctionne bien après l’alignement des photos et vous permet de gagner du temps sur les travaux longs.
3. Exporter automatiquement l’orthophoto
output_path = "C:/exports/orthophoto.tif" chunk.buildOrthomosaic(surface_data=Metashape.ModelData, blending_mode=Metashape.MosaicBlending) chunk.exportRaster(output_path, image_format=Metashape.ImageFormatTIFF)
Cet exemple exporte l’orthomosaïque sous forme de GeoTIFF. Vous pouvez ajouter des paramètres de projection en utilisant projection=
.
4. Exporter le nuage de points au format LAS
output_las = "C:/exports/dense_cloud.las" chunk.exportPoints(output_las, source_data=Metashape.DenseCloudData, format=Metashape.PointsFormatLAS)
Vous pouvez changer le format en Metashape.PointsFormatPLY
ou XYZ
en fonction de la plateforme que vous utilisez.
5. Génération automatique d’un rapport PDF
chemin_du_rapport = "C:/exports/rapport_de_projet.pdf" chunk.exportReport(chemin_du_rapport)
Il comprend les statistiques d’alignement de la caméra, les erreurs GCP et les étapes de traitement – un résultat parfait pour les clients.
Bonus : Pipeline d’automatisation complet
Pour les grands projets, combinez toutes les étapes ci-dessus en un seul script Python et exécutez Metashape en mode headless via le terminal :
metashape.sh -platform offscreen -r full_pipeline.py
Incluez la logique des chemins d’entrée/sortie et l’analyse des noms de fichiers pour créer un système de traitement par lots pour les dossiers d’images.
Où en savoir plus
- Référence officielle de l’API Python de Metashape
- Agisoft Metashape Dépôt GitHub
- Scripts communautaires sur les forums Agisoft et GIS Stack Exchange
Conclusion
Les scripts Python révèlent le véritable potentiel d’Agisoft Metashape, en particulier pour les utilisateurs qui traitent de grands ensembles de données ou qui effectuent des travaux fréquents. Les cinq scripts présentés dans cet article automatiseront vos principales tâches de photogrammétrie, ce qui vous permettra de gagner du temps, de réduire les erreurs et de garantir la cohérence. Que vous créiez des orthophotos, des nuages de points ou des modèles texturés, les scripts sont la clé d’une mise à l’échelle efficace de vos flux de travail 3D.
Commencez modestement, adaptez les scripts à vos besoins et construisez votre propre bibliothèque d’automatisation pour devenir un utilisateur puissant de Metashape en 2025.