Skip to content

Update zenith and azimuth angle documentation #2503

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

Closed
wants to merge 16 commits into from
Closed

Conversation

RDaxini
Copy link
Member

@RDaxini RDaxini commented Jul 22, 2025

OmarBahamida and others added 6 commits June 17, 2025 16:50
- Add detailed definitions for solar angles with range constraints
- Clarify pvlib's east-of-north convention for azimuth angles
- Add cross-references between related terms using :term: directive
- Add coordinate system conventions for latitude/longitude
- Enhance existing angle definitions with usage notes and examples

This commit addresses issue pvlib#2448 by migrating angle definitions and
conventions from parameter descriptions to the nomenclature page.

(cherry picked from commit 16435c7)
- Created test_solar_angles.py to verify solar angle calculations
- Tests zenith, azimuth, and elevation angles for different times of day
- Uses New York City as example location on spring equinox
- Verifies angles are within expected ranges and follow correct patterns

(cherry picked from commit f202c5d)
…s/test_solarposition.py

- Deleted the standalone test_solar_angles.py file.
- Added a new test function, test_solar_angles_spring_equinox, to tests/test_solarposition.py.
- The new test verifies solar angles for New York City on the spring equinox, ensuring angles are within expected ranges and follow correct patterns.

(cherry picked from commit 9963629)
@RDaxini RDaxini added this to the v0.13.1 milestone Jul 22, 2025
@RDaxini RDaxini changed the title Angles Update zenith and azimuth angle documentation Jul 22, 2025
@RDaxini RDaxini requested a review from cwhanse July 22, 2025 21:34
@cwhanse
Copy link
Member

cwhanse commented Jul 22, 2025

@RDaxini is this intended to modify #2448 or to replace it?

@RDaxini
Copy link
Member Author

RDaxini commented Jul 22, 2025

@RDaxini is this intended to modify #2448 or to replace it?

@cwhanse what do you mean modify/replace the issue #2448? Are you referring to the definitions in my comment? I retained the definitions from #2485 but removed the statements on the angle range.

@cwhanse
Copy link
Member

cwhanse commented Jul 22, 2025

Did you mean this to be a PR to #2448?

@RDaxini
Copy link
Member Author

RDaxini commented Jul 22, 2025

Did you mean this to be a PR to #2448?

Yes, I think it relates to #2488.

@RDaxini
Copy link
Member Author

RDaxini commented Jul 22, 2025

Merged with #2485.

@RDaxini RDaxini closed this Jul 22, 2025
@RDaxini RDaxini deleted the angles branch July 29, 2025 23:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Glossary update: surface/solar zenith/azimuth angles, and others
3 participants