Chapter 10: Monitoring Report Schema Development

This chapter teaches you how to build monitoring report schemas that handle time-series data collection and calculation updates. You'll learn the exact field-by-field process used for VM0033's monitoring schema, building on the PDD foundation from Chapter 9.

By the end of this chapter, you'll know how to create the VM0033 Monitoring schema structure yourself, understanding temporal data management, annual parameter tracking, and calculation update mechanisms.

Monitoring Schema Purpose and Structure

Monitoring schemas extend your PDD implementation to handle ongoing project operations over crediting periods. Unlike PDD schemas that capture initial project design, monitoring schemas handle:

  • Annual Data Collection: Time-series parameter measurements across project lifetime

  • Calculation Updates: Dynamic recalculation of emission reductions based on new monitoring data

  • Quality Control: Data validation and evidence documentation for verification activities

  • Temporal Relationships: Maintaining connections between annual data and cumulative results

Usually, there's always a section on methodology PDF(including VM0033) on data and parameters to be monitored. Typcially, those fields are submitted as part of Monitoring report.

Subsection of Herbaceous Vegetation Stratum Data for Project in MR schema

Building the Primary Monitoring Schema

Step 1: Create Main Monitoring Schema Header

Start your monitoring Excel file with the main schema structure:

This establishes the monitoring schema as a Verifiable Credentials type that will create on-chain records for each monitoring submission.

Step 2: Add Temporal Framework Fields

The first fields should establish the temporal context for monitoring data:

These fields establish when the monitoring data was collected and create unique identifiers for each monitoring period.

Step 3: Add Monitoring Period Input Structure

Create the main monitoring data collection framework:

This references a sub-schema containing the detailed monitoring parameter collection fields.

Step 4: Create Monitoring Period Inputs Sub-Schema

Create a new worksheet "(New) Monitoring Period Inputs" with the monitoring parameter structure:

Monitoring Period Inputs Sheet

Implementing Stratum-Level Data Collection

Creating Stratum Monitoring Sub-Schemas

For methodologies with multiple strata like VM0033, create stratum-specific monitoring:

Create "(New) MP Herbaceous Vegetat 1" worksheet(names are trimmed to accomodate excel's limitations):

Adding Change Detection Fields

Monitor changes from baseline or previous periods:

Annual Parameter Tracking Implementation

Step 1: Create Annual Input Parameters Structure

Add annual parameter collection capability:

Step 2: Build Annual Inputs Sub-Schema

Create "(New) Annual Inputs Parameters" worksheet:

Step 3: Add Project Scenario Annual Parameters

Create corresponding project emissions tracking:

Create "(New) Annual Inputs Paramet 1" worksheet with project-specific parameters:

Implementing Quality Control and Evidence Collection

Adding Data Quality Indicators

Include quality control fields in your monitoring schemas:

Create "Data quality level (enum)" tab:

Evidence Documentation Structure

Add fields for verification evidence:

Calculation Update Mechanisms

Adding Calculation Fields

Include fields that trigger calculation updates:

Linking to PDD Parameters

Ensure monitoring parameters connect to PDD estimates:

Temporal Boundary Management

Crediting Period Tracking

Add fields to manage crediting periods:

Create "Crediting period (enum)" tab:

Historical Data References

Enable access to previous monitoring data:

VVB Verification Support Fields

Adding Verification Workflow Fields

Include fields supporting VVB verification activities:

Create "Verification status (enum)" tab:

Audit Trail Fields

Maintain audit trail for verification:

Advanced Monitoring Features

Conditional Monitoring Based on PDD Selections

Link monitoring requirements to PDD method selections:

Multi-Year Averaging Fields

For parameters requiring multi-year tracking:

Uncertainty Quantification

Add uncertainty tracking as required by methodology:

Performance Optimization for Long-term Monitoring

Efficient Data Structure Design

Use sub-schemas to group related annual data:

Create efficient annual data structure in "(New) Project Emissions Annual":

Archive and Retrieval Planning

Include fields supporting long-term data management:

Testing Your Monitoring Schema

Guardian provides built-in validation when importing Excel schemas and testing schema functionality through the UI.

Validation Checklist for Monitoring Schemas

Before deploying, verify:

Important: Field Key Management for Monitoring Schemas

Just like PDD schemas, Guardian generates default field keys when importing monitoring Excel schemas. This is especially important for monitoring schemas since they often have time-series calculations.

After Import - Review and Rename Field Keys:

  1. Navigate to schema management in Guardian

  2. Open your imported monitoring schema for editing

  3. Review each field's "Field Key" property

  4. Rename keys for calculation-friendly monitoring code:

    • monitoring_year_t instead of G5

    • carbon_stock_current_period instead of carbonStockCurrentPeriod

    • emission_reduction_annual instead of emissionReductionAnnual

    • biomass_change_since_baseline instead of biomassChangeSinceBaseline

Why This Matters for Monitoring: Time-series calculations rely heavily on clear field naming:

Integration Testing with PDD Schema

  1. Test parameter name consistency between PDD and monitoring field keys

  2. Validate calculation updates when monitoring data changes

  3. Verify temporal relationship tracking works correctly

  4. Test VVB verification workflow with monitoring submissions

  5. Validate cumulative calculation accuracy over multiple periods

Trigger Automatic Calculations

  • Monitoring data submission triggers emission reduction calculations

  • Updated results flow to token minting calculations

  • Quality control validation occurs before calculation updates

Support Verification Processes

  • VVB receives monitoring data with evidence documentation

  • Verification decisions update project status and calculation eligibility

  • Approved monitoring data enables token issuance for the monitoring period

Best Practices for Monitoring Schema Development

Parameter Consistency: Ensure monitoring parameter names and units exactly match PDD schema definitions to enable proper calculation updates.

Quality Control Integration: Include quality indicators and evidence fields for every critical measurement to support verification workflows.

Performance Planning: It's important to design efficient sub-schema structures that maintain performance as historical monitoring data accumulates over project lifetimes.

Temporal Logic: Plan temporal relationships carefully to support both period-specific and cumulative calculations across crediting periods.

Evidence Management: Include appropriate file upload and documentation fields to support verification requirements and audit trail maintenance.

VVB Workflow Design: Design verification support fields that enable efficient VVB review and approval processes without overwhelming interfaces.

Last updated