{"id":29585,"date":"2026-08-31T00:17:28","date_gmt":"2026-08-30T22:17:28","guid":{"rendered":"https:\/\/www.heliotis.com\/tutorials2\/premiers-pas-avec-la-helialgo-library\/"},"modified":"2026-08-31T10:25:31","modified_gmt":"2026-08-31T08:25:31","slug":"premiers-pas-avec-la-helialgo-library","status":"publish","type":"tutorial","link":"https:\/\/www.heliotis.com\/fr\/tutorial\/premiers-pas-avec-la-helialgo-library\/","title":{"rendered":"Premiers pas avec la heliAlgo Library"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\">R\u00e9sum\u00e9<\/h2>\n\n<p class=\"wp-block-paragraph\">La <strong>heliAlgo Library<\/strong> \u00e9tend les logiciels de vision industrielle classiques avec des algorithmes sp\u00e9cialis\u00e9s pour le traitement des donn\u00e9es de mesure 3D Heliotis. Beaucoup de ces algorithmes utilisent des connaissances sp\u00e9cifiques sur les principes de mesure et les donn\u00e9es d&rsquo;Heliotis, et sont \u00e9galement utilis\u00e9s en interne dans les logiciels de r\u00e9f\u00e9rence et de production d&rsquo;Heliotis.<\/p>\n\n<p class=\"wp-block-paragraph\">heliAlgo n&rsquo;est pas con\u00e7u pour remplacer les biblioth\u00e8ques de vision industrielle existantes, mais pour les compl\u00e9ter. Les algorithmes peuvent \u00eatre combin\u00e9s avec HALCON, OpenCV, des algorithmes propri\u00e9taires ou d&rsquo;autres composants d&rsquo;une application de vision industrielle existante.<\/p>\n\n<p class=\"wp-block-paragraph\">Des bindings sont disponibles pour <strong>C\/C++, CLR (C#, LabVIEW), Python, Rust, HALCON et Aurora Vision<\/strong>. Les m\u00eames algorithmes de base sont utilis\u00e9s, quelle que soit l&rsquo;interface de programmation.<\/p>\n\n<p class=\"wp-block-paragraph\">Les packages standard de la heliAlgo Library sont <strong>disponibles gratuitement<\/strong>. Seul le package <strong>ISO Roughness<\/strong>, pour le calcul des param\u00e8tres de surface conformes aux normes, n\u00e9cessite une licence suppl\u00e9mentaire.<\/p>\n\n<figure class=\"wp-block-video\"><video height=\"1080\" style=\"aspect-ratio: 1920 \/ 1080;\" width=\"1920\" controls=\"\" poster=\"https:\/\/www.heliotis.com\/wp-content\/uploads\/2026\/08\/heliAlgo_tutorial.webp\" src=\"https:\/\/www.heliotis.com\/wp-content\/uploads\/2026\/08\/heliAlgo-intro_1.mp4\"><\/video><\/figure>\n\n<div style=\"height:50px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n<h1 class=\"wp-block-heading\">Guide rapide<\/h1>\n\n<h3 class=\"wp-block-heading\">1. T\u00e9l\u00e9charger et installer heliAlgo<\/h3>\n\n<p class=\"wp-block-paragraph\">La version actuelle de la heliAlgo Library peut \u00eatre t\u00e9l\u00e9charg\u00e9e dans la section de t\u00e9l\u00e9chargement de logiciels d&rsquo;Heliotis. Des installateurs sont disponibles pour <strong>Windows et Linux<\/strong>. Un identifiant Heliotis est requis pour le t\u00e9l\u00e9chargement.<\/p>\n\n<p class=\"wp-block-paragraph\">Dans l&rsquo;installateur, les packages d&rsquo;algorithmes et les interfaces de programmation n\u00e9cessaires peuvent \u00eatre s\u00e9lectionn\u00e9s. Dans la plupart des cas, nous recommandons l&rsquo;installation de la biblioth\u00e8que compl\u00e8te. La documentation locale et les exemples de programmation sont \u00e9galement install\u00e9s.<\/p>\n\n<h3 class=\"wp-block-heading\">2. Packages d&rsquo;algorithmes<\/h3>\n\n<p class=\"wp-block-paragraph\">heliAlgo est structur\u00e9 en packages fonctionnels pour diff\u00e9rentes t\u00e2ches de traitement :<\/p>\n\n<ul class=\"wp-block-list\">\n<li><strong>C4 Algos<\/strong> \u2013 Algorithmes sp\u00e9cifiquement pour les donn\u00e9es heliCam C4<\/li>\n\n\n\n<li><strong>Calibration<\/strong> \u2013 Calibrage, correction et assemblage (stitching)<\/li>\n\n\n\n<li><strong>Data Cleaning<\/strong> \u2013 y compris la suppression des valeurs aberrantes et l&rsquo;ajustement polynomial<\/li>\n\n\n\n<li><strong>Surface Algorithms<\/strong> \u2013 Traitement des donn\u00e9es de surface et de phase, y compris le d\u00e9ballage de phase guid\u00e9 (Guided Phase Unwrapping)<\/li>\n\n\n\n<li><strong>System Checks<\/strong> \u2013 Caract\u00e9risation des syst\u00e8mes optiques, par exemple l&rsquo;analyse de la mise au point et de la MTF<\/li>\n\n\n\n<li><strong>ISO Roughness<\/strong> \u2013 Param\u00e8tres de surface conformes aux normes<\/li>\n\n\n\n<li><strong>Utilities<\/strong> \u2013 Fonctions utilitaires suppl\u00e9mentaires<\/li>\n\n\n\n<li><strong>Experimental<\/strong> \u2013 Algorithmes d\u00e9j\u00e0 utilisables dont l&rsquo;API peut encore changer dans les futures versions<\/li>\n<\/ul>\n\n<p class=\"wp-block-paragraph\">La structure de r\u00e9pertoires de l&rsquo;installation refl\u00e8te ces packages fonctionnels et contient en outre les bindings s\u00e9lectionn\u00e9s, la documentation et les exemples.<\/p>\n\n<h3 class=\"wp-block-heading\">3. Utilisation de la documentation<\/h3>\n\n<p class=\"wp-block-paragraph\">Chaque package d&rsquo;algorithmes contient une documentation locale d\u00e9taill\u00e9e. Sous <strong>Background Information<\/strong>, le fonctionnement et l&rsquo;utilisation de l&rsquo;algorithme respectif, ainsi que les conditions limites et les restrictions pertinentes, sont d\u00e9crits.<\/p>\n\n<p class=\"wp-block-paragraph\">Des sections s\u00e9par\u00e9es documentent les interfaces pour les diff\u00e9rents environnements de programmation avec leurs fonctions et param\u00e8tres respectifs. La documentation est donc un bon point de d\u00e9part pour l&rsquo;int\u00e9gration d&rsquo;un algorithme heliAlgo dans une application existante.<\/p>\n\n<h3 class=\"wp-block-heading\">4. Int\u00e9grer heliAlgo dans votre propre application<\/h3>\n\n<p class=\"wp-block-paragraph\">Des bindings sont disponibles pour les environnements de programmation suivants :<\/p>\n\n<p class=\"wp-block-paragraph\"><strong>C\/C++ \u00b7 CLR (C#, LabVIEW) \u00b7 Python \u00b7 Rust \u00b7 HALCON \u00b7 Aurora Vision<\/strong><\/p>\n\n<p class=\"wp-block-paragraph\">Seule l&rsquo;interface de programmation diff\u00e8re. Les algorithmes heliAlgo sous-jacents restent identiques et peuvent donc \u00eatre utilis\u00e9s dans diff\u00e9rents environnements de vision industrielle.<\/p>\n\n<h3 class=\"wp-block-heading\">5. Exemple : D\u00e9ballage de phase guid\u00e9 (Guided Phase Unwrapping) avec Python<\/h3>\n\n<p class=\"wp-block-paragraph\">Le tutoriel montre une cha\u00eene de traitement simple avec le <strong>d\u00e9ballage de phase guid\u00e9 (Guided Phase Unwrapping)<\/strong> du package Surface Algorithms et l&rsquo;<strong>ajustement polynomial (Polynomial Fit)<\/strong> de Data Cleaning.<\/p>\n\n<p class=\"wp-block-paragraph\">Le point de d\u00e9part est une image de phase envelopp\u00e9e et l&rsquo;image d&rsquo;amplitude associ\u00e9e. Le d\u00e9ballage de phase guid\u00e9 utilise les deux donn\u00e9es d&rsquo;entr\u00e9e. L&rsquo;amplitude fournit des informations sur la qualit\u00e9 de la mesure et aide l&rsquo;algorithme \u00e0 choisir un chemin appropri\u00e9 pour le d\u00e9ballage de phase. Cela r\u00e9duit le risque que des erreurs de phase locales se propagent sur de plus grandes zones de la surface.<\/p>\n\n<p class=\"wp-block-paragraph\">Ensuite, le plan de r\u00e9f\u00e9rence est supprim\u00e9 \u00e0 l&rsquo;aide d&rsquo;un <strong>ajustement polynomial de premier ordre<\/strong>. Dans la derni\u00e8re \u00e9tape, les valeurs de phase sont converties de radians en une hauteur de surface physique, en tenant compte de la longueur d&rsquo;onde de mesure.<\/p>\n\n<p class=\"wp-block-paragraph\">Le r\u00e9sultat peut \u00eatre affich\u00e9 sous forme de carte de hauteur 2D ou trait\u00e9 ult\u00e9rieurement dans l&rsquo;application de vision industrielle.<\/p>\n\n<h3 class=\"wp-block-heading\">6. Licences<\/h3>\n\n<p class=\"wp-block-paragraph\">Les fonctions standard de la heliAlgo Library sont <strong>disponibles gratuitement<\/strong> ; la licence standard correspondante est incluse dans l&rsquo;installation.<\/p>\n\n<p class=\"wp-block-paragraph\">Pour le package <strong>ISO Roughness<\/strong>, une licence suppl\u00e9mentaire est requise. L&rsquo;<strong>outil d&rsquo;identification mat\u00e9rielle (Hardware ID Tool)<\/strong> fourni permet de d\u00e9terminer l&rsquo;ID mat\u00e9riel du PC cible. Heliotis peut alors fournir le fichier de licence correspondant. Alternativement, la licence peut \u00eatre li\u00e9e \u00e0 un dongle HALCON si n\u00e9cessaire.<\/p>\n\n<p class=\"wp-block-paragraph\">Lors d&rsquo;une mise \u00e0 jour d&rsquo;heliAlgo, un fichier de licence existant est automatiquement d\u00e9tect\u00e9 et conserv\u00e9.<\/p>\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"excerpt":{"rendered":"<p>La heliAlgo Library fournit des algorithmes pr\u00eats \u00e0 l&#8217;emploi pour le traitement des donn\u00e9es de mesure 3D Heliotis. Ce tutoriel donne un aper\u00e7u des packages d&rsquo;algorithmes disponibles, de l&rsquo;installation et des interfaces de programmation, et montre l&rsquo;int\u00e9gration \u00e0 l&rsquo;aide d&rsquo;un exemple Python simple.<\/p>\n","protected":false},"author":4,"featured_media":29586,"template":"","wpdmcategory":[],"wpdmtag":[],"measurement_type":[],"application_area":[],"class_list":["post-29585","tutorial","type-tutorial","status-publish","has-post-thumbnail","hentry"],"_links":{"self":[{"href":"https:\/\/www.heliotis.com\/fr\/wp-json\/wp\/v2\/tutorial\/29585","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.heliotis.com\/fr\/wp-json\/wp\/v2\/tutorial"}],"about":[{"href":"https:\/\/www.heliotis.com\/fr\/wp-json\/wp\/v2\/types\/tutorial"}],"author":[{"embeddable":true,"href":"https:\/\/www.heliotis.com\/fr\/wp-json\/wp\/v2\/users\/4"}],"version-history":[{"count":2,"href":"https:\/\/www.heliotis.com\/fr\/wp-json\/wp\/v2\/tutorial\/29585\/revisions"}],"predecessor-version":[{"id":29605,"href":"https:\/\/www.heliotis.com\/fr\/wp-json\/wp\/v2\/tutorial\/29585\/revisions\/29605"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.heliotis.com\/fr\/wp-json\/wp\/v2\/media\/29586"}],"wp:attachment":[{"href":"https:\/\/www.heliotis.com\/fr\/wp-json\/wp\/v2\/media?parent=29585"}],"wp:term":[{"taxonomy":"wpdmcategory","embeddable":true,"href":"https:\/\/www.heliotis.com\/fr\/wp-json\/wp\/v2\/wpdmcategory?post=29585"},{"taxonomy":"wpdmtag","embeddable":true,"href":"https:\/\/www.heliotis.com\/fr\/wp-json\/wp\/v2\/wpdmtag?post=29585"},{"taxonomy":"measurement_type","embeddable":true,"href":"https:\/\/www.heliotis.com\/fr\/wp-json\/wp\/v2\/measurement_type?post=29585"},{"taxonomy":"application_area","embeddable":true,"href":"https:\/\/www.heliotis.com\/fr\/wp-json\/wp\/v2\/application_area?post=29585"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}