Dernière modification : 26 avril 2022.
Veuillez lire ce fichier attentivement avant d'entreprendre toute installation.
La procédure d'installation a été testée pour Cygwin (PC sous Windows, voir ci-après), GNU/Linux et MacOSX.
LSD est écrit en C ANSI et devrait être portable sur un grand nombre de plates-formes Unix.
LSD-3.5.2 a été développé dans un environnement Unix. Toutefois, les utilisateurs de PC sous Windows peuvent utiliser LSD en installant l'environnement Cygwin, destiné à fournir sous Windows un sous-ensemble important des fonctionnalités d'Unix. Alternativement, il est possible d'utiliser une distribution binaire, LSDos, qui correspond à LSD pour DOS. Une documentation spécifique est incluse.
Cygwin est téléchargeable depuis www.cygwin.com.
L'utilisation de Ghostview sous Windows est nécessaire pour visualiser les fichiers Postscript contenant les solutions fournies par LSD. Il est possible de s'en passer en éditant le fichier solve. Ghostview (gv) est téléchargeable à www.cs.wisc.edu/~ghost. Il faut aussi télécharger à partir du même site Ghostscript (gs). L'installation de ces 2 logiciels (gs puis gv) se fera de préférence aux endroits proposés par défaut.
L'installation de Cygwin est décrite en détail sur www.gammon.com.au/smaug/installingcygwin.htm, par exemple, mais à d'autres endroits aussi. Les paquets "gcc-g++" et "make" sont les seuls qui doivent être installés. D'autres paquets seront installés automatiquement.
Un double-clic sur l'icône de cygwin fait apparaître une fenêtre de commande DOS (avec un fond noir) dans laquelle il est possible de taper des commandes Unix. C'est de là que vous pourrez lancer LSD, une fois installé. Selon la terminologie Unix, une fenêtre de commande s'appelle aussi "fenêtre de shell", voire "shell" tout simplement.
Si vous voulez quitter (détruire) une fenêtre de commande, entrez Contrôle-D (une fois pour la fenêtre créée par rxvt, une seconde fois pour la fenêtre DOS).
Dans le cas où vous ne seriez familiarisé ni avec Cygwin ni même avec Unix, les points suivants vous seront probablement utiles.
La racine du système de fichiers de Cygwin se note "/" et se confond avec C:\cygwin64 pour Windows. "/" est pour cygwin le point à partir duquel tous les fichiers de la machine sont accessibles.
Votre dossier personnel (appelé "home") est l'endroit où vous rangerez vos propres programmes et documents, comme "C:\Users\MonNom\Documents" pour Windows. Avant de pouvoir entrer une commande dans une fenêtre, vous obtenez dedans quelque chose comme MonNom@MonPC (écrit en vert) où MonPC est le nom de l'ordinateur et MonNom votre nom d'utilisateur. Votre dossier personnel s'appelle /home/MonNom pour Cygwin, et donc C:\cygwin64\home\MonNom pour Windows. Un synonyme pour le nom de ce dossier est "~", comme cela est visible en jaune dans les fenêtres de commande ainsi que sur leur barre de titre.
Votre dossier personnel est l'endroit où il faut copier le fichier LSD-3.5.2.tar.gz avant de le décompacter (ne décompactez pas maintenant) et de procéder à l'installation de LSD proprement dite (voir ci-après).
Il est fortement recommandé de modifier dans le dossier personnel un fichier nommé ".bash_profile". Ajoutez-y à la fin la ligne "export PATH=.:$PATH" (sans les guillemets). Quittez la fenêtre de commande puis réouvrez en une neuve pour que ce qui vient d'être fait soit pris en compte. La commande qui a été mise dans le fichier .bash_profile va faire en sorte que le dossier courant soit toujours dans la liste des dossiers où sont répertoriés les programmes exécutables. Cette liste est définie par le paramètre $PATH de l'interpréteur de commandes.
Lorque vous ouvrez une fenêtre de commande, le dossier courant sera votre dossier personnel (d'où le ~ dans la barre de titre, laquelle affiche toujours le nom du dossier courant). Pour changer de dossier courant entrez la commande "cd" suivie d'un espace, suivi du nom du dossier que l'on veut atteindre, suivi de la touche "Entrée". S'il s'agit d'un sous-dossier du dossier courant, son nom suffit. S'il s'agit du dossier parent, son nom est toujours "..". Il est aussi possible d'utiliser un nom "absolu", commançant par / et suivi de la suite des noms des dossiers imbriqués, séparés par des /. Par exemple "cd /home/MyName" fait du dossier personnel le dossier courant. La commande "cd" sans argument vous replace aussi dans votre dossier personnel.
Le nom du dossier courant est toujours "." quel qu'il soit. Pour connaître son contenu complet il suffit de rentrer la commande "ls -a" (ou de regarder avec l'Explorateur Windows). Si vous n'avez pas modifié de fichier ".bash_profile", il faudra taper "./lsd" au lieu de "lsd" (de même pour outlsd et genpos), pour signifier que le programme à exécuter se trouve dans le dossier courant.
Le site Web de Cygwin contient une description détaillée du logiciel et une abondante documentation.
Si ce n'est déjà fait, faites du dossier qui contient LSD-3.5.2.tar.gz le dossier courant, et entrez les commandes suivantes :
1. Décompactez :
gunzip LSD-3.5.2.tar.gz
tar xvf LSD-3.5.2.tar
2. Changez de dossier courant
cd LSD-3.5.2
3. Configurez et compilez
sh install.sh
4. Testez
make test
Vous devriez voir la structure de la molécule de pinène. Si le test échoue mais après une installation correcte (étape 3 sans erreur), il est probable que l'interpréteur Postscript ne soit pas installé ou soit inaccessible par le fichier de script nommé "solve". Pour résoudre le problème, il convient d'éditer ce fichier et de corriger le chemin d'accès à l'interpréteur Postscript.
Le programme LSD est lancé par la commande "lsd". Au moins pour certaines versions de Linux "lsd" est un alias de la commande "ls -d". Taper "lsd" donne alors la liste des dossiers contenus dans le dossier courant. Cela peut être changé provisoirement par la commande "unalias lsd" ou de manière permanente en modifiant le fichier de démarrage qui contient les définitions des alias.
Il faut utiliser un compilateur pour créer les fichiers
exécutables à partir des fichiers sources écrits en langage C.
Pour Cygwin et GNU/Linux, gcc est le compilateur C par défaut
et est inclus dans la distribution de ces systèmes d'exploitation
(sous réserve de l'installation initiale des outils de
développement).
Pour MacOSX, il faut disposer de l'environnement
de développement Apple pour utiliser le compilateur gcc.
Le fichier Makefile qui est copié dans le dossier LSD-3.5.2permet de compiler les sources par la commande "make fromSrc".
Ce type de programme est nécessaire pour visualiser et imprimer les solutions fournies par lsd. Le fichier texte produit par lsd est traduit sous divers formats graphiques par le programme outlsd. Un de ces formats est traduisible en langage Postscript par le programme genpos à des fins de visualisation et d'impression.
Avec Cygwin, vous utiliserez gsview64.exe pour Windows, installé par la procédure décrite dans la note aux utilisateurs de PC sous Windows (ci-dessus). Sous MacOSX et Linux open et evince sont respectivement les interpréteurs généralement disponibles.
M_edit est une sorte d'éditeur de structure chimique très simplifié. Il est là pour embellir les horribles dessins qu'outlsd est parfois capable de produire. Il est écrit en langage Tcl et utilise la boîte à outil Tk pour la partie graphique. Tcl/Tk est lancé par la commande "wish", qui signifie "windowing shell".
m_edit utilise les commandes tk_getOpenFile et tk_getSaveFile qui ne sont apparues qu'avec la version 8.0 de Tk. Vous devez donc utiliser celle-là ou une version ultérieure.
Wish fait partie des distributions de Cygwin et de GNU/Linux, respectivement sous les noms de cygwish8x.exe et wish8.x (x = numéro de version). Sous GNU/Linux, il est commode d'établir un lien symbolique entre wish8.x et wish avec la commande "ln -s /usr/bin/wish8.x /usr/bin/wish", si ce n'est pas déjà fait. Il est aussi possible d'éditer le script m_edit pour qu'il invoque correctement wish.
Pour MacOSX, Tcl/Tk est déjà là.
Solve est un petit script qui lance successivement lsd pour résoudre un problème de structure, outlsd pour la création des dessins de molécules, genpos pour leur traduction en Postscript et l'interpréteur Postscript pour leur visualisation. Solve est lancé lorsque vous tapez "make test" (étape 4 de l'installation). Si vous obtenez le résultat souhaité (la structure du pinène), l'installation est terminée et vous pouvez commencer à apprendre comment écrire des fichiers de données pour LSD en lisant MANUAL_FR.html.
Copyright(C)2000 CNRS-UMR 7312-Jean-Marc Nuzillard