Treatment Program Generator Design - Revision history

Peder at 07:32, 26 May 2010

2010-05-26T07:32:35Z

Fkl: /* Creating Generation 2-n */

2010-05-24T07:33:48Z

Creating Generation 2-n

Fkl: /* Creating Generation 2-n */

2010-05-21T13:54:49Z

Creating Generation 2-n

Fkl: /* Creating Treatment Specifications */

2010-05-21T13:32:09Z

Creating Treatment Specifications

Fkl: /* Creating Even Aged Treatment Programs */

2010-05-21T13:04:29Z

Creating Even Aged Treatment Programs

Fkl: /* Creating Continous Management and Unmanaged Treatment Programs */

2010-05-21T12:44:33Z

Creating Continous Management and Unmanaged Treatment Programs

Fkl: /* Creating Treatment Programs for an analysis area */

2010-05-21T12:41:59Z

Creating Treatment Programs for an analysis area

2010-05-21T12:34:54Z

Created page with '== Creating Treatment Programs for an analysis area == Klassen TreatmentProgramManager håller ihop generering av skötselprogram för ett analysområde. Algoritmen för att gö�?�'

New page

← Older revision		Revision as of 07:32, 26 May 2010
Line 1:		Line 1:
		+	[[Category:System design]]
	== Creating Treatment Programs for an analysis area ==		== Creating Treatment Programs for an analysis area ==

@@ Line 82: / Line 82: @@
 === Creating Generation  2-n ===
-First time a second generation is created it must be simulated, but as the treatment program generates more programs for a treatment unit, treatment specifications and results from a generation can be reused to get better performance.
+First time a second generation is created it must be simulated, but as the treatment program generates more programs for a treatment unit, treatment specifications and results from a generation are reused whenever possible, to get better performance.
 When a generation is finished and if it is complete (from regeneration to final felling), the treatment specification for it is saved. The treatment specifications are saved per control category, and separeted for generations that started with trees from an earlier generation (seed trees or shelterwood). The specification are sorted, with highest net present value first.
@@ Line 101: / Line 103: @@
 ;CopyBestSaved: Several generations are created with result copied from saved treatment programs. No new simulation required. SameControlCat and SavedSpecs, and SameStartState must be true.
 ;RepeatBestSaved: Several generations are created from saved specifications. New simulations required. SameControlCat and SavedSpecs must be true.
-;GenerateNew: Both new specifications and new simulation is done.
+;GenerateNew: Both new specifications and new simulation is done. Used when none of the methods above can be used.
 A special case occurs when the treatment program generator is invoked from StandWise. In this case the copy methods above are not allowed. This is due to the fact the copied results not are stored in the treatment unit, and diagrams and tables in StandWise only shows results from the treatment unit.
@@ Line 108: / Line 110: @@
 # First alternative of generation 1 is simulated.
-## GenerateNew First alternative of generation 2 is simulated, specification is saved
+## First alternative of generation 2 is simulated, specification is saved (GenerateNew)
-### CopyPreviousGeneration
+### Only alternative of generation 3 (CopyPreviousGeneration)

@@ Line 81: / Line 81: @@
 === Creating Generation  2-n ===
-Exempel på hur detta kan ske:
+First time a second generation is created it must be simulated, but as the treatment program generates more programs for a treatment unit, treatment specifications and results from a generation can be reused to get better performance.
-Generation 1	Generation 2	Generation 3-n	Kommentar
-Gen 1 Alt 1 skapas	Gen 2 alt 1 skapas, specifikation sparas	Gen 2 alt 1 kopieras	Resultat från generation 2 kopieras till generation 3
+When a generation is finished and if it is complete (from regeneration to final felling), the treatment specification for it is saved. The treatment specifications are saved per control category, and separeted for generations that started with trees from an earlier generation (seed trees or shelterwood). The specification are sorted, with highest net present value first.
-	Gen 2 alt 2 skapas, specifikation sparas	Gen 2 alt 2 kopieras	Anta att detta alternativ har högre nuvärde, då sparas det först
-Gen 1 Alt 2 skapas	Gen 2 Alt 2 kopieras	(skapas redan vid kopiering av gen 2)	Bästa resultatet kopieras först.
+Also, treatment programs are saved when they are complete.
-	Gen 2 Alt 1 kopieras	(skapas redan vid kopiering av gen 2)	Näst bästa resultatet kopieras

@@ Line 37: / Line 37: @@
 === Creating Treatment Specifications ===
-En skötselspecifikation innehåller en beskrivning av när röjning, första gallring och slutavverkning ska ske (röjning och första gallring kan vara utelämnade, slutavverkning finns alltid med). Målet med att skapa skötselspecifikationer är att ta fram de kombinationer som är möjliga, utifrån användarens inställningar och skogens tillstånd.
+A treatment specification contains a description on when cleaning, first thinning, and final felling can be done (cleaning and thinning can be omitted, final felling is always present in a treatment specification).
-Först bestämmer man vilka åtgärder som är möjliga. , för röjning och gallring innebär det att man skriver fram åtgärdsenheten och provar när röjning och gallring är möjligt. Utifrån användarens inställningar har man nu fått fram 1-3 åtgärder med ett område för varje åtgärd i varsin TreatmentSpecificationRange.
-Det kan se ut så här:
+The purpose of treatment specifications is to generated all possible combinations of even aged management, based on user settings and of course the state of the treatment unit.
-period 4-5
-period 8-10
+First it is determined when and if the treatments can be performed. For final felling lowest final felling age is calculated (according SVL, Skogsvårdslagen). For cleaning and thinning growth prognosis has to be made and in each period it is evaulated if the treatment is possible. Each treatment is then stored in a <tt>TreatmentSpecificationRange</tt>. It may look like this:
-period 10-14
-Därefter sorteras åtgärderna i omvänd prioritetsordning, så att den åtgärd som har högst prioritet (ska varieras mest) ligger sist. :
+# Cleaning period 4-5
-period 4-5
+# Thinning period 8-10
-period 10-14
+# Final Felling period 10-14
-period 8-10
-Sista steget är att utifrån framräknade områden ta fram en lista över specifikationer som är möjliga. Det sker i två delsteg, först skapas alla permutationer som är möjliga (med hjälp av klassen TreatmentSpecificationEnumerator), därefter filtreras de permutationer som inte är tillåtna bort (av klassen TreatmentSpecificationCollection). Det kan se ut så här:
+Thereafter the ranges are sorted in reverse priority, so that the treatment with highest priority (which will be varied most) is last. If the priority order (set by the user) is thinning - final felling - cleaning then the list above will look like this after sorting:
-Röjning	Slutavverkning	Gallring	Kommentar
-	10	8
+# Cleaning period 4-5
-	10	9
+# Final Felling period 10-14
-	10	10	Filtreras bort eftersom gallring och slutavverkning inte kan ske samtidigt
+# Thinning period 8-10
 	11	8
-	11	9
+The last step is to, from the ranges, create a list of possible specifications. The class <tt>TreatmentSpecificationEnumerator</tt> creates an enumeration of all possible treatment specifications from the ranges and the class <tt>TreatmentSpecificationCollection</tt> filters the invalid permutations.
 	11	10
-	10	8
+It might look like this:
-osv
 === Creating Generation  2-n ===
 Första gången generation 2 skapas måste den simuleras fram, men när skötselprogramgeneratorn skapar fler alternativ för generation 1 och senare generationer kan specifikationer och resultat återanvändas. Det går till så här:

@@ Line 19: / Line 19: @@
 == Creating Even Aged Treatment Programs ==
-Generera skötselprogram för trakthyggesbruk är mer komplext. Nedanstående diagram visar principen för detta:
+Creating even aged treatment programs is more complex. A number of generations of the forest has to be created (a forest generation starts with regeneration and ends with final felling). An even aged treatment program must contain at least one complete generation, even if the planning horizon is shorter (net present value cannot be calculated if not a complete generation is present).
-−
-Initiering sker en gång per åtgärdsenhet. Behövs föryngring sker det och åtgärdsenheten skrivs i så fall fram så långt att föryngringen aktiverats på alla provytor.
+Even aged treatment programs are created based on treatment specifications (specifying when cleaning, first thinning, and final felling should be done) and fertilization policies (specifying if and how fertilization should be done). During the generation, a number of treatment specifications are evaluated, but the same fertilization policy is always applied for a given generation and control category. The latter also applies to regeneration.
-Skötselspecifikationer skapas först för den första generationen en gång, sedan kan detta upprepas flera gånger för kommande generationer och alternativ.
-Ett alternativ skapas för varje skötselspecifikation. . Därefter tillämpas även eventuell gödslingspolicy.
+Each forest domain contains one or more control categories. For each control category, it is specified if the control category is to be used in generation 1, generation 2 (and forward), or both. Treatment programs will be generated for each control category in the generation being in progress.
-Sedan fortsätter man att skapa fler generationer till dess planeringshorisonten är nådd och det finns minst en komplett generation. Diagrammet ovan visar hur nya generationer simuleras, det finns även andra varianter för att skapa nya generationer, mer om det nedan.
 === Creating Treatment Specifications ===

@@ Line 13: / Line 13: @@
 == Creating Continous Management and Unmanaged Treatment Programs ==
-Genering av skötselprogram för blädning och fri utveckling är trivialt. Man skriver helt enkelt fram åtgärdsenheten önskat antal perioder. För blädning utvärderar man i varje period om blädning är tillåtet och utför i så fall en blädning.
+Creating Continous Management and Unmanaged Treatment Programs is fairly trivial. Growth prognosis is done for the treatment unit until the planning horizon has been reached.
 == Creating Even Aged Treatment Programs ==

@@ Line 1: / Line 1: @@
 == Creating Treatment Programs for an analysis area ==
-Klassen TreatmentProgramManager håller ihop generering av skötselprogram för ett analysområde.
+The class <tt>TreatmentProgramManager</tt> manages treatment program generation for an analysis area, as follows:
-Algoritmen för att göra detta är som följer:
-.	Utvärdera skogsdomäner och tilldela åtgärdsenheter till varje domän.
+# <tt>ForestDomains</tt> are evaluated and each treatment unit is assigned to a domain.
-.	För varje domän:
+# For each domain:
-.1.	Fördela v för naturvårdshänsyn
+## Treatment units are set aside for nature conservation
-.2.	Skapa vanliga skötselprogram för åtgärdsenheter som inte är avsatta
+## For treatment units that not has been set aside, the <tt>TreatmentProgramGenerator</tt> is called and treatment programs of the desired types (unmanaged, continuous management, or even aged management, given by the user) are generated
-.3.	Skapa skötselprogram med fri utveckling för avsatta åtgärdsenheter.
+## For treatment units that has been set aside, unmanaged treatment programs are generated by the <tt>TreatmentProgramGenerator</tt>.
-Skötselprogramgenereringen är både prestanda- och minneskrävande. För att få bra prestanda vid läsning från databas läser man i steg 2.2 och 2.3 ovan upp 20 åtgärdsenheter åt gången (eller så många som är kvar om det är färre än 20). För att minska minnesutnyttjandet släpper man minnet för en åtgärdsenhet när alla skötselprogram för den är klara.
 == Creating Continous Management and Unmanaged Treatment Programs ==