-
Notifications
You must be signed in to change notification settings - Fork 0
/
bps-model.qmd
196 lines (111 loc) · 8.21 KB
/
bps-model.qmd
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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
---
title: "BpS Models"
author: "Randy Swaty"
date: "2024-01-03"
output: html_document
---
## What you will learn here
For each Biophysical Setting (BpS, pre-European colonization ecosystem), LANDFIRE wanted to accomplish several things including:
* Document historical disturbances and their effects
* Describe and estimate the historical amounts of up to 5 succession classes per BpS
* Build a platform for understanding our ecosystems historically, and for gaming out how they might change under future conditions and management
To do so we worked with hundreds of experts to build state-and-transition models in modeling software. We now use SyncorSim, which will be the focus of this page.
On this page you will find guidance on how to:
* Download and install SyncroSim
* Load all LANDFIRE BpS models using the LANDFIRE Package
* Isolate a subset of BpS models
* Explore the models you are interested in
*Note, there are many resources for these steps on the internet, so this page will cover the highlights, and point to those resources at the bottom,*
## Download and install SyncroSim
Installing SyncroSim is similar to installing most software, i.e., you download the application, then click to start an installer, etc. A few points about this particular software:
* Find the software at https://syncrosim.com/
* We typically accept all defaults when installing
* Installing on a governmental machine will likely present challenges.
## Load all LANDFIRE BpS models using the LANDFIRE Package
While SyncroSim is powerful as downloaded, adding 'packages' will bring even more functionality. For our work you will need to add in the St-Sim and landfirevegmodels packages. In SyncroSim:
1. Go to File -> Packages. Click the "Install" button. See "Packages Pane" screenshot below.
2. From the list check the "St-Sim" and "landfirevegmodels" packages, when click "OK". The install will happen automatically. See "Select packages" screenshot below.
3. Close the "Packages" window.
Once you have those packages installed, you are ready to bring in the LANDFIRE vegetation models. To do that will take a few steps:
*Note: you will need internet for this section.*
1. Go to File -> New... This will bring up a "New Library" window.
2. In the New Library window highlight "landfirevegmodels" at the top of the window, *then* select "Reference Models" near the bottom. See "New Library Selections" screenshot below.
3. Note where the "Reference Models" library will be saved. Change if needed. Hit "OK", then grab a beverage as this will take a few minutes.
*Note: an "Update Library" window may open once the Reference Models library is downloaded. Click "Apply" at the bottom of that window to proceed.*
Once you complete these steps, SyncroSim will have downloaded and loaded the LANDFIRE BpS Reference Condition Models library into your "Library Explorer" window.
#### Screenshots of loading LANDFIRE Package and Reference Conditions Library
<br>
*Packages Pane*
{fig-alt="\"Packages pane in SyncroSim"}
------------------------------------------------------------------------
<br>
*Select packages*
{fig-alt="Select Packages Pane with landfirevegetationmodels and St-Sim packages checked and ready to install."}
## Isolate a subset of BpS models
We assume you will not want to explore all 900+ LANDFIRE models, so outline how to subset one or more individual models below.
1. For good luck close and re-open SyncroSim. Seriously, after installing packages and libraries some of the functions just work better if you do so.
2. If it is not there, open the LANDFIRE BpS Reference Condition Models library by going to File -> Open then navigating to the "Reference-Condition-Models.ssim" file, likely in your SyncroSim directory. You will then click "Open".
3. Once opened, the LANDFIRE BpS Reference Condition Models will be in the Library Explorer pane. You will also see, within the library, a "project" named "Definitions" and a "Scenaro" named "Reference Condition Models".
4. Click the "Reference Condition Models" scenario once to highlight it. See "Select Scenario" screenshot below.
5. Go to Edit -> Export LFVM Strata to bring up the selection window. See "Export Strata" screenshot below.
6. Once at the Export LFVM Strata window, you will check the BpSs of interest, give a file name for the new library and assign a folder that it will be saved to. See "Create new library with selected strata" screenshot below.
*Note: we do not suggest selecting many strata at once until you are familiar with the modeling process. Stick to 1-3 initially.*
#### Screenshots of Isolating a model
<br>
*Select scenario*
{fig-alt="\"Highlighting a scenario in SyncroSim in the Library Explorer pane"}
------------------------------------------------------------------------
<br>
*Export Strata*
{fig-alt="Export strata tool."}
------------------------------------------------------------------------
<br>
*Create new library with selected strata*
{fig-alt="Export strata tool with specific strata selected, a new library name and a location for the new library. "}
<br>
----------------------------------------------------------------------------
## Explore the models you are interested in
OK you are doing a great job. Now you have a library with a subset of strata (i.e., BpSs in this case) that you care about. Now what?
By exploring the BpS models you can learn how the modeling experts parameterized them, and more interactively see how the disturbances and states all fit together.
Start exploring:
1. Double click on "Reference Condition Models" then the Transition Pathways tab.
2. To make viewing easier go to Window -> Arrange All.
3. At the bottom will be tabs of all of the BpSs that are in this library. Click any one. See "Transitions Pane".
4. Click on any box to see the pathways associated with that state (i.e., succession class).
5. If you want to run the scenario:
* Go to "Output Options" tab within the scenario, make sure that the "State classes every" box is set to 100 (i.e., not "1"). See "State Class Outputs" screenshot below.
* Go to "Run Control tab" and set the 'Total iterations' to 2.
* In the "Initial Conditions" tab, insure that the "Total Acres"and "Number of Simulation cells" boxes both have "1,000"
For exploring we recommend these three steps as it will speed up your runs.
* In the Library Explorer highlight the scenario, then click the small green triangle at the top of the screen. See "Run your model" screenshot below.
6. Make a chart by clicking the "New" icon in the "Charts" pane, then name it appropriately. See "Start new chart" screenshot below. You will change some settings to get your first chart:
* Change Line Chart to Column Chart (top left of window)
* Under "State Classes" select "Proportion"
* Under "Disaggregate by" check the "State Class" box
* Under "Include Data For", click "State Class" then select the appropriate state classes
* *Note: if you have multiple BpSs, you will also want to go to and select one "Model" under the "Include Data For" dropdown*
* Click "Apply"
See "Set up your column chart" screenshot below.
"State Class Outputs"
"Run your model"
"Set up your column chart"
#### Screenshots of Running a Model and Making a Chart
<br>
*State Class Outputs*
{fig-alt="Setting up state class outputs "}
------------------------------------------------------------------------
<br>
*Run your model*
{fig-alt="Highlighting the run button in SyncroSim"}
------------------------------------------------------------------------
<br>
*Start your chart*
{fig-alt="Starting a chart and naming it."}
------------------------------------------------------------------------
<br>
*Set up your column chart*
{fig-alt="Setting up new chart"}
<br>
----------------------------------------------------------------------------
## Additional Resources
* https://thenatureconservancy.github.io/landfiremodels/