この構造体は、"OpenVINO Toolkit" モデル用の推論パラメータを設定する関数群を提供する。続き...

#include <opencv2/gapi/infer/ie.hpp>

Collaboration diagram for cv::gapi::ie::Params< Net >:

公開メンバ関数
	Params (const std::string &model, const std::string &device)

	Params (const std::string &model, const std::string &weights, const std::string &device)
	クラスのコンストラクタ。

GBackend	backend () const

Params< Net > &	cfgBatchSize (const size_t size)
	推論バッチサイズを指定する。

Params &	cfgContextParams (const cv::util::any &ctx_cfg)
	InferenceEngine の RemoteContext の設定を指定する。

Params &	cfgContextParams (cv::util::any &&ctx_cfg)

Params< Net > &	cfgInferMode (InferMode mode)
	推論の実行に使用する api を指定する。

Params< Net > &	cfgInputLayers (const typename PortCfg< Net >::In &layer_names)
	推論用にネットワーク入力レイヤ名の並びを指定する。

Params< Net > &	cfgInputLayout (detail::AttrMap< std::string > layout_map)

Params< Net > &	cfgInputLayout (std::string layout)
	モデルの入力レイアウトを指定する。

Params< Net > &	cfgInputReshape (const std::map< std::string, std::vector< std::size_t > > &reshape_table)
	ネットワーク入力の新しい入力形状を指定する。

Params< Net > &	cfgInputReshape (const std::string &layer_name, const std::vector< size_t > &layer_dims)

Params< Net > &	cfgInputReshape (const std::unordered_set< std::string > &layer_names)

Params< Net > &	cfgInputReshape (std::map< std::string, std::vector< std::size_t > > &&reshape_table)

Params< Net > &	cfgInputReshape (std::string &&layer_name, std::vector< size_t > &&layer_dims)

Params< Net > &	cfgInputReshape (std::unordered_set< std::string > &&layer_names)

Params &	cfgNumRequests (size_t nireq)
	非同期推論リクエストの数を指定する。

Params< Net > &	cfgOutputLayers (const typename PortCfg< Net >::Out &layer_names)
	推論用のネットワーク出力レイヤ名の並びを指定する。

Params< Net > &	cfgOutputLayout (detail::AttrMap< std::string > layout_map)

Params< Net > &	cfgOutputLayout (std::string layout)
	モデルの出力レイアウトを指定する。

Params< Net > &	cfgOutputPrecision (detail::ParamDesc::PrecisionMapT precision_map)

Params< Net > &	cfgOutputPrecision (detail::ParamDesc::PrecisionT precision)
	モデルの出力精度を指定する。

Params< Net > &	cfgPreprocessingParams (const cv::gapi::wip::onevpl::Device &device, const cv::gapi::wip::onevpl::Context &ctx)

Params< Net > &	cfgResize (detail::AttrMap< int > interpolation)

Params< Net > &	cfgResize (int interpolation)
	リサイズの補間アルゴリズムを指定する。

Params< Net > &	constInput (const std::string &layer_name, const cv::Mat &data, TraitAs hint=TraitAs::TENSOR)
	定数入力を指定する。

cv::util::any	params () const

Params &	pluginConfig (const IEConfig &cfg)
	OpenVINOプラグインの設定を指定する。

Params &	pluginConfig (IEConfig &&cfg)

std::string	tag () const

限定公開変数類
detail::ParamDesc	desc

詳細説明

template<typename Net>
class cv::gapi::ie::Params< Net >

この構造体は、"OpenVINO Toolkit" モデル用の推論パラメータを設定する関数群を提供する。

構築子と解体子の詳解

◆ Params() [1/2]

template<typename Net >

cv::gapi::ie::Params< Net >::Params	(	const std::string &	model,
		const std::string &	weights,
		const std::string &	device )

inline

クラスのコンストラクタ。

モデル情報に基づいて Params を構築し、その他の推論記述パラメータにはデフォルト値を指定する。モデルは "OpenVINO Toolkit" を用いて読み込み・コンパイルされる。

引数

model	トポロジー IR (.xml ファイル) へのパス。
weights	重み (.bin ファイル) へのパス。
device	使用するターゲットデバイス。

◆ Params() [2/2]

template<typename Net >

cv::gapi::ie::Params< Net >::Params	(	const std::string &	model,
		const std::string &	device )

inline

これはオーバーロードされたメンバ関数であり、利便性のために提供されている。上記の関数とは、受け取る引数が異なるだけである。コンパイル済みネットワークを扱うにはこのコンストラクタを使用する。モデルはコンパイル済みのblobからインポートされる。

引数

model	モデルへのパス。
device	使用するターゲットデバイス。

メンバ関数詳解

◆ backend()

template<typename Net >

GBackend cv::gapi::ie::Params< Net >::backend ( ) const

inline

この関数の呼び出しグラフ:

◆ cfgBatchSize()

template<typename Net >

Params< Net > & cv::gapi::ie::Params< Net >::cfgBatchSize ( const size_t size )

inline

推論バッチサイズを指定する。

この関数は推論バッチサイズを指定するために使用される。追加情報については https://docs.openvinotoolkit.org/latest/classInferenceEngine_1_1CNNNetwork.html#a8e9d19270a48aab50cb5b1c43eecb8e9 を参照

引数

size	使用されるバッチサイズ。

戻り値: この引数構造体への参照。

この関数の呼び出しグラフ:

◆ cfgContextParams() [1/2]

template<typename Net >

Params & cv::gapi::ie::Params< Net >::cfgContextParams ( const cv::util::any & ctx_cfg )

inline

InferenceEngine の RemoteContext の設定を指定する。

RemoteContext が設定されている場合、バックエンドはそのコンテキストを用いてネットワークをインポートする。また、コンテキスト経由で blob を扱うために、cv::MediaFrames が実際にリモートであることを期待する。

引数

ctx_cfg InferenceEngine::ParamMap を保持する cv::util::any 値。

戻り値: この引数構造体への参照。

◆ cfgContextParams() [2/2]

template<typename Net >

Params & cv::gapi::ie::Params< Net >::cfgContextParams ( cv::util::any && ctx_cfg )

inline

これはオーバーロードされたメンバ関数であり、利便性のために用意されている。受け取る引数のみが上記の関数と異なる。rvalue パラメータを持つ関数。

引数

ctx_cfg InferenceEngine::ParamMap を保持する cv::util::any 値。

戻り値: この引数構造体への参照。

◆ cfgInferMode()

template<typename Net >

Params< Net > & cv::gapi::ie::Params< Net >::cfgInferMode ( InferMode mode )

inline

推論の実行に使用する api を指定する。

この関数は OpenVINO 推論のモードを指定するために使用される。OpenVINO には推論を実行する 2 つのオプションがある:

非同期（StartAsync を使用: https://docs.openvino.ai/latest/classInferenceEngine_1_1InferRequest.html#doxid-class-inference-engine-1-1-infer-request-1a405293e8423d82a5b45f642a3bef0d24）
同期（Infer を使用: https://docs.openvino.ai/latest/classInferenceEngine_1_1InferRequest.html#doxid-class-inference-engine-1-1-infer-request-1a3391ce30894abde730523e9ca9371ce8）デフォルトでは非同期モードが使用される。

引数

mode	使用される推論モード。

戻り値: この引数構造体への参照。

◆ cfgInputLayers()

template<typename Net >

Params< Net > & cv::gapi::ie::Params< Net >::cfgInputLayers ( const typename PortCfg< Net >::In & layer_names )

inline

推論用にネットワーク入力レイヤ名の並びを指定する。

この関数は cv::gapi::infer<> の入力をモデルの入力と関連付けるために使用する。名前の数は G_API_NET() で定義されたネットワーク入力の数と一致している必要がある。ネットワークの入力レイヤが1つだけの場合は、名前を手動で指定する必要はない。

引数

layer_names std::array<std::string, N>。N は G_API_NET で定義された入力の数である。入力レイヤの名前を格納する。

戻り値: この引数構造体への参照。

◆ cfgInputLayout() [1/2]

template<typename Net >

Params< Net > & cv::gapi::ie::Params< Net >::cfgInputLayout ( detail::AttrMap< std::string > layout_map )

inline

これは利便性のために提供されているオーバーロードされたメンバ関数である。上記の関数とは、受け取る引数のみが異なる。

引数

layout_map ペアのマップ: 対応する入力レイヤの名前と、その文字列表現でのレイアウト（"NCHW"、"NHWC" など）

戻り値: この引数構造体への参照。

◆ cfgInputLayout() [2/2]

template<typename Net >

Params< Net > & cv::gapi::ie::Params< Net >::cfgInputLayout ( std::string layout )

inline

モデルの入力レイアウトを指定する。

この関数はモデルの入力レイアウトを設定するために使用される。

引数

layout 文字列表現でのレイアウト（"NCHW"、"NHWC" など）がすべての入力レイヤに適用される。

戻り値: この引数構造体への参照。

◆ cfgInputReshape() [1/6]

template<typename Net >

Params< Net > & cv::gapi::ie::Params< Net >::cfgInputReshape ( const std::map< std::string, std::vector< std::size_t > > & reshape_table )

inline

ネットワーク入力の新しい入力形状を指定する。

この関数はネットワーク入力の新しい入力形状を指定するために使用される。追加情報については https://docs.openvinotoolkit.org/latest/classInferenceEngine_1_1networkNetwork.html を参照。

引数

reshape_table ペアのマップ: 対応するデータの名前と、その次元。

戻り値: この引数構造体への参照。

◆ cfgInputReshape() [2/6]

template<typename Net >

Params< Net > & cv::gapi::ie::Params< Net >::cfgInputReshape	(	const std::string &	layer_name,
		const std::vector< size_t > &	layer_dims )

inline

これは利便性のために提供されているオーバーロードされたメンバ関数である。上記の関数とは、受け取る引数のみが異なる。

引数

layer_name	レイヤの名前。
layer_dims	このレイヤの新しい次元。

戻り値: この引数構造体への参照。

◆ cfgInputReshape() [3/6]

template<typename Net >

Params< Net > & cv::gapi::ie::Params< Net >::cfgInputReshape ( const std::unordered_set< std::string > & layer_names )

inline

これは利便性のために提供されているオーバーロードされたメンバ関数である。上記の関数とは、受け取る引数のみが異なる。

引数

layer_names ネットワークのリシェイプに使用されるネットワークレイヤの名前のセット。

戻り値: この引数構造体への参照。

◆ cfgInputReshape() [4/6]

template<typename Net >

Params< Net > & cv::gapi::ie::Params< Net >::cfgInputReshape ( std::map< std::string, std::vector< std::size_t > > && reshape_table )

inline

これは利便性のために提供されているオーバーロードされたメンバ関数である。上記の関数とは、受け取る引数のみが異なる。

◆ cfgInputReshape() [5/6]

template<typename Net >

Params< Net > & cv::gapi::ie::Params< Net >::cfgInputReshape	(	std::string &&	layer_name,
		std::vector< size_t > &&	layer_dims )

inline

これは利便性のために提供されているオーバーロードされたメンバ関数である。上記の関数とは、受け取る引数のみが異なる。

◆ cfgInputReshape() [6/6]

template<typename Net >

Params< Net > & cv::gapi::ie::Params< Net >::cfgInputReshape ( std::unordered_set< std::string > && layer_names )

inline

これは利便性のために提供されているオーバーロードされたメンバ関数である。上記の関数とは、受け取る引数のみが異なる。

引数

layer_names 選択されたレイヤの rvalue セット。その入力画像サイズに合わせて自動的にリシェイプされる。

戻り値: この引数構造体への参照。

◆ cfgNumRequests()

template<typename Net >

Params & cv::gapi::ie::Params< Net >::cfgNumRequests ( size_t nireq )

inline

非同期推論リクエストの数を指定する。

引数

nireq 非同期推論リクエストの数。

戻り値: この引数構造体への参照。

◆ cfgOutputLayers()

template<typename Net >

Params< Net > & cv::gapi::ie::Params< Net >::cfgOutputLayers ( const typename PortCfg< Net >::Out & layer_names )

inline

推論用のネットワーク出力レイヤ名の並びを指定する。

この関数は cv::gapi::infer<> の出力をモデルの出力と関連付けるために使用する。名前の数は G_API_NET() で定義されたネットワーク出力の数と一致している必要がある。ネットワークの出力レイヤが1つだけの場合は、名前を手動で指定する必要はない。

引数

layer_names std::array<std::string, N>。N は G_API_NET で定義された出力の数である。出力レイヤの名前を格納する。

戻り値: この引数構造体への参照。

◆ cfgOutputLayout() [1/2]

template<typename Net >

Params< Net > & cv::gapi::ie::Params< Net >::cfgOutputLayout ( detail::AttrMap< std::string > layout_map )

inline

これは利便性のために提供されているオーバーロードされたメンバ関数である。上記の関数とは、受け取る引数のみが異なる。

引数

layout_map ペアのマップ: 対応する出力レイヤの名前と、その文字列表現でのレイアウト（"NCHW"、"NHWC" など）

戻り値: この引数構造体への参照。

◆ cfgOutputLayout() [2/2]

template<typename Net >

Params< Net > & cv::gapi::ie::Params< Net >::cfgOutputLayout ( std::string layout )

inline

モデルの出力レイアウトを指定する。

この関数はモデルの出力レイアウトを設定するために使用される。

引数

layout 文字列表現でのレイアウト（"NCHW"、"NHWC" など）がすべての出力レイヤに適用される。

戻り値: この引数構造体への参照。

◆ cfgOutputPrecision() [1/2]

template<typename Net >

Params< Net > & cv::gapi::ie::Params< Net >::cfgOutputPrecision ( detail::ParamDesc::PrecisionMapT precision_map )

inline

これは利便性のために提供されているオーバーロードされたメンバ関数である。上記の関数とは、受け取る引数のみが異なる。

引数

precision_map ペアのマップ：対応する出力レイヤの名前と、OpenCV形式でのその精度（CV_8U、CV_32F、...）

戻り値: この引数構造体への参照。

◆ cfgOutputPrecision() [2/2]

template<typename Net >

Params< Net > & cv::gapi::ie::Params< Net >::cfgOutputPrecision ( detail::ParamDesc::PrecisionT precision )

inline

モデルの出力精度を指定する。

この関数はモデルの出力精度を設定するために使用される。

引数

precision OpenCV形式での精度（CV_8U、CV_32F、...）がすべての出力レイヤに適用される。

戻り値: この引数構造体への参照。

◆ cfgPreprocessingParams()

template<typename Net >

Params< Net > & cv::gapi::ie::Params< Net >::cfgPreprocessingParams	(	const cv::gapi::wip::onevpl::Device &	device,
		const cv::gapi::wip::onevpl::Context &	ctx )

inline

この関数の呼び出しグラフ:

◆ cfgResize() [1/2]

template<typename Net >

Params< Net > & cv::gapi::ie::Params< Net >::cfgResize ( detail::AttrMap< int > interpolation )

inline

これは利便性のために提供されているオーバーロードされたメンバ関数である。上記の関数とは、受け取る引数のみが異なる。

引数

interpolation ペアのマップ：対応する入力レイヤの名前とそのリサイズアルゴリズム。

戻り値: この引数構造体への参照。

◆ cfgResize() [2/2]

template<typename Net >

Params< Net > & cv::gapi::ie::Params< Net >::cfgResize ( int interpolation )

inline

リサイズの補間アルゴリズムを指定する。

この関数は入力レイヤのリサイズ前処理を構成するために使用する。

引数

interpolation リサイズの補間アルゴリズム。サポートされているアルゴリズム: INTER_LINEAR、INTER_AREA。

戻り値: この引数構造体への参照。

◆ constInput()

template<typename Net >

Params< Net > & cv::gapi::ie::Params< Net >::constInput	(	const std::string &	layer_name,
		const cv::Mat &	data,
		TraitAs	hint = TraitAs::TENSOR )

inline

定数入力を指定する。

この関数は定数入力を設定するために使用される。この入力は、その型が TENSOR の場合、前処理済みのテンソルでなければならない。提供されたデータを受け取るネットワークレイヤの名前を指定する必要がある。

引数

layer_name	ネットワークレイヤの名前。
data	ネットワークレイヤーに関連付けられるデータを格納するcv::Mat。
hint	入力型

参照: cv::gapi::ie::TraitAs.

戻り値: この引数構造体への参照。

◆ params()

template<typename Net >

cv::util::any cv::gapi::ie::Params< Net >::params ( ) const

inline

◆ pluginConfig() [1/2]

template<typename Net >

Params & cv::gapi::ie::Params< Net >::pluginConfig ( const IEConfig & cfg )

inline

OpenVINO プラグインの構成を指定する。

この関数は OpenVINO プラグインの構成を設定するために使用する。一部の引数はプラグインごとに異なる場合がある。特定のプラグインに関する情報については https://docs.openvinotoolkit.org/latest/index.html を参照すること。

引数

cfg	ペアのマップ：（設定パラメータ名、設定パラメータ値）。

戻り値: この引数構造体への参照。

◆ pluginConfig() [2/2]

template<typename Net >

Params & cv::gapi::ie::Params< Net >::pluginConfig ( IEConfig && cfg )

inline

これはオーバーロードされたメンバ関数であり、利便性のために用意されている。受け取る引数のみが上記の関数と異なる。rvalue パラメータを持つ関数。

引数

cfg	ペアの rvalue マップ: (設定パラメータ名, 設定パラメータ値)。

戻り値: この引数構造体への参照。

◆ tag()

template<typename Net >

std::string cv::gapi::ie::Params< Net >::tag ( ) const

inline

メンバ変数詳解

◆ desc

template<typename Net >

detail::ParamDesc cv::gapi::ie::Params< Net >::desc

protected

このクラス詳解は次のファイルから抽出されました:

opencv2/gapi/infer/ie.hpp

公開メンバ関数

限定公開変数類

詳細説明

構築子と解体子の詳解

◆ Params() [1/2]

◆ Params() [2/2]

メンバ関数詳解

◆ backend()

◆ cfgBatchSize()

◆ cfgContextParams() [1/2]

◆ cfgContextParams() [2/2]

◆ cfgInferMode()

◆ cfgInputLayers()

◆ cfgInputLayout() [1/2]

◆ cfgInputLayout() [2/2]

◆ cfgInputReshape() [1/6]

◆ cfgInputReshape() [2/6]

◆ cfgInputReshape() [3/6]

◆ cfgInputReshape() [4/6]

◆ cfgInputReshape() [5/6]

◆ cfgInputReshape() [6/6]

◆ cfgNumRequests()

◆ cfgOutputLayers()

◆ cfgOutputLayout() [1/2]

◆ cfgOutputLayout() [2/2]

◆ cfgOutputPrecision() [1/2]

◆ cfgOutputPrecision() [2/2]

◆ cfgPreprocessingParams()

◆ cfgResize() [1/2]

◆ cfgResize() [2/2]

◆ constInput()

◆ params()

◆ pluginConfig() [1/2]

◆ pluginConfig() [2/2]

◆ tag()

メンバ変数詳解

◆ desc