キャプチャ開始¶
- typhoon.test.capture. start_capture ( duration , offset_absolute = 0 , offset_relative = None , rate = 'Max' , signal = () , trigger_source = 'Forced' , trigger_threshold = None , trigger_edge = None , trigger_use_first_occurence = True , fileName = '' , executeAt = None , timeout = None , absolute_time = False ) ¶
キャプチャ設定を行い、キャプチャを開始します。
これは、通常のTyphoon HIL API start_capture()関数の簡易版であり、すべての設定が1つの関数にまとめられています。また、自動的に導出される可能性のある一部の引数は省略されています。
詳細については、HIL API ドキュメントを参照してください。
- パラメータ:
期間– オフセットを含むキャプチャ時間の合計（秒単位）
オフセット絶対 – トリガー前にキャプチャされたデータの期間（秒）。
間隔.offset_relative –
トリガー前のデータキャプチャの相対的な期間（パーセンテージ）。100 を超えることはできません。
注記
ユーザーはどちらか一方のみを使用してください
オフセット絶対またはオフセット相対両方が定義されている場合は、offset_relative が使用されます。レート-
サンプリングレート（サンプル/秒）
注記
サンプリングレートと期間は任意に定義できますが、HIL制約によっては有効ではない場合があります。その場合、可能な限り近い設定が使用され、警告として表示され、関数呼び出しから返されます。
信号–
キャプチャする信号のリスト。同じ名前の信号が2つ存在できないため、アナログとデジタルの区別はありません。
注記
少なくとも1つのシグナルを定義する必要があります
信号リスト。トリガーソース–
キャプチャをトリガーするために使用する信号
注記
トリガーソース定義されていない場合はデフォルトで「強制」になります。それ以外の値で定義されている場合は、トリガーしきい値そしてトリガーエッジも定義する必要があります。trigger_threshold – キャプチャを開始するためにtrigger_source信号が達すべきレベル
trigger_edge – トリガしきい値に達した際にトリガソース信号がキャプチャを開始する方向。「立ち上がり」または「立ち下がり」のいずれかになります。
トリガー使用最初の発生–
オフセット期間がトリガー前の使用可能期間よりも長い場合は、使用可能な量のみを考慮するか (True に設定)、トリガーを無視して後で別のトリガーを探します (False に設定)。
注記
トリガー使用最初の発生純粋な周期信号を扱う場合、およびオフセットを厳密に尊重する必要がある場合にのみ、False として使用する必要があります。ファイル名-
キャプチャしたデータを保存するファイル名
注記
サポートされているファイル形式は hil api で定義されており、こちらで確認できます: https://www.typhoon-hil.com/documentation/typhoon-hil-api-documentation/hil_api.html?highlight=start_capture#typhoon.api.hil.start_capture
executeAt – 設定されている場合、このstart_captureが有効になるシミュレーション時間
タイムアウト– トリガーが実行されるまでに許容される最大待機時間
絶対時間(ブール値) –
デフォルトは
間違い。 もし真実キャプチャ時間の時間インデックスは、シミュレーション時間またはグローバル時間です（台風テストキャプチャの取得結果ドキュメント）。間違い、キャプチャ時間の時間インデックスは相対的です。注記
将来のリリースではこのパラメータは非推奨になります。
- 戻り値:
namedtuple(t, duration, rate) – 以下の属性を持ちます:
t ( NoneType ): キャプチャ開始時刻 (非推奨)
duration ( float ): 調整されたキャプチャ期間
rate : ( float ): システム制約に基づくレート。
- 戻り値の型:
タプル
例
強制キャプチャ開始、戻り値を出力します:
>>>から 台風テストキャプチャ start_captureをインポートします>>> capture_info = start_capture ( duration = 10 , rate = 10000 ) >>> print ( capture_info . t ) >>> print ( capture_info . duration ) >>> print ( capture_info . rate )
オフセットなし、アナログ信号をトリガーとして使用:
>>> start_capture ( duration = rtspec . duration + 2 、 rate=500、 signal=["Probe val", "enable inv", "enable ref"]、 trigger_source="Probe val", trigger_edge="Rising edge" trigger_threshold=277 timeout=10)
デジタル信号で絶対オフセットとトリガーを使用する:
>>> start_capture ( duration = 4 、 offset_absolute=2、 rate=500、 signal=["P", "operating"]、 trigger_source="operating", trigger_threshold=0.5、 trigger_edge="Rising edge", timeout=10)
