3. Annexes

`-a, -auto-outdir`	génère automatiquement un répertoire contenant un les données résultats
`-c, -clean-outdir`	vide le répertoire avant l'écriture des données résultats
`-f, -functions-list`	liste les fonctions de simulation disponibles (n'exécute pas le modèle)
`-h, -help`	affiche l'aide
`-i, -inputdir=<str>`	spécifie le répertoire contenant les données d'entrée
`-k, -openfluid-version`	affiche le numéro de version du SDK utilisé
`-m, -trace-dir=<str>`	spécifie le répertoire pour les données trace (en mode trace uniquement)
`-o, -outputdir=<str>`	spécifie le répertoire pour les données résultats
`-q, -quiet`	désactive l'afichage pendant la simulation
`-r, -functions-report`	affiche un rapport détaillé sur les fonctions de simulation disponibles (n'exécute pas le modèle)
`-s, -no-simreport`	ne génère pas de rapport de simulation
`-t, -trace`	active le mode trace
`-v, -verbose`	active l'afffichage détaillé pendant la simulation
`-version`	affiche la version du moteur de calcul
`-x, -xml-functions-report`	affiche un rapport détaillé au format XML sur les fonctions de simulation disponibles (n'exécute pas le modèle)
`-z, -no-results`	ne génère pas de fichier de sortie résultats
`-no-varname-check`	désactive la vérification du nommage des variables

3.3 Généralités sur les formats de fichier OpenFLUID-engine

Les formats de fichiers utilisés par OpenFLUID-engine sont de 3 types: texte-colonnes, XML, XML-mixte.

Les exemples pris ci-dessous pour illustrer les différents formats de fichiers ne sont pas tous tirés de jeux de données issus d'OpenFLUID-engine. Il ne faut donc pas s'attacher au contenu mais plutôt au format des exemples.

3.3.1 Format texte-colonnes

Les fichiers au format texte-colonne contiennent des données en format texte qui sont rangées en colonnes, séparées par au moins un espace ou une tabulation.
Toute ligne commençant par le caractère % est ignorée.

3.3.2 Format XML

Le format XML est un format de données auto-descriptif, hiérarchique, utilisant les notions de balises et d'attributs. Pour obtenir des informations plus complètes sur ce format largement utilisé, nous vous invitons à vous rendre sur un des sites suivants:

les fichiers xml ont obligatoirement pour entête <?xml version="1.0" standalone="yes"?>
les fichiers xml OpenFLUID-Engine ont pour balise racine <openfluid>
pour insérer un commentaire dans un fichier XML ou désactiver une partie du fichier, il faut encadrer la partie souhaitée par <!- au début et -> en fin.

3.3.3 Format XML-mixte

Le format XML-mixte est basé sur XML. Il est utilisé ici pour la descriptions de propriétés ou de conditions initiales distribuées dans l'espace.
Ce format permet de définir des données en colonnes avec la possibilité d'avoir un nombre de colonnes variables ainsi qu'un ordre et une signification "à la carte" de ces colonnes. Il est appelé XML-mixte car on utilise les caractéristiques du XML pour la description du contenu, mêlées à la facilité d'utilisation du format texte colonne. Le format XML-mixte est un format XML classique avec la particularité d'une zone balisée dans laquelle se trouve les données en colonnes.

Les fichiers XML-mixte contiennent une section principale définie par la balise qui va donner la type d'objet spatial (SU, RS ou GU) ainsi que le type de données (propriétés ou condition initiales). Cette balise peut donc être <SUprops>, <SUini>, <RSprops>, <RSini>, <GUprops> ou <GUini> et contient 2 balises:

<?xml version="1.0" standalone="yes"?> <openfluid> <RSprops> <columns order="ks;nmanning" /> <data> 1 0.003 0.2 2 0.003 0.2 3 0.003 0.2 4 0.003 0.2 5 0.003 0.2 </data> </RSprops> </openfluid>

3.4 Formatage des dates à l'aide de la norme ANSI strftime()

La fonction strftime() permet de transformer une date en une chaîne de caractère en utilisant une chaîne de formatage composée d'indicateurs standardisés représentants les champs d'une date. Ces indicateurs de champs commencent par le caractère % (voir ci-après). Les caractères ordinaires présent dans la chaîne de formatage seront reproduits tels quels. Une tabulation est représentée par le code \t, une fin de ligne par le code \n, le caractère % par le code %%.

Par exemple, la date 19 avril 2007 à 10h11m25s formatée à l'aide des chaînes de formatage suivantes:

%a	Le nom abrégé du jour de la semaine, en fonction de la localisation en cours.

%A	Le nom complet du jour de la semaine, en fonction de la localisation en cours.

%b	Le nom abrégé du mois, en fonction de la localisation en cours.

%B	Le nom complet du mois, en fonction de la localisation en cours.

%c	La représentation classique de la date et de l'heure, suivant la localisation en cours.

%C	Le siècle (année / 100) sous forme de nombre de deux chiffres. (SU)

%d	Le quantième du mois sous forme de nombre décimal (entre 01 et 31).

%D	Equivalent à %m/%d/%y. Seulement pour les américains. Ces derniers doivent noter que les autres pays préfèrent le format %d/%m/%y. Dans un contexte international ce format est ambigu et doit être évité. (SU)

%e	Comme %d, le quantième du mois sous forme décimal, mais l'éventuel zéro en tête est remplacé par un espace. (SU)

%E	Modificateur : Utiliser un format de rechange. Voir plus bas. (SU)

%G	L'année ISO 8601 avec le siècle comme nombre décimal. L'année sur quatre chiffres correspond au numéro de la semaine ISO (voir %V). C'est le même format que %y, sauf que si le numéro de semaine appartient à l'année suivante ou précédente, c'est celle-ci qui est affichée à la place. (TZ)

%g	Comme %G sans le siècle, c'est à dire avec une année sur deux chiffres (00-99). (TZ)

%h	Equivalent à %b. (SU)

%H	L'heure, sur 24 heures, sous forme de nombre décimal (entre 00 et 23).

%I	L'heure, sur 12 heures, sous forme de nombre décimal (entre 01 et 12).

%j	Le numéro du jour dans l'année (entre 001 et 366). %k L'heure (sur 24 heures) sous forme de nombre décimal (intervalle 0 à 23). Les chiffres uniques sont précédés d'un blanc (voir aussi %H). (TZ).

%l	L'heure (sur 12 heures) sous forme de nombre décimal (intervalle 1 à 12). Les chiffres uniques sont précédés d'un blanc (voir aussi %I). (TZ).

%m	Le numéro du mois (entre 01 et 12).

%M	La minute, sous forme de nombre décimal (00 à 59).

%n	Un caractère saut-de-ligne. (SU)

%O	Modificateur : Utiliser un format de rechange. Voir plus bas. (SU)

%p	L'une des deux chaînes 'AM' ou 'PM' en fonction de l'heure, ou la traduction de ces chaînes en fonctions de la localisation en cours. Midi est traité comme 'PM' et Minuit comme 'AM'.

%P	Comme %p mais en minuscule: 'am' ou 'pm' ou une chaîne locale équivalente. (GNU)

%r	L'heure en notation a.m. ou p.m. Dans la localisation POSIX, c'est équivalent à '%I:%M:%S %p'. (SU)

%R	L'heure en format 24 heures (%H:%M). (SU). Pour avoir les secondes voir %T.

%s	Le nombre de secondes écoulées depuis le 1er Janvier 1970 à 00:00:00 UTC. (TZ).

%S	La seconde, sous forme de nombre décimal. (00-61)

%t	Un caractère Tab. (SU)

%T	L'heure en notation 24 heures (%H:%M:%S). (SU)

%u	Le jour de la semaine sous forme décimal, de 1 (Lundi) à 7. Voir aussi %w. (SU)

%U	Le numéro de la semaine dans l'année, sous forme de nombre décimal (00-53), en commençant le comptage au premier Dimanche de l'année. Voir aussi %V et %W.

%V	Le numéro de semaine ISO 8601:1988 de l'année en cours sous forme de nombre décimal dans l'intervalle 01-53, où la semaine 1 est la première ayant au moins 4 jours dans l'année en cours, et où Lundi est le premier jour de la semaine. Voir aussi %U et %W. (SU)

%W	Le numéro de la semaine dans l'année, sous forme de nombre décimal (00-53), en commençant le comptage au premier Lundi de l'année.

%w	Le numéro du jour de la semaine, sous forme décimale (0-6), Dimanche valant 0. Voir aussi %u.

%x	La représentation usuelle de la date, sans l'heure, dans la localisation en cours.

%X	La représentation usuelle de l'heure, sans la date, dans la localisation en cours.

%y	L'année, sous forme de nombre décimal, sans le siècle (entre 00 et 99).

%Y	L'année, sous forme de nombre décimal, incluant le siècle.

%z	Le fuseau horaire sous forme de décalage GMT. Nécessaire pour crééer des dates conformes à la RFC 822 (avec %a, %d %b %Y %H:%M:%S %z). (GNU)

%Z	Le nom ou l'abréviation du fuseau horaire.

%+	La date et l'heure au format date(1) . (TZ)

%%	Un caractère '%'.