run_oa.py オプション

<project-dir>

必須です。インテル® Advisor のプロジェクト・ディレクトリーへのパスを指定します。

-h

--help

すべてのスクリプトのオプションを表示.

-v <verbose>

--verbose <verbose>

出力の詳細レベルを指定します。

• 1 - エラーメッセージにのみを表示します。これは最も冗長的なレベルです。

• 2 - 警告とエラーメッセージを表示します。

• 3 (デフォルト) - 情報、警告、およびエラーメッセージを表示します。

• 4 - デバッグ情報、警告、およびエラーメッセージを表示します。これは最も詳細なレベルです。

--assume-dependencies (デフォルト) | --no-assume-dependencies

ループのタイプが不明である場合、ループに依存関係があると想定されます。無効にすると、ループの依存関係タイプが不明 (unknown) である場合、ループには依存関係がないと想定されます。

--assume-hide-taxes [<loop-id> | <file-name>:<line-number>]

楽観的なアプローチにより呼び出しコストを見積もります。最初の呼び出しコストを除くすべての呼び出しコストを非表示にします。

コストを非表示にするループ ID とソースの場所を、カンマで区切ったリストで指定できます。リストを指定しないとすべてのループのコストは非表示になります。

--assume-never-hide-taxes (デフォルト)

悲観的なアプローチにより呼び出しコストを見積もります。呼び出しコストを非表示にしません。

--assume-parallel | --no-assume-parallel (デフォルト)

ループのタイプが不明である場合、並列ループであると想定されます。

--check-profitability (デフォルト) | --no-check-profitability

オフロード領域のゲインを確認します。スピード向上の恩恵が得られる領域のみがレポートに追加されます。

無効にすると、特定の領域のオフロードの収益性に関わりなく、評価されたすべての領域がレポートに追加されます。

-c {basic, refinement, full}

--collect {basic, refinement, full}

アプリケーションで収集するデータタイプを指定します。

• basic- 基本的なパフォーマンス・データ (サーベイ、トリップカウント、FLOP) を収集し、ホストとデバイスメモリー間のデータ転送を解析し、メモリー・オブジェクトをループに関連付けてスタックメモリーへのアクセスを追跡します。
• refinement- マークされたループについてのみリファインデータ (依存関係) を収集します。データ転送を解析しません。
• full(デフォルト) - アプリケーションの基本データとマークされたループの詳細データを収集し、ホストとデバイスメモリー間のデータ転送と潜在的なデータの再利用を解析し、メモリー・オブジェクトをループに関連付けてスタックメモリーへのアクセスを追跡します。

--config <config>

絶対パスまたは名前で設定ファイルを指定します。後者を選択した場合、モデル設定ディレクトリーで最初にファイルが検索され、次に現在のディレクトリーが検索されます。

次のデバイス構成が利用できます。Xehpg_512xve (デフォルト)、xehpg_256xve、gen12_tgl、gen12_dg1。

--cpu-scale-factor <integer>

元の CPU よりも指定された値だけ高速なホスト CPU を推測します。

元の CPU 時間はすべてスケール係数で除算されます。

--data-reuse-analysis (デフォルト) | --no-data-reuse-analysis

オフロード領域間でのデータの再利用を推測します。無効にするとオーバーヘッドを減らすことができます。

--data-transfer (デフォルト) | --no-data-transfer

データ転送を解析します。

--dry-run

指定された構成に対応する advisor のインテル® Advisor CLI コマンドを表示します。実際の収集は行われません。

--enable-batching | --disable-batching (デフォルト)

上位レベルオフロードのジョブバッチを有効にします。複数インスタンスの同時実行をエミュレートします。

--enable-edram

メモリー階層モデルで eDRAM のモデル化を有効にします。

--enable-slm

メモリー階層モデルで SLM によるモデル化を有効にします。collect.py と analyze.py の両方を使用します。

--exclude-from-report <items-to-exclude>

レポートから除外する項目を指定します。利用可能な項目は以下です。memory_objects、sources、call_graph、dependencies、strides。

デフォルトでは、次の項目をレポートから除外できます。

• CPU から GPU へのモデル化:
  • メモリー・オブジェクト
  • ソース
  • コールグラフ
  • 依存関係
• GPU から GPU へのモデル化:
  • メモリー・オブジェクト
  • ソース

例えば、大量のメモリー・オブジェクトやソースが含まれるため、レポートが重くなりブラウザーで開くのに時間がかかる場合は、このオプションを使用します。

--executable-of-interest <executable-name>

実行するアプリケーションと異なる場合、プロファイルする実行形式のプロセス名を指定します。このオプションは、スクリプトまたはその他のバイナリーからアプリケーションが実行される場合に使用します。

--flex-cachesim <cache-configuration>

柔軟性のあるキャッシュ・シミュレーションにより、複数のターゲットデバイスのキャッシュデータをモデル化します。また、データを再収集することなく解析対象のデバイスを変更できます。構成が設定されていないとデフォルトでは、サポートされるすべてのターゲット・プラットフォームのキャッシュデータがシミュレートされます。

<size_of_level1>:<size_of_level2>:<size_of_level3> の形式で、スラッシュで区切ったキャッシュ構成リストを指定できます。各メモリーレベルのサイズには、次の測定単位を使用します。b- バイト、k- キロバイトまたは、m- メガバイト。

例:8k:512k:8m/24k:1m:8m/32k:1536k:8m。

--gpu (推奨) | --profile-gpu | --analyze-gpu-kernels-only

GPU 上で実行されるコア領域のみのパフォーマンスをモデル化します。以下の 3 つのいずれかのオプションを使用します。

--ignore <list>

プログラムごとにスピードアップを計算する際に、ランタイムやライブラリー領域で費やされた時間を無視するには、ランタイムやライブラリーをカンマで区切って指定します。

--include-to-report <items-to-include>

含める項目を次のように指定します。利用可能な項目は以下です。memory_objects、sources、call_graph、dependencies、strides。

デフォルトでは、次の項目をレポートに追加できます。

• CPU から GPU へのモデル化: ストライド
• GPU から GPU へのモデル化:
  • コールグラフ
  • 依存関係
  • ストライド

レポートにさらにデータを追加する、または収集したデータでソースやメモリー・オブジェクトがデータレポートから欠落していることを確認するには、このオプションを使用します。

-m [{all, generic, regions, omp, icpx -fsycl, daal, tbb}]

--markup [{all, generic, regions, omp, icpx -fsycl, daal, tbb}]

サーベイまたはその他のデータ収集後にループをマークします。このオプションを使用して与えられたパラメーターに従ってループを選択することで、追加の収集の範囲を制限します。

• all- 追加して収集するオプションとして渡すループ ID のリストを取得します。

• generic(デフォルト) - すべての領域をマークして最も収益性の高い場所を選択します。

• regions- 既存の並列領域を選択します。

• omp- OpenMP* 領域の最も外側のループを選択します。

• icpx -fsycl- SYCL* 領域の最も外側のループを選択します。

• daal- インテル® oneAPI データ・アナリティクス・ライブラリー領域の最も外側のループを選択します。

• tbb- インテル® oneAPI スレッディング・ビルディング・ブロック (oneTBB) 領域の最も外側のループを選択します。

omp、icpx -fsycl、またはgenericループ選択オプションなしでも対応する収集を実行できるように、プロジェクトでループを選択します。

複数のパラメーターをカンマで区切ってリストで指定できます。ループは指定されたパラメーターのいずれかに一致する場合選択されます。

--model-system-calls (デフォルト) | --no-model-system-calls

システムコールで領域を解析します。領域内にシステムコールがあると、モデル化の精度が低下する可能性があります。

--mpi-rank <mpi-rank>

複数のランクが解析されている場合、対象とする MPI ランクを指定します。

--no-cache-sources

プロジェクトでソースコードのキャッシュ保持を無効にします。

--no-cachesim

収集中のキャッシュ・シミュレーションを無効にします。このモデルは 100% のキャッシュヒット率を想定します。

--no-profile-jit

JIT 関数の解析を無効にします。

--no-stacks

スタック上のデータ分布を収集せずにデータ収集を実行します。このオプションを使用すると、精度が低下する代わりにオーバーヘッドを減らすことができます。

-o <output-dir>

--out-dir <output-dir>

生成されるすべてのファイルを格納するディレクトリーを指定します。デフォルトでは、結果は <advisor-project>/e<NNN>/pp<MMM>/data.0 に保存されます。既存のディレクトリーや絶対パスを指定すると、結果はそのディレクトリーに保存されます。存在しない場合は、新しいディレクトリーが作成されます。

ディレクトリー <name> のみが指定されると、結果は <advisor-project>/perf_models/<name> に保存されます。

-p <output-name-prefix>

--out-name-prefix <output-name-prefix>

出力結果ファイル名の先頭に追加する文字列を指定します。

--set-parameter <CLI-config>

変更する構成パラメーターを "<group>.<parameter>=<new-value>」 形式で指定します。例:"min_required_speed_up=0"、"scale.Tiles_per_process=0.5"。このオプションを複数指定して、複数のパラメーターを変更することもできます。

--track-heap-objects (デフォルト)| --no-track-heap-objects

非推奨です。--track-memory-objects を使用します。

--track-memory-objects (デフォルト) | --no-track-memory-objects

ヒープに割り当てられたオブジェクトを、解析中にオブジェクトにアクセスしたループに属性化します。無効にすると解析のオーバーヘッドを減らすことができます。

--track-stack-accesses (デフォルト) | --no-track-stack-accesses

スタックメモリーへのアクセスを追跡します。