feat: minimum iterations (#304)

Author: sebhoerl

core/src/main/java/org/eqasim/core/simulation/termination/EqasimTerminationConfigGroup.java

@@ -20,6 +20,7 @@ public EqasimTerminationConfigGroup() {
 	static private final String THRESHOLD = "threshold";
 	static private final String MODES = "modes";
 	static private final String HISTORY_FILE = "historyFile";
+	static private final String MINIMUM_ITERATIONS = "minimumIterations";
 
 	private int horizon = 10;
 	private int smoothing = 20;
@@ -29,6 +30,8 @@ public EqasimTerminationConfigGroup() {
 
 	private String historyFile = null;
 
+	private int minimumIterations = 0;
+
 	@StringGetter(HORIZON)
 	public int getHorizon() {
 		return horizon;
@@ -89,6 +92,16 @@ public String getHistoryFile() {
 		return historyFile;
 	}
 
+	@StringGetter(MINIMUM_ITERATIONS)
+	public int getMinimumIterations() {
+		return minimumIterations;
+	}
+
+	@StringSetter(MINIMUM_ITERATIONS)
+	public void setMinimumIterations(int value) {
+		this.minimumIterations = value;
+	}
+
 	static public EqasimTerminationConfigGroup getOrCreate(Config config) {
 		if (!config.getModules().containsKey(GROUP_NAME)) {
 			config.addModule(new EqasimTerminationConfigGroup());

core/src/main/java/org/eqasim/core/simulation/termination/EqasimTerminationCriterion.java

@@ -17,14 +17,16 @@ public class EqasimTerminationCriterion implements TerminationCriterion {
 
 	private final int firstIteration;
 	private final int lastIteration;
+	private final int minimumIteration;
 
 	private final TerminationWriter writer;
 
-	public EqasimTerminationCriterion(int firstIteration, int lastIteration,
+	public EqasimTerminationCriterion(int firstIteration, int lastIteration, int minimumIteration,
 			Map<String, TerminationIndicatorSupplier> indicators, Map<String, TerminationCriterionCalculator> criteria,
 			TerminationWriter writer) {
 		this.firstIteration = firstIteration;
 		this.lastIteration = lastIteration;
+		this.minimumIteration = minimumIteration;
 
 		this.indicators = indicators;
 		this.criteria = criteria;
@@ -39,7 +41,7 @@ public boolean mayTerminateAfterIteration(int iteration) {
 
 		boolean mayTerminate = false;
 
-		if (iteration > firstIteration) {
+		if (iteration > firstIteration && iteration >= minimumIteration) {
 			// check if we may terminate
 			TerminationData terminationData = prepareTerminationData(iteration);
 			history.add(terminationData);

core/src/main/java/org/eqasim/core/simulation/termination/EqasimTerminationModule.java

@@ -42,7 +42,10 @@ EqasimTerminationCriterion provideEqasimTerminationCriterion(ControllerConfigGro
 			new TerminationReader(indicators.keySet(), criteria.keySet()).read(historyURL);
 		}
 
-		return new EqasimTerminationCriterion(firstIteration, lastIteration, indicators, criteria, writer);
+		int minimumIteration = firstIteration + terminationConfig.getMinimumIterations();
+
+		return new EqasimTerminationCriterion(firstIteration, lastIteration, minimumIteration, indicators, criteria,
+				writer);
 	}
 
 	@Provides