Related to this thread in Google Groups about difficulties when trying to go from object-oriented to procedural API.

So basically .run_model() does a great job at simplifying the required code in order to run a simulation, but it does a lot of "magic" behind the scenes and it is not easy to follow all the logic just looking at the source code, so maybe some documentation could be added to improve this. How much or where to add it? (docstring, an example under docs/...) I don't know. 😇 But if you tell me, I'd be happy to contribute a PR.

For this particular case, it was not clear to me that .run_model() was, when calculating the solar position apparent zenith, using the TMY air temperature series and the calculated pressure at the given altitude.

Maybe I could update the example in the documentation to make the results match exactly? At least this way there is an example on how to use both paradigms to get the same results.