Skip to content

Glossary update: surface/solar zenith/azimuth angles, and others #2448

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
RDaxini opened this issue Apr 25, 2025 · 1 comment
Open

Glossary update: surface/solar zenith/azimuth angles, and others #2448

RDaxini opened this issue Apr 25, 2025 · 1 comment
Milestone

Comments

@RDaxini
Copy link
Contributor

RDaxini commented Apr 25, 2025

Is your feature request related to a problem? Please describe.
Some longer definitions and conventions are being removed from parameter descriptions in #2311

Describe the solution you'd like
Migrate definitions and conventions over to the nomenclature page

See thread below for examples.

Additional context
Let's agree on some definitions here, then I'll add them to the glossary.
Note: some conventions (e.g. angle ranges or irradiance limits) might be function specific.
Related discussion/comments: Issue #1421, comment in #1421, Comment in #2311, #2284

@RDaxini
Copy link
Contributor Author

RDaxini commented Apr 25, 2025

Original definitions from irradiance.py with some suggested modifications from me.

surface_tilt
Surface tilt angle, must be >=0°  and <=180°. The surface tilt angle describes
the inclination of the PV panel and is defined as degrees from the horizontal
such that a surface facing up would have a surface tilt of 0°, and one facing
the horizon would be 90°.  [°]

surface_azimuth
Surface azimuth angle, must be >=0° and <=360°. This angle describes the
horizontal orientation of the PV panel relative to a reference direction, and
the convention is defined as degrees east (clockwise) of north. For example,
North = 0°, South=180° East = 90°, West = 270°.  [°]

solar_zenith
Apparent (refraction-corrected) zenith angle, must be ≥0° and ≤180°. The solar
zenith angle describes the position of the sun relative to the vertical and is
defined as the angle between the sun’s rays and a vector pointing straight up from
the observer. [°]

solar_azimuth
Solar azimuth angle, must be ≥0° and ≤360°. The solar azimuth angle describes
the sun’s position along the horizon and is defined as degrees east (clockwise)
of north. For example, North = 0°, East = 90°, South = 180°, West = 270°. [°]

Some of these would be new definitions, some of these exist in the glossary but need to be updated with more detail.
There are others. We can update this list...

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant