グリッドフォールト¶
- typhoon.test.sources. grid_fault ( sources , fault_duration , rms_pu = None , freq_pu = None , phase_shift = None , initial_ramp_duration = 0 , final_ramp_duration = 0 , ramp_type = 'lin' , executeAt = None ) ¶
グリッド障害を作成するための汎用関数です。executeAt引数で指定された時点に障害が生成されます。指定された障害継続時間が経過すると、すべてのソースの設定が障害発生前の値に戻され、障害は解除されます。図は、関数実行中にどの時間パラメータが適用されるかを示しています。
- パラメータ:
sources ( str , list ) – 文字列または文字列のリストとして指定されたグリッドを表すソースの名前。
fault_duration ( float , pandas.Timedelta ) – 障害の継続時間(秒)。過渡時間の間に電圧源に障害が適用される継続時間を指します。
rms_pu ( float 、 list ) – 適切な電圧源の障害前の値に基づいた、障害中の電圧実効値または単位値あたりの電圧実効値のリスト。デフォルト値は None で、その場合は障害前の実効値が適用されます。
freq_pu ( float , list ) – 適切な電圧源の障害前の値に基づいた、障害中の周波数または単位値あたりの周波数のリスト。デフォルト値は None で、その場合、障害前の周波数値が適用されます。
Phase_shift ( float , list ) – 故障発生時の位相シフト値または位相シフト値のリスト。デフォルト値は None であり、この場合、電圧源に位相シフトは適用されません。値は度単位で指定します。
initial_ramp_duration ( float , pandas.Timedelta ) – 電圧源が故障前状態から故障状態に移行するのに必要な時間。
final_ramp_duration ( float , pandas.Timedelta ) – 電圧源が故障状態から故障前の状態に戻るのに必要な時間。
ramp_type ( str ) – 初期ランプと最終ランプの種類。サポートされる値は 'lin' (線形補間) と 'exp' (一次システム応答 - ランプ時間は 7 タウ) です。
executeAt ( float , pandas.Timedelta ) – 障害が適用される時刻。現在のシミュレーション時間が障害発生時刻よりも大きい場合、障害は直ちに適用されます。
- 戻り値:
なし
- 戻り値の型:
この関数には戻り値がありません。
例
この例は、次のスキーマで実行されるpytest テスト内で実行されます。
以下のテストコードでは、ライブラリがインポートされ、作成されたモデルがコンパイルおよびロードされます。テストを実行する前に、回路図のパスを調整してください。
>>>から 台風.api hilをインポート>>>から typhoon.api.schematic_editor インポートモデル>>>から 台風テスト キャプチャをcapとしてインポート>>> 台風テストソース grid_faultをインポート>>> >>> def test_grid_fault_docstring (): >>> model_name_1 = "grid_fault_test.tse" >>> >>> # 回路図の絶対パス>>> model_path_1 = str ( file_path / "hil_model" / model_name_1 ) >>> compiled_model_path_1 = model . get_compiled_model_file ( model_path_1 ) >>> >>> model . load ( model_path_1 ) >>> model . compile () >>> >>> hil . load_model ( compiled_model_path_1 , vhil_device = True ) >>> # テストは次のサンプル (1/3) に続きます
断層は、
対1
電圧源。電圧値はRMS値とともに測定されます。電圧と故障パラメータは以下のように設定できます。>>> # テスト パート 2/3 >>> # 初期電圧源構成>>> Vnom = 220 # 公称電圧>>> fnom = 60 # 公称周波数>>> phase_nom = 0 # 公称位相>>> >>> source = "Vs1" >>> >>> # グリッド障害パラメーター>>> rms_pu = 0.8 # 電圧 rms 値が公称値の 80% に低下することを意味します>>> >>> ## 期間>>> fault_duration = 1 # 障害の作成が開始される時間>>> init_ramp_time = 0.75 # 障害の作成時間>>> final_ramp_time = 0.25 # 障害の除去時間>>> fault_start_moment = 1 # 障害の持続時間>>> >>> # 電圧源が初期化されました>>> hil . set_source_sine_waveform ( source , rms = Vnom , Frequency = fnom , Phase = phase_nom ) >>> # テストは次のサンプル (2/3) で続行されます
パラメータ化された障害が適用された後、キャプチャはAllureレポートとして作成され、または保存されます。
グリッド障害信号.h5
ファイル:>>> # テストパート 3/3 >>> # 三相電圧源に障害を作成します。 >>> grid_fault ( sources = source 、 >>> rms_pu = rms_pu 、 >>> fault_duration = fault_duration 、 >>> initial_ramp_duration = init_ramp_time 、 >>> final_ramp_duration = final_ramp_time 、 >>> ramp_type = 'lin' 、 >>> executeAt = fault_start_moment ) >>> >>> cap . start_capture ( >>> duration = 5 、 >>> signals = [ source 、 'Vrms1' ]、 >>> fileName = 'grid_fault_signals.h5' >>> ) >>> >>> hil . start_simulation () >>> cap . get_capture_results ( True ) >>> # テストは終了です (3/3)
電圧源
対1
捕獲: