{"_id":"574c1b10281b010e00008fa6","githubsync":"","parentDoc":null,"project":"574a3bc0d1d1381900b73fab","__v":129,"category":{"_id":"574a3bc0d1d1381900b73faf","version":"574a3bc0d1d1381900b73fae","project":"574a3bc0d1d1381900b73fab","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-05-29T00:45:52.959Z","from_sync":false,"order":1,"slug":"documentation","title":"Introduction"},"user":"574bfb9290d8b32000864973","version":{"_id":"574a3bc0d1d1381900b73fae","project":"574a3bc0d1d1381900b73fab","__v":7,"createdAt":"2016-05-29T00:45:52.939Z","releaseDate":"2016-05-29T00:45:52.939Z","categories":["574a3bc0d1d1381900b73faf","574be6d52aa7221700c51bed","574c0b6d281b010e00008f89","574c1afbcf99610e00ef7d2b","574d13b9a1f0be2000ae3803","574d14140db0870e0075382d","591eb3a72c1b1f0f000fa9f2"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"3517.0.0","version":"3517"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-05-30T10:50:56.966Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"The Tigermoth software provides users with a standardized forest estate description and optimization framework for understanding and valuing forest assets.  It is used for describing, forecasting and analyzing the results of forest management strategies.\n\nForest owners, managers, investors, financiers and independent appraisers need to be able to readily and clearly understand the assumptions that underpin forest value.  The purpose of the software is to provide this clarity.\n\nThe software provides a consistent framework for forestry data, allowing the use of both continuous and integer constraints to produce a forest estate model that can then be optimized.\n\nThe solution of the optimization model is used to determine future wood flows and cash flows, and understand key metrics of the forest estate such as the net present value (NPV) of the individual forest assets.\n<br />\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"The Purpose of the Software\"\n}\n[/block]\n\n[block:embed]\n{}\n[/block]\nTigermoth is a forest estate modelling framework that has been designed to standardize forest estate description, optimization, valuation and compliance with financial reporting standards.\n\nForest estate modelling with optimization has been widely practiced since the 1970s and is well documented in many academic journals and publications (see Dykstra, Dennis P. c1984, Mathematical Programming for Natural Resource Management, ISBN 0-07-018552-2).\n\nForest estate models provide the means to explore forest management options from a “top-down” approach – that is, the performance of the whole forest resource can be examined at once.  Such systems may offer either optimization or simulation options or both. They allow the modelling of short, medium and long term forest wood flows. While in the first instance they are based on physical parameters associated with the forest – such as area and wood volume, they readily incorporate financial parameters. The latter are essential in identifying management strategies that are economically optimal.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ycHK6e63QQ6Oroqd9uG6_tm-overview.jpg\",\n        \"tm-overview.jpg\",\n        \"1462\",\n        \"932\",\n        \"#446a7f\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nForests are complex investments. Success depends on being able to measure the value of a forest at the time it is acquired and forecast its value accurately at the time it is sold. In between times, investors need to be able to manage and operate their forests with a full appreciation of how their choices and decisions will impact their investment.\n\nOften, this information needs to be communicated to third party groups. The Tigermoth modelling system gives investors in forest assets the ability to report on their operations with transparency, building confidence and trust among stakeholders.\n<br />\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"The Design Goals of the Software\"\n}\n[/block]\nThe software has been developed to achieve a series of fundamental design goals.  These are:\n\n1. The use of Microsoft Excel for all standard input and output requirements\n\n2. All forest description and management information to be held in a single workbook\n\n3. Avoidance of any type of cryptic or free-form ASCII text file formats\n\n4. Use of a normalized SQL database structure with a published schema\n\n5. The provision of Microsoft Excel valuation reporting and solution analysis templates\n\n<br />\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"The Components of the Modelling System\"\n}\n[/block]\nThe Tigermoth modelling system consists of three components:\n\n1. Standard Forest Description Data - Microsoft Excel data input workbook in a standard format.\n\n2. Optimization and Solution Analysis - Bespoke interface of the linear programming engine.\n\n3. Valuation and Results Reporting - Microsoft Excel valuation reporting workbooks.\n<br />\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/0hq8OUoUQxqxOkAp1qs8_tm-components.jpg\",\n        \"tm-components.jpg\",\n        \"1549\",\n        \"1044\",\n        \"#385f69\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n<br />\n<br />\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Component 1 - Standard Forest Description Data\"\n}\n[/block]\nThe standard forest description (SFD) is a single, stand-alone Microsoft Excel workbook.  The workbook contains a series of worksheets that hold the data needed for a forest estate model and forest asset valuation.\n\nThe standard forest description workbook can be most easily understood by considering it as a **biological balance sheet**.  It is a forest owner's best understanding of their existing forest assets at a particular point in time, being the date of the forest description.\n\nThe workbook has been designed to be easily understood and audited, and includes:\n\n1. Physical Forestry Asset Information\n\n2. Alternatives for Managing the Current Rotation\n\n3. Alternatives for Replanting the Future Rotations\n\n4. Harvest Planning and Wood Flow Management\n\n5. Log Market Logistics and Allocation\n\n<br />\nThe forest description workbook has been organized so that the worksheets flow from the physical forest data such as age and area on the left, through growth, yield, operational management, usage and finally market allocation and revenue on the right.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/cqS22wSyQYCy8yk60RbC_tm-description.jpg\",\n        \"tm-description.jpg\",\n        \"1055\",\n        \"842\",\n        \"#2b455e\",\n        \"\"\n      ],\n      \"sizing\": \"full\",\n      \"caption\": \"Example of the standard forest description workbook\"\n    }\n  ]\n}\n[/block]\nA full example of the standard forest description (SFD) in Microsoft Excel format can be downloaded and examined from the following link.  Note that all possible worksheets are shown in this example, whereas smaller models do not need all worksheets to be present.\n\n[block:embed]\n{\n  \"html\": false,\n  \"url\": \"http://tigermoth.s3.amazonaws.com/examples/Description%20-%20Standard%20Forest%20Description%20with%20all%20worksheets.xlsb\",\n  \"title\": \"Download an example of the Standard Forest Description workbook\",\n  \"favicon\": null\n}\n[/block]\n<br />\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Component 2 - Optimization and Solution Analysis\"\n}\n[/block]\nThe concepts behind formulating linear programming and mixed integer programming problems consist of four basic components:\n\n1. Decision variables representing the quantities to be determined,\n\n2. An objective function representing how the decision variables affect the value to be optimized,\n \n3. Constraints representing how the decision variables consume limited resources, and;\n \n4. Data that quantifies the relationships in the objective function and the constraints.\n\n<br />\nIn a linear program, the objective function and the constraints are linear relationships, meaning that the effect of changing a decision variable is proportional to its magnitude.  This provides a powerful and robust analytical methodology for supporting fact-based decision making.\n\nThe standard forest description in Microsoft Excel workbook holds all the data necessary to formulate the decision variables, constraints and objective function of a mathematical optimization problem that can be solved using a commercial optimizer such as <a href=\"http://www.mosek.com/products/mosek/\" target=\"_blank\">**MOSEK**</a>.\n\nThe entire forest estate is optimized over (say) 70+ years, while adhering to the forest management options and market constraints supplied in the standard forest description.  The objective function is set to maximize the net present value (NPV) of the entire forest estate.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/RTTxuzJTWe1smVTndTIf_tm-optimisation.jpg\",\n        \"tm-optimisation.jpg\",\n        \"1107\",\n        \"781\",\n        \"#217dc5\",\n        \"\"\n      ],\n      \"sizing\": \"full\",\n      \"caption\": \"Example of the optimization interface and results\"\n    }\n  ]\n}\n[/block]\nOnce an optimal solution to the forest estate model has been determined, the results can be interpreted and presented for analysis. Typically the wood flows that are forecast to arise over the 70+ year horizon of the model are shown graphically so that users can quickly interpret the results.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/q757P1QxQpuCcglxSy37_optimisation-woodflow.jpg\",\n        \"optimisation-woodflow.jpg\",\n        \"1107\",\n        \"781\",\n        \"#368bd1\",\n        \"\"\n      ],\n      \"sizing\": \"full\",\n      \"caption\": \"Graphical wood flow data forecast from the model's solution\"\n    }\n  ]\n}\n[/block]\nFunctionality is provided by the software interface so that users can drill-into more detailed levels of the wood flows and cash flows components, either graphically or in a tabular grid as shown below.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/2ufCaKAxQyy7G1Y1l7vN_optimisation-grid.jpg\",\n        \"optimisation-grid.jpg\",\n        \"1107\",\n        \"781\",\n        \"#aa5949\",\n        \"\"\n      ],\n      \"caption\": \"Tabular wood flow data forecast from the model's solution\",\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nUsers can then add, remove and change constraints and the forest estate model can be re-optimized to produce a new solution consistent with the requirements of the new constraints.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/tekEq3bVQPOSDmiCffYQ_tm-constraints.jpg\",\n        \"tm-constraints.jpg\",\n        \"1107\",\n        \"781\",\n        \"#2784d2\",\n        \"\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n<br />\n<br />\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Component 3 - Valuation and Results Reporting\"\n}\n[/block]\nSolution analysis within the interface has been designed to enable users to quickly develop alternative modelling scenarios to arrive at increasingly refined solutions. Users can then extract the results of the forest estate model into more detailed and comprehensive Microsoft Excel valuation and reporting templates.\n\nThe reporting templates have been designed to be used across all forest estates and to quickly extract and consolidate the solution into a standardized reporting format.  Users are free to change and alter the templates as they may require.\n\nThe standard types of Microsoft Excel templates that are provisioned by the software cover:\n\n1. Physical forest metrics and measures such as wood flow, age, area and forest growing stock\n \n2. Specialized forest valuation templates of varying degrees of complexity\n\n3. Carbon sequestration templates for reporting changes in forest estate carbon stocks\n\n4. 'Spread-Back' templates for assigning forest value across discreet components of the estate\n\n<br />\nAn example of a simple template that reports forest estate wood flow, the average age of harvesting, forest area, growth measures and annual changes in forest growing stock can be downloaded and reviewed from the following link.\n\n[block:embed]\n{\n  \"html\": false,\n  \"url\": \"http://tigermoth.s3.amazonaws.com/examples/Results%20-%20Forest%20metrics%20and%20measures.xlsb\",\n  \"title\": \"Download an example of a forest metrics and measures reporting template\",\n  \"favicon\": null\n}\n[/block]\n\n<br />\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/rURrEeySqO2g4pT16iD2_tm-statements.jpg\",\n        \"tm-statements.jpg\",\n        \"1591\",\n        \"984\",\n        \"#749857\",\n        \"\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ZWzoUKwEQbe6FjKxH25U_tm-valuation.jpg\",\n        \"tm-valuation.jpg\",\n        \"1605\",\n        \"1045\",\n        \"#79a252\",\n        \"\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]","excerpt":"What is Tigermoth, what does it do and what is the purpose of the software?","slug":"what-is-tigermoth","type":"basic","title":"What is Tigermoth?"}

What is Tigermoth?

What is Tigermoth, what does it do and what is the purpose of the software?

The Tigermoth software provides users with a standardized forest estate description and optimization framework for understanding and valuing forest assets. It is used for describing, forecasting and analyzing the results of forest management strategies. Forest owners, managers, investors, financiers and independent appraisers need to be able to readily and clearly understand the assumptions that underpin forest value. The purpose of the software is to provide this clarity. The software provides a consistent framework for forestry data, allowing the use of both continuous and integer constraints to produce a forest estate model that can then be optimized. The solution of the optimization model is used to determine future wood flows and cash flows, and understand key metrics of the forest estate such as the net present value (NPV) of the individual forest assets. <br /> [block:api-header] { "type": "basic", "title": "The Purpose of the Software" } [/block] [block:embed] {} [/block] Tigermoth is a forest estate modelling framework that has been designed to standardize forest estate description, optimization, valuation and compliance with financial reporting standards. Forest estate modelling with optimization has been widely practiced since the 1970s and is well documented in many academic journals and publications (see Dykstra, Dennis P. c1984, Mathematical Programming for Natural Resource Management, ISBN 0-07-018552-2). Forest estate models provide the means to explore forest management options from a “top-down” approach – that is, the performance of the whole forest resource can be examined at once. Such systems may offer either optimization or simulation options or both. They allow the modelling of short, medium and long term forest wood flows. While in the first instance they are based on physical parameters associated with the forest – such as area and wood volume, they readily incorporate financial parameters. The latter are essential in identifying management strategies that are economically optimal. [block:image] { "images": [ { "image": [ "https://files.readme.io/ycHK6e63QQ6Oroqd9uG6_tm-overview.jpg", "tm-overview.jpg", "1462", "932", "#446a7f", "" ] } ] } [/block] Forests are complex investments. Success depends on being able to measure the value of a forest at the time it is acquired and forecast its value accurately at the time it is sold. In between times, investors need to be able to manage and operate their forests with a full appreciation of how their choices and decisions will impact their investment. Often, this information needs to be communicated to third party groups. The Tigermoth modelling system gives investors in forest assets the ability to report on their operations with transparency, building confidence and trust among stakeholders. <br /> [block:api-header] { "type": "basic", "title": "The Design Goals of the Software" } [/block] The software has been developed to achieve a series of fundamental design goals. These are: 1. The use of Microsoft Excel for all standard input and output requirements 2. All forest description and management information to be held in a single workbook 3. Avoidance of any type of cryptic or free-form ASCII text file formats 4. Use of a normalized SQL database structure with a published schema 5. The provision of Microsoft Excel valuation reporting and solution analysis templates <br /> [block:api-header] { "type": "basic", "title": "The Components of the Modelling System" } [/block] The Tigermoth modelling system consists of three components: 1. Standard Forest Description Data - Microsoft Excel data input workbook in a standard format. 2. Optimization and Solution Analysis - Bespoke interface of the linear programming engine. 3. Valuation and Results Reporting - Microsoft Excel valuation reporting workbooks. <br /> [block:image] { "images": [ { "image": [ "https://files.readme.io/0hq8OUoUQxqxOkAp1qs8_tm-components.jpg", "tm-components.jpg", "1549", "1044", "#385f69", "" ] } ] } [/block] <br /> <br /> [block:api-header] { "type": "basic", "title": "Component 1 - Standard Forest Description Data" } [/block] The standard forest description (SFD) is a single, stand-alone Microsoft Excel workbook. The workbook contains a series of worksheets that hold the data needed for a forest estate model and forest asset valuation. The standard forest description workbook can be most easily understood by considering it as a **biological balance sheet**. It is a forest owner's best understanding of their existing forest assets at a particular point in time, being the date of the forest description. The workbook has been designed to be easily understood and audited, and includes: 1. Physical Forestry Asset Information 2. Alternatives for Managing the Current Rotation 3. Alternatives for Replanting the Future Rotations 4. Harvest Planning and Wood Flow Management 5. Log Market Logistics and Allocation <br /> The forest description workbook has been organized so that the worksheets flow from the physical forest data such as age and area on the left, through growth, yield, operational management, usage and finally market allocation and revenue on the right. [block:image] { "images": [ { "image": [ "https://files.readme.io/cqS22wSyQYCy8yk60RbC_tm-description.jpg", "tm-description.jpg", "1055", "842", "#2b455e", "" ], "sizing": "full", "caption": "Example of the standard forest description workbook" } ] } [/block] A full example of the standard forest description (SFD) in Microsoft Excel format can be downloaded and examined from the following link. Note that all possible worksheets are shown in this example, whereas smaller models do not need all worksheets to be present. [block:embed] { "html": false, "url": "http://tigermoth.s3.amazonaws.com/examples/Description%20-%20Standard%20Forest%20Description%20with%20all%20worksheets.xlsb", "title": "Download an example of the Standard Forest Description workbook", "favicon": null } [/block] <br /> [block:api-header] { "type": "basic", "title": "Component 2 - Optimization and Solution Analysis" } [/block] The concepts behind formulating linear programming and mixed integer programming problems consist of four basic components: 1. Decision variables representing the quantities to be determined, 2. An objective function representing how the decision variables affect the value to be optimized, 3. Constraints representing how the decision variables consume limited resources, and; 4. Data that quantifies the relationships in the objective function and the constraints. <br /> In a linear program, the objective function and the constraints are linear relationships, meaning that the effect of changing a decision variable is proportional to its magnitude. This provides a powerful and robust analytical methodology for supporting fact-based decision making. The standard forest description in Microsoft Excel workbook holds all the data necessary to formulate the decision variables, constraints and objective function of a mathematical optimization problem that can be solved using a commercial optimizer such as <a href="http://www.mosek.com/products/mosek/" target="_blank">**MOSEK**</a>. The entire forest estate is optimized over (say) 70+ years, while adhering to the forest management options and market constraints supplied in the standard forest description. The objective function is set to maximize the net present value (NPV) of the entire forest estate. [block:image] { "images": [ { "image": [ "https://files.readme.io/RTTxuzJTWe1smVTndTIf_tm-optimisation.jpg", "tm-optimisation.jpg", "1107", "781", "#217dc5", "" ], "sizing": "full", "caption": "Example of the optimization interface and results" } ] } [/block] Once an optimal solution to the forest estate model has been determined, the results can be interpreted and presented for analysis. Typically the wood flows that are forecast to arise over the 70+ year horizon of the model are shown graphically so that users can quickly interpret the results. [block:image] { "images": [ { "image": [ "https://files.readme.io/q757P1QxQpuCcglxSy37_optimisation-woodflow.jpg", "optimisation-woodflow.jpg", "1107", "781", "#368bd1", "" ], "sizing": "full", "caption": "Graphical wood flow data forecast from the model's solution" } ] } [/block] Functionality is provided by the software interface so that users can drill-into more detailed levels of the wood flows and cash flows components, either graphically or in a tabular grid as shown below. [block:image] { "images": [ { "image": [ "https://files.readme.io/2ufCaKAxQyy7G1Y1l7vN_optimisation-grid.jpg", "optimisation-grid.jpg", "1107", "781", "#aa5949", "" ], "caption": "Tabular wood flow data forecast from the model's solution", "sizing": "full" } ] } [/block] Users can then add, remove and change constraints and the forest estate model can be re-optimized to produce a new solution consistent with the requirements of the new constraints. [block:image] { "images": [ { "image": [ "https://files.readme.io/tekEq3bVQPOSDmiCffYQ_tm-constraints.jpg", "tm-constraints.jpg", "1107", "781", "#2784d2", "" ], "sizing": "full" } ] } [/block] <br /> <br /> [block:api-header] { "type": "basic", "title": "Component 3 - Valuation and Results Reporting" } [/block] Solution analysis within the interface has been designed to enable users to quickly develop alternative modelling scenarios to arrive at increasingly refined solutions. Users can then extract the results of the forest estate model into more detailed and comprehensive Microsoft Excel valuation and reporting templates. The reporting templates have been designed to be used across all forest estates and to quickly extract and consolidate the solution into a standardized reporting format. Users are free to change and alter the templates as they may require. The standard types of Microsoft Excel templates that are provisioned by the software cover: 1. Physical forest metrics and measures such as wood flow, age, area and forest growing stock 2. Specialized forest valuation templates of varying degrees of complexity 3. Carbon sequestration templates for reporting changes in forest estate carbon stocks 4. 'Spread-Back' templates for assigning forest value across discreet components of the estate <br /> An example of a simple template that reports forest estate wood flow, the average age of harvesting, forest area, growth measures and annual changes in forest growing stock can be downloaded and reviewed from the following link. [block:embed] { "html": false, "url": "http://tigermoth.s3.amazonaws.com/examples/Results%20-%20Forest%20metrics%20and%20measures.xlsb", "title": "Download an example of a forest metrics and measures reporting template", "favicon": null } [/block] <br /> [block:image] { "images": [ { "image": [ "https://files.readme.io/rURrEeySqO2g4pT16iD2_tm-statements.jpg", "tm-statements.jpg", "1591", "984", "#749857", "" ], "sizing": "full" } ] } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/ZWzoUKwEQbe6FjKxH25U_tm-valuation.jpg", "tm-valuation.jpg", "1605", "1045", "#79a252", "" ], "sizing": "full" } ] } [/block]