CLSS Shade — LiDAR-based Solar/Shade Analysis for Home Assistant

Share your Projects! Custom Integrations
1

CLSS Shade — LiDAR-based Solar/Shade Analysis for Home Assistant

Hi everyone!

I’d like to share a custom integration I’ve been building: CLSS Shade — real-time shade analysis using actual 3D LiDAR data.

What does it do?

Instead of simplified solar models, this integration downloads high-resolution LiDAR point cloud data (10 points/m²) and builds a real 3D model of your surroundings — every building, tree, fence, and terrain feature. It then
computes, every 5 minutes, which parts of your property are in sun and which are in shade.

Key features:

  • Real-time shade analysis — per-zone sun/shade % based on actual 3D model (buildings, trees, overhangs)
  • PV production forecast — 5-day forecast combining shadow analysis + weather data + panel orientation
  • Smart irrigation per zone — FAO-56 crop coefficients (blueberries need less water than vegetables!), 5-day forecast, seasonal adjustment, greenhouse support
  • 3D zone editor — Three.js viewer with LiDAR terrain, draw zones on facades, windows, under overhangs
  • Automated blinds — narrow zones in front of windows detect exactly when sun hits each facade

Slovenia only (for now)

This uses CLSS (Cyclical Laser Scanning of Slovenia) data from GURS — the entire country scanned at 10 pts/m². Combined with ARSO agrometeo data for irrigation. These datasets only exist for Slovenia.

Smart irrigation highlight

Each garden zone gets its own irrigation sensor with:

  • Crop-specific water needs (Kc coefficients: berries 0.85, vegetables 1.05, lawn 0.95)
  • Shade-adjusted evapotranspiration — shaded zones need up to 50% less water
  • 5-day forecast from ARSO agrometeo
  • Historical precipitation correction (if forecast predicted rain that didn’t come, need increases)
  • Seasonal factors (winter: 0, summer: 1.0)
  • Greenhouse mode (ignores rain, year-round watering)
  • binary_sensor for automation triggers

Links

This is a beta release (v0.0.1) — feedback and bug reports very welcome!

Screenshots coming soon.