Python (Windows)

Vous consultez actuellement la documentation pour la dernière version (2.5.4). Pour accéder à une autre version, cliquez sur le bouton "Changer de version" situé dans le coin supérieur droit de la page.

■ Si vous n’êtes pas sûr de la version du produit que vous utilisez, veuillez contacter le support technique Mech-Mind pour obtenir de l’aide.

Ce sujet explique comment obtenir et exécuter les exemples Python de Mech-Eye API sous Windows.

Liste des exemples

Les exemples sont répartis dans les catégories suivantes : basique, avancé, utilitaire et étalonnage.

  • basic exemples: Se connecter et acquérir des données.

  • advanced exemples: Acquérir des données de manière plus complexe et définir des paramètres spécifiques au modèle.

  • util exemples: Obtenir les informations de la caméra et définir des paramètres communs.

  • Calibration exemples: Effectuer l’étalonnage main-œil avec Mech-Eye API.

The samples in each category and their descriptions are provided below.

basic
  • connect_to_camera: Se connecter à une caméra.

  • connect_and_capture_images: Se connecter à une caméra et obtenir l’image 2D, la carte de profondeur et les données de nuage de points.

  • capture_2d_image: Obtenir et enregistrer l’image 2D.

  • capture_depth_map: Obtenir et enregistrer la carte de profondeur.

  • capture_point_cloud: Obtenir et enregistrer les nuages de points non texturés et texturés.

  • capture_point_cloud_hdr: Définir plusieurs temps d’exposition, puis obtenir et enregistrer le nuage de points.

  • capture_point_cloud_with_normals: Calculer les normales et enregistrer le nuage de points avec des normales.

  • save_virtual_device: Enregistrer les données acquises par la caméra en tant que fichier de périphérique virtuel.

advanced
  • convert_depth_map_to_point_cloud: Générer un nuage de points à partir de la carte de profondeur et enregistrer le nuage de points.

  • multiple_cameras_capture_sequentially: Obtenir et enregistrer des images 2D, des cartes de profondeur et des nuages de points de manière séquentielle depuis plusieurs caméras.

  • multiple_cameras_capture_simultaneously: Obtenir et enregistrer simultanément des images 2D, des cartes de profondeur et des nuages de points depuis plusieurs caméras.

  • capture_periodically: Obtenir et enregistrer périodiquement, pendant la durée spécifiée, des images 2D, des cartes de profondeur et des nuages de points depuis une caméra.

  • mapping_2d_image_to_depth_map: Générer des nuages de points non texturés et texturés à partir d’une image 2D masquée et d’une carte de profondeur.

  • render_depth_map: Obtenir et enregistrer la carte de profondeur rendue avec la palette de couleurs jet.

  • transform_point_cloud: Obtenir et enregistrer les nuages de points dans le repère personnalisé.

  • set_parameters_of_laser_cameras: Définir les paramètres spécifiques aux caméras laser (les séries DEEP et LSR).

  • set_parameters_of_uhp_cameras: Définir les paramètres spécifiques à la série UHP.

  • register_camera_event: Définir et enregistrer la fonction de rappel pour surveiller les événements de la caméra.

  • warm_up: Préchauffer l’appareil.

  • capture_stereo_2d_images: Obtenir les images 2D des deux caméras 2D de Laser L Enhanced, LSR L-GL, LSR S-GL, NANO ULTRA-GL, et DEEP-GL.

util
  • get_camera_intrinsics: Obtenir et afficher les paramètres intrinsèques de la caméra.

  • print_camera_info: Obtenir et afficher les informations de la caméra, telles que le modèle, le numéro de série, la version du firmware et les températures.

  • set_scanning_parameters: Définir les paramètres dans les catégories Paramètres 3D, Paramètres 2D et ROI.

  • set_depth_range: Définir le paramètre Plage de profondeur.

  • set_point_cloud_processing_parameters: Définir les paramètres de Traitement du nuage de points.

  • manage_user_sets: Gérer des groupes de paramètres, par exemple obtenir les noms de tous les groupes de paramètres, ajouter un groupe de paramètres, changer de groupe de paramètres et enregistrer des réglages de paramètres dans le groupe de paramètres.

  • save_and_load_user_set: Importer et remplacer tous les groupes de paramètres depuis un fichier JSON, et enregistrer tous les groupes de paramètres dans un fichier JSON.

Calibration
  • hand_eye_calibration: Effectuer l’étalonnage main-œil.

Prérequis

Pour utiliser les exemples Python de Mech-Eye API, les prérequis suivants doivent être satisfaits :

  • Assurez-vous que l’installation de Python est en 64 bits et que la version est comprise entre 3.7 et 3.11.

    Si Ajouter Python au PATH n’a pas été sélectionné lors de l’installation, veuillez ajouter les deux chemins suivants à la variable d’environnement Path :

    • xxx/AppData/Local/Programs/Python/Python3x/

    • xxx/AppData/Local/Programs/Python/Python3x/Scripts/

  • Connectez correctement le Caméra et l’ordinateur.

  • Obtenez les exemples.

  • Installez les logiciels requis.

  • (Facultatif) Installez les bibliothèques logicielles dont dépendent les exemples.

Obtenir les exemples

Les exemples Python sont inclus dans le chemin d’installation de Mech-Eye SDK ou peuvent être obtenus en clonant depuis GitHub. Les exemples dans le chemin d’installation correspondent à la version au moment de la publication de Mech-Eye SDK. La version sur GitHub peut contenir les dernières modifications.

  • Les exemples dans le chemin d’installation se trouvent dans xxx/Mech-Eye SDK-2.5.4/API/samples/python/area_scan_3d_camera.

  • Les exemples clonés depuis GitHub se trouvent dans xxx/mecheye_python_samples/area_scan_3d_camera.

Installer les logiciels requis

Pour utiliser les exemples Python de Mech-Eye API, Mech-Eye SDK et Python Mech-Eye API doivent être installés.

Installer la dernière version de Mech-Eye SDK

Veuillez installer ou mettre à niveau Mech-Eye SDK conformément à Guide d’installation de Mech-Eye SDK.

Installer la dernière version de Python Mech-Eye API

Suivez ces étapes pour installer la dernière version de Python Mech-Eye API :

  1. Appuyez sur Win + R au clavier pour ouvrir la boîte de dialogue Exécuter. Saisissez « PowerShell » puis appuyez sur Ctrl+Maj+Entrée pour exécuter PowerShell en tant qu’administrateur.

  2. Exécutez la commande suivante pour installer Python Mech-Eye API :

    pip install MechEyeAPI

(Facultatif) Installer les bibliothèques logicielles dépendantes

Certains exemples contiennent des fonctions qui dépendent d’OpenCV. Si vous devez utiliser les exemples listés dans le tableau ci-dessous, OpenCV doit être installé (version la plus récente recommandée).

  • capture_2d_image

  • capture_depth_map

  • multiple_cameras_capture_sequentially

  • multiple_cameras_capture_simultaneously

  • capture_periodically

  • capture_stereo_2d_images

  • render_depth_map

Exécutez la commande suivante pour installer la dernière version d’OpenCV :

pip install opencv-python

Exécuter les exemples

Les chemins fournis dans cette section correspondent aux exemples inclus dans le chemin d’installation. Si vous utilisez les exemples clonés depuis GitHub, veuillez modifier les chemins en conséquence.

Suivez ces étapes pour exécuter les exemples :

  1. Accédez au dossier où se trouve un exemple. Remplacez category par le nom de catégorie de l’exemple.

    cd xxx/Mech-Eye SDK-2.5.4/API/samples/python/area_scan_3d_camera/category
  2. Exécutez l’exemple : remplacez sample_name par le nom de l’exemple. Pendant l’exécution, saisissez l’index du Caméra auquel vous souhaitez vous connecter selon les instructions, puis appuyez sur Entrée pour vous connecter au Caméra.

    python sample_name.py
  3. Si des fichiers image et/ou de nuage de points sont sauvegardés par l’exemple, vous trouverez ces fichiers dans le dossier où se trouve l’exemple.

Cette page est-elle utile ?

Veuillez nous indiquer comment améliorer :

Nous accordons de l’importance à votre vie privée

Nous utilisons des cookies pour vous offrir la meilleure expérience possible sur notre site web. En continuant à utiliser le site, vous reconnaissez accepter l’utilisation des cookies. Si vous refusez, un cookie unique sera utilisé pour garantir que vous ne soyez pas suivi ou reconnu lors de votre visite sur ce site.