Differences

This shows you the differences between two versions of the page.

Link to this comparison view

python:validatetelemac [2015/07/29 16:15]
n.durand
python:validatetelemac [2022/12/08 11:02] (current)
b.basic [Tools for the validation of the TELEMAC system : validateTELEMAC.py]
Line 3: Line 3:
  
 \\ \\
-===== Tools for the validation of the TELEMAC system : validateTELEMAC.py =====+===== Tools for the validation of the TELEMAC system : validate_telemac.py =====
  
-validateTELEMAC.py +validate_telemac.py 
  
 \\ \\
  
-Arguments available under validateTELEMAC.py are listed with validateTELEMAC.py -help.+Arguments available under validate_telemac.py are listed with validate_telemac.py --help.
 \\ \\
 They are : They are :
-  * -c CONFIGNAME (alternatively ​''​--''​configname=CONFIGNAME) +  * -c CONFIGNAME (alternatively ​<​nowiki>​--</​nowiki>​configname=CONFIGNAME) 
-  * -f CONFIGFILE (alternatively ​''​--''​configfile=CONFIGFILE) +  * -f CONFIGFILE (alternatively ​<​nowiki>​--</​nowiki>​configfile=CONFIGFILE) 
-  * -r ROOTDIR ​   (alternatively ​''​--''​rootdir=ROOTDIR) +  * -r ROOTDIR ​   (alternatively ​<​nowiki>​--</​nowiki>​rootdir=ROOTDIR) 
-  * -v VERSION ​   (alternatively ​''​--''​version=VERSION) +  * -v VERSION ​   (alternatively ​<​nowiki>​--</​nowiki>​version=VERSION) 
-  * -m MODULES ​   (alternatively ​''​--''​modules=MODULES) +  * -m MODULES ​   (alternatively ​<​nowiki>​--</​nowiki>​modules=MODULES) 
-  * -s            (alternatively ​''​--''​screen) +  * -s            (alternatively ​<​nowiki>​--</​nowiki>​screen) 
-  * -w WDIR       ​(alternatively ​''​--''​workdirectory=WDIR) +  * -w WDIR       ​(alternatively ​<​nowiki>​--</​nowiki>​workdirectory=WDIR) 
-  * ''​--''​jobname=JOBNAME +  * <​nowiki>​--</​nowiki>​jobname=JOBNAME 
-  * ''​--''​queue=HPC_QUEUE +  * <​nowiki>​--</​nowiki>​queue=HPC_QUEUE 
-  * ''​--''​walltime=WALLTIME +  * <​nowiki>​--</​nowiki>​walltime=WALLTIME 
-  * ''​--''​email=EMAIL +  * <​nowiki>​--</​nowiki>​email=EMAIL 
-  * ''​--''​hosts=HOSTS +  * <​nowiki>​--</​nowiki>​hosts=HOSTS 
-  * ''​--''​ncsize=NCSIZE +  * <​nowiki>​--</​nowiki>​ncsize=NCSIZE 
-  * ''​--''​nctile=NCTILE +  * <​nowiki>​--</​nowiki>​nctile=NCTILE 
-  * ''​--''​ncnode=NCNODE +  * <​nowiki>​--</​nowiki>​ncnode=NCNODE 
-  * ''​--''​mpi +  * <​nowiki>​--</​nowiki>​mpi 
-  * ''​--''​split +  * <​nowiki>​--</​nowiki>​split 
-  * ''​--''​merge +  * <​nowiki>​--</​nowiki>​merge 
-  * ''​--''​run +  * <​nowiki>​--</​nowiki>​run 
-  * -b            (alternatively ​''​--''​bypass) +  * -b            (alternatively ​<​nowiki>​--</​nowiki>​bypass) 
-  * -k RANK       ​(alternatively ​''​--''​rank=RANK) +  * -k RANK       ​(alternatively ​<​nowiki>​--</​nowiki>​rank=RANK) 
-  * ''​--''​act=ACTION +  * <​nowiki>​--</​nowiki>​act=ACTION 
-  * ''​--''​draw=DRAWING +  * <​nowiki>​--</​nowiki>​draw=DRAWING 
-  * ''​--''​save=SAVING +  * <​nowiki>​--</​nowiki>​save=SAVING 
-  * ''​--''​cast=CASTING +  * <​nowiki>​--</​nowiki>​cast=CASTING 
-  * ''​--''​report=REPORT +  * <​nowiki>​--</​nowiki>​report=REPORT 
-  * ''​--''​clean +  * <​nowiki>​--</​nowiki>​clean 
-  * ''​--''​use-link ​+  * <​nowiki>​--</​nowiki>​use-link ​
  
 \\ \\
Line 71: Line 71:
 \\ \\
  
-''​--''​jobname assigns a jobname to help track the run on HPC.+<​nowiki>​--</​nowiki>​jobname assigns a jobname to help track the run on HPC.
  
 \\ \\
  
-''​--''​queue specifies the HPC queue where the job is to be run.+<​nowiki>​--</​nowiki>​queue specifies the HPC queue where the job is to be run.
  
 \\ \\
  
-''​--''​walltime specifies a walltime (real time, not CPU time) for the job corresponding to the maximum time it should take. If this limit is exceeded, the HPC queue manager will stop the job.+<​nowiki>​--</​nowiki>​walltime specifies a walltime (real time, not CPU time) for the job corresponding to the maximum time it should take. If this limit is exceeded, the HPC queue manager will stop the job.
  
 \\ \\
  
-''​--''​email defines the list of  users (email addresses) to which the HPC queue manager has to send mail, if any, about the job.+<​nowiki>​--</​nowiki>​email defines the list of  users (email addresses) to which the HPC queue manager has to send mail, if any, about the job.
  
 \\ \\
  
-''​--''​hosts if specified, the job will only run on one or several of the hosts. ';'​ delimited+<​nowiki>​--</​nowiki>​hosts if specified, the job will only run on one or several of the hosts. ';'​ delimited
  
 \\ \\
  
-''​--''​ncsize gives the number of processors to be used for the job.+<​nowiki>​--</​nowiki>​ncsize gives the number of processors to be used for the job.
  
 \\ \\
  
-''​--''​nctile gives the number of nodes to be used for the job.+<​nowiki>​--</​nowiki>​nctile gives the number of nodes to be used for the job.
  
 \\ \\
  
-''​--''​ncnode specifies the number of cores to be used on each node (cannot be greater than the number of cores in a node). This can be useful if memory requirements for the job are high.+<​nowiki>​--</​nowiki>​ncnode specifies the number of cores to be used on each node (cannot be greater than the number of cores in a node). This can be useful if memory requirements for the job are high.
  
 \\ \\
  
-''​--''​mpi (**internal command**).+<​nowiki>​--</​nowiki>​mpi (**internal command**).
  
 \\ \\
  
-''​--''​split if specified, will only prepare and split the input files but will not run the job.+<​nowiki>​--</​nowiki>​split if specified, will only prepare and split the input files but will not run the job.
  
 \\ \\
  
-''​--''​merge if specified, will merge the different contributions to the job output into one result file. ''​--''​merge usually follows a ''​--''​run command.+<​nowiki>​--</​nowiki>​merge if specified, will merge the different contributions to the job output into one result file. <​nowiki>​--</​nowiki>​merge usually follows a <​nowiki>​--</​nowiki>​run command.
  
 \\ \\
  
-''​--''​run if specified, will only run the multi-processor job but will not recombine the output into one result file at the end of the job. ''​--''​run usually follows a ''​--''​split command.+<​nowiki>​--</​nowiki>​run if specified, will only run the multi-processor job but will not recombine the output into one result file at the end of the job. <​nowiki>​--</​nowiki>​run usually follows a <​nowiki>​--</​nowiki>​split command.
  
 \\ \\
Line 151: Line 151:
 \\ \\
  
-''​--''​use-link allows the user to setup symbolic links to the input files rather than making copies of the files in the temporary working folder. Available on linux platforms only.+<​nowiki>​--</​nowiki>​use-link allows the user to setup symbolic links to the input files rather than making copies of the files in the temporary working folder. Available on linux platforms only.
  
 \\ \\
Line 226: Line 226:
 In this example, the variables '​surface libre*'​ and '​fond*'​ from the 2D result file of action "​1"​ (target) are plotted along the line with end points (0;0.93) and (21;1.07) for the last timestep only (-1) in the png file "​Figure2.csv"​.\\ In this example, the variables '​surface libre*'​ and '​fond*'​ from the 2D result file of action "​1"​ (target) are plotted along the line with end points (0;0.93) and (21;1.07) for the last timestep only (-1) in the png file "​Figure2.csv"​.\\
 config="​oneofall"​ will extract the results for only one of the configurations under action "​1"​ (e.g. ubuntu, gfortran, intel as defined by the user in systel.cfg). It is the user's responsibility to make sure that all configurations agree.\\ config="​oneofall"​ will extract the results for only one of the configurations under action "​1"​ (e.g. ubuntu, gfortran, intel as defined by the user in systel.cfg). It is the user's responsibility to make sure that all configurations agree.\\
-It is noted that config can be assigned the name of a particular configuration as well.+It is noted that config can be assigned the name of a particular configuration as well as is the case in the example below. 
 + 
 +\\ 
 + 
 +===== Example3 
 + ​===== 
 +''<​color blue> <plot2d </​color><​color green> xref=</​color><​color orange> "​Figure3"</​color><​color green> config=</​color><​color orange> "​one"</​color><​color green> time=</​color><​color orange> "​[-1]"</​color><​color green> size=</​color><​color orange> "​[12;​3]"</​color><​color blue> ></​color>​ 
 +\\ 
 +<color blue> ​  <​layer</​color><​color green> vars=</​color><​color orange> "​VITESSE:​map"</​color><​color green> target=</​color><​color orange> "​1:​T2DRES"</​color><​color blue> /></​color>​ 
 +\\ 
 +<color blue> ​  <​layer</​color><​color green> vars=</​color><​color orange> "​VITESSE:​angle"</​color><​color green> target=</​color><​color orange> "​1:​T2DRES"</​color><​color green> sample=</​color><​color orange> "​(7;​0.25)(13.5;​1.75){10;​4}"</​color><​color blue> /></​color>​ 
 +\\ 
 +<color blue> <plot2d /></​color>​ 
 +''​ 
 + 
 +\\ 
 +{{ python:​depth-sect.png?​200}} 
 +In this example, ​
 \\ \\
 ===== validateTELEMAC.py : save ===== ===== validateTELEMAC.py : save =====