PVジェネレータAPI

モジュール: typhoon.api.pv_generator

このモジュールは、選択した PV モデルに従ってさまざまな PV パネル設定ファイル (.ipvx) を生成するために使用されます。

この設定ファイルは、後で HIL API および HIL SCADa で適切な PV パネルを初期化するために使用できます。

API リファレンスセクションには、使用できるすべてのメソッドが表示されます。

APIリファレンス

generate_pv_settings_file (モデルタイプ,ファイル名,パラメータ)

指定されたパラメータを使用して PV パネル設定 (.ipvx 拡張子) を生成します。

パラメータ:

• modelType ( str ) – 設定ファイルの生成に使用されるPV モデルタイプ。

• fileName ( str ) – 結果の .ipvx ファイルのファイル名。

• パラメータ( dict ) – パラメータを持つ辞書。

サポートされているPV モデルタイプ は：

• 「詳細」 または pv.PV_MODELS[0]

• 「EN50530準拠」 または pv.PV_MODELS[1]

• 「正規化IV」 または pv.PV_MODELS[2]

使用可能なPVモデルの種類に応じて パラメータ は：

• 「詳細」 モデル

  辞書キー	意味	価値
  「Voc_ref」	開放電圧（Voc [V]）	フロート
  「Isc_ref」	短絡電流（Isc [A]）	フロート
  「dIsc_dT」	Iscの温度係数[%Isc/C]	フロート
  「Nc」	セルの数	フロート
  「dV_dI_ref」	Voc_refポイントにおける曲線の勾配（VocにおけるdV/dI [V/A]）	フロート
  「Vg」	バンドギャップ電圧	文字列（「cSi」または「アモルファスSi」）
  「ん」	Voc_refポイントにおける曲線の勾配（VocにおけるdV/dI [V/A]）	フロート
  「負の電流」	負電流を許容する	ブール値（TrueまたはFalse）

• 「EN50530準拠」 モデル

  辞書キー	意味	価値
  「Voc_ref」	開放電圧（Voc [V]）	フロート
  「Isc_ref」	短絡電流（Isc [A]）	フロート
  「pv_type」	PVタイプ	文字列（「cSi」、「薄膜」、または「ユーザー定義」）
  「負の電流」	負電流を許容する	ブール値（TrueまたはFalse）
  「ユーザー定義パラメータ」	ユーザー定義のテクノロジーパラメータ	辞書（「pv_type」!=「ユーザー定義」の場合は省略可能）

• 「IV正常化」 モデル

  辞書キー	意味	価値
  「csv_path」	csvファイルへのパス	str

  万一に備えて 「ユーザー定義」 として選択されます pv_type 追加のサブ辞書パラメータ（「ユーザー定義パラメータ」）を指定する必要があります。

  辞書キー	意味	価値
  「ff_u」	最大電力点対開回路電圧比	float ( 0.0 < ff_u < 1.0)
  「ff_i」	最大電力点対短絡電圧比	float ( 0.0 < ff_i < 1.0)
  「c_g」	技術依存補正係数	float ( 0.0 < c_g < 1.0)
  「c_v」	技術依存補正係数	float ( 0.0 < c_v < 1.0)
  「c_r」	技術依存補正係数	float ( 0.0 < c_r < 1.0)
  「v_l2h」	200 W/m2の放射照度のUMPPと1000 W/m2の放射照度のUMPPの電圧比	float ( 0.0 < v_l2h < 1.0)
  "アルファ"	電流の温度係数	float ( 0.0 < alpha < 1.0)
  "ベータ"	電圧の温度係数	float ( -1.0 < beta < 0.0)

戻り値:

タプル(状態, メッセージ)

• ステータス（ブール値）: 真実 すべてOKなら、そうでない場合は戻る 間違い

• message (str): ステータスメッセージ

例：

import typhoon.api.pv_generator as pv

    params = {"Voc_ref": 45.60,
              "Isc_ref": 5.8,
              "dIsc_dT": 0.0004,
              "Nc": 72,
              "dV_dI_ref": -1.1,
              "Vg": "cSi",
              "n" : 1.3,
              "neg_current": False }

    # generate settings file using Detailed type of PV Model
    (status, msg) =  pv.generate_pv_settings_file(pv.PV_MT_DETAILED,
                                                  "./setDet.ipvx",
                                                  params)


    params = {"Voc_ref": 45.60,
              "Isc_ref": 5.8,
              "pv_type": "Thin film",
              "neg_current": False }

    # generate settings file using EN50530 type of PV Model
    (status, msg) =  pv.generate_pv_settings_file(pv.PV_MT_EN50530,
                                                  "./setEN.ipvx",
                                                  params)

    params = {"Voc_ref": 45.60,
              "Isc_ref": 5.8,
              "pv_type": "User defined",
              "neg_current": False,
              "user_defined_params": {
                  "ff_u": 0.72,
                  "ff_i": 0.8,
                  "c_g": 1.252e-3,
                  "c_v": 8.419e-2,
                  "c_r": 1.476e-4,
                  "v_l2h": 0.98,
                  "alpha": 0.0002,
                  "beta": -0.002 }
              }

    # generate settings file using IV normalized type of PV Model
    (status, msg) =  pv.generate_pv_settings_file(pv.IV_Normalized,
                                                  "./setEN.ipvx",
                                                  params)

    params = {"csv_path": "csv_file.csv"}


    # generate settings file using EN50530 type of PV Model with
    # user defined parameters
    (status, msg) =  pv.generate_pv_settings_file(pv.PV_MT_EN50530,
                                                  "./setEN.ipvx",
                                                  params)