{"_id":"574d0ffb6f075519007da3cb","category":{"_id":"574c1afbcf99610e00ef7d2b","__v":0,"project":"574a3bc0d1d1381900b73fab","version":"574a3bc0d1d1381900b73fae","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-05-30T10:50:35.767Z","from_sync":false,"order":9999,"slug":"documentation-1","title":"1. Forest Description"},"project":"574a3bc0d1d1381900b73fab","user":"574a38c455098f0e00f065cc","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"},"__v":49,"parentDoc":null,"githubsync":"","metadata":{"title":"","description":"","image":[]},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-05-31T04:15:55.706Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"The forest asset information within the standard forest description describes the majority of the actual physical forestry information of the forest assets.  Typically these types of information include age, area, growth and yield, possible log products at thinning and clearfell, costs of forest management and costs of production.\n\nThese types of data once defined are normally static within the forest description and forest estate model.  These types of data are normally revisited annually and updated as new information about the estate are measure and developed.\n\nThe forest asset information is held on the following worksheets:\n\n1. [Worksheet 'Plunits'](doc:forest-information#worksheet-plunits)\n\n2. [Worksheet 'Tending'](doc:forest-information#worksheet-tending--regime)\n\n3. [Worksheet 'Regime'](doc:forest-information#worksheet-tending--regime)\n\n4. [Worksheet 'Croptype'](doc:forest-information#worksheet-croptype--cost)\n\n5. [Worksheet 'Cost'](doc:forest-information#worksheet-croptype--cost)\n\n6. [Worksheet 'Carbon'](doc:forest-information#worksheet-carbon)\n\n7. [Worksheet 'Other'](doc:forest-information#worksheet-other)\n\n<br />\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Worksheet 'Plunits'\"\n}\n[/block]\nThe worksheet 'Plunits' contains the planning unit (Plunit) data that describe the area age-class structure of the entire forest estate, its growth and yield, its cost structure and other tabular attribute data that can be used in modelling constraints and solution reporting.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Mandatory Worksheet\",\n  \"body\": \"The worksheet 'Plunits' is a mandatory worksheet in the forest description workbook.\"\n}\n[/block]\nThe worksheet structure is based around individual plunit entries on each row, with both mandatory and optional groups of data attributes entered for each plunit via worksheet the columns.\n\nData always start at Cell 'B5'.  The Columns 'B' to 'R' are mandatory, and must be kept in the same structure and location as the standard forest description template defines.\n\nColumns 'S' onward are user-definable and hold attribute data for each plunit that the user deems needed in the model, either for formulating modelling constraints or defining groupings of plunits that need to be analyzed during solution reporting.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/yev9VFDsRnGbIX4ui05e_data_rows_columns.jpg\",\n        \"data_rows_columns.jpg\",\n        \"1179\",\n        \"639\",\n        \"#274c56\",\n        \"\"\n      ],\n      \"sizing\": \"full\",\n      \"caption\": \"Plunits are defined in rows and tabular attribute data in columns.\"\n    }\n  ]\n}\n[/block]\n<br />\nThe Columns 'B' to 'R' are mandatory columns that need to be in the same ordinal position as the standard fores description provides, that is, extra columns cannot be inserted, and columns can not be re-positioned on the worksheet.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"Plunits can be defined without a year of establishment (YOE) entry and without an area entry if they define optional management alternatives for the current rotation or possible replanting options for the future rotation.  However, if a plunit is defined with an area then a YOE must be entered, and if an area is entered then so too must a year of establishment.\"\n}\n[/block]\n<br />\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Mandatory Data Requirments\"\n}\n[/block]\nThe mandatory data requirements and standard rules for entering these mandatory plunit data are:\n\n1. The plunit name in Column 'B' be needs to be a unique entry that does no occur in any other rows as another plunit name.\n\n2. All plunits with both area and year of establishment (YOE) data form the 'Current Rotation' of the estate that exists at the beginning of the first modelling period.\n\n3. The area of each plunit is defined in Column 'C'.  This is the net-stocked area (NSA) which will be available for clearfell and will generate age-dependent operating costs.\n\n4. Each plunit's YOE in Column 'D' is an actual calendar year, being the planting year of the planning unit.  **The YOE is not an age, i.e. it is not the plunit's current age in the model**.\n\n5. Each plunit needs a mandatory Species entry in Column 'E'.  These Species data are used elsewhere in the model for defining constraints and market allocation information.  A NULL entry is not allowed for a plunit in Column 'E' to defined its Species.\n\n6. Each plunit needs a mandatory Origin entry in Column 'F'.  These Origin data are used on the worksheet 'Transport' and worksheet 'Distance' to define the matrix of costs and distances that are used in the market allocation information.  A NULL entry is not allowed for a plunit in Column 'F' to defined its Origin.\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/kd8tjyuiQfGCYKUJN2fh_basic_plunit_data.jpg\",\n        \"basic_plunit_data.jpg\",\n        \"1179\",\n        \"639\",\n        \"#274855\",\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/NBCChZ4yQBylOP3I8jN7_core_data_classes.jpg\",\n        \"core_data_classes.jpg\",\n        \"1179\",\n        \"639\",\n        \"#274755\",\n        \"\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n<br />\n<br />\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Worksheet 'Tending' & 'Regime'\"\n}\n[/block]\nTree-Age dependent information normally associated with age based forest management silviculture and tending operations.\n\nTree-Age dependent information normally associated with production thinning based log product yield information.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Optional Worksheet\",\n  \"body\": \"The worksheet 'Tending' is an optional worksheet in the forest description workbook.\"\n}\n[/block]\n<br />\n<br />\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Worksheet 'Croptype' & 'Cost'\"\n}\n[/block]\nClearfell-Age dependent information normally associated with yield tables that detail log out-turn.\n\nClearfell-Age dependent information normally associated with the costs of clearfelling, loading, harvest roading and any marketing overheads and expenses.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"The worksheet 'Croptype' is a mandatory worksheet in the forest description workbook.\",\n  \"title\": \"Worksheet 'Croptype' is Mandatory\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Worksheet 'Cost' is Optional\",\n  \"body\": \"The worksheet 'Regime' is an optional worksheet in the forest description workbook.\"\n}\n[/block]\n<br />\n<br />\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Worksheet 'Carbon'\"\n}\n[/block]\nThe carbon sequestration data for the individual planning units within the model. Information about the stem release and the decay release are also detailed on this worksheet.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Optional Worksheet\",\n  \"body\": \"The worksheet 'Carbon' is an optional worksheet in the forest description workbook.\"\n}\n[/block]\n<br />\n<br />\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Worksheet 'Other'\"\n}\n[/block]\nA less structured worksheet that allows costs and non-timber revenues to be easily defined that only apply to discreet subsets of the forest estate. Overheads costs normally defined.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Optional Worksheet\",\n  \"body\": \"The worksheet 'Other' is an optional worksheet in the forest description workbook.\"\n}\n[/block]","excerpt":"The fundamental data and information about the forest assets in the forest estate model","slug":"forest-information","type":"basic","title":"Forest Information"}

Forest Information

The fundamental data and information about the forest assets in the forest estate model

The forest asset information within the standard forest description describes the majority of the actual physical forestry information of the forest assets. Typically these types of information include age, area, growth and yield, possible log products at thinning and clearfell, costs of forest management and costs of production. These types of data once defined are normally static within the forest description and forest estate model. These types of data are normally revisited annually and updated as new information about the estate are measure and developed. The forest asset information is held on the following worksheets: 1. [Worksheet 'Plunits'](doc:forest-information#worksheet-plunits) 2. [Worksheet 'Tending'](doc:forest-information#worksheet-tending--regime) 3. [Worksheet 'Regime'](doc:forest-information#worksheet-tending--regime) 4. [Worksheet 'Croptype'](doc:forest-information#worksheet-croptype--cost) 5. [Worksheet 'Cost'](doc:forest-information#worksheet-croptype--cost) 6. [Worksheet 'Carbon'](doc:forest-information#worksheet-carbon) 7. [Worksheet 'Other'](doc:forest-information#worksheet-other) <br /> [block:api-header] { "type": "basic", "title": "Worksheet 'Plunits'" } [/block] The worksheet 'Plunits' contains the planning unit (Plunit) data that describe the area age-class structure of the entire forest estate, its growth and yield, its cost structure and other tabular attribute data that can be used in modelling constraints and solution reporting. [block:callout] { "type": "warning", "title": "Mandatory Worksheet", "body": "The worksheet 'Plunits' is a mandatory worksheet in the forest description workbook." } [/block] The worksheet structure is based around individual plunit entries on each row, with both mandatory and optional groups of data attributes entered for each plunit via worksheet the columns. Data always start at Cell 'B5'. The Columns 'B' to 'R' are mandatory, and must be kept in the same structure and location as the standard forest description template defines. Columns 'S' onward are user-definable and hold attribute data for each plunit that the user deems needed in the model, either for formulating modelling constraints or defining groupings of plunits that need to be analyzed during solution reporting. [block:image] { "images": [ { "image": [ "https://files.readme.io/yev9VFDsRnGbIX4ui05e_data_rows_columns.jpg", "data_rows_columns.jpg", "1179", "639", "#274c56", "" ], "sizing": "full", "caption": "Plunits are defined in rows and tabular attribute data in columns." } ] } [/block] <br /> The Columns 'B' to 'R' are mandatory columns that need to be in the same ordinal position as the standard fores description provides, that is, extra columns cannot be inserted, and columns can not be re-positioned on the worksheet. [block:callout] { "type": "info", "body": "Plunits can be defined without a year of establishment (YOE) entry and without an area entry if they define optional management alternatives for the current rotation or possible replanting options for the future rotation. However, if a plunit is defined with an area then a YOE must be entered, and if an area is entered then so too must a year of establishment." } [/block] <br /> [block:api-header] { "type": "basic", "title": "Mandatory Data Requirments" } [/block] The mandatory data requirements and standard rules for entering these mandatory plunit data are: 1. The plunit name in Column 'B' be needs to be a unique entry that does no occur in any other rows as another plunit name. 2. All plunits with both area and year of establishment (YOE) data form the 'Current Rotation' of the estate that exists at the beginning of the first modelling period. 3. The area of each plunit is defined in Column 'C'. This is the net-stocked area (NSA) which will be available for clearfell and will generate age-dependent operating costs. 4. Each plunit's YOE in Column 'D' is an actual calendar year, being the planting year of the planning unit. **The YOE is not an age, i.e. it is not the plunit's current age in the model**. 5. Each plunit needs a mandatory Species entry in Column 'E'. These Species data are used elsewhere in the model for defining constraints and market allocation information. A NULL entry is not allowed for a plunit in Column 'E' to defined its Species. 6. Each plunit needs a mandatory Origin entry in Column 'F'. These Origin data are used on the worksheet 'Transport' and worksheet 'Distance' to define the matrix of costs and distances that are used in the market allocation information. A NULL entry is not allowed for a plunit in Column 'F' to defined its Origin. [block:image] { "images": [ { "image": [ "https://files.readme.io/kd8tjyuiQfGCYKUJN2fh_basic_plunit_data.jpg", "basic_plunit_data.jpg", "1179", "639", "#274855", "" ], "sizing": "full" } ] } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/NBCChZ4yQBylOP3I8jN7_core_data_classes.jpg", "core_data_classes.jpg", "1179", "639", "#274755", "" ], "sizing": "full" } ] } [/block] <br /> <br /> [block:api-header] { "type": "basic", "title": "Worksheet 'Tending' & 'Regime'" } [/block] Tree-Age dependent information normally associated with age based forest management silviculture and tending operations. Tree-Age dependent information normally associated with production thinning based log product yield information. [block:callout] { "type": "info", "title": "Optional Worksheet", "body": "The worksheet 'Tending' is an optional worksheet in the forest description workbook." } [/block] <br /> <br /> [block:api-header] { "type": "basic", "title": "Worksheet 'Croptype' & 'Cost'" } [/block] Clearfell-Age dependent information normally associated with yield tables that detail log out-turn. Clearfell-Age dependent information normally associated with the costs of clearfelling, loading, harvest roading and any marketing overheads and expenses. [block:callout] { "type": "warning", "body": "The worksheet 'Croptype' is a mandatory worksheet in the forest description workbook.", "title": "Worksheet 'Croptype' is Mandatory" } [/block] [block:callout] { "type": "info", "title": "Worksheet 'Cost' is Optional", "body": "The worksheet 'Regime' is an optional worksheet in the forest description workbook." } [/block] <br /> <br /> [block:api-header] { "type": "basic", "title": "Worksheet 'Carbon'" } [/block] The carbon sequestration data for the individual planning units within the model. Information about the stem release and the decay release are also detailed on this worksheet. [block:callout] { "type": "info", "title": "Optional Worksheet", "body": "The worksheet 'Carbon' is an optional worksheet in the forest description workbook." } [/block] <br /> <br /> [block:api-header] { "type": "basic", "title": "Worksheet 'Other'" } [/block] A less structured worksheet that allows costs and non-timber revenues to be easily defined that only apply to discreet subsets of the forest estate. Overheads costs normally defined. [block:callout] { "type": "info", "title": "Optional Worksheet", "body": "The worksheet 'Other' is an optional worksheet in the forest description workbook." } [/block]