Code Aster Procédure TEST_TEMPS Mode d'emploi

Version 11
Code_Aster
Titre : Procédure TEST_TEMPS
Responsable : Mathieu COURTOIS
Date : 16/06/2015 Page : 1/4
Clé : U4.92.05
Révision : 13230
Procédure TEST_TEMPS
1
But
Cette macro-commande mesure le temps passé dans les commandes et compare cette valeur à des
temps de référence.
Cette commande n'a de sens que pour les cas tests afin de s'assurer que les temps d'exécution ne
varient pas de manière incontrôlée.
Manuel d'utilisation
Copyright 2015 EDF R&D - Document diffusé sous licence GNU FDL (http://www.gnu.org/copyleft/fdl.html)
Fascicule u4.92 : Test
Version 11
Code_Aster
Titre : Procédure TEST_TEMPS
Responsable : Mathieu COURTOIS
2
Date : 16/06/2015 Page : 2/4
Clé : U4.92.05
Révision : 13230
Syntaxe
TEST_TEMPS

(
RESU
= _F(
 COMMANDE
=
cmde,
[Kn]
◊
NUME_ORDRE
=
/ numord
/ 1
[I]
[DEFAUT]

MACHINE
=
l_mach,
[l_Kn]

VALE
=
l_val,
[l_R]
◊
TYPE_TEST
=
/
/
/
/
[DEFAUT]
◊
CRITERE = / 'RELATIF',
/ 'ABSOLU',
PRECISION = / epsi ,
/ 1.E-2 ,
◊
'USER+SYS',
'USER',
'SYSTEM',
'ELAPSED'
[DEFAUT]
[R]
[DEFAUT]
),
◊
INFO =
/
/
1 ,
2 ,
[DEFAUT]
)
Manuel d'utilisation
Copyright 2015 EDF R&D - Document diffusé sous licence GNU FDL (http://www.gnu.org/copyleft/fdl.html)
Fascicule u4.92 : Test
Version 11
Code_Aster
Titre : Procédure TEST_TEMPS
Responsable : Mathieu COURTOIS
3
Opérandes
3.1
Mot-clé RESU
Date : 16/06/2015 Page : 3/4
Clé : U4.92.05
Révision : 13230
Le mot-clé facteur RESU est répétable pour tester les temps d'exécution de plusieurs commandes.
3.1.1
Opérandes COMMANDE / NUME_ORDRE
Il s'agit de la commande dont on doit vérifier le temps d'exécution.
Si la commande est appelée plusieurs fois dans le fichier de commandes, NUME_ORDRE permet de
sélectionner l'occurrence à tester.
3.1.2
Opérande MACHINE / VALE
Le temps d'exécution peut varier significativement selon la machine.
Pour identifier les différentes machines testées, on peut indiquer un label dans le fichier config.txt
sous le champ ID_PERF. Si le champ n'est pas renseigné, TEST_TEMPS construit un label de la
forme Linux-i686-ifort (à partir de la commande uname et du nom du compilateur fortran
utilisé).
On fournit alors sous VALE les valeurs de référence du temps d'exécution de la COMMANDE et sous
MACHINE la liste des ID_PERF correspondant.
3.1.3
Opérande TYPE_TEST
Il s'agit
•
•
•
•
3.1.4
du temps testé :
USER
:
SYSTEM
:
USER+SYS :
ELAPSED :
temps cpu ;
temps system ;
cumul des deux précédents (défaut) ;
temps écoulé.
Opérandes CRITERE/PRECISION
Comme pour toutes les commandes TEST_xxx, il s'agit de préciser si le critère de comparaison est
ABSOLU ou RELATIF ainsi que la précision associée. On compare la valeur obtenue sur le fichier à la
valeur de référence fournie au mot-clé VALE.
3.2
Opérande INFO
Précise le détail des informations imprimées dans le fichier message.
En INFO=2, on imprime un tableau contenant l'ensemble des temps d'exécution semblable à
celui que l'on trouve dans le fichier .resu en fin d'exécution.
Manuel d'utilisation
Copyright 2015 EDF R&D - Document diffusé sous licence GNU FDL (http://www.gnu.org/copyleft/fdl.html)
Fascicule u4.92 : Test
Version 11
Code_Aster
Titre : Procédure TEST_TEMPS
Responsable : Mathieu COURTOIS
Date : 16/06/2015 Page : 4/4
Clé : U4.92.05
Révision : 13230
4
Exemple
4.1
Des valeurs de référence différentes par machine
Supposons que l'on souhaite vérifier le temps d'exécution de la commande MODE_ITER_SIMULT sur
4 machines dont les performances sont assez éloignées. Sur chaque machine, on prend soin de
définir un label pour les identifier dans le fichier config.txt. Par exemple :
ID_PERF
| id
| -
| machine1
On fera :
TEST_TEMPS(
RESU=(_F(
COMMANDE
NUME_ORDRE
MACHINE
VALE
PRECISION
),)
=
=
=
=
=
'MODE_ITER_SIMULT',
1,
('machine1', 'machine2', 'machine3', 'machine4'),
(
30 ,
35 ,
48 ,
40
),
0 05,),
Au moment de l'exécution :
• on cherche l'ID_PERF dans le fichier config.txt,
• si on le trouve parmi ceux fournit sous MACHINE, on prend la valeur de référence
correspondante, sinon on prend la première valeur (une alarme est émise),
• on compare le temps mesuré à la valeur de référence à 5% près.
4.2
Exemple d'impression
Ici, ID_PERF n'est pas défini sur la machine, il est construit automatiquement.
Il ne fait pas partie des valeurs fournies sous MACHINE, une alarme nous en avertit.
!----------------------------------------------------------------------------------!
! <A> <TEST0_9>
!
! Les temps de référence ne sont pas connus pour l'identifiant 'Linux-i686-ifort'. !
! On utilise les valeurs de 'Server'.
!
!----------------------------------------------------------------------------------!
--------------------------------------------------------------------------------Fichier de configuration
: config.txt
Identifiant pour la mesure des performances : Linux-i686-ifort
--------------------------------------------------------------------------------!-------------------------------------------------------------------------------!
! Commande
! Ordre ! Reference ! Mesure
! Difference ! Diagnostic !
!-------------------------------------------------------------------------------!
! MODE_ITER_SIMULT !
1 !
65.00 !
25.18 !
-39.82 !
OK
!
! DEFI_BASE_MODALE !
1 !
144.00 !
60.09 !
-83.91 !
NOOK
!
! MACR_ELEM_DYNA
!
1 !
73.00 !
40.38 !
-32.62 !
OK
!
! MODE_ITER_SIMULT !
2 !
13.00 !
4.52 !
-8.48 !
OK
!
!-------------------------------------------------------------------------------!
Manuel d'utilisation
Copyright 2015 EDF R&D - Document diffusé sous licence GNU FDL (http://www.gnu.org/copyleft/fdl.html)
Fascicule u4.92 : Test
">