README.md 4.03 KB
Newer Older
Laura Meier's avatar
Laura Meier committed
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
******************************************MASTIFF MODEL*********************************************
MASTIFF (Multiple Aquatic STressors In Flowing Food webs) is a spatially explivit simulation model 
for multi-stressed riverine systems which supports systematic analyses of organismic drift and 
dispersal processes and their functional importance for (i) the community structure of benthic 
grazers, (ii) the performance of grazer-mediated control of eutrophication, and (iii) the ability to 
counteract adverse effects of local stressors in the different river segments

INSTALLATION

Requirements:
Java Version 1.8.0_271

Recommended software for development:
SceneBuilder (8.5.0)
Eclipse IDE for Java Developers (2019-09 R, 4.13.0)

Open model GUI via:
(1) Run Main.java (in ...\MODEL_MASTIFF\Mastiff\Java model project\src\application) as Java 
	application (e.g. via Eclipse IDE)
(2) Double-click runMASTIFF.jar (if it does not open, check in 'Registrierungs-Editor' under 
	'Computer\HKEY_CLASSES_ROOT\jarfile\shell\open\command' the path points on the right java 
	version)
(3) via command line (cmd): 'java -jar runMASTIFF.jar' (check 'java -version' for version)

...and choose scenarios options via GUI. 



SET PARAMETERS

Mastiff is modular in design. Therefore, you can switch on and off different processes in the GUI 
interface, including options/functions/processes that are not included in ODD protocol yet. 
Left side: 
	- Simulation parameters (amount segments, simulation time in months), initialisation for 
		biofilm biomass and abundances (x:y defines the range, e.g. increasing intial 
		abundance, if x = y every segmen has the same abundance)
	- Button for intialize parameters (save parameters) and Button for run the model
	- Number runs, Name Scenario, Path in which the output should be saved
Middle:
	- Environmental parameters: air temperature, land use profile by defining land use types 
		for each segment (options: individual by A-F, sequence (Holtemme), load file), 
		minimum nutrient factor (min eN)
	- Biofilm parameters (growth rate, B0) and compartments (epsilon, my), Eutrophication 
		parameters (thresholds beta0 and beta 1, pfmax, betaf)
	- Species characteristics: Mortality(mortality rates, scale, drift mortality), Reproduction 
		(offspring, dispersal probability and distances)
	- Trohic interaction
Right side:
	- Stressors: constant input of herbicides and insecticides in segments with agriculture and 
		WWTP, input of pesticides by event
	- Output Files (see OUTPUT/RESULT FILES)
Table (lower right):
	- segment specific parameters (number, land use type, maximal shading factor, epsilon, my, 
		drift mortality, nutrient factor, biofilm biomass, abundance for each species, 
		constant herbicide/insecticide input, beta1)
	-> double-click: change a parameter in a segment individually


RUNNING

Single scenario: choose tab single scenario, press 'Initialize Parameter' and afterwards 'Run Model'

Multiple scenario (e.g. sensitive analysis): Define parameter variation in MainController.java 
method onButtonClickvaryPar(). Choose tab multiple scenarios and define scenario name and path. 
Decide if result files should be filtered by coexistence of species or/and rangeof abundance. 
Press Run multiple. 


OUTPUT/RESULT FILES

Output files could be choosen on the mid right. Possible are air temperature, water temperature, 
biofilm biomass, biofilm condition, probability of filamentous algae (pf), abundance of each species, 
demand of each species, Available feed, inflow and outflow of organisms, dispersal loss, abundance 
in biomass, diffusive herbicide and insecticides, event herbicide and insecticides.
You can find result files starting with .jar in MODEL_MASTIFF\Data\Results
You can find result files starting manually in MODEL_MASTIFF\Mastiff\Java model project\data\Results


NOTE

A few options/function shown in GUI are implemented and tested but not relevant for publications and 
not mentioned in ODD. For further studies interfaces are build (e.g. predator 'Stonefly' eating on 
grazers, pesticide module) but not coupled or tested sufficiently.