jpawlowski/hass.tibber_prices
1
0
Fork 0
mirror of https://github.com/jpawlowski/hass.tibber_prices.git synced 2026-03-30 13:23:41 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2
hass.tibber_prices/docs/user
History
Julian Pawlowski b46f8a2d28 docs(periods): fix corrupted period-calculation.md and add outlier filtering documentation 
Completely rewrote period-calculation.md after severe corruption (massive text
duplication throughout the file made it 2489 lines).

Changes:
- Fixed formatting: Removed all duplicate text and headers
- Reduced file size: 2594 lines down to 516 lines (clean, readable structure)
- Added section 5: "Statistical Outlier Filtering (NEW)" explaining:
  - Linear regression-based spike detection (95% confidence intervals)
  - Symmetry checking to preserve legitimate price shifts
  - Enhanced zigzag detection with relative volatility
  - Data integrity guarantees (original prices always used)
  - New period attributes: period_interval_smoothed_count
- Added troubleshooting: "Price spikes breaking periods" section
- Added technical details: Algorithm constants and implementation notes

Impact: Users can now understand how outlier filtering prevents isolated
price spikes from breaking continuous periods. Documentation is readable
again with no duplicate content.
2025-11-12 16:59:07 +00:00
..
automation-examples.md docs: restructure documentation and add AI development disclosure 2025-11-09 14:25:27 +00:00
configuration.md docs: restructure documentation and add AI development disclosure 2025-11-09 14:25:27 +00:00
installation.md docs: restructure documentation and add AI development disclosure 2025-11-09 14:25:27 +00:00
period-calculation.md docs(periods): fix corrupted period-calculation.md and add outlier filtering documentation 2025-11-12 16:59:07 +00:00
README.md feat(docs): enhance period calculation documentation and add detailed guides for best/peak price periods 2025-11-10 11:54:06 +00:00
sensors.md feat(docs): enhance period calculation documentation and add detailed guides for best/peak price periods 2025-11-10 11:54:06 +00:00
services.md docs: restructure documentation and add AI development disclosure 2025-11-09 14:25:27 +00:00
troubleshooting.md docs: restructure documentation and add AI development disclosure 2025-11-09 14:25:27 +00:00

README.md

User Documentation

Welcome to Tibber Prices! This integration provides enhanced electricity price data from Tibber with quarter-hourly precision, statistical analysis, and intelligent ratings.

📚 Documentation

🚀 Quick Start

  1. Install via HACS (add as custom repository)
  2. Add Integration in Home Assistant → Settings → Devices & Services
  3. Enter Tibber API Token (get yours at developer.tibber.com)
  4. Configure Price Thresholds (optional, defaults work for most users)
  5. Start Using Sensors in automations, dashboards, and scripts!

✨ Key Features

  • Quarter-hourly precision - 15-minute intervals for accurate price tracking
  • Statistical analysis - Trailing/leading 24h averages for context
  • Price ratings - LOW/NORMAL/HIGH classification based on your thresholds
  • Best/Peak hour detection - Automatic detection of cheapest/peak periods with configurable filters (learn how)
  • ApexCharts integration - Custom services for beautiful price charts
  • Multi-currency support - EUR, NOK, SEK with proper minor units (ct, øre, öre)

🔗 Useful Links

🤝 Need Help?

Note: These guides are for end users. If you want to contribute to development, see the Developer Documentation.