Tuflow

Run TUFLOW From PowerShell: Difference between revisions

Browse history interactively
← Older edit
Content deleted Content added
VisualWikitext
 
(45 intermediate revisions by 3 users not shown)
Line 7:
 
=Using PowerShell=
Open Windows PowerShell from the Windows start menu. When running a script via the PowerShell command line, the current working directory should typically be set to the same directory as the location of the script and TCF file. To change the current working directory, use the “cd” command. If there are spaces in your folder path, use single quotations around the entry (' '):
<pre>
cd '<Path-to-Tuflow-Runs-Folder>'
</pre>
 
Assuming the PowerShell script filename is runrun_TUFLOW_simulations.ps1, this can be run from the PowerShell command line with this command:
<pre>
.\runrun_TUFLOW_simulations.ps1
</pre>
 
{{Video|name=TUFLOW Run_Edited.mp4|width=850}}<br>
=A simple example=
 
A Windows batch file can also be used to execute a PowerShell script, avoiding the need to work in the PowerShell command line.
A simple PowerShell script is as follows:▼
* Create a text file with a *.bat file extension, saved in your TUFLOW\runs folder (alongside your TCF)
* Add the following syntax to the batch file (if your ps1 file uses a different name, specify it instead of run_TUFLOW_simulations.ps1):
<pre>▼
@powershell -File .\run_TUFLOW_simulations.ps1
</pre>▼
* Double left mouse click the batch file from Window Explorer to execute the batch file that calls the PowerShell script
 
=Simple Example=
 
▲A simple PowerShell script to run a single simulation is as follows:
<pre>
C:\bin\TUFLOW\2025.0.3\TUFLOW_iSP_w64.exe model_001.tcf
Line 29 ⟶ 39:
</pre>
 
=Multiple simulationsSimulations=
Running multiple simulations in series can be handled by adding new lines to run.ps1. Use a –b (batch) switch to suppressessuppress the need to press the return key at the end of each simulation:
<pre>
C:\bin\TUFLOW\2025.0.3\TUFLOW_iSP_w64.exe -b model_001.tcf
Line 36 ⟶ 46:
</pre>
 
=Adding switchesSwitches=
To alter the behaviour of TUFLOW, switches can be used in the same way as a batch file (see <u>[[Run_TUFLOW_From_a_Batch-file#TUFLOW_switches_in_a_batch_file | Batch File Switches]]</u>). It is recommended that switches be contained with single quotations (' '). For example, running with the test switch -t:
<pre>
C:\bin\TUFLOW\2025.0.3\TUFLOW_iSP_w64.exe '-t'b '-b's1 5m -s2 D01 model_001model_~s1~_~s2~_001.tcf
▲</pre>
 
This is an example demonstrates how to make a copy of project milestone model for archiving:
▲<pre>
C:\bin\TUFLOW\2025.0.3\TUFLOW_iSP_w64.exe '-b' '-capncf' 'C:\Projects\11056\Milestone_Archive' model_001.tcf
</pre>
 
=Looping=
Looping is undertaken in a similar way to batch files. The following PowerShell script contains a nested loop, so thatwhere TUFLOW runs a simulation for all combinations of scenarioscenarios and eventevents.
Comments can be added using #.
 
<pre>
#TUFLOW RUN VARIABLES
$scenarios = @("1m", "2m", "5m")
$events = @("1hr", "2hr", "5hr")
 
#SIMULATION EXECUTION LOOP
foreach ($scenario in $scenarios){
foreach ($event in $events){
C:\bin\TUFLOW\2025.0.3\TUFLOW_iSP_w64.exe '-b' '-s1' $scenario '-e1' $event 'model_~s1~_~e1~.tcf'
}
}
</pre>
 
=Email Notifications=
=Sending an email when a simulation ends=
An email can be sent using PowerShell to inform the user that a TUFLOW run has completed (successfully or otherwise). The following approach requires that Outlook is already set up on the computer running TUFLOW:
<pre>
Line 70 ⟶ 79:
$Mail.Send()
</pre>
It is also possible to send the contents of a log file (for example, the simulation TLF or _ TUFLOW Simulations.log) as the body of the email. To do this, you must pre-empt the name and path of the TLF file that will be produced:
<pre>
$Mail.Body = Get-Content -Raw .\log\model_001.tlf
Retrieved from "https://wiki.tuflow.com/Run_TUFLOW_From_PowerShell"