Scripts

RasTop accepte toutes les commandes de Rasmol. Il exécute, a priori, tous les scripts .scr.
Pour plus de détails, consulter l'aide de RasTop.

• Ouvrir un fichier de script existant
• Modifier un script existant
• Créer un fichier de script
• Copier le texte d'un script et l'exécuter
• Commander manuellement le déroulement d'un script
• Inclure des scripts dans des scripts
• Enregistrer une session dans un script

  ---

• Associer un commentaire (Echo) à un script  (à partir de la version 2.0.3)

Ouvrir un fichier de script existant

• Dans le menu Fichier, choisir Charger un script.

Normalement, la ou les molécules concernées sont associées au script.
Si aucune molécule n'est désignée dans le script, les commandes s'appliquent à la molécule présente dans la fenêtre active.
• RasTop exécute le script.

S'il ne se passe rien, c'est qu'il y a une erreur ou une incompatibilité dans le script (voir les messages dans le panneau de commande).

Modifier un fichier de script existant

• Ouvrir le script avec un éditeur de texte.
• Vérifier que la molécule désignée est bien à un endroit connu du script.
• Dans RasTop, Editer, Commandes.
• Tester le script pas à pas.

Une fois satisfaits :

- Copier le texte du script (Ctrl C). 
- Coller dans un éditeur de texte. 
- Enregistrer en format test avec l'extension .scr.

Attention : 

- Toutes les commandes de Rasmol ne sont pas acceptées dans la fenêtre de commande (exemple : pause, wait, etc.).

- La commande Exporter, Scripts n'enregistre pas le contenu de la fenêtre de commande mais l'historique complet de la session.
 

Créer un fichier de script

Avec un éditeur de textes

• Taper votre script en mettant une commande par ligne.
• Enregistrer votre fichier au format texte avec l'extension .scr.

Rastop comporte en particulier un répertoire scripts dans lequel vous pouvez ranger vos propres sous-répertoires.

Avec RasTop

• Choisir dans le menu Editer, l'option Commandes. La fenêtre qui s'ouvre est un éditeur multilignes.
• Taper une commande.
• La tester en cliquant sur OK.
• Séparer 2 commandes par un retour à la ligne.

Une fois le script achevé :

- Copier le texte du script (Ctrl C). 
- Coller dans un éditeur de texte. 
- Enregistrer au format texte avec l'extension .scr.

Attention : La commande Exporter, Scripts n'enregistre pas le contenu de la fenêtre de commande mais l'historique complet de la session.
 

Copier le texte d'un script et l'exécuter

Le texte d'un script créé avec n'importe quel éditeur de texte, peut être copié, collé dans la fenêtre de l'éditeur de commandes, exécuté en cliquant sur OK.

Un script peut aussi être copié à partir d'une fenêtre en html.

• Lancer RasTop et ouvrir une molécule.
• Copier le script de votre choix.
• Coller le texte dans la fenêtre de commande.
• Cliquer sur OK.

Commander manuellement le déroulement d'un script

Inclure entre deux ligne de commandes Pause.
Avancer en cliquant sur la barre d'espacement.
 

Inclure des scripts dans des scripts

RasTop permet de créer un super script composé d'un nombre indéfini de scripts.

Il est également possible d'appeler un script qui appelle un script contenant lui-même un appel de script, et ainsi de suite jusqu'au 10ème niveau.
 

Enregistrer une session dans un script

Le déroulement de toute une session peut être enregistré sous la forme d'un script et son aboutissement affiché.

• Charger une molécule, effectuer les transformations souhaitées.
• Dans le menu Fichier, Exporter, Scripts, donner un nom au script.
• L'extension .scr est ajoutée automatiquement.

Attention : la taille des fichiers de tels scripts peut augmenter rapidement.
 

Les commentaires insérés dans un script sont affichés dans une fenêtre indépendante.

Associer un commentaire (Echo) à un script

Insérer la commande d'écho dans un script

• Ouvrir le script existant avec un éditeur de texte ou en créer un nouveau. 
• A la position souhaitée, après la commande de chargement d'un fichier de molécule par exemple et sur une seule ligne,  insérer la commande echo suivie du texte du commentaire.

Exemple : 
echo Ceci est la molécule d'ADN affichée en fil de fer.
• Pour un commentaire sur plusieurs lignes, il suffit d'insérer autant de commandes echo que de lignes du commentaire.

Exemple : 
echo Ceci est la molécule d'ADN affichée en fil de fer. 
echo Carbone = gris, Oxygene = rouge, Azote = bleu, Phosphore = orange. 
• Pour permettre à l'utilisateur de lire le commentaire, terminer par une commande pause.

Exemple : 
echo Ceci est la molécule d'ADN affichée en fil de fer. 
echo Carbone = gris, Oxygene = rouge, Azote = bleu, Phosphore = orange. 
echo Faites tourner la molecule avec la souris pour bien voir sa forme.
pause

Utiliser la fenêtre d'écho dans RasTop

• Cliquer sur l'icône correspondante de la barre d'outils.
• Ouvrir le fichier de script.
• Pour fermer la fenêtre d'écho, cliquer sur l'icône correspondante.