Household-level Monitoring

from emerging import StoveStackingOracle

# Initialize oracle
oracle = StoveStackingOracle()

# Analyze household cooking patterns
analysis = oracle.analyze_household(
    household_id="did:ixo:household/123",
    period_start="2024-01-01",
    period_end="2024-01-31"
)

# Get stove stacking metrics
metrics = analysis.get_metrics()
print(f"Primary stove usage: {metrics.primary_stove_percentage}%")
print(f"Secondary stove usage: {metrics.secondary_stove_percentage}%")

{
  "householdId": "did:ixo:household/123",
  "period": {
    "start": "2024-01-01",
    "end": "2024-01-31"
  },
  "analysis": {
    "baselineEmissions": 120,
    "actualEmissions": 45,
    "reductions": 75,
    "confidence": 0.95,
    "deviceContributions": [{
      "deviceId": "did:ixo:device/456",
      "reductionShare": 0.8,
      "evidence": {
        "usageHours": 120,
        "fuelSaved": 32
      }
    }]
  }
}

# Create household
curl -X POST https://api.emerging.eco/v1/households \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "location": {
      "district": "XYZ",
      "density": "Medium"
    },
    "baseline": {
      "fuelType": "Charcoal",
      "monthlyConsumption": 40
    }
  }'

# Analyze household impact
curl -X POST https://api.emerging.eco/v1/analysis/household \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "householdId": "did:ixo:household/123",
    "periodStart": "2024-01-01",
    "periodEnd": "2024-01-31"
  }'