How frequenz-floss/frequenz-sdk-python works
Main Components
a. Core SDK Components:
• Actor System (src/frequenz/sdk/actor)
• Microgrid Management (src/frequenz/sdk/microgrid)
• Time Series Processing (src/frequenz/sdk/timeseries)
• Configuration Management (src/frequenz/sdk/config)
b. Key Subsystems:
• Power Distribution System
• Data Sourcing System
• Formula Engine
• Component Pools (Battery, EV Charger, PV)
┌─────────────────────────────────────────────────────────────┐
• Client Applications │
• ┘
• ▲
┌─────────────────────────────────────────────────────────────┐
• SDK Core │
• ┬────────────────┬──────────────┬──────────────┤
• Actor │ Microgrid │ Time Series │ Config │
• System │ Management │ Processing │ Management │
• ┴────────────────┴──────────────┴──────────────┘
• ▲
┌─────────────────────────────────────────────────────────────┐
• Component Management │
• ┬────────────────┬──────────────┬──────────────┤
• Battery │ EV Charger │ PV │ Logical │
• Pool │ Pool │ Pool │ Meter │
• ┴────────────────┴──────────────┴──────────────┘
• ▲
┌─────────────────────────────────────────────────────────────┐
• Power Management │
• ┬────────────────┬──────────────┬──────────────┤
• Power │ Power │ Power │ Formula │
• Distribution │ Managing │ Wrapper │ Engine │
• ┴────────────────┴──────────────┴──────────────┘
• ▲
┌─────────────────────────────────────────────────────────────┐
• Data Processing │
• ┬────────────────┬──────────────┬──────────────┤
• Data │ Resampling │ Ring Buffer │ Moving │
• Sourcing │ │ │ Window │
• ┴────────────────┴──────────────┴──────────────┘
Important Relationships to Highlight
• Actor System's relationship with all components (central to architecture)
• Data flow from Data Sourcing through Power Management to Component Pools
• Formula Engine's integration with Time Series Processing
• Component Pool interactions with Power Distribution
Additional Elements
A separate panel showing:
• External interfaces (API connections)
• Configuration flow
• Error handling paths
• Monitoring and logging paths
Implementation Details
• Async nature of the system (shown in actor system)
• Data pipeline architecture
• Component pooling and management
• Power distribution algorithms
• Time series processing capabilities