Si vous ne pouvez pas vous déplacer jusqu'à la fin du texte ci-dessous, cliquez ici.

Présentation générale

Création d'un fichier cyloop.

Syntaxe : cylcree [nom_fichier_cyloop]

cylcree est une commande interactive qui demande à l'utilisateur de définir toutes les caractéristiques d'un fichier cyloop avant de créer ce fichier.

Le nom du fichier cyloop à créer peut être passé en paramètre (avec ou sans le suffixe .cyl).
En l'absence de ce paramètre, la commande cylcree commence par demander le nom du fichier à créer.

Ensuite commence une série de questions/réponses qui permet à l'utilisateur de définir toutes les caractéristiques du fichier cyloop qu'il veut créer.

Pour plus de détails sur la création d'un fichier cyloop, voir cette page web.

Affichage de la structure et du contenu d'un fichier cyloop.

Syntaxe : cyldump [nom_fichier_cyloop]

cyldump affiche les différentes caractéristiques d'un fichier cyloop :

• caractéristiques du cycle en cours,
• caractéristiques de la variable,
• données mémorisées pour chacun des instants du cycle.

Le nom de fichier cyloop à dumper peut être passé en paramètre (avec ou sans le suffixe .cyl).
En l'absence de ce paramètre, la commande cyldump commence par demander le nom de ce fichier.

Incrémentation d'une variable de type compteur.

Syntaxe : cylincr nom_fichier_cyloop

Le paramètre nom_fichier_cyloop est obligatoire.

cylincr permet d'incrémenter la variable du fichier nom_fichier_cyloop à l'instant courant du cycle en cours, lorsque cette variable est de type compteur.

L'incrémentation du compteur est systématique lors du premier appel de cylincr pour un nouvel instant du cycle.

Si d'autres appels de cylincr surviennent durant le même instant du cycle, ils seront comptabilisés ou ignorés selon les caractéristiques de la variable.

De même, en cas de changement de cycle depuis l'appel précédent de cylincr, un calcul de pondération est effectué sur les données des cycles précédents déjà mémorisées, lorsque ce calcul a été prévu pour la variable.

Insertion d'une nouvelle valeur dans une variable qui n'est pas de type compteur

Syntaxe : cyladdval nom_fichier_cyloop valeur

Les paramètres nom_fichier_cyloop et valeur sont obligatoires.

cyladdval permet d'ajouter la donnée valeur à la variable du fichier nom_fichier_cyloop à l'instant courant du cycle en cours, lorsque cette variable n'est pas de type compteur.

L'ajout de la donnée est systématique lors du premier appel de cyladdval pour un nouvel instant du cycle.

Si d'autres appels de cyladdval surviennent durant le même instant du cycle, ils seront comptabilisés ou ignorés selon les caractéristiques de la variable.

De même, en cas de changement de cycle depuis l'appel précédent de cyladdval, un calcul de pondération est effectué sur les données des cycles précédents déjà mémorisées, lorsque ce calcul a été prévu pour la variable.

Génération de graphiques à partir d'un fichier cyloop

Syntaxe : cylgraph

nom_fichier_cyloop nom_fichier_image options_générales descriptions_tracés

Les paramètres nom_fichier_cyloop et nom_fichier_image sont obligatoires.

cylgraph génère une image nom_fichier_image à partir du fichier nom_fichier_cyloop.

Options générales

Ces premières options sont toutes facultatives et peuvent apparaître dans n'importe quel ordre. Elles concernent les propriétés de l'image générée.

• [-h hauteur_graphique]
• [-w largeur_graphique]
• [-H hauteur_image]
• [-W largeur_image]
• [-T titre_image]
• [-p]

-h permet de préciser la hauteur hauteur_graphique en pixels du graphique intégré à l'image générée.
Par défaut, cette hauteur est de 100 pixels, sauf si la hauteur totale de l'image est fixée à une valeur inférieure.

-w permet de préciser la largeur largeur_graphique en pixels du graphique intégré à l'image générée.
Par défaut, cette largeur est de 400 pixels, sauf si la largeur totale de l'image est fixée à une valeur inférieure.

-H permet de préciser la hauteur hauteur_image en pixels de l'image.
Par défaut, cette hauteur est de 50 pixels de plus que la hauteur du graphique.

-W permet de préciser la largeur largeur_image en pixels de l'image.
Par défaut, cette largeur est de 100 pixels de plus que la largeur du graphique. Par rapport à la largeur choisie, elle est toujours arrondie au multiple de 8 supérieur.

-T permet de rajouter en haut de l'image générée le titre titre_image

-p demande d'afficher l'échelle verticale du graphique sous la forme de pourcentages, plutôt que sous la forme de valeurs numériques brutes.

Description des tracés

La description des tracés est constituée d'une série d'options ayant la forme suivante :

-[m|M](tépaisseur|a) couleur

Les options qui suivent permettent chacune de décrire un tracé inclus dans le graphique.

Il peut y avoir plusieurs tracés (jusqu'à 12). Dans ce cas, les différents tracé sont insérés dans le graphique dans l'ordre dans lequel ils sont mentionnés. Lorsque plusieurs tracés se chevauchent dans le graphique, c'est le dernier tracé qui est prioritaire et qui donnera au pixel sa couleur.

-tépaisseur couleur

trace dans le graphique la courbe correspondant à la valeur moyenne des données de la variable aux différents instants du cycle.
L'option -t est immédiatement suivie (sans aucun espace) du chiffre épaisseur (de 1 à 9) qui correspond à l'épaisseur du trait en pixels.
Toutefois, l'épaisseur d'un trait est limitée à 3 pixels dans le sens horizontal.

Le paramètre couleur qui suit définit la couleur du trait. Il est exprimé sous la forme de 6 caractères hexadécimaux.

• les 2 premiers caractères de 00 à FF correspondent à la luminosité de la composante rouge (en synthèse additive des couleurs),
• les 2 caractères suivants, à la luminosité de la composante verte,
• les 2 derniers, à la luminosité de la composante bleue.

-a couleur

trace dans le graphique la courbe correspondant à la valeur moyenne des données de la variable aux différents instants du cycle.
Cette courbe est représentée sous la forme d'une surface de couleur uniforme couleur commençant au bas du graphique.
La couleur de la surface est exprimée de la même manière que pour l'option -t

-mtépaisseur couleur

similaire à l'option -t sauf que le tracé concerne la valeur minimale de la donnée pour chaque instant du cycle.

-ma couleur

similaire à l'option -a sauf que le tracé de la surface concerne la valeur minimale de la donnée pour chaque instant du cycle.

-Mtépaisseur couleur

similaire à l'option -t sauf que le tracé concerne la valeur maximale de la donnée pour chaque instant du cycle.

-Ma couleur

similaire à l'option -a sauf que le tracé de la surface concerne la valeur maximale de la donnée pour chaque instant du cycle.

Formats d'image

La commande cylgraph peut générer des images dans de nombreux format.
Le format de l'image généré dépend du suffixe du fichier nom_fichier_image passé en paramètre.

Toutefois, afin de supporter de nombreux formats d'image, la commande cylgraph fait appel à la commande convert du projet ImageMagick.

En l'absence de cette commande, les images sont générées au format bmp et les noms des fichier image se terminent par le suffixe .bmp

Configuration : le fichier sysfont

Le fichier sysfont est un fichier système optionnel du projet cyloop.

Il doit être créé si nécessaire au moment de l'installation de cyloop.

Ce fichier n'est utile que lorsque l'ordinateur n'utilise pas le jeu de caractères UTF-8 (c'est à dire lorsque la variable d'environnement $LANG ne se termine pas par UTF-8).

Dans ce cas, il est utilisé par la commande cylgraph afin d'utiliser le bon jeu de caractères pour insérer du texte dans les graphiques générés.

Implantation

Si les commandes exécutables du projet Cyloop sont implantées dans /usr/bin comme presque les autres commandes du système d'exploitation, le fichier sysfont doit être implanté dans /usr/share/cyloop

Dans le cas contraire, il doit être implanté dans le même répertoire que les fichiers exécutables du projet Cyloop soit : (...)/cyloop/bin

Contenu

Le contenu du fichier sysfont se limite au nom d'un fichier fonte (sans autre caractère avant ou après notamment des blancs).

Les noms de fichiers fonte possibles sont :

iso8859-2	iso8859-3	iso8859-4	iso8859-5
iso8859-6	iso8859-7	iso8859-8	iso8859-9
iso8859-10	iso8859-11	iso8859-13	iso8859-14
iso8859-15	iso8859-16	windows-1252

Le nom iso8859-1 est également autorisé, mais le fichier sysfont n'est pas nécessaire si on utilise ce jeu de caractères, puisque c'est le jeu de caractères par défaut.