Clarification of variables

[ccdunder]

Hi,

First off, very cool project. I was thinking of doing the same thing and found you've already done all the hard work. Thanks!

I'm curious about some of the variables and was wondering if you could answer a few questions. I'll be happy to send a PR to update docs/template.md afterwards.

• What are height and min_height relative to? e.g. the ground outside, the floor inside, the bottom of the window frame?
• Is this the correct understanding of fov_* & elev_*?
  
  

Cheers,

• Chris

[langestefan]

Hi,

• height and min_height are relative to the lowest point of the blind. You don't really need min_height, the only reason I added it is because I could think of systems where the blind would not be able to close all the way so then the scaling to [0-100]% would be off.
• Regarding your image, the FOV has no relation to the dimensions of the window. You can think of it like a virtual box in the sky, if the sun is within that box we track it, if it's outside the box we do nothing. This is mostly useful when you have large buildings or trees in the FOV of your window. ps. because the earth is so far away from the sun, we consider the sun's rays to be parallel (as opposed to a point source). That makes these calculations easier, because we can always work with elevation and azimuth. There are some images in this thread, might be helpful: https://community.home-assistant.io/t/automatic-blinds-sunscreen-control-based-on-sun-platform/573818/30

[nurtext]

Thanks for explaining, oh and btw: No need to only consider the sun's rays to be parallel, because actually they are (because the sun is so far away from earth) :)