This page documents Emerging Household Energy sensor workflows. It covers stove-use monitoring implementation for solution verification and reporting outcomes.
Key Features
Installation required on all active cookstoves unless deviation is justified
Ongoing measurements with no interruption preferred
Track concurrent usage across multiple stoves to prevent double-counting
Regular collection to prevent data loss when digital transmission isn't possible
Quick Start
curl -X POST https://api.emerging.eco/v1/devices \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"type": "StoveUseMonitor",
"householdId": "did:ixo:household/123",
"stoveId": "did:ixo:stove/456",
"configuration": {
"samplingRate": 300,
"temperatureThreshold": 60,
"transmissionMode": "realtime"
}
}'from emerging import Device
# Register a new Device
sum_device = Device.create(
type="StoveUseMonitor",
household_id="did:ixo:household/123",
stove_id="did:ixo:stove/456",
configuration={
"sampling_rate": 300, # 5 minute intervals
"temperature_threshold": 60, # Celsius
"transmission_mode": "realtime"
}
)Implementation Requirements
Installation Coverage
- Full Coverage Mandate:
- Install sensors on ALL cookstoves in project
- Document any deviation with detailed justification
- Regular verification of sensor presence
- Monitor sensor health and calibration
- Stove Stacking Prevention:
- Track temperature patterns across all household stoves
- Detect concurrent usage
- Validate cooking event plausibility
- Cross-reference with household surveys
Measurement Duration
- Continuous Operation:
- Ongoing monitoring required
- No planned interruptions
- Battery life management
- Backup data storage
- Data Continuity:
- Real-time transmission where possible
- Regular manual collection if needed
- Backup procedures for power/connectivity issues
- Data gap documentation and justification
Data Collection
- Digital Transmission:
- Preferred method for data retrieval
- Real-time data validation
- Automatic anomaly detection
- Manual Collection:
- Required when digital not possible
- Frequent collection to prevent data loss
- Structured collection schedule
- Chain of custody documentation
- Data Quality:
- Validation of temperature readings
- Cross-checking between stoves
- Time synchronization
- Completeness verification
Sampling Design
- Coverage Requirements:
- Full monitoring preferred
- Sampling allowed if digital collection impossible
- Must follow sampling guidelines
- Statistical validity requirements
Device Configuration
Seconds between temperature readings (recommended: 1-5 minutes)
Temperature (°C) threshold for cooking event detection
"realtime" | "batch" | "manual"
Data Model
{
"deviceId": "did:ixo:device/sum789",
"stoveId": "did:ixo:stove/456",
"readings": [{
"timestamp": "2024-02-20T08:15:00Z",
"temperature": 85.4,
"cookingEvent": true,
"duration": 1800
}],
"status": {
"battery": 92,
"signal": "strong",
"lastSync": "2024-02-20T08:20:00Z"
}
}Handling Stove Stacking
from emerging import HouseholdAnalytics
# Analyze stove usage patterns
analytics = HouseholdAnalytics("did:ixo:household/123")
stacking_report = analytics.detect_stacking(
period_start="2024-02-01",
period_end="2024-02-28",
stove_types=["traditional", "improved"]
)
# Get detailed cooking events
events = analytics.get_cooking_events(
min_duration=1800, # 30 minutes
min_temperature=60
)Integration with Household Monitoring
from emerging import Household, Device
# Get household digital twin
household = Household.get("did:ixo:household/123")
# Register SUMs for all stoves
for stove in household.stoves:
sum_device = Device.create(
type="StoveUseMonitor",
stove_id=stove.id,
household_id=household.id
)
# Link to household digital twin
household.add_device(sum_device)
# Monitor stove usage compliance
compliance = household.check_monitoring_compliance()Error Handling
Invalid device configuration
Device or stove not found
Data transmission failure
Best Practices
Installation
- Mount sensors securely
- Calibrate temperature thresholds
- Verify signal strength
- Test data transmission
- Document any coverage exceptions
Monitoring
- Check battery levels regularly
- Validate sensor readings
- Monitor data completeness
- Track transmission status
- Verify continuous operation
Data Collection
- Implement backup procedures
- Regular quality checks
- Document collection frequency
- Maintain collection records
- Prevent data loss
Stove Stacking Prevention
- Monitor all household stoves
- Track concurrent usage
- Validate cooking patterns
- Cross-reference data sources
- Document usage anomalies
Next Steps
Sensor placement and setup
Managing SUM data
Usage pattern analysis
Digital twin setup