グローバルモーション推定

詳細説明

ビデオスタビライゼーションモジュールには、点群間または画像間のグローバルな動き推定を行う関数とクラスの一式が含まれる。後者の場合、特徴は内部で抽出されマッチングされる。利便性のため、動き推定関数はクラスにラップされている。関数とクラスの両方が利用可能である。

クラス
class	cv::videostab::FromFileMotionReader
class	cv::videostab::GaussianMotionFilter
class	cv::videostab::ImageMotionEstimatorBase
	フレームを入力として受け取るグローバル2D動き推定手法の基底クラス。続きを読む...
class	cv::videostab::IMotionStabilizer
class	cv::videostab::KeypointBasedMotionEstimator
	マッチングにキーポイント検出とオプティカルフローを用いるグローバル2D動き推定手法を記述する。続きを読む...
class	cv::videostab::LpMotionStabilizer
class	cv::videostab::MotionEstimatorBase
	すべてのグローバル動き推定手法の基底クラス。続きを読む...
class	cv::videostab::MotionEstimatorL1
	L1 誤差を最小化するグローバル2D動き推定手法を記述する。続きを読む...
class	cv::videostab::MotionEstimatorRansacL2
	L2 誤差を最小化する、RANSACベースのロバストなグローバル2D動き推定手法を記述する。続きを読む...
class	cv::videostab::MotionFilterBase
class	cv::videostab::MotionStabilizationPipeline
struct	cv::videostab::RansacParams
	RANSAC法の引数を記述する。続き...
class	cv::videostab::ToFileMotionWriter

列挙型
enum	cv::videostab::MotionModel {   cv::videostab::MM_TRANSLATION = 0 ,   cv::videostab::MM_TRANSLATION_AND_SCALE = 1 ,   cv::videostab::MM_ROTATION = 2 ,   cv::videostab::MM_RIGID = 3 ,   cv::videostab::MM_SIMILARITY = 4 ,   cv::videostab::MM_AFFINE = 5 ,   cv::videostab::MM_HOMOGRAPHY = 6 ,   cv::videostab::MM_UNKNOWN = 7 }
	2つの点群間の動きモデルを記述する。続き...

関数
	cv::videostab::GaussianMotionFilter::GaussianMotionFilter (int radius=15, float stdev=-1.f)
	cv::videostab::RansacParams::RansacParams (int size, float thresh, float eps, float prob)
	コンストラクタ。
Mat	cv::videostab::ensureInclusionConstraint (const Mat &M, Size size, float trimRatio)
Mat	cv::videostab::estimateGlobalMotionLeastSquares (InputOutputArray points0, InputOutputArray points1, int model=MM_AFFINE, float *rmse=0)
	2つの2D点群間の最適なグローバル動きを最小二乗の意味で推定する。
Mat	cv::videostab::estimateGlobalMotionRansac (InputArray points0, InputArray points1, int model=MM_AFFINE, const RansacParams &params=RansacParams::default2dMotion(MM_AFFINE), float *rmse=0, int *ninliers=0)
	2つの2D点群間の最適なグローバル動きをロバストに(RANSAC法を用いて)推定する。
float	cv::videostab::estimateOptimalTrimRatio (const Mat &M, Size size)
Mat	cv::videostab::getMotion (int from, int to, const std::vector< Mat > &motions)
	すべての中間の動きが既知であると仮定して、2つのフレーム間の動きを計算する。

列挙型詳解

MotionModel

enum cv::videostab::MotionModel

#include <opencv2/videostab/motion_core.hpp>

2つの点群間の動きモデルを記述する。

列挙値
MM_TRANSLATION  Python: cv.videostab.MM_TRANSLATION
MM_TRANSLATION_AND_SCALE  Python: cv.videostab.MM_TRANSLATION_AND_SCALE
MM_ROTATION  Python: cv.videostab.MM_ROTATION
MM_RIGID  Python: cv.videostab.MM_RIGID
MM_SIMILARITY  Python: cv.videostab.MM_SIMILARITY
MM_AFFINE  Python: cv.videostab.MM_AFFINE
MM_HOMOGRAPHY  Python: cv.videostab.MM_HOMOGRAPHY
MM_UNKNOWN  Python: cv.videostab.MM_UNKNOWN

関数詳解

GaussianMotionFilter()

cv::videostab::GaussianMotionFilter::GaussianMotionFilter ( int radius = 15, float stdev = -1.f )

inline

#include <opencv2/videostab/motion_stabilizing.hpp>

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

RansacParams()

cv::videostab::RansacParams::RansacParams ( int size, float thresh, float eps, float prob )

inline

#include <opencv2/videostab/motion_core.hpp>

コンストラクタ。

引数

size	サブセットのサイズ。
thresh	インライアと判定するための再投影誤差の最大値。
eps	誤った対応点の最大比率。
prob	要求される成功確率。

ensureInclusionConstraint()

Mat cv::videostab::ensureInclusionConstraint	(	const Mat &	M,
		Size	size,
		float	trimRatio )

#include <opencv2/videostab/motion_stabilizing.hpp>

estimateGlobalMotionLeastSquares()

Mat cv::videostab::estimateGlobalMotionLeastSquares	(	InputOutputArray	points0,
		InputOutputArray	points1,
		int	model = MM_AFFINE,
		float *	rmse = 0 )

#include <opencv2/videostab/global_motion.hpp>

2つの2D点群間の最良のグローバルな動きを最小二乗の意味で推定する。

覚え書き

インプレースで動作し、入力の点配列を変更する。

引数

points0	2D点の入力集合 (32F)。
points1	2D点の出力集合 (32F)。
model	動きモデル (MM_AFFINE まで)。
rmse	最終的な二乗平均平方根誤差。

戻り値

3x3 の2D変換行列 (32F)。

estimateGlobalMotionRansac()

Mat cv::videostab::estimateGlobalMotionRansac	(	InputArray	points0,
		InputArray	points1,
		int	model = MM_AFFINE,
		const RansacParams &	params = RansacParams::default2dMotion(MM_AFFINE),
		float *	rmse = 0,
		int *	ninliers = 0 )

#include <opencv2/videostab/global_motion.hpp>

2つの2D点群間の最良のグローバルな動きをロバストに（RANSAC法を用いて）推定する。

引数

points0	2D点の入力集合 (32F)。
points1	2D点の出力集合 (32F)。
model	動きモデル。cv::videostab::MotionModel を参照。
params	RANSAC法の引数。videostab::RansacParams を参照。
rmse	最終的な二乗平均平方根誤差。
ninliers	最終的なインライアの数。

estimateOptimalTrimRatio()

float cv::videostab::estimateOptimalTrimRatio	(	const Mat &	M,
		Size	size )

#include <opencv2/videostab/motion_stabilizing.hpp>

getMotion()

Mat cv::videostab::getMotion	(	int	from,
		int	to,
		const std::vector< Mat > &	motions )

#include <opencv2/videostab/global_motion.hpp>

すべての中間の動きが既知であると仮定して、2つのフレーム間の動きを計算する。

引数

from	ソースフレームのインデックス。
to	デスティネーションフレームのインデックス。
motions	ペアごとの動き。motions[i] はフレーム i からフレーム i+1 への動きを表す。

戻り値

ソースフレームからデスティネーションフレームへの動き。

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