From e6941fd00f47289b76bb55de35a58e6aff568e4d Mon Sep 17 00:00:00 2001
From: Julio Biason <j.biason@engys.com>
Date: Fri, 23 Aug 2024 09:56:51 -0300
Subject: [PATCH] vault backup: 2024-08-23 09:56:51

---
 HelyxProject.md | 35 +++++++++++++++++++++++++++++++++--
 1 file changed, 33 insertions(+), 2 deletions(-)

diff --git a/HelyxProject.md b/HelyxProject.md
index 6588d30..a415b36 100644
--- a/HelyxProject.md
+++ b/HelyxProject.md
@@ -7,21 +7,30 @@ simple
 	// Change files in during execution.
 	changes
 	{
+		// This is the automatic reduction of a case. It will look for
+		// caseSetupDict (or, if the case lacks it, controlDict) and will
+		// change the endTime to 10x the deltaT.
 		reduce
 		{
 			steps 10;
 		}
 	}
-	
+
+	// List of commands to be run.
 	commands
 	(
 		"helyxHexMesh"
 		"helyxSolve"
 	);
 
+	// If all commands run without failing, run this:
 	post
 	(
 		(
+			// compare is a special command, which will trigger calling
+			// helyxProject-compare-[name], passing the other parameters
+			// to the command; it also expects it to produce some foam
+			// file with the comparison results (format described later)
 			compare tsv;
 			files "postProcessing/foo" "reference/foo";
 			variables "phi";
@@ -32,15 +41,24 @@ simple
 
 continuation
 {
+	// This run will only be executed if the run named "simple" passes.
 	execute pass simple;
+	// Reuse the worked; if not defined, a new workspace will be created,
+	// start the run from scratch. With "reuse", the commands will be run in
+	// the previous run workspace.
 	workspace reuse;
 	changes 
 	{
+		// "continue" defines a continuation. It also changes caseSetupDict
+		// (or controlDict) to have 1xdeltaT, but also change "startTime" to
+		// "lastTime"
 		continue
 		{
 			steps 1;
 		}
 	}
+
+	// This run will execute only one command.
 	commands
 	(
 		"helyxSolve"
@@ -50,6 +68,9 @@ continuation
 split
 {
 	execute fail simple;
+	// It is possible to indicate that the commands will come from one
+	// external file -- in this case, a shell script named "Allrun"
+	// (this replicates the way helyxVerify works).
 	commands from "Allrun";
 	workspace reuse;
 
@@ -63,13 +84,17 @@ split
 	)
 }
 
-continuation
+more-continuation
 {
+	// This is the second run set to run after "simple" passes. The ordering
+	// is given by their appearance in the file: "continuation" will be run
+	// before "more-continuation"
 	execute pass simple;
 	workspace reuse;
 
 	changes
 	{
+		// instead letting Project do all the changes, we'll do it manually.
 		files {
 			"system/caseSetupDict"
 			{
@@ -91,9 +116,15 @@ continuation
 
 variation
 {
+	// This have no execution clause, so it will be run in parallel with 
+	// "simple" (being considering a different case, for example).
+
 	// Change files in during execution.
 	changes
 	{
+		// it is possible to mix specialized changes with manual ones, but
+		// specialized changes will always run before the manual changes.
+		// this makes the manual more explicit than the specialized.
 		reduce
 		{
 			steps 5;