SIC^2 : Logiciel de Simulation Intégrée des Canaux et de leur Contrôle
SicExport : utilitaire d’exportation des résultats au format texte
SicExport est un exécutable à utiliser en ligne de commande fourni dans le répertoire EXE de l’installation de SIC. Il peut être lancé directement en ligne de commande DOS ou Windows, mais aussi à partir de script écrit dans d’autres langages (MatLab, Scilab, R, etc), par exemple pour enchainer des calculs et leur pré et post-traitements.
Il permet de créer rapidement un fichier texte à séparateur tabulation avec les résultats d’une ligne d’eau pour un temps donné ou les résultats d’une localisation précise du réseau pour tous les temps.
Il peut gérer des résultats de calculs en régime permanent ou transitoire.
Cet utilitaire permet d’exporter les résultats qu’ils soient écrits au format XML directement dans le fichier du projet, ou également au format binaire dans un fichier externe RES. Ce format est choisi avant le lancement de calcul en permanent (programme Fluvia) ou transitoire (programme Sirene), dans les paramètres généraux et cette information est stockée dans le fichier XML. SicExport ira lire ce mode et cherchera les informations dans le fichier adhoc (XML ou RES). Si le fichier RES correspondant au scénario et variante concernés n’existe pas, un message d’erreur sera indiqué.
Syntaxe d’utilisation
La syntaxe d’utilisation de Sic Export est la suivante :
SicExport.exe FichierXml /sce=n /out=FichierTexte [Options]Il ne doit y avoir aucun espace entre la barre oblique « / » et l’option, et entre l’option, le signe égal et la valeur de l’option sous peine de voir les options ignorées.
Paramètres obligatoires
-
FichierXml: Nom du fichier de projet à utiliser . Les noms avec des espaces doivent être entre guillemets. -
/sce=n: n° du scénario où se trouve le résultat à extraire. -
/out=FichierTexte: Nom du fichier texte où seront stockés les résultats extraits. Si le chemin n’est pas spécifié, c’est celui deFichierXmlqui est utilisé. Les noms avec des espaces doivent être entre guillemets.
Paramètres optionnels
-
/var=n: n° de la variante où se trouve le résultat à extraire./var=0correspond au résultat du scénario sans variante. -
/t=n: Ligne d’eau au temps n. Si ce paramètre est présent le fichier généré contient les résultats de toutes les sections du réseau au temps n au format n°bief . -
/bf=n: n° de bief -
/sn=n: n° de section de lit mineur -
/x=n: Abscisse. Ne peut être utilisée que si l’option/bf=nest présente et l’option/sn=nabsente. -
/nd=n: n° de noeud -
/pr=n: n° de prise (valide uniquement si l’option/nd=nest présente) -
/st=n: n° de structure. S’utilise uniquement pour extraire les données d’un ouvrage à une prise (valide uniquement si les options/nd=net/pr=nsont présentes) -
/ouv=n: n° d’ouvrage -
/quiet={0;1;2}: Options d’entêtes sur le fichier (voir ci-dessous).
Si aucune de ces options n’est présente, c’est la ligne d’eau au temps 0 qui est exportée (option /t=0).
Options sur les entêtes du fichier : le paramètre /quiet
- Option absente ou
/quiet=0: Entêtes complètes avec des commentaires sur 3 lignes et le nom des variables sur 1 ligne après un retour charriot -
/quiet=1: Entête du tableau (noms des variables) uniquement -
/quiet=2: Aucun entête (ni commentaires, ni noms des variables)
Exemple
Exemple de fichier de sortie avec la commande SicExport "C:\SIC\DAT\asce1\asce1.xml" /sce=1 /out=test.txt /t=0
% Projet : C:\DocDD\SIC\Validation\asce1\asce1.xml
% Scenario 1
% Simulation FLUVIA Version 5.12 du 17/03/2011 15:20:10
Bief Section Abscisse Q Z L V ST
1 1 0 8.000000E-01 100.703850 3.111552 5.528833E-01 1.446960
1 2 95 8.000000E-01 100.700073 3.670238 3.849038E-01 2.078442
2 1 95 7.000000E-01 100.700073 3.670238 3.367907E-01 2.078442
2 2 100 7.000000E-01 100.699997 3.699981 3.309729E-01 2.114977
2 3 100 7.000000E-01 99.163811 2.091429 1.244785 5.623461E-01
2 4 1295 7.000000E-01 97.300064 3.670175 3.368033E-01 2.078365
...