Differences

This shows you the differences between two versions of the page.

--- doc:user:tutorials:installation [2014/05/07 12:21] – boman
+++ doc:user:tutorials:installation [2017/10/25 10:06] – boman
@@ Line 1: / Line 1: @@
-====== Installer Metafor ======
+====== How to install Metafor? ======
-===== En vidéo =====
+===== Video =====
-Une petite video pour vous éviter de lire la suite de cette page...
+This video shows how to install Metafor on a PC running Windows.
 <html>
@@ Line 9: / Line 9: @@
 </html>
+===== Download the installer =====
-===== Installation de python =====
-Metafor fonctionne avec Python ([[http://www.python.org/|site officiel]]), qui est fourni automatiquement et n'a donc pas besoin d'être installé séparément.
+Installers are available for Windows, Linux and macOS on this website: [[teaching:private:start|]]
-===== Installer Metafor =====
-Sous Windows, il suffit d'utiliser l'installeur.
+{{ :doc:user:tutorials:padlock.jpg?nolink&200|}}
+===== Step-by-step Procedure =====
-{{ doc:user:install_metafor.jpg |}}
+  * Run the installer and follow the instructions.
+  * Install the Visual 2015 C++ runtime libraries if they are not present on your system.
+  * Run Metafor (desktop link).
+  * Click on the padlock in order to import the license file (''metafor.lic'').
+  * Restart Metafor.
-A la fin de l'installation, il est possible d'installer le runtime Visual C++ 2012 de Microsoft (à installer si vous ne savez pas de quoi il s'agit).
+===== Where is Metafor? =====
-Sous Linux/Unix, il suffit de décomprimer un tarball.
+By default, all the files are located in ''C:\Program Files\Metafor''
+{{ :doc:user:tutorials:what_is_installed.jpg?nolink&200|}}
-===== Licence =====
+===== What is installed? =====
-Metafor nécessite une licence d'utilisation (fichier ''metafor.lic'' à placer dans le répertoire de l'utilisateur - ''C:\Users\NomUtilisateur'' sous Windows 7/8 ou ''C:\Documents and Settings\NomUtilisateur'' sous XP, répertoire ''~'' sous Linux). Le programme d'installation copie une licence "démo" de 500 noeuds maximum si aucune licence n'existe.
+Have a quick look at the files installed in ''C:\Program Files\Metafor''.
-Pour demander une licence, il est nécessaire de connaitre l'adresse MAC de la machine sur laquelle Metafor va tourner. Le plus simple est de supprimer le fichier ''metafor.lic'' et de lancer l'interface graphique.
+  * ''Metafor'': Binary files (*.exe, *.dll, etc.).
+  * ''.../apps'': Lots of examples (input files).
+  * ''.../metafor.ltas.ulg.ac.be'': Offline documentation (html files).
+  * ''.../python'': Local installation of python.
+  * ''.../toolbox'': Python toolbox of Metafor.
+  * ''.../wrap'': Python/C++ interface.
-{{ doc:user:getmac.png |}}
-Il suffit alors de communiquer au LTAS-MN²L les adresses mentionnées dans la fenêtre ci-dessus. Et d'utiliser ensuite la fonction "Import..." de la boîte de dialogue.
-Enfin, il faut redémarrer Metafor pour que le programme puisse relire le nouveau fichier de licence.
-===== Les fichiers de Metafor =====
-Lorsqu'on installe Metafor sur son ordinateur, plusieurs répertoires sont créés :
-{{ doc:user:fichiersinstall.png |doc:user:fichiersinstall.png }}
-    * **doc** : un snapshot de la doc en ligne (ces pages) figées et offline pour la version installée.
-    * **oo_meta** : ce répertoire contient Metafor et ses fichiers (décrits ci-dessous)
-    * **redist** : l'installeur des runtimes VC++ 2012 (au cas où vous n'auriez pas coché la case dans l'installeur)
-L'exécutable de Metafor (''Metafor.exe'' ainsi que les [[doc:user:general:glossaire#DLL|DLLs]] utiles sont dans ''oo_meta''. Les 3 sous-répertoires correspondent à des "[[doc:user:general:glossaire#module|modules]]" Python (concept python similaire à des packages java ou, plus généralement à des bibliothèques).
-    * **oo_meta/apps** : contient la [[doc:user:general:glossaire#batterie|batterie de tests]]. C'est un ensemble de fichiers Python, triés dans une arborescence de répertoires. Chaque fichier correspond à un [[doc:user:general:glossaire#cas-test]] (et chaque cas-test est donc un [[doc:user:general:glossaire#module]] Python).
-    * **oo_meta/toolbox** : contient des modules Python définissant des fonctions utiles pour définir un cas-test. Par exemple, la création d'un cube, la définition de matériaux, de fixations, ... Le répertoire ''toolbox'' contient un module nommé ''utilities'' qui contient les fonctions principales pour faire appel à Metafor (fonction ''meta'' (lancer un calcul), ''vizu'' (visualiser un maillage), ''restart'' (continuer un calcul), etc.
-    * **oo_meta/wrap** : contient les modules du "wrapper" (ensemble de modules définissant sous Python les classes de Metafor - les "shadow classes"). Ces modules font la liaison entre Python et le code [[doc:user:general:glossaire#C++]] compilé dans Metafor. L'utilisateur n'a jamais besoin de regarder ces fichiers.
-\\
-\\
-Metafor est installé, il faut maintenant vérifier que tout fonctionne bien.
-⇒ [[doc:user:tutorials:premiertest]]
-\\