Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

pvlib.irradiance._calc_delta documentation/usage

Đang mở
  • Có gì không ổn?
#2,879 7 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
35/100
Loại issue
Tài liệu
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
python
Lĩnh vực
data, documentation

Hướng nghiên cứu

Start with the docstrings for pvlib.irradiance._calc_delta, _calc_zeta, pvlib.irradiance.perez, and pvlib.irradiance.perez_driesse; the issue links to the _calc_delta location in pvlib/irradiance.py. Review the discussion and linked PR #2808 to understand the behavior divergence and the unresolved question of aligning calculations. Done means clarifying the documented behavior and intended parameter calculations, but the issue does not settle whether implementation changes are needed.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

The docstring for pvlib.irradiance._calc_delta currently states:

Compute the delta parameter, which represents sky dome "brightness" in the Perez and Perez-Driesse models.

This is somewhat misleading, because this function is not currently used In the pvlib.irradiance.perez function. Perhaps it should be? If not, then I suggest updating the language. (_calc_zeta's docstring notably only mentions Perez-Driesse.)

In addition, after a helpful communication with @adriesse, it seems that the inaugural pvlib.irradiance.perez function does not indicate in its doctoring that kastenyoung1989 is (apparently) the preferred method for computing the airmass parameter.

Was there ever a discussion about aligning the airmass input, its (default) calculation, and the delta calculation between pvlib.irradiance.perez and pvlib.irradiance.perez_driesse?

(Same question could be made for zeta and _calc_zeta usage, I suppose.)

I have been somewhat frustrated by the divergence in behavior of perez and perez-driesse, with the latter seeming to have better safeguards in place. This was much of the impetus behind https://github.com/pvlib/pvlib-python/pull/2808.

Ngôn ngữ chính
Python
Star
1.7k
Fork
1.2k
Merge trung bình
3 ngày 18 giờ
Pull request đã merge (30 ngày)
13

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của pvlib/pvlib-python

Tất cả issue của pvlib/pvlib-python

Issue tương tự

Thêm issue về Python

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.