Metafor

Pour compiler/executer Metafor, il est nécessaire de disposer

• d'un compilateur (Visual Studio 2017)
• du gestionnaire de source Subversion (SVN)
• du gestionnaire de source git
• d'un ensemble d'outils de compilation/programmes/librairies:
  • CMake : générateur de projet
  • SWIG : interface c++/python
  • Python : interface utilisateur de Metafor
  • Intel TBB : librairie template de parallélisation C++
  • Intel MKL : librairie mathématique (BLAS & solveur linéaire)
  • VTK : librairie de dessin 3D (interface graphique)
  • Qt : librairie de gestion de menu/boutons (interface graphique)
  • …

A l'exception du compilateur (VS2017), des gestionaires de sources (SVN, git), et des outils de post-traitement numériques (Matlab, scilab), tous ces outils/librairies sont pré-compilés pour vous et packagés dans une archive téléchargeable sur le FTP du service (/ftp/metafor/bin/VS2017Python3_X64/)

Pour exécuter la batterie de test de Metafor, Matlab sera lui aussi nécessaire pour valider certains post-traitements. Le chemin d'accès de l'exécutable ('matlab.exe') doit aussi se trouver dans le path.

Le compilateur par défaut actuellement utilisé pour développer Metafor sous Windows est le Visual Studio 2017 (numéro de version interne : vs 15.0).

La première étape est donc de l'installer (téléchargez l'iso sur le ftp /ftpDisk/apps/_dev/Visual Studio 2012/Visual_Studio_Pro_2012_Eng.ISO) en version anglaise (la gestion des codes d'erreur est buggée en français). Seul le compilateur C++ et les “Microsoft Fundation Classes for C++” sont indispensables.

La deuxième étape est d'appliquer le dernier service pack (/ftpDisk/apps/_dev/Visual Studio 2012/VS2012.5.iso) pour que le compilateur soit à jour.

Enfin, afin d'uniformiser l'écriture du code, l'éditeur doit être configuré pour insérer 4 espace en lieu et place de la tabulation : Tools → Options → Text Editor → All Languages → Tabs ⇒ remplacer “keep tabs” par “Insert Spaces” et “Tab size” = 4

Les sources Metafor étant gérées par un serveur SVN, il est nécessaire d'installer un client SVN pour pouvoir y accéder.

Tortoise SVN est le client windows généralement utilisé au service. Télécharger et installer la dernière version de la branche 1.8 (pour faciliter vos futurs commits).

ATTENTION :

• le “command line client tools” n'est pas sélectionné par défaut par l'installeur mais indispensable pour compiler Metafor ⇒ séléctionnez le
• pour éviter d'envoyer des crasses sur les serveurs svn, il est important de configurer correctement son client svn … svnConfig dès maintenant

Certains modules de Metafor sont aussi gérées par un serveur Git, il est nécessaire d'installer un client Git pour pouvoir y accéder.

Tortoise GIT est le client windows généralement utilisé au service. Téléchargez le du net et installez la dernière version.

ATTENTION :

• pour éviter d'envoyer des crasses sur les serveurs git, il est important de configurer correctement son client … Utiliser git dès maintenant

Metafor nécessite une volée de libs (par exemple Python, Qt, VTK, Swig, TCL/TK…) qu'il faut compiler. La solution simple consiste à reprendre les “libs de Luc”:

• Récupérer l'archive sur le ftp dernière archive :/ftpDisk/metafor/bin/VS2012_X64/LibsVs2012-XXXXXX.zip
• Vérifier que vous n'avez pas d'ancienne libs ou de python installés sur votre machine
• Définir un répertoire racine de vos développements (E:\Dev) sur un disque ayant quelques Gb disponibles
• Dézipper l'archive sur votre PC (E:\Dev\LibsVS2012)
• Lire le fichier E:\Dev\LibsVs2012/README.txt
• Ouvrir une fenetre de commande EN MODE ADMINISTRATEUR (Start → execute → cmd : “as administrator”!!!)
• Installer les Libs : executer la commande suivante:
  • “E:\Dev64\LibsVs2012\Python-XXXXX\bin\python E:\Dev64\LibsVs2012\setup.py install”
  • remplacer xxxx par le numero de la version de python dans les Libs
• rebooter votre pc pour recharger la base de registre

Une série de programmes complémentaires peuvent être installés pour améliorer votre expérience de programmation :

• Productivity Power Tools 2012 : Boite à outil du visual studio permettant entre autre d'imprimer le code en couleur (configurer les outils utils pour votre usage)
• Incredibuild: compilation partagée sur le réseau
  • télécharger la dernière version sur le ftp : /ftpDisk/apps/_dev/Incredibuild/
  • installer en tant que “Agent”
  • coordinateur : Metafor.ltas.ulg.ac.be (effectuer le test pour ouvrir les firewalls)
  • installer les “Add-In” pour le Visual Studio 2012
• Araxis Merge: diffs entre fichiers
  • Utilisation de Araxis Merge avec TortoiseSVN :

• Notepad++: editeur de texte
• Editpad Pro: éditeur texte
• PowerGrep: search/replace dans le source
• …