README.md 4.34 KB
Newer Older
Laura Meier's avatar
Laura Meier committed
1
2
# **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.
Laura Meier's avatar
Laura Meier committed
3

Laura Meier's avatar
Laura Meier committed
4
## INSTALLATION
Laura Meier's avatar
Laura Meier committed
5
6

Requirements:
Laura Meier's avatar
Laura Meier committed
7
> Java Version 1.8.0_271
Laura Meier's avatar
Laura Meier committed
8
9

Recommended software for development:
Laura Meier's avatar
Laura Meier committed
10
> SceneBuilder (8.5.0)
Laura Meier's avatar
Laura Meier committed
11
>
Laura Meier's avatar
Laura Meier committed
12
> Eclipse IDE for Java Developers (2019-09 R, 4.13.0)
Laura Meier's avatar
Laura Meier committed
13
14

Open model GUI via:
Laura Meier's avatar
Laura Meier committed
15
1. Run Main.java (in ...\MODEL_MASTIFF\Mastiff\Java model project\src\application) as Java application (e.g. via Eclipse IDE)
Laura Meier's avatar
Laura Meier committed
16
2. Double-click [runMASTIFF.jar](https://git.ufz.de/oesa/mastiff/-/blob/main/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)
Laura Meier's avatar
Laura Meier committed
17
3. via command line (cmd): `java -jar runMASTIFF.jar` (check `java -version` for version)
Laura Meier's avatar
Laura Meier committed
18
19
20
21
22

...and choose scenarios options via GUI. 



Laura Meier's avatar
Laura Meier committed
23
## SET PARAMETERS
Laura Meier's avatar
Laura Meier committed
24
25
26

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. 
Laura Meier's avatar
Laura Meier committed
27

Laura Meier's avatar
Laura Meier committed
28
Left side: 
Laura Meier's avatar
Laura Meier committed
29
30
31
- 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
Laura Meier's avatar
Laura Meier committed
32

Laura Meier's avatar
Laura Meier committed
33
Middle:
Laura Meier's avatar
Laura Meier committed
34
35
36
37
- 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
Laura Meier's avatar
Laura Meier committed
38

Laura Meier's avatar
Laura Meier committed
39
Right side:
Laura Meier's avatar
Laura Meier committed
40
41
- Stressors: constant input of herbicides and insecticides in segments with agriculture and WWTP, input of pesticides by event
- Output Files (see OUTPUT/RESULT FILES)
Laura Meier's avatar
Laura Meier committed
42

Laura Meier's avatar
Laura Meier committed
43
Table (lower right):
Laura Meier's avatar
Laura Meier committed
44
- 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)
Laura Meier's avatar
Laura Meier committed
45
-> double-click: change a parameter in a segment individually
Laura Meier's avatar
Laura Meier committed
46

Laura Meier's avatar
Laura Meier committed
47
<img src="GUI.PNG" width = 900>  
Laura Meier's avatar
Laura Meier committed
48

Laura Meier's avatar
Laura Meier committed
49

Laura Meier's avatar
Laura Meier committed
50
## RUNNING
Laura Meier's avatar
Laura Meier committed
51

Laura Meier's avatar
Laura Meier committed
52
53
Single scenario: 
> Choose tab single scenario, press 'Initialize Parameter' and afterwards 'Run Model'
Laura Meier's avatar
Laura Meier committed
54

Laura Meier's avatar
Laura Meier committed
55
56
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. 
Laura Meier's avatar
Laura Meier committed
57
58


Laura Meier's avatar
Laura Meier committed
59
## OUTPUT/RESULT FILES
Laura Meier's avatar
Laura Meier committed
60

Laura Meier's avatar
Laura Meier committed
61
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.
Laura Meier's avatar
Laura Meier committed
62
You can find result files starting with [.jar](https://git.ufz.de/oesa/mastiff/-/blob/main/runMASTIFF.jar) in MODEL_MASTIFF\Data\Results
Laura Meier's avatar
Laura Meier committed
63
64
65
You can find result files starting manually in MODEL_MASTIFF\Mastiff\Java model project\data\Results


Laura Meier's avatar
Laura Meier committed
66
## NOTE
Laura Meier's avatar
Laura Meier committed
67

Laura Meier's avatar
Laura Meier committed
68
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. 
Laura Meier's avatar
Laura Meier committed
69

Laura Meier's avatar
Laura Meier committed
70
## ODD protocol
Laura Meier's avatar
Laura Meier committed
71
A complete, detailed model description, following the ODD protocall is provided [here](https://git.ufz.de/oesa/mastiff/-/blob/main/Model%20description.pdf).
Laura Meier's avatar
Laura Meier committed
72

Laura Meier's avatar
Laura Meier committed
73
<img src="Mastiff/Java model project/src/application/Icon_Mastiff2.png" width = 100>  
Laura Meier's avatar
Laura Meier committed
74