Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

pvlib.irradiance._calc_delta documentation/usage

オープン
#2,879 コメント 7 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
35/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
活発
技術スタック
python

調査の方向性

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.

索引モデルが issue の本文から書いたものです。

説明

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.

主要言語
Python
スター
1.7k
フォーク
1.2k
平均マージ
3日 18時間
マージ済み PR(30日)
13

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

pvlib/pvlib-python のほかの issue

pvlib/pvlib-python の issue をすべて見る

似ている issue

Python の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。