Asoba Ona Documentation

O&M Optimization

AI-powered operations and maintenance optimization for solar assets using the OODA loop methodology.


Overview

O&M optimization transforms reactive maintenance into proactive, data-driven operations. Using the OODA (Observe-Orient-Decide-Act) loop methodology, Ona Terminal provides comprehensive solar asset management that maximizes uptime, minimizes costs, and protects revenue.


The OODA Loop Methodology

🔍 Observe Phase - Fault Detection

Real-time monitoring and fault detection with energy production forecasting integration:

# Run fault detection on new telemetry data
ona ooda detect run --asset "inverter-001" --data "latest_telemetry.csv"

Enhanced Capabilities:

🎯 Orient Phase - Diagnostics

Advanced diagnostics with Energy-at-Risk (EAR) calculations:

# Run comprehensive diagnostics
ona ooda diagnose run --asset "inverter-001" --horizon "7d"

Diagnostic Features:

đź§  Decide Phase - Risk Assessment & Scheduling

Optimized maintenance scheduling with financial impact analysis:

# Calculate Energy-at-Risk with forecast integration
ona ooda ear calc --asset "inverter-001" --confidence "95%"

Decision Support:

⚡ Act Phase - Work Execution

Actionable work orders and execution tracking:

# Build Bill of Materials with economic comparison
ona ooda bom build --asset "inverter-001" --variants-per-type 3

Execution Features:


Key Use Case Scenarios

Scenario A: Rapid Fault Triage and Revenue Protection

Challenge: Intermittent inverter underperformance detected during routine monitoring.

Ona Solution:

# Detect and analyze the issue
ona ooda detect run --asset "inverter-001"
ona ooda diagnose run --asset "inverter-001" --horizon "48h"
ona ooda ear calc --asset "inverter-001" --confidence "95%"

Business Impact:

Scenario B: Parts/OEM Advisory and Lead-Time Risk

Challenge: Diagnostic analysis indicates likely DC fan failure requiring immediate parts procurement.

Ona Solution:

# Generate BOM with multiple vendor options
ona ooda bom build --asset "inverter-001" --variants-per-type 5
ona ooda bom compare --bom "bom-001" --include-downtime-cost

Business Impact:

Scenario C: Regulatory and Compliance Readiness

Challenge: Need to prepare for regulatory audits and warranty compliance requirements.

Ona Solution:

# Generate compliance documentation
ona ooda compliance report --asset "inverter-001" --period "30d"
ona ooda warranty evidence --asset "inverter-001" --issue "fault-001"

Business Impact:


Asset Management

Asset Registration

Manage assets through the CLI instead of editing JSON directly:

# Add an asset with OEM components
ona ooda assets add \
  --id "inverter-001" \
  --type "inverter" \
  --model "SolarEdge SE5000" \
  --location "Site A" \
  --oem "SolarEdge" \
  --serial "SE123456"

Parts Catalogue

Import comprehensive parts catalogues for price/lead-time optimization:

# Import parts catalogue
ona ooda catalog import --file "parts_catalogue.csv"

# View catalogue contents
ona ooda catalog list --type "cooling_fan"

AI-Assisted Analysis

Interactive AI Mode

Leverage AI for deeper insights and analysis:

# Start interactive AI mode
ona ooda interactive

Example AI Prompts:

AI Capabilities


Economic Optimization

Price vs. Lead-Time vs. Downtime Analysis

When building BOMs with multiple vendor options:

# Build BOM with economic comparison
ona ooda bom build --asset "inverter-001" --variants-per-type 5
ona ooda bom compare --bom "bom-001" --include-downtime-cost

Economic Factors:

Vendor Optimization


Integration Capabilities

Data Sources

API Integration

from ona_sdk import OODAClient

# Initialize OODA client
client = OODAClient(api_key="your-api-key")

# Run complete OODA loop
detection = client.observe(asset_id="inverter-001")
diagnosis = client.orient(asset_id="inverter-001")
decision = client.decide(asset_id="inverter-001")
action = client.act(asset_id="inverter-001")

Performance Metrics

Operational KPIs

Financial Impact


Getting Started

Prerequisites

Quick Start

# 1. Set up sample data
ona ooda sample_data setup

# 2. Add your first asset
ona ooda assets add --id "inverter-001" --type "inverter"

# 3. Run your first OODA loop
ona ooda detect run --asset "inverter-001"
ona ooda diagnose run --asset "inverter-001"
ona ooda ear calc --asset "inverter-001"
ona ooda bom build --asset "inverter-001"

Support & Resources

Documentation

Community

Support


Get Help & Stay Updated

Contact Support

For technical assistance, feature requests, or any other questions, please reach out to our dedicated support team.

Email Support Join Discord

Subscribe to Updates

* indicates required

© 2025 Asoba Corporation. All rights reserved.