Page d'Accueil

S O M M A I R E
		page
	A -  LES DIRECTIVES            2 

	B – GENERATION D’UN PROJET     10




Index des directives :
 page				
ctin ctinm         11
defval             3
(exec)             2
hat_name           4
insert_fct         13   
modul              9
netward            8  
option             5  
opera              7
order              12  
space              7
traj               6



A) LES DIRECTIVES
________________________________________________________________

Avant propos :

Les directives sont des indications, des informations grâce auxquelles on va pouvoir décrire les différents éléments nécessaires à 
la création d’un projet. Ces directives doivent être saisies dans un fichier dit de description, dont le nom, passé en paramètre au
 générateur, sera le nom attribué au projet (cf B)

Le générateur reconnaît une certaine syntaxe qui l’informe de la tâche à accomplir.

Le 1er terme de cette syntaxe peut être :
- Le ‘#’
- Un nom de directive
- Le mot ‘exec’

# :  Indique que ce qui suit est du commentaire et ne sera donc pas pris en compte.
directive :

On appelle ‘directive’, une syntaxe reconnue par le générateur, qui le renseigne sur certaines caractéristiques du modèle, à partir 
de laquelle il pourra générer le code source approprié (structures de données, fonctions, …).

Une directive se compose de son nom, qui peut être suivi de paramètres ou de mots clés eux même suivis de paramètres.

L’ordre suivant de déclaration des directives doit être respecté :
 
  1: defval,        2: hat_name,      3: option,       4: traj,               5: space,   
  6: opera,	7: netward,         8: modul,       9: ctin ctinm,   10: order,  
11: insert_fct.

à part defval, option,  opera, netward et insert_fct, elles sont toutes nécessaires donc obligatoires.

Les directives peuvent apparaître sur plusieurs lignes consécutivement.

La liste et les explications des directives et de leur syntaxe sont données ci-après.

exec action
Il ne s’agit donc pas d’une directive mais d’une action qu’on demande au générateur d’exécuter. Initialement cette fonctionnalité a été 
ajoutée pour la mise au point du programme, mais elle peut s’avérer utile pour la création d’un modèle. Les actions possibles sont :
	- exit		: arrête la génération. Les résultats sont « unpredictable »
	- help		: affiche la liste des directives et des exec
	- disp_defval	: affiche la liste des valeurs définies (cf defval)
	- disp_ct_in	: affiche la liste des connections établies (cf ctin ctinm) regroupées sur 
  les entrées des modules. 
	- disp_ct_out	: affiche la liste des connections établies (cf ctin ctinm) regroupées sur 
  les sorties des modules 
	- disp_modul	: affiche la liste des modules et leurs caractéristiques.
	- disp_netward: affiche la liste des réseaux de neurones et leurs caractéristiques.
			

Liste, syntaxe et explications des directives

Syntaxe des directives : 
- On met entre-crochet ( [ ] ) les termes non obligatoires.
- On met entre accolades ( { } ) les termes dont obligatoirement un et un seul doit être choisi.
- Tous les autres termes (ceux qui ne sont ni entre accolades, ni entre crochets) sont obligatoires.

Les noms des objets qui vont être déclarés par les directives devront être unique même s’il s’agit d’objets différents 
(trajectoire, espace, opérateur, réseau de neurones, module, …) 



B) GENERATION D’UN PROJET
________________________________________________________________

Nom de la commande de génération :

Lorsqu’un projet a été décrit dans un fichier de description, et que les modules ont été programmés, il suffit, pour générer
 l’exécutable correspondant, à partir de celui-ci, d’utiliser la commande :  
Yao?*1.

Sa syntaxe est :

Yao? [options]  prjname 

Description :
Yao?  lance la procédure YAO qui va générer le code à partir du fichier de description du projet désigné par prjname.

		Ex :	YaoH  shallow
	

Le suffixe .d qui affuble éventuellement le nom du fichier ne doit pas être précisé. En effet, si le fichier n’est pas trouvé, 
le suffixe .d est ajouté automatiquement. Ce suffixe n’est donc pas une obligation, il sert néanmoins à reconnaître aisément le fichier 
de description.

Options :
	-h
Affiche uniquement la liste des directives et des exec. Cette option s’utilise toute seule (i.e. les autres options 
présentes seraient ignorées).

–g 
Permet de recompiler le projet sans regénération des sources. Les fichiers préalablement générés (Y1prjname.h, Y2prjname.h), doivent 
être présents dans le répertoire courant (il faut donc les rapatrier du répertoire de travail de YAO ./Yworkdir).
Cette option peut s’avérer pratique en phase de mise au point de programme car les sources générés peuvent ainsi être modifiés 
directement à la main (cette option s’adresse plus particulièrement aux interventions « système »).

	-e
		Affiche les ordres de compilation et de link.

	-x execname
Par défaut, l’exécutable porte le même nom que le projet (prjname). Cette option permet de changer ce nom par celui indiqué avec execname.

	-d path
Le répertoire de production utilisé par la procédure YAO est normalement celui qui est défini par la variable d’environnement
 YAODIR ou à défaut par le répertoire courant. Cette option force la procédure à utiliser, à la place, le répertoire indiqué 
par path.