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.

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:

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:
Navigate to schema management in Guardian
Open your imported monitoring schema for editing
Review each field's "Field Key" property
Rename keys for calculation-friendly monitoring code:
monitoring_year_tinstead ofG5carbon_stock_current_periodinstead ofcarbonStockCurrentPeriodemission_reduction_annualinstead ofemissionReductionAnnualbiomass_change_since_baselineinstead ofbiomassChangeSinceBaseline
Why This Matters for Monitoring: Time-series calculations rely heavily on clear field naming:
Integration Testing with PDD Schema
Test parameter name consistency between PDD and monitoring field keys
Validate calculation updates when monitoring data changes
Verify temporal relationship tracking works correctly
Test VVB verification workflow with monitoring submissions
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