Yield Summary Tool

Overview

The Yield Summary tool provides comprehensive forest yield analysis by allowing you to select or draw areas of interest and analyze harvest yield data. This powerful tool helps foresters evaluate timber volumes, analyze yield patterns, and generate detailed reports for harvest planning and forest management.

Location: Report Tools panel → dropdown → Yield Summary

Key Capabilities:

• Select or draw analysis areas on the map
• Analyze yield data for polygon features
• Filter results by field attributes (age, type, etc.)
• Summary modes: individual features or grouped by coupe
• Interactive yield tables with detailed attributes
• Related feature analysis and correlation
• Export results to CSV format
• Dual table display for comprehensive analysis

Example Use Cases:

• Estimating timber volumes for harvest planning
• Analyzing yield by age class or forest type
• Evaluating cutting permit areas for volume projections
• Comparing yields across different coupes
• Generating yield reports for forest management plans

---

When to Use This Tool

Ideal Scenarios

Harvest Planning:

• Estimating timber volumes before operations
• Comparing yields across different areas
• Planning harvest sequences based on yields
• Volume projections for operational planning

Forest Management:

• Age class yield analysis
• Forest type productivity comparison
• Stand-level yield assessment
• Long-term harvest scheduling

Reporting Requirements:

• Generating yield summaries for management plans
• Documenting volume estimates
• Creating harvest projections
• Supporting AAC (Annual Allowable Cut) calculations

Analytical Studies:

• Yield curve development
• Growth and yield modeling validation
• Comparing actual vs. predicted yields
• Regional yield pattern analysis

Not Recommended For

• Individual tree cruising (use field measurement methods)
• Precise volume scaling (use post-harvest measurements)
• Financial valuations (use appraisal tools)
• Real-time harvest tracking (use production monitoring systems)

---

How to Use the Tool

Step 1: Select Target Layer

Click the Select Geometries From Layer dropdown to choose the polygon layer that Select Shape picks your analysis area from (the yield figures themselves always come from the Yield layer):

• Lists all visible polygon layers currently on the map
• Only layers with geometry type "polygon" appear
• Click dropdown to refresh layer list
• First available layer selected by default

Layer Requirements:

• Must be a polygon layer (a feature layer, or a map image layer with polygon sublayers)
• Layer must be visible on the map
• Does not need yield attributes — the Yield layer, which must also be on the map, supplies the yield data

If no layers appear, ensure you have polygon layers loaded and visible.

Step 2: Define Analysis Area

You have two methods to define your area of interest:

Method 1: Select Existing Feature

Click the Select Shape button (selector icon):

• Button shows active state when selection mode is on
• Click button to toggle selection mode on/off
• When active, click any feature from your selected layer on the map
• Selected feature highlights with blue fill
• Can select different feature by clicking again
• Only features from the selected layer can be picked

Selection Tips:

• Zoom to your area of interest first
• Click near feature center for best results
• Selection highlights with semi-transparent blue

Method 2: Draw Custom Polygon

Click the Draw Shape button (polygon icon):

• Button shows active state when drawing mode is on
• Click button to toggle drawing mode on/off
• When active, click on map to add vertices
• Continue clicking to define polygon boundary
• Double-click to complete the polygon
• Drawn graphic appears in the Target Layer graphics style (orange by default)

Drawing Tips:

• Start by clicking first vertex
• Continue around desired area
• Double-click to finish
• Drawing automatically deactivates when complete

Important: Select or draw before proceeding to summary. The analysis uses this geometry to intersect with the Yield layer.

Step 3: Run Initial Summary

Choose your summary mode by clicking one of the analysis buttons:

Summary Individually

Click the Summary Individually button (selection icon):

• Analyzes each intersecting feature separately
• Creates individual records for each yield polygon
• Maintains feature-level detail
• Best for detailed feature-by-feature analysis
• Calculated area shows intersection size for each feature

Summary and Union

Click the Summary and Union button (selection-filter icon):

• Groups features by COUPE attribute
• Combines (unions) features with same coupe value
• Creates merged polygons and aggregated attributes
• Best for coupe-level summaries
• Calculated area shows total for each coupe

Which to Use:

• Individual: When you need feature-level detail
• Union: When you want coupe totals and simplified results

Step 4: Review Yield Summary Table

After running summary, results open in a draggable, resizable Yield Summary dialog with a two-column layout displaying the Yield Feature Set and Related Feature Set tables. The dialog can be repositioned and resized to suit your workspace.

• Click Dock to Bottom to move results to the bottom panel for a wider view. Selecting rows there does not update the related table and the bottom panel has no Export CSV, so click Undock to return to the dialog for those. Drag the panel's top edge to make it taller or shorter (up to 60% of the window's height)
• Click Export CSV to download both datasets as a single CSV file — the button appears once you select a row in the Yield Feature Set table
• Click Close to dismiss the dialog

The Yield Feature Set table displays:

Table Contents:

• All intersecting features from the Yield layer
• Calculated area for each feature (in hectares)
• Attribute data (COUPE, YID, SPECIES, REGIME, PLANT_YEAR, etc.)
• Sortable and browsable

Table Interaction:

• Select Rows: Click rows to select features (Ctrl-click for multiple)
• Sorting: Click column headers to sort
• Review: Examine attributes and calculated areas

Key Action: When you select rows in this table, the related Yield Table automatically updates to show corresponding related records.

Step 5: Filter Related Yield Data (Optional)

Once you select rows in the Yield Feature Set table and the related records load, a Filter Yield Details section appears in the panel, below the analysis buttons:

Select Filter Field

A field dropdown appears showing available fields:

• Lists fields from the related yield data
• Fields: AGE, HA, CURRENT_AGE, the pruned (PR…) and unpruned (UP…) columns, PU08, Total and YID
• Select the field you want to filter by

Enter Filter Value

An input field appears below the dropdown:

• Enter the value to filter on
• Value type depends on field type (number or text)
• Must exactly match attribute values

Apply Filter

Click the Filter button (layer-filter icon):

• Filters the Yield Table to show only matching records
• Updates table display immediately
• Filtered results still support row selection

Reset Filter

Click the Reset button (reset icon) next to the filter:

• Removes filter criteria
• Restores all related yield records
• Returns to full dataset view

Step 6: Export Results

Click the Export CSV button (file-csv icon):

• Exports both Yield Feature Set and Related Feature Set
• Creates single CSV file with both datasets
• Headers identify each section
• Downloads as "YieldSummary.csv"
• Includes only selected rows from Yield Feature Set

Export Contents:

1. Yield Feature Set section (selected rows)
2. Related Feature Set section (corresponding related features)
3. All attribute fields except ID

Step 7: Reset Analysis

Click the Reset button (red reset icon) in the Draw row:

• Clears all graphics from map
• Removes analysis layers
• Clears filter values
• Deactivates selection and drawing modes
• Leaves the Yield Summary dialog open — click Close to dismiss it

---

Understanding the Results

Yield Feature Set Table

Location: Left-hand table of the Yield Summary dialog

Purpose: Shows direct intersection results between your drawn/selected area and the Yield layer

Key Columns:

• CALCULATED_AREA: Area of intersection in hectares
• COUPE: Cutting permit area identifier
• YID: Yield identifier (links to related features)
• Additional attributes: SPECIES, REGIME, PLANT_YEAR, OWNERSHIP and TACTICAL_PLAN_YEAR (age and volumes are in the related table)

Interpretation:

• Each row represents one intersecting yield polygon (Individual mode)
• Or one merged coupe polygon (Union mode)
• CALCULATED_AREA shows intersection size, not full polygon size
• YID may contain multiple values separated by "/" (Union mode)

Related Feature Set (Yield Table)

Location: Right-hand table of the Yield Summary dialog (appears after row selection)

Purpose: Shows detailed yield records related to selected features

How It Works:

1. Select rows in Yield Feature Set table
2. System extracts YID values from selected rows
3. Queries Yield layer for features matching those YIDs
4. Displays related records in Yield Table

Key Columns:

• AGE and CURRENT_AGE
• HA
• Pruned (PR50–PR20) and unpruned (UP40–UP20) columns, PU08 and Total
• YID (links back to the Yield Feature Set row)

Interpretation:

• Provides deeper detail than summary table
• Shows full yield record attributes
• Useful for detailed analysis
• Supports further filtering

Filter Results

When filtering is applied:

Field Selection:

• Choose attribute to filter (e.g., AGE)
• Only numeric and text fields are valid

Value Matching:

• Filter uses exact match (equals)
• Case-sensitive for text fields
• Must match attribute values exactly

Filtered Display:

• Yield Table shows only matching records
• Yield Feature Set table unchanged
• Selection still active
• Reset to clear filter

Summary Modes Comparison

Aspect	Individual	Union
Grouping	None - each feature separate	Grouped by COUPE
Geometry	Original intersected polygons	Merged polygons per coupe
CALCULATED_AREA	Individual feature areas	Combined area per coupe
YID Values	Single YID per row	Multiple YIDs separated by "/"
Detail Level	High - feature-by-feature	Lower - summarized by coupe
Best For	Detailed spatial analysis	Coupe-level volume summaries

---

Working with Results

Table Interaction

Selecting Features:

• Click rows to select (highlights in blue)
• Ctrl-click to select multiple rows
• Shift-click to select range
• Selected rows trigger Yield Table update

Sorting Data:

• Click column header to sort ascending
• Click again for descending
• Useful for finding highest/lowest values
• Sort by CALCULATED_AREA to see largest intersections

Reviewing Attributes:

• Scroll horizontally to see all columns
• Hover over cells for full values
• Use column headers to identify fields
• Review YID for tracking purposes

Analysis Workflows

Single Feature Analysis:

1. Select or draw area around one feature
2. Run Summary Individually
3. Review calculated area and attributes
4. Select row to see related yield details
5. Export for documentation

Multi-Feature Analysis:

1. Draw polygon covering multiple features
2. Run Summary Individually for detail
3. Sort by CALCULATED_AREA or other attribute
4. Select multiple rows for related data
5. Apply filters to refine results

Coupe-Level Summary:

1. Select or draw area covering multiple coupes
2. Run Summary and Union
3. Review merged coupe totals
4. Export aggregated results
5. Use for harvest planning

Age Class Analysis:

1. Run initial summary (either mode)
2. Select rows in Yield Feature Set
3. Use filter dropdown to select AGE field
4. Enter specific age value
5. Filtered Yield Table shows only that age class

Export Workflows

Standard Export:

1. Run analysis
2. Select relevant rows in Yield Feature Set
3. Click Export CSV button
4. Open CSV in spreadsheet software
5. Perform additional calculations or charting

Filtered Export:

1. Run analysis and select rows
2. Apply filter to Yield Table
3. Note that the filter changes only the on-screen table — Export CSV still writes every related record for the selected rows
4. To narrow the export, select fewer rows in the Yield Feature Set table
5. Filter the CSV in spreadsheet software if you need a single attribute value

Comparison Export:

1. Run multiple analyses (different areas)
2. Export each to separate CSV
3. Compare results in spreadsheet
4. Identify yield differences
5. Support decision-making

---

Best Practices

Layer Selection

Choose Appropriate Layer:

• Select the layer whose polygons you want to use as analysis areas (yield data always comes from the Yield layer)
• Ensure layer coverage matches analysis area
• Verify layer is current and up-to-date
• Check layer visibility before starting

Layer Preparation:

• Add required layers before opening panel
• Turn on layer visibility
• Zoom to area of interest
• Verify attribute table has expected fields

Area Definition

Selection Method:

• Use when exact feature boundaries needed
• Faster than drawing
• Ensures complete feature analysis
• Best for single feature or coupe

Drawing Method:

• Use for custom boundary analysis
• Cross multiple features
• Irregular areas of interest
• Flexible for exploratory analysis

Drawing Tips:

• Zoom in for precise vertex placement
• Use fewer vertices for smoother polygons
• Consider operational boundaries
• Double-check coverage before summary

Analysis Strategy

Exploratory Analysis:

1. Start with Individual summary for detail
2. Review all intersecting features
3. Identify patterns or anomalies
4. Re-run with Union for totals if needed

Reporting Analysis:

1. Use Union for cleaner coupe-level results
2. Export for inclusion in reports
3. Document parameters used
4. Archive results for future reference

Comparative Analysis:

1. Run analysis for multiple areas
2. Keep track of parameters
3. Export each result separately
4. Compare calculated areas and yields

Data Quality

Verify Results:

• Check that CALCULATED_AREA is reasonable
• Confirm YID values are valid
• Review related feature counts
• Cross-reference with map display

Attribute Validation:

• Spot-check attribute values
• Ensure field names match expectations
• Verify numeric fields are numbers
• Check for missing or null values

---

Troubleshooting

Common Error Messages

"No graphic layer found - Please draw a polygon first"

• Cause: Attempting to run summary without defining analysis area
• Solution: Use Select Shape or Draw Shape to define area before clicking summary buttons

"No Yield layer found - Please add the Yield layer first"

• Cause: Yield layer not found in map
• Solution:
  • Add the Yield layer to your map
  • Ensure layer is named correctly
  • Check layer visibility
  • Refresh map if layer was just added

Empty "Select Geometries From Layer" list (no message is shown)

• Cause: No visible polygon layers available for selection
• Solution:
  • Add polygon feature layers to map
  • Make layers visible
  • Click the Select Geometries From Layer dropdown again to refresh

"Query Failed - Failed to load related yield data"

• Cause: Error querying related features from Yield layer
• Solution:
  • Check network connection
  • Verify Yield layer is accessible
  • Try running analysis again
  • Contact support if issue persists

"Analysis Error - Failed to analyze layer"

• Cause: Error during spatial analysis operation
• Solution:
  • Verify drawn/selected geometry is valid
  • Check Yield layer is properly loaded
  • Try simpler geometry (fewer vertices)
  • Refresh page and try again

Performance Issues

Slow Summary Processing:

• Large areas with many intersections take longer
• Complex polygons increase processing time
• Solution: Use smaller analysis areas, simplify drawn geometry

Tables Not Appearing:

• May indicate no intersecting features found
• Check that analysis area overlaps Yield layer
• Solution: Verify geometry placement, try different area

Related Features Not Loading:

• May be network latency
• Large related feature sets take time
• Solution: Wait for loading to complete, avoid rapid row selections

Workflow Issues

Selection Not Working:

• Selection mode may be inactive
• Wrong layer may be selected
• Solution: Click Select Shape button to activate, verify layer dropdown

Drawing Not Working:

• Drawing mode may be inactive
• Previous drawing still present
• Solution: Click Draw Shape to activate, use Reset to clear previous

Can't Filter Yield Table:

• Filter options only appear after running summary
• Must select rows in Yield Feature Set first
• Solution: Run summary, select rows, then filter

Export Has No Data:

• Must select rows in Yield Feature Set before exporting
• No related features loaded
• Solution: Select rows in Yield Feature Set, verify related table loaded

Data Issues

Calculated Area Seems Wrong:

• May be intersection area, not full feature area
• Units are in hectares
• Solution: Verify geometry overlaps features correctly

Missing YID Values:

• Some features may not have yield data assigned
• Solution: Check source data, contact data administrator

Duplicate Features in Results:

• May occur if Union mode used with varied COUPE values
• Solution: Verify COUPE attributes are consistent, use Individual mode for detail

Getting Help

When contacting support, please provide:

1. Analysis Parameters:

   • Selected layer name
   • Summary mode used (Individual vs. Union)
   • Filter settings (if applicable)
   • Screenshot of selections

2. Error Details:

   • Exact error message
   • Steps taken before error
   • Whether geometry was drawn or selected

3. Geometry Information:

   • Size and complexity of analysis area
   • Number of expected intersecting features
   • Screenshot of map with geometry

4. System Information:

   • Browser type and version
   • Horizon version
   • Date and time of analysis