Skip to content

O
opencv
Commit d3b14b71 authored by Andrey Kamaev's avatar Andrey Kamaev
Browse files
Options

Documenation: merged recent changes from trunk

parent 567949e2
Expand all Hide whitespace changes
Inline Side-by-side
Showing with 254 additions and 243 deletions
doc/ocv.py
View file @ d3b14b71
...@@ -302,9 +302,10 @@ _visibility_re = re.compile(r'\b(public|private|protected)\b') ...@@ -302,9 +302,10 @@ _visibility_re = re.compile(r'\b(public|private|protected)\b')
_operator_re = re.compile(r'''(?x) _operator_re = re.compile(r'''(?x)
\[\s*\] \[\s*\]
| \(\s*\) | \(\s*\)
| (<<|>>)=?
| [!<>=/*%+|&^-]=? | [!<>=/*%+|&^-]=?
| \+\+ | -- | \+\+ | --
| (<<|>>)=? | ~ | && | \| | \|\| | ~ | && | \| | \|\|
| ->\*? | \, | ->\*? | \,
''') ''')
...@@ -560,6 +561,18 @@ class ConstDefExpr(WrappingDefExpr): ...@@ -560,6 +561,18 @@ class ConstDefExpr(WrappingDefExpr):
def __unicode__(self): def __unicode__(self):
return (self.prefix and u'const %s' or u'%s const') % self.typename return (self.prefix and u'const %s' or u'%s const') % self.typename
class ConstTemplateDefExpr(WrappingDefExpr):
def __init__(self, typename, prefix=False):
WrappingDefExpr.__init__(self, typename)
self.prefix = prefix
def get_id(self):
return self.typename.get_id() + u'C'
def __unicode__(self):
return (self.prefix and u'const %s' or u'%s const') % self.typename
class CastOpDefExpr(PrimaryDefExpr): class CastOpDefExpr(PrimaryDefExpr):
...@@ -933,9 +946,11 @@ class DefinitionParser(object): ...@@ -933,9 +946,11 @@ class DefinitionParser(object):
else: else:
rv = PathDefExpr(result) rv = PathDefExpr(result)
is_const = self._peek_const(modifiers) is_const = self._peek_const(modifiers)
if is_const:
rv = ConstDefExpr(rv, prefix=True)
if modifiers: if modifiers:
rv = ModifierDefExpr(rv, modifiers) rv = ModifierDefExpr(rv, modifiers)
return self._attach_crefptr(rv, is_const) return self._attach_crefptr(rv, False)
def _parse_default_expr(self): def _parse_default_expr(self):
self.skip_ws() self.skip_ws()
...@@ -1136,7 +1151,7 @@ class OCVObject(ObjectDescription): ...@@ -1136,7 +1151,7 @@ class OCVObject(ObjectDescription):
theid = sig#obj.get_id() theid = sig#obj.get_id()
theid = re.sub(r" +", " ", theid) theid = re.sub(r" +", " ", theid)
theid = re.sub(r"=[^,()]+\([^)]*?\)[^,)]*(,|\))", "\\1", theid) theid = re.sub(r"=[^,()]+\([^)]*?\)[^,)]*(,|\))", "\\1", theid)
theid = re.sub(r"=[^,)]+(,|\))", "\\1", theid) theid = re.sub(r"=\w*[^,)(]+(,|\))", "\\1", theid)
theid = theid.replace("( ", "(").replace(" )", ")") theid = theid.replace("( ", "(").replace(" )", ")")
name = unicode(sigobj.name) name = unicode(sigobj.name)
if theid not in self.state.document.ids: if theid not in self.state.document.ids:
...@@ -1149,6 +1164,8 @@ class OCVObject(ObjectDescription): ...@@ -1149,6 +1164,8 @@ class OCVObject(ObjectDescription):
#(self.env.docname, self.objtype, theid)) #(self.env.docname, self.objtype, theid))
self.env.domaindata['ocv']['objects'].setdefault(theid, self.env.domaindata['ocv']['objects'].setdefault(theid,
(self.env.docname, self.objtype, theid)) (self.env.docname, self.objtype, theid))
self.env.domaindata['ocv']['objects2'].setdefault(name,
(self.env.docname, self.objtype, theid))
indextext = self.get_index_text(name) indextext = self.get_index_text(name)
if indextext: if indextext:
...@@ -1192,33 +1209,32 @@ class OCVObject(ObjectDescription): ...@@ -1192,33 +1209,32 @@ class OCVObject(ObjectDescription):
class OCVClassObject(OCVObject): class OCVClassObject(OCVObject):
object_annotation = "class "
object_long_name = "class"
def get_index_text(self, name): def attach_modifiers(self, node, obj):
return _('%s (C++ class)') % name if obj.visibility != 'public':
node += addnodes.desc_annotation(obj.visibility,
def parse_definition(self, parser): obj.visibility)
return parser.parse_class() node += nodes.Text(' ')
if obj.static:
def describe_signature(self, signode, cls): node += addnodes.desc_annotation('static', 'static')
#self.attach_modifiers(signode, cls) node += nodes.Text(' ')
#signode += addnodes.desc_annotation('class ', 'class ')
#self.attach_name(signode, cls.name)
pass
class OCVStructObject(OCVObject):
def get_index_text(self, name): def get_index_text(self, name):
return _('%s (C structure)') % name return _('%s (C++ %s)') % (name, self.__class__.object_long_name)
def parse_definition(self, parser): def parse_definition(self, parser):
return parser.parse_class() return parser.parse_class()
def describe_signature(self, signode, cls): def describe_signature(self, signode, cls):
#self.attach_modifiers(signode, cls) self.attach_modifiers(signode, cls)
#signode += addnodes.desc_annotation('class ', 'class ') signode += addnodes.desc_annotation(self.__class__.object_annotation, self.__class__.object_annotation)
#self.attach_name(signode, cls.name) self.attach_name(signode, cls.name)
pass
class OCVStructObject(OCVClassObject):
object_annotation = "struct "
object_long_name = "structure"
class OCVTypeObject(OCVObject): class OCVTypeObject(OCVObject):
...@@ -1238,9 +1254,7 @@ class OCVTypeObject(OCVObject): ...@@ -1238,9 +1254,7 @@ class OCVTypeObject(OCVObject):
signode += nodes.Text(' ') signode += nodes.Text(' ')
self.attach_name(signode, obj.name) self.attach_name(signode, obj.name)
class OCVMemberObject(OCVObject): class OCVMemberObject(OCVObject):
ismember = True ismember = True
def get_index_text(self, name): def get_index_text(self, name):
...@@ -1259,7 +1273,6 @@ class OCVMemberObject(OCVObject): ...@@ -1259,7 +1273,6 @@ class OCVMemberObject(OCVObject):
if obj.value is not None: if obj.value is not None:
signode += nodes.Text(u' = ' + obj.value) signode += nodes.Text(u' = ' + obj.value)
class OCVFunctionObject(OCVObject): class OCVFunctionObject(OCVObject):
def attach_function(self, node, func): def attach_function(self, node, func):
...@@ -1406,9 +1419,9 @@ class OCVDomain(Domain): ...@@ -1406,9 +1419,9 @@ class OCVDomain(Domain):
'func' : OCVXRefRole(fix_parens=True), 'func' : OCVXRefRole(fix_parens=True),
'funcx' : OCVXRefRole(), 'funcx' : OCVXRefRole(),
'cfunc' : OCVXRefRole(fix_parens=True), 'cfunc' : OCVXRefRole(fix_parens=True),
'cfunc' : OCVXRefRole(), 'cfuncx' : OCVXRefRole(),
'jfunc' : OCVXRefRole(fix_parens=True), 'jfunc' : OCVXRefRole(fix_parens=True),
'jfunc' : OCVXRefRole(), 'jfuncx' : OCVXRefRole(),
'pyfunc' : OCVPyXRefRole(), 'pyfunc' : OCVPyXRefRole(),
'pyoldfunc' : OCVPyXRefRole(), 'pyoldfunc' : OCVPyXRefRole(),
'member': OCVXRefRole(), 'member': OCVXRefRole(),
...@@ -1417,6 +1430,10 @@ class OCVDomain(Domain): ...@@ -1417,6 +1430,10 @@ class OCVDomain(Domain):
initial_data = { initial_data = {
'objects': {}, # fullname -> docname, objtype 'objects': {}, # fullname -> docname, objtype
} }
def __init__(self, env):
Domain.__init__(self, env)
self.data['objects2'] = {}
def clear_doc(self, docname): def clear_doc(self, docname):
for fullname, (fn, _, _) in self.data['objects'].items(): for fullname, (fn, _, _) in self.data['objects'].items():
...@@ -1427,13 +1444,28 @@ class OCVDomain(Domain): ...@@ -1427,13 +1444,28 @@ class OCVDomain(Domain):
typ, target, node, contnode): typ, target, node, contnode):
def _create_refnode(expr): def _create_refnode(expr):
name = unicode(expr) name = unicode(expr)
if name not in self.data['objects']: if "type" in self.objtypes_for_role(typ):
return None
if "cfunction" in self.objtypes_for_role(typ):
if not name.startswith(u'cv'):
name = u'cv' + name
dict = self.data['objects']
if name not in dict:
dict = self.data['objects2']
if name not in dict:
refdoc = node.get('refdoc', fromdocname)
env.warn(refdoc, 'unresolved reference: %r - %r' % (target, typ), node.line)
return None return None
obj = self.data['objects'][name] obj = dict[name]
if obj[1] not in self.objtypes_for_role(typ): if obj[1] not in self.objtypes_for_role(typ):
return None return None
title = obj[2]
if "class" in self.objtypes_for_role(typ):
title = u"class " + title
elif "struct" in self.objtypes_for_role(typ):
title = u"struct " + title
return make_refnode(builder, fromdocname, obj[0], obj[2], return make_refnode(builder, fromdocname, obj[0], obj[2],
contnode, name) contnode, title)
parser = DefinitionParser(target) parser = DefinitionParser(target)
try: try:
...@@ -1443,7 +1475,7 @@ class OCVDomain(Domain): ...@@ -1443,7 +1475,7 @@ class OCVDomain(Domain):
raise DefinitionError('') raise DefinitionError('')
except DefinitionError: except DefinitionError:
refdoc = node.get('refdoc', fromdocname) refdoc = node.get('refdoc', fromdocname)
env.warn(refdoc, 'unparseable1 C++ definition: %r' % target, env.warn(refdoc, 'unparseable C++ definition: %r' % target,
node.line) node.line)
return None return None
......
modules/calib3d/doc/camera_calibration_and_3d_reconstruction.rst
View file @ d3b14b71
...@@ -184,7 +184,7 @@ The function returns the final re-projection error. ...@@ -184,7 +184,7 @@ The function returns the final re-projection error.
.. seealso:: .. seealso::
:ocv:func:`FindChessboardCorners`, :ocv:func:`findChessboardCorners`,
:ocv:func:`solvePnP`, :ocv:func:`solvePnP`,
:ocv:func:`initCameraMatrix2D`, :ocv:func:`initCameraMatrix2D`,
:ocv:func:`stereoCalibrate`, :ocv:func:`stereoCalibrate`,
...@@ -272,7 +272,7 @@ For points in an image of a stereo pair, computes the corresponding epilines in ...@@ -272,7 +272,7 @@ For points in an image of a stereo pair, computes the corresponding epilines in
:param whichImage: Index of the image (1 or 2) that contains the ``points`` . :param whichImage: Index of the image (1 or 2) that contains the ``points`` .
:param F: Fundamental matrix that can be estimated using :ocv:func:`findFundamentalMat` or :ocv:func:`StereoRectify` . :param F: Fundamental matrix that can be estimated using :ocv:func:`findFundamentalMat` or :ocv:func:`stereoRectify` .
:param lines: Output vector of the epipolar lines corresponding to the points in the other image. Each line :math:`ax + by + c=0` is encoded by 3 numbers :math:`(a, b, c)` . :param lines: Output vector of the epipolar lines corresponding to the points in the other image. Each line :math:`ax + by + c=0` is encoded by 3 numbers :math:`(a, b, c)` .
...@@ -435,7 +435,7 @@ Finds the positions of internal corners of the chessboard. ...@@ -435,7 +435,7 @@ Finds the positions of internal corners of the chessboard.
* **CV_CALIB_CB_ADAPTIVE_THRESH** Use adaptive thresholding to convert the image to black and white, rather than a fixed threshold level (computed from the average image brightness). * **CV_CALIB_CB_ADAPTIVE_THRESH** Use adaptive thresholding to convert the image to black and white, rather than a fixed threshold level (computed from the average image brightness).
* **CV_CALIB_CB_NORMALIZE_IMAGE** Normalize the image gamma with :ocv:func:`EqualizeHist` before applying fixed or adaptive thresholding. * **CV_CALIB_CB_NORMALIZE_IMAGE** Normalize the image gamma with :ocv:func:`equalizeHist` before applying fixed or adaptive thresholding.
* **CV_CALIB_CB_FILTER_QUADS** Use additional criteria (like contour area, perimeter, square-like shape) to filter out false quads extracted at the contour retrieval stage. * **CV_CALIB_CB_FILTER_QUADS** Use additional criteria (like contour area, perimeter, square-like shape) to filter out false quads extracted at the contour retrieval stage.
...@@ -628,9 +628,9 @@ the found fundamental matrix. Normally just one matrix is found. But in case of ...@@ -628,9 +628,9 @@ the found fundamental matrix. Normally just one matrix is found. But in case of
:math:`9 \times 3` matrix that stores all 3 matrices sequentially). :math:`9 \times 3` matrix that stores all 3 matrices sequentially).
The calculated fundamental matrix may be passed further to The calculated fundamental matrix may be passed further to
:ocv:func:`ComputeCorrespondEpilines` that finds the epipolar lines :ocv:func:`computeCorrespondEpilines` that finds the epipolar lines
corresponding to the specified points. It can also be passed to corresponding to the specified points. It can also be passed to
:ocv:func:`StereoRectifyUncalibrated` to compute the rectification transformation. :: :ocv:func:`stereoRectifyUncalibrated` to compute the rectification transformation. ::
// Example. Estimation of fundamental matrix using the RANSAC algorithm // Example. Estimation of fundamental matrix using the RANSAC algorithm
int point_count = 100; int point_count = 100;
...@@ -726,11 +726,11 @@ Homography matrix is determined up to a scale. Thus, it is normalized so that ...@@ -726,11 +726,11 @@ Homography matrix is determined up to a scale. Thus, it is normalized so that
.. seealso:: .. seealso::
:ocv:func:`GetAffineTransform`, :ocv:func:`getAffineTransform`,
:ocv:func:`GetPerspectiveTransform`, :ocv:func:`getPerspectiveTransform`,
:ocv:func:`EstimateRigidMotion`, :ocv:func:`estimateRigidTransform`,
:ocv:func:`WarpPerspective`, :ocv:func:`warpPerspective`,
:ocv:func:`PerspectiveTransform` :ocv:func:`perspectiveTransform`
estimateAffine3D estimateAffine3D
...@@ -800,7 +800,7 @@ Returns the new camera matrix based on the free scaling parameter. ...@@ -800,7 +800,7 @@ Returns the new camera matrix based on the free scaling parameter.
:param newImageSize: Image size after rectification. By default,it is set to ``imageSize`` . :param newImageSize: Image size after rectification. By default,it is set to ``imageSize`` .
:param validPixROI: Optional output rectangle that outlines all-good-pixels region in the undistorted image. See ``roi1, roi2`` description in :ocv:func:`StereoRectify` . :param validPixROI: Optional output rectangle that outlines all-good-pixels region in the undistorted image. See ``roi1, roi2`` description in :ocv:func:`stereoRectify` .
:param centerPrincipalPoint: Optional flag that indicates whether in the new camera matrix the principal point should be at the image center or not. By default, the principal point is chosen to best fit a subset of the source image (determined by ``alpha``) to the corrected image. :param centerPrincipalPoint: Optional flag that indicates whether in the new camera matrix the principal point should be at the image center or not. By default, the principal point is chosen to best fit a subset of the source image (determined by ``alpha``) to the corrected image.
...@@ -919,9 +919,9 @@ Reprojects a disparity image to 3D space. ...@@ -919,9 +919,9 @@ Reprojects a disparity image to 3D space.
:param _3dImage: Output 3-channel floating-point image of the same size as ``disparity`` . Each element of ``_3dImage(x,y)`` contains 3D coordinates of the point ``(x,y)`` computed from the disparity map. :param _3dImage: Output 3-channel floating-point image of the same size as ``disparity`` . Each element of ``_3dImage(x,y)`` contains 3D coordinates of the point ``(x,y)`` computed from the disparity map.
:param Q: :math:`4 \times 4` perspective transformation matrix that can be obtained with :ocv:func:`StereoRectify` . :param Q: :math:`4 \times 4` perspective transformation matrix that can be obtained with :ocv:func:`stereoRectify`.
:param handleMissingValues: Indicates, whether the function should handle missing values (i.e. points where the disparity was not computed). If ``handleMissingValues=true``, then pixels with the minimal disparity that corresponds to the outliers (see :ocv:func:`StereoBM::operator()` ) are transformed to 3D points with a very large Z value (currently set to 10000). :param handleMissingValues: Indicates, whether the function should handle missing values (i.e. points where the disparity was not computed). If ``handleMissingValues=true``, then pixels with the minimal disparity that corresponds to the outliers (see :ocv:funcx:`StereoBM::operator()` ) are transformed to 3D points with a very large Z value (currently set to 10000).
:param ddepth: The optional output array depth. If it is ``-1``, the output image will have ``CV_32F`` depth. ``ddepth`` can also be set to ``CV_16S``, ``CV_32S`` or ``CV_32F``. :param ddepth: The optional output array depth. If it is ``-1``, the output image will have ``CV_32F`` depth. ``ddepth`` can also be set to ``CV_16S``, ``CV_32S`` or ``CV_32F``.
...@@ -933,8 +933,8 @@ The function transforms a single-channel disparity map to a 3-channel image repr ...@@ -933,8 +933,8 @@ The function transforms a single-channel disparity map to a 3-channel image repr
The matrix ``Q`` can be an arbitrary The matrix ``Q`` can be an arbitrary
:math:`4 \times 4` matrix (for example, the one computed by :math:`4 \times 4` matrix (for example, the one computed by
:ocv:func:`StereoRectify`). To reproject a sparse set of points {(x,y,d),...} to 3D space, use :ocv:func:`stereoRectify`). To reproject a sparse set of points {(x,y,d),...} to 3D space, use
:ocv:func:`PerspectiveTransform` . :ocv:func:`perspectiveTransform` .
...@@ -962,7 +962,7 @@ Computes an RQ decomposition of 3x3 matrices. ...@@ -962,7 +962,7 @@ Computes an RQ decomposition of 3x3 matrices.
:param Qz: Optional output 3x3 rotation matrix around z-axis. :param Qz: Optional output 3x3 rotation matrix around z-axis.
The function computes a RQ decomposition using the given rotations. This function is used in The function computes a RQ decomposition using the given rotations. This function is used in
:ocv:func:`DecomposeProjectionMatrix` to decompose the left 3x3 submatrix of a projection matrix into a camera and a rotation matrix. :ocv:func:`decomposeProjectionMatrix` to decompose the left 3x3 submatrix of a projection matrix into a camera and a rotation matrix.
It optionally returns three rotation matrices, one for each axis, and the three Euler angles It optionally returns three rotation matrices, one for each axis, and the three Euler angles
(as the return value) (as the return value)
...@@ -1036,12 +1036,12 @@ Class for computing stereo correspondence using the block matching algorithm. :: ...@@ -1036,12 +1036,12 @@ Class for computing stereo correspondence using the block matching algorithm. ::
Ptr<CvStereoBMState> state; Ptr<CvStereoBMState> state;
}; };
The class is a C++ wrapper for the associated functions. In particular, ``StereoBM::operator()`` is the wrapper for The class is a C++ wrapper for the associated functions. In particular, :ocv:funcx:`StereoBM::operator()` is the wrapper for
:ocv:func:`StereoBM::operator()`. :ocv:cfunc:`cvFindStereoCorrespondenceBM`.
StereoBM::StereoBM StereoBM::StereoBM
--------------------- ------------------
The constructors. The constructors.
.. ocv:function:: StereoBM::StereoBM() .. ocv:function:: StereoBM::StereoBM()
...@@ -1137,7 +1137,7 @@ The class implements the modified H. Hirschmuller algorithm HH08 that differs fr ...@@ -1137,7 +1137,7 @@ The class implements the modified H. Hirschmuller algorithm HH08 that differs fr
* Mutual information cost function is not implemented. Instead, a simpler Birchfield-Tomasi sub-pixel metric from BT96 is used. Though, the color images are supported as well. * Mutual information cost function is not implemented. Instead, a simpler Birchfield-Tomasi sub-pixel metric from BT96 is used. Though, the color images are supported as well.
* Some pre- and post- processing steps from K. Konolige algorithm :ocv:func:`StereoBM::operator()` are included, for example: pre-filtering (``CV_STEREO_BM_XSOBEL`` type) and post-filtering (uniqueness check, quadratic interpolation and speckle filtering). * Some pre- and post- processing steps from K. Konolige algorithm :ocv:funcx:`StereoBM::operator()` are included, for example: pre-filtering (``CV_STEREO_BM_XSOBEL`` type) and post-filtering (uniqueness check, quadratic interpolation and speckle filtering).
...@@ -1401,7 +1401,7 @@ Computes a rectification transform for an uncalibrated stereo camera. ...@@ -1401,7 +1401,7 @@ Computes a rectification transform for an uncalibrated stereo camera.
:param threshold: Optional threshold used to filter out the outliers. If the parameter is greater than zero, all the point pairs that do not comply with the epipolar geometry (that is, the points for which :math:`|\texttt{points2[i]}^T*\texttt{F}*\texttt{points1[i]}|>\texttt{threshold}` ) are rejected prior to computing the homographies. Otherwise,all the points are considered inliers. :param threshold: Optional threshold used to filter out the outliers. If the parameter is greater than zero, all the point pairs that do not comply with the epipolar geometry (that is, the points for which :math:`|\texttt{points2[i]}^T*\texttt{F}*\texttt{points1[i]}|>\texttt{threshold}` ) are rejected prior to computing the homographies. Otherwise,all the points are considered inliers.
The function computes the rectification transformations without knowing intrinsic parameters of the cameras and their relative position in the space, which explains the suffix "uncalibrated". Another related difference from The function computes the rectification transformations without knowing intrinsic parameters of the cameras and their relative position in the space, which explains the suffix "uncalibrated". Another related difference from
:ocv:func:`StereoRectify` is that the function outputs not the rectification transformations in the object (3D) space, but the planar perspective transformations encoded by the homography matrices ``H1`` and ``H2`` . The function implements the algorithm :ocv:func:`stereoRectify` is that the function outputs not the rectification transformations in the object (3D) space, but the planar perspective transformations encoded by the homography matrices ``H1`` and ``H2`` . The function implements the algorithm
[Hartley99]_. [Hartley99]_.
.. note:: .. note::
......
modules/core/doc/basic_structures.rst
View file @ d3b14b71
...@@ -246,7 +246,7 @@ Template class for short numerical vectors, a partial case of :ocv:class:`Matx`: ...@@ -246,7 +246,7 @@ Template class for short numerical vectors, a partial case of :ocv:class:`Matx`:
typedef Vec<double, 4> Vec4d; typedef Vec<double, 4> Vec4d;
typedef Vec<double, 6> Vec6d; typedef Vec<double, 6> Vec6d;
It is possible to convert ``Vec<T,2>`` to/from ``Point_``, ``Vec<T,3>`` to/from ``Point3_`` , and ``Vec<T,4>`` to ``CvScalar`` or :ocv:class:`Scalar`. Use ``operator[]`` to access the elements of ``Vec``. It is possible to convert ``Vec<T,2>`` to/from ``Point_``, ``Vec<T,3>`` to/from ``Point3_`` , and ``Vec<T,4>`` to :ocv:struct:`CvScalar` or :ocv:class:`Scalar_`. Use ``operator[]`` to access the elements of ``Vec``.
All the expected vector operations are also implemented: All the expected vector operations are also implemented:
...@@ -1517,11 +1517,11 @@ The method is used in quite a few of OpenCV functions. The point is that element ...@@ -1517,11 +1517,11 @@ The method is used in quite a few of OpenCV functions. The point is that element
This approach, while being very simple, can boost the performance of a simple element-operation by 10-20 percents, especially if the image is rather small and the operation is quite simple. This approach, while being very simple, can boost the performance of a simple element-operation by 10-20 percents, especially if the image is rather small and the operation is quite simple.
Another OpenCV idiom in this function, a call of Another OpenCV idiom in this function, a call of
:ocv:func:`Mat::create` for the destination array, that allocates the destination array unless it already has the proper size and type. And while the newly allocated arrays are always continuous, you still need to check the destination array because :ocv:func:`create` does not always allocate a new matrix. :ocv:func:`Mat::create` for the destination array, that allocates the destination array unless it already has the proper size and type. And while the newly allocated arrays are always continuous, you still need to check the destination array because :ocv:func:`Mat::create` does not always allocate a new matrix.
Mat::elemSize Mat::elemSize
----------------- -------------
Returns the matrix element size in bytes. Returns the matrix element size in bytes.
.. ocv:function:: size_t Mat::elemSize() const .. ocv:function:: size_t Mat::elemSize() const
...@@ -1530,7 +1530,7 @@ The method returns the matrix element size in bytes. For example, if the matrix ...@@ -1530,7 +1530,7 @@ The method returns the matrix element size in bytes. For example, if the matrix
Mat::elemSize1 Mat::elemSize1
------------------ --------------
Returns the size of each matrix element channel in bytes. Returns the size of each matrix element channel in bytes.
.. ocv:function:: size_t Mat::elemSize1() const .. ocv:function:: size_t Mat::elemSize1() const
...@@ -1539,7 +1539,7 @@ The method returns the matrix element channel size in bytes, that is, it ignores ...@@ -1539,7 +1539,7 @@ The method returns the matrix element channel size in bytes, that is, it ignores
Mat::type Mat::type
------------- ---------
Returns the type of a matrix element. Returns the type of a matrix element.
.. ocv:function:: int Mat::type() const .. ocv:function:: int Mat::type() const
...@@ -1622,7 +1622,7 @@ Returns a pointer to the specified matrix row. ...@@ -1622,7 +1622,7 @@ Returns a pointer to the specified matrix row.
:param i: A 0-based row index. :param i: A 0-based row index.
The methods return ``uchar*`` or typed pointer to the specified matrix row. See the sample in The methods return ``uchar*`` or typed pointer to the specified matrix row. See the sample in
:ocv:func:`Mat::isContinuous` () to know how to use these methods. :ocv:func:`Mat::isContinuous` to know how to use these methods.
Mat::at Mat::at
......
modules/core/doc/drawing_functions.rst
View file @ d3b14b71
...@@ -6,7 +6,7 @@ Drawing Functions ...@@ -6,7 +6,7 @@ Drawing Functions
Drawing functions work with matrices/images of arbitrary depth. Drawing functions work with matrices/images of arbitrary depth.
The boundaries of the shapes can be rendered with antialiasing (implemented only for 8-bit images for now). The boundaries of the shapes can be rendered with antialiasing (implemented only for 8-bit images for now).
All the functions include the parameter ``color`` that uses an RGB value (that may be constructed All the functions include the parameter ``color`` that uses an RGB value (that may be constructed
with ``CV_RGB`` or the :ocv:class:`Scalar` constructor with ``CV_RGB`` or the :ocv:class:`Scalar_` constructor
) for color ) for color
images and brightness for grayscale images. For color images, the channel ordering images and brightness for grayscale images. For color images, the channel ordering
is normally *Blue, Green, Red*. is normally *Blue, Green, Red*.
......
modules/core/doc/dynamic_structures.rst
View file @ d3b14b71
Dynamic Structures Dynamic Structures
================== ==================
.. highlight:: c .. highlight:: c
...@@ -43,7 +43,7 @@ The buffer is put in the end of already allocated space in the ``top`` memory bl ...@@ -43,7 +43,7 @@ The buffer is put in the end of already allocated space in the ``top`` memory bl
If there are no more free blocks, a new block is allocated (or borrowed from the parent, see :ocv:cfunc:`CreateChildMemStorage`) and added to the end of list. Thus, the storage behaves as a stack with ``bottom`` indicating bottom of the stack and the pair (``top``, ``free_space``) If there are no more free blocks, a new block is allocated (or borrowed from the parent, see :ocv:cfunc:`CreateChildMemStorage`) and added to the end of list. Thus, the storage behaves as a stack with ``bottom`` indicating bottom of the stack and the pair (``top``, ``free_space``)
indicating top of the stack. The stack top may be saved via :ocv:cfunc:`SaveMemStoragePos`, restored via indicating top of the stack. The stack top may be saved via :ocv:cfunc:`SaveMemStoragePos`, restored via
:ocv:cfunc:`RestoreMemStoragePos`, or reset via :ocv:cfunc:`ClearStorage`. :ocv:cfunc:`RestoreMemStoragePos`, or reset via :ocv:cfunc:`ClearMemStorage`.
CvMemBlock CvMemBlock
---------- ----------
...@@ -112,27 +112,31 @@ CvSlice ...@@ -112,27 +112,31 @@ CvSlice
.. ocv:struct:: CvSlice .. ocv:struct:: CvSlice
A sequence slice. In C++ interface the class :ocv:class:`Range` should be used instead. A sequence slice. In C++ interface the class :ocv:class:`Range` should be used instead.
.. ocv:member: int start_index .. ocv:member:: int start_index
inclusive start index of the sequence slice inclusive start index of the sequence slice
.. ocv:member: int end_index .. ocv:member:: int end_index
exclusive end index of the sequence slice exclusive end index of the sequence slice
There are helper functions to construct the slice and to compute its length:
.. ocv:cfunction:: CvSlice cvSlice( int start, int end )
::
There are helper functions to construct the slice and to compute its length: ::
inline CvSlice cvSlice( int start, int end );
#define CV_WHOLE_SEQ_END_INDEX 0x3fffffff #define CV_WHOLE_SEQ_END_INDEX 0x3fffffff
#define CV_WHOLE_SEQ cvSlice(0, CV_WHOLE_SEQ_END_INDEX) #define CV_WHOLE_SEQ cvSlice(0, CV_WHOLE_SEQ_END_INDEX)
/* calculates the sequence slice length */
int cvSliceLength( CvSlice slice, const CvSeq* seq );
.. ..
.. ocv:cfunction:: int cvSliceLength( CvSlice slice, const CvSeq* seq )
Calculates the sequence slice length
Some of functions that operate on sequences take a ``CvSlice slice`` parameter that is often set to the whole sequence (CV_WHOLE_SEQ) by default. Either of the ``start_index`` and ``end_index`` may be negative or exceed the sequence length. If they are equal, the slice is considered empty (i.e., contains no elements). Because sequences are treated as circular structures, the slice may select a Some of functions that operate on sequences take a ``CvSlice slice`` parameter that is often set to the whole sequence (CV_WHOLE_SEQ) by default. Either of the ``start_index`` and ``end_index`` may be negative or exceed the sequence length. If they are equal, the slice is considered empty (i.e., contains no elements). Because sequences are treated as circular structures, the slice may select a
few elements in the end of a sequence followed by a few elements at the beginning of the sequence. For example, ``cvSlice(-2, 3)`` in the case of a 10-element sequence will select a 5-element slice, containing the pre-last (8th), last (9th), the very first (0th), second (1th) and third (2nd) few elements in the end of a sequence followed by a few elements at the beginning of the sequence. For example, ``cvSlice(-2, 3)`` in the case of a 10-element sequence will select a 5-element slice, containing the pre-last (8th), last (9th), the very first (0th), second (1th) and third (2nd)
elements. The functions normalize the slice argument in the following way: elements. The functions normalize the slice argument in the following way:
...@@ -452,17 +456,17 @@ Finds an edge in a graph. ...@@ -452,17 +456,17 @@ Finds an edge in a graph.
.. ocv:cfunction:: CvGraphEdge* cvFindGraphEdge( const CvGraph* graph, int start_idx, int end_idx ) .. ocv:cfunction:: CvGraphEdge* cvFindGraphEdge( const CvGraph* graph, int start_idx, int end_idx )
::
#define cvGraphFindEdge cvFindGraphEdge
..
:param graph: Graph :param graph: Graph
:param start_idx: Index of the starting vertex of the edge :param start_idx: Index of the starting vertex of the edge
:param end_idx: Index of the ending vertex of the edge. For an unoriented graph, the order of the vertex parameters does not matter. :param end_idx: Index of the ending vertex of the edge. For an unoriented graph, the order of the vertex parameters does not matter.
::
#define cvGraphFindEdge cvFindGraphEdge
..
The function finds the graph edge connecting two specified vertices and returns a pointer to it or NULL if the edge does not exist. The function finds the graph edge connecting two specified vertices and returns a pointer to it or NULL if the edge does not exist.
...@@ -472,17 +476,17 @@ Finds an edge in a graph by using its pointer. ...@@ -472,17 +476,17 @@ Finds an edge in a graph by using its pointer.
.. ocv:cfunction:: CvGraphEdge* cvFindGraphEdgeByPtr( const CvGraph* graph, const CvGraphVtx* startVtx, const CvGraphVtx* endVtx ) .. ocv:cfunction:: CvGraphEdge* cvFindGraphEdgeByPtr( const CvGraph* graph, const CvGraphVtx* startVtx, const CvGraphVtx* endVtx )
::
#define cvGraphFindEdgeByPtr cvFindGraphEdgeByPtr
..
:param graph: Graph :param graph: Graph
:param startVtx: Pointer to the starting vertex of the edge :param startVtx: Pointer to the starting vertex of the edge
:param endVtx: Pointer to the ending vertex of the edge. For an unoriented graph, the order of the vertex parameters does not matter. :param endVtx: Pointer to the ending vertex of the edge. For an unoriented graph, the order of the vertex parameters does not matter.
::
#define cvGraphFindEdgeByPtr cvFindGraphEdgeByPtr
..
The function finds the graph edge connecting two specified vertices and returns pointer to it or NULL if the edge does not exists. The function finds the graph edge connecting two specified vertices and returns pointer to it or NULL if the edge does not exists.
...@@ -521,15 +525,16 @@ Returns a pointer to a sequence element according to its index. ...@@ -521,15 +525,16 @@ Returns a pointer to a sequence element according to its index.
.. ocv:cfunction:: char* cvGetSeqElem( const CvSeq* seq, int index ) .. ocv:cfunction:: char* cvGetSeqElem( const CvSeq* seq, int index )
:param seq: Sequence
:param index: Index of element
:: ::
#define CV_GET_SEQ_ELEM( TYPE, seq, index ) (TYPE*)cvGetSeqElem( (CvSeq*)(seq), (index) ) #define CV_GET_SEQ_ELEM( TYPE, seq, index ) (TYPE*)cvGetSeqElem( (CvSeq*)(seq), (index) )
.. ..
:param seq: Sequence
:param index: Index of element
The function finds the element with the given The function finds the element with the given
index in the sequence and returns the pointer to it. If the element index in the sequence and returns the pointer to it. If the element
...@@ -841,6 +846,12 @@ Allocates a text string in a storage block. ...@@ -841,6 +846,12 @@ Allocates a text string in a storage block.
.. ocv:cfunction:: CvString cvMemStorageAllocString(CvMemStorage* storage, const char* ptr, int len=-1) .. ocv:cfunction:: CvString cvMemStorageAllocString(CvMemStorage* storage, const char* ptr, int len=-1)
:param storage: Memory storage
:param ptr: The string
:param len: Length of the string (not counting the ending ``NUL`` ) . If the parameter is negative, the function computes the length.
:: ::
typedef struct CvString typedef struct CvString
...@@ -852,12 +863,6 @@ Allocates a text string in a storage block. ...@@ -852,12 +863,6 @@ Allocates a text string in a storage block.
.. ..
:param storage: Memory storage
:param ptr: The string
:param len: Length of the string (not counting the ending ``NUL`` ) . If the parameter is negative, the function computes the length.
The function creates copy of the string The function creates copy of the string
in memory storage. It returns the structure that contains user-passed in memory storage. It returns the structure that contains user-passed
or computed length of the string and pointer to the copied string. or computed length of the string and pointer to the copied string.
...@@ -1256,6 +1261,12 @@ Sorts sequence element using the specified comparison function. ...@@ -1256,6 +1261,12 @@ Sorts sequence element using the specified comparison function.
.. ocv:cfunction:: void cvSeqSort( CvSeq* seq, CvCmpFunc func, void* userdata=NULL ) .. ocv:cfunction:: void cvSeqSort( CvSeq* seq, CvCmpFunc func, void* userdata=NULL )
:param seq: The sequence to sort
:param func: The comparison function that returns a negative, zero, or positive value depending on the relationships among the elements (see the above declaration and the example below) - a similar function is used by ``qsort`` from C runline except that in the latter, ``userdata`` is not used
:param userdata: The user parameter passed to the compasion function; helps to avoid global variables in some cases
:: ::
/* a < b ? -1 : a > b ? 1 : 0 */ /* a < b ? -1 : a > b ? 1 : 0 */
...@@ -1263,12 +1274,6 @@ Sorts sequence element using the specified comparison function. ...@@ -1263,12 +1274,6 @@ Sorts sequence element using the specified comparison function.
.. ..
:param seq: The sequence to sort
:param func: The comparison function that returns a negative, zero, or positive value depending on the relationships among the elements (see the above declaration and the example below) - a similar function is used by ``qsort`` from C runline except that in the latter, ``userdata`` is not used
:param userdata: The user parameter passed to the compasion function; helps to avoid global variables in some cases
The function sorts the sequence in-place using the specified criteria. Below is an example of using this function: The function sorts the sequence in-place using the specified criteria. Below is an example of using this function:
:: ::
......
modules/core/doc/old_basic_structures.rst
View file @ d3b14b71
...@@ -671,7 +671,7 @@ Creates a matrix header but does not allocate the matrix data. ...@@ -671,7 +671,7 @@ Creates a matrix header but does not allocate the matrix data.
:param type: Type of the matrix elements, see :ocv:cfunc:`CreateMat` :param type: Type of the matrix elements, see :ocv:cfunc:`CreateMat`
The function allocates a new matrix header and returns a pointer to it. The matrix data can then be allocated using :ocv:cfunc:`CreateData` or set explicitly to user-allocated data via :ocv:func:`SetData`. The function allocates a new matrix header and returns a pointer to it. The matrix data can then be allocated using :ocv:cfunc:`CreateData` or set explicitly to user-allocated data via :ocv:cfunc:`SetData`.
CreateMatND CreateMatND
----------- -----------
...@@ -719,7 +719,7 @@ Creates sparse array. ...@@ -719,7 +719,7 @@ Creates sparse array.
:param type: Type of array elements. The same as for CvMat :param type: Type of array elements. The same as for CvMat
The function allocates a multi-dimensional sparse array. Initially the array contain no elements, that is The function allocates a multi-dimensional sparse array. Initially the array contain no elements, that is
:ocv:cfunc:`GetPtrND` and other related functions will return 0 for every index. :ocv:cfunc:`PtrND` and other related functions will return 0 for every index.
CrossProduct CrossProduct
...@@ -935,7 +935,7 @@ The function returns a matrix header for the input array that can be a matrix - ...@@ -935,7 +935,7 @@ The function returns a matrix header for the input array that can be a matrix -
The function provides an easy way to handle both types of arrays - ``IplImage`` and ``CvMat`` using the same code. Input array must have non-zero data pointer, otherwise the function will report an error. The function provides an easy way to handle both types of arrays - ``IplImage`` and ``CvMat`` using the same code. Input array must have non-zero data pointer, otherwise the function will report an error.
.. seealso:: :ocv:cfunc:`GetImage`, :ocv:cfunc:`GetMatND`, :ocv:func:`cvarrToMat`. .. seealso:: :ocv:cfunc:`GetImage`, :ocv:func:`cvarrToMat`.
.. note:: If the input array is ``IplImage`` with planar data layout and COI set, the function returns the pointer to the selected plane and ``COI == 0``. This feature allows user to process ``IplImage`` strctures with planar data layout, even though OpenCV does not support such images. .. note:: If the input array is ``IplImage`` with planar data layout and COI set, the function returns the pointer to the selected plane and ``COI == 0``. This feature allows user to process ``IplImage`` strctures with planar data layout, even though OpenCV does not support such images.
...@@ -1250,13 +1250,15 @@ The functions return a pointer to a specific array element. Number of array dime ...@@ -1250,13 +1250,15 @@ The functions return a pointer to a specific array element. Number of array dime
The functions can be used for sparse arrays as well - if the requested node does not exist they create it and set it to zero. The functions can be used for sparse arrays as well - if the requested node does not exist they create it and set it to zero.
All these as well as other functions accessing array elements ( All these as well as other functions accessing array elements (
:ocv:cfunc:`Get` :ocv:cfunc:`GetND`
, ,
:ocv:cfunc:`GetReal` :ocv:cfunc:`GetRealND`
, ,
:ocv:cfunc:`Set` :ocv:cfunc:`Set`
, ,
:ocv:cfunc:`SetReal` :ocv:cfunc:`SetND`
,
:ocv:cfunc:`SetRealND`
) raise an error in case if the element index is out of range. ) raise an error in case if the element index is out of range.
......
modules/core/doc/old_xml_yaml_persistence.rst
View file @ d3b14b71
...@@ -681,7 +681,7 @@ Starts writing a new structure. ...@@ -681,7 +681,7 @@ Starts writing a new structure.
following the structure name (see the example in :ocv:struct:`CvFileStorage` following the structure name (see the example in :ocv:struct:`CvFileStorage`
description). Mainly it is used with user objects. When the storage description). Mainly it is used with user objects. When the storage
is read, the encoded type name is used to determine the object type is read, the encoded type name is used to determine the object type
(see :ocv:struct:`CvTypeInfo` and :ocv:cfunc:`FindTypeInfo` ). (see :ocv:struct:`CvTypeInfo` and :ocv:cfunc:`FindType` ).
:param attributes: This parameter is not used in the current implementation :param attributes: This parameter is not used in the current implementation
......
modules/core/doc/operations_on_arrays.rst
View file @ d3b14b71
...@@ -695,18 +695,17 @@ Normally, the function is used to convert an old-style 2D array ( ...@@ -695,18 +695,17 @@ Normally, the function is used to convert an old-style 2D array (
``CvMatND`` using an arbitrary element-wise function. ``CvMatND`` using an arbitrary element-wise function.
The last parameter, ``coiMode`` , specifies how to deal with an image with COI set. By default, it is 0 and the function reports an error when an image with COI comes in. And ``coiMode=1`` means that no error is signalled. You have to check COI presence and handle it manually. The modern structures, such as The last parameter, ``coiMode`` , specifies how to deal with an image with COI set. By default, it is 0 and the function reports an error when an image with COI comes in. And ``coiMode=1`` means that no error is signalled. You have to check COI presence and handle it manually. The modern structures, such as
:ocv:func:`Mat` and :ocv:class:`Mat` and
:ocv:func:`MatND` do not support COI natively. To process an individual channel of a new-style array, you need either to organize a loop over the array (for example, using matrix iterators) where the channel of interest will be processed, or extract the COI using ``MatND`` do not support COI natively. To process an individual channel of a new-style array, you need either to organize a loop over the array (for example, using matrix iterators) where the channel of interest will be processed, or extract the COI using
:ocv:func:`mixChannels` (for new-style arrays) or :ocv:func:`mixChannels` (for new-style arrays) or
:ocv:func:`extractImageCOI` (for old-style arrays), process this individual channel, and insert it back to the destination array if needed (using :ocv:func:`extractImageCOI` (for old-style arrays), process this individual channel, and insert it back to the destination array if needed (using
:ocv:func:`mixChannel` or :ocv:func:`mixChannels` or
:ocv:func:`insertImageCOI` , respectively). :ocv:func:`insertImageCOI` , respectively).
.. seealso:: .. seealso::
:c:func:`cvGetImage`, :ocv:cfunc:`cvGetImage`,
:c:func:`cvGetMat`, :ocv:cfunc:`cvGetMat`,
:c:func:`cvGetMatND`,
:ocv:func:`extractImageCOI`, :ocv:func:`extractImageCOI`,
:ocv:func:`insertImageCOI`, :ocv:func:`insertImageCOI`,
:ocv:func:`mixChannels` :ocv:func:`mixChannels`
...@@ -1606,7 +1605,7 @@ Calculates an average (mean) of array elements. ...@@ -1606,7 +1605,7 @@ Calculates an average (mean) of array elements.
.. ocv:cfunction:: CvScalar cvAvg(const CvArr* src, const CvArr* mask=NULL) .. ocv:cfunction:: CvScalar cvAvg(const CvArr* src, const CvArr* mask=NULL)
.. ocv:pyoldfunction:: cv.Avg(src, mask=None)-> CvScalar .. ocv:pyoldfunction:: cv.Avg(src, mask=None)-> CvScalar
:param src: Source array that should have from 1 to 4 channels so that the result can be stored in :ocv:func:`Scalar` . :param src: Source array that should have from 1 to 4 channels so that the result can be stored in :ocv:class:`Scalar_` .
:param mask: Optional operation mask. :param mask: Optional operation mask.
...@@ -1638,7 +1637,7 @@ Calculates a mean and standard deviation of array elements. ...@@ -1638,7 +1637,7 @@ Calculates a mean and standard deviation of array elements.
.. ocv:cfunction:: void cvAvgSdv(const CvArr* src, CvScalar* mean, CvScalar* stdDev, const CvArr* mask=NULL) .. ocv:cfunction:: void cvAvgSdv(const CvArr* src, CvScalar* mean, CvScalar* stdDev, const CvArr* mask=NULL)
.. ocv:pyoldfunction:: cv.AvgSdv(src, mask=None)-> (mean, stdDev) .. ocv:pyoldfunction:: cv.AvgSdv(src, mask=None)-> (mean, stdDev)
:param src: Source array that should have from 1 to 4 channels so that the results can be stored in :ocv:func:`Scalar` 's. :param src: Source array that should have from 1 to 4 channels so that the results can be stored in :ocv:class:`Scalar_` 's.
:param mean: Output parameter: computed mean value. :param mean: Output parameter: computed mean value.
...@@ -1786,11 +1785,11 @@ Finds the global minimum and maximum in a whole array or sub-array. ...@@ -1786,11 +1785,11 @@ Finds the global minimum and maximum in a whole array or sub-array.
:param mask: Optional mask used to select a sub-array. :param mask: Optional mask used to select a sub-array.
The functions ``ninMaxLoc`` find the minimum and maximum element values and their positions. The extremums are searched across the whole array or, The functions ``minMaxLoc`` find the minimum and maximum element values and their positions. The extremums are searched across the whole array or,
if ``mask`` is not an empty array, in the specified array region. if ``mask`` is not an empty array, in the specified array region.
The functions do not work with multi-channel arrays. If you need to find minimum or maximum elements across all the channels, use The functions do not work with multi-channel arrays. If you need to find minimum or maximum elements across all the channels, use
:ocv:func:`reshape` first to reinterpret the array as single-channel. Or you may extract the particular channel using either :ocv:func:`Mat::reshape` first to reinterpret the array as single-channel. Or you may extract the particular channel using either
:ocv:func:`extractImageCOI` , or :ocv:func:`extractImageCOI` , or
:ocv:func:`mixChannels` , or :ocv:func:`mixChannels` , or
:ocv:func:`split` . :ocv:func:`split` .
...@@ -1806,7 +1805,7 @@ In case of a sparse matrix, the minimum is found among non-zero elements only. ...@@ -1806,7 +1805,7 @@ In case of a sparse matrix, the minimum is found among non-zero elements only.
:ocv:func:`extractImageCOI`, :ocv:func:`extractImageCOI`,
:ocv:func:`mixChannels`, :ocv:func:`mixChannels`,
:ocv:func:`split`, :ocv:func:`split`,
:ocv:func:`reshape` :ocv:func:`Mat::reshape`
...@@ -1931,7 +1930,7 @@ For a not-per-element matrix product, see ...@@ -1931,7 +1930,7 @@ For a not-per-element matrix product, see
.. seealso:: .. seealso::
:ocv:func:`add`, :ocv:func:`add`,
:ocv:func:`substract`, :ocv:func:`subtract`,
:ocv:func:`divide`, :ocv:func:`divide`,
:ref:`MatrixExpressions`, :ref:`MatrixExpressions`,
:ocv:func:`scaleAdd`, :ocv:func:`scaleAdd`,
...@@ -2174,7 +2173,7 @@ PCA constructors ...@@ -2174,7 +2173,7 @@ PCA constructors
:param maxComponents: Maximum number of components that PCA should retain. By default, all the components are retained. :param maxComponents: Maximum number of components that PCA should retain. By default, all the components are retained.
The default constructor initializes an empty PCA structure. The second constructor initializes the structure and calls The default constructor initializes an empty PCA structure. The second constructor initializes the structure and calls
:ocv:func:`PCA::operator()` . :ocv:funcx:`PCA::operator()` .
...@@ -2530,7 +2529,7 @@ Fills arrays with random numbers. ...@@ -2530,7 +2529,7 @@ Fills arrays with random numbers.
.. ocv:function:: void RNG::fill( InputOutputArray mat, int distType, InputArray a, InputArray b ) .. ocv:function:: void RNG::fill( InputOutputArray mat, int distType, InputArray a, InputArray b )
:param mat: 2D or N-dimensional matrix. Currently matrices with more than 4 channels are not supported by the methods. Use :ocv:func:`reshape` as a possible workaround. :param mat: 2D or N-dimensional matrix. Currently matrices with more than 4 channels are not supported by the methods. Use :ocv:func:`Mat::reshape` as a possible workaround.
:param distType: Distribution type, ``RNG::UNIFORM`` or ``RNG::NORMAL`` . :param distType: Distribution type, ``RNG::UNIFORM`` or ``RNG::NORMAL`` .
...@@ -3116,7 +3115,7 @@ The constructors. ...@@ -3116,7 +3115,7 @@ The constructors.
* **SVD::FULL_UV** When the matrix is not square, by default the algorithm produces ``u`` and ``vt`` matrices of sufficiently large size for the further ``A`` reconstruction. If, however, ``FULL_UV`` flag is specified, ``u`` and ``vt`` will be full-size square orthogonal matrices. * **SVD::FULL_UV** When the matrix is not square, by default the algorithm produces ``u`` and ``vt`` matrices of sufficiently large size for the further ``A`` reconstruction. If, however, ``FULL_UV`` flag is specified, ``u`` and ``vt`` will be full-size square orthogonal matrices.
The first constructor initializes an empty ``SVD`` structure. The second constructor initializes an empty ``SVD`` structure and then calls The first constructor initializes an empty ``SVD`` structure. The second constructor initializes an empty ``SVD`` structure and then calls
:ocv:func:`SVD::operator()` . :ocv:funcx:`SVD::operator()` .
SVD::operator () SVD::operator ()
......
modules/core/doc/xml_yaml_persistence.rst
View file @ d3b14b71
...@@ -10,7 +10,7 @@ You can store and then restore various OpenCV data structures to/from XML (http: ...@@ -10,7 +10,7 @@ You can store and then restore various OpenCV data structures to/from XML (http:
(http://www.yaml.org) formats. Also, it is possible store and load arbitrarily complex data structures, which include OpenCV data structures, as well as primitive data types (integer and floating-point numbers and text strings) as their elements. (http://www.yaml.org) formats. Also, it is possible store and load arbitrarily complex data structures, which include OpenCV data structures, as well as primitive data types (integer and floating-point numbers and text strings) as their elements.
Use the following procedure to write something to XML or YAML: Use the following procedure to write something to XML or YAML:
#. Create new :ocv:class:`FileStorage` and open it for writing. It can be done with a single call to :ocv:func:`FileStorage::FileStorage` constructor that takes a filename, or you can use the default constructor and then call :ocv:class:`FileStorage::open`. Format of the file (XML or YAML) is determined from the filename extension (".xml" and ".yml"/".yaml", respectively) #. Create new :ocv:class:`FileStorage` and open it for writing. It can be done with a single call to :ocv:func:`FileStorage::FileStorage` constructor that takes a filename, or you can use the default constructor and then call :ocv:func:`FileStorage::open`. Format of the file (XML or YAML) is determined from the filename extension (".xml" and ".yml"/".yaml", respectively)
#. Write all the data you want using the streaming operator ``>>``, just like in the case of STL streams. #. Write all the data you want using the streaming operator ``>>``, just like in the case of STL streams.
#. Close the file using :ocv:func:`FileStorage::release`. ``FileStorage`` destructor also closes the file. #. Close the file using :ocv:func:`FileStorage::release`. ``FileStorage`` destructor also closes the file.
......
modules/features2d/doc/common_interfaces_of_descriptor_matchers.rst
View file @ d3b14b71
...@@ -358,7 +358,7 @@ FlannBasedMatcher ...@@ -358,7 +358,7 @@ FlannBasedMatcher
----------------- -----------------
.. ocv:class:: FlannBasedMatcher .. ocv:class:: FlannBasedMatcher
Flann-based descriptor matcher. This matcher trains :ocv:func:`flann::Index` on a train descriptor collection and calls its nearest search methods to find the best matches. So, this matcher may be faster when matching a large train collection than the brute force matcher. ``FlannBasedMatcher`` does not support masking permissible matches of descriptor sets because ``flann::Index`` does not support this. :: Flann-based descriptor matcher. This matcher trains :ocv:class:`flann::Index_` on a train descriptor collection and calls its nearest search methods to find the best matches. So, this matcher may be faster when matching a large train collection than the brute force matcher. ``FlannBasedMatcher`` does not support masking permissible matches of descriptor sets because ``flann::Index`` does not support this. ::
class FlannBasedMatcher : public DescriptorMatcher class FlannBasedMatcher : public DescriptorMatcher
{ {
......
modules/features2d/doc/common_interfaces_of_feature_detectors.rst
View file @ d3b14b71
...@@ -144,8 +144,10 @@ The following detector types are supported: ...@@ -144,8 +144,10 @@ The following detector types are supported:
* ``"SURF"`` -- :ocv:class:`SurfFeatureDetector` * ``"SURF"`` -- :ocv:class:`SurfFeatureDetector`
* ``"ORB"`` -- :ocv:class:`OrbFeatureDetector` * ``"ORB"`` -- :ocv:class:`OrbFeatureDetector`
* ``"MSER"`` -- :ocv:class:`MserFeatureDetector` * ``"MSER"`` -- :ocv:class:`MserFeatureDetector`
* ``"GFTT"`` -- :ocv:class:`GfttFeatureDetector` * ``"GFTT"`` -- :ocv:class:`GoodFeaturesToTrackDetector`
* ``"HARRIS"`` -- :ocv:class:`HarrisFeatureDetector` * ``"HARRIS"`` -- :ocv:class:`GoodFeaturesToTrackDetector` with Harris detector enabled
* ``"Dense"`` -- :ocv:class:`DenseFeatureDetector`
* ``"SimpleBlob"`` -- :ocv:class:`SimpleBlobDetector`
Also a combined format is supported: feature detector adapter name ( ``"Grid"`` -- Also a combined format is supported: feature detector adapter name ( ``"Grid"`` --
:ocv:class:`GridAdaptedFeatureDetector`, ``"Pyramid"`` -- :ocv:class:`GridAdaptedFeatureDetector`, ``"Pyramid"`` --
...@@ -587,30 +589,3 @@ SurfAdjuster ...@@ -587,30 +589,3 @@ SurfAdjuster
SurfAdjuster(); SurfAdjuster();
... ...
}; };
FeatureDetector
---------------
.. ocv:class:: FeatureDetector
Abstract base class for 2D image feature detectors. ::
class CV_EXPORTS FeatureDetector
{
public:
virtual ~FeatureDetector();
void detect( const Mat& image, vector<KeyPoint>& keypoints,
const Mat& mask=Mat() ) const;
void detect( const vector<Mat>& images,
vector<vector<KeyPoint> >& keypoints,
const vector<Mat>& masks=vector<Mat>() ) const;
virtual void read(const FileNode&);
virtual void write(FileStorage&) const;
static Ptr<FeatureDetector> create( const string& detectorType );
protected:
...
};
modules/flann/doc/flann_fast_approximate_nearest_neighbor_search.rst
View file @ d3b14b71
...@@ -10,7 +10,7 @@ This section documents OpenCV's interface to the FLANN library. FLANN (Fast Libr ...@@ -10,7 +10,7 @@ This section documents OpenCV's interface to the FLANN library. FLANN (Fast Libr
flann::Index\_ flann::Index\_
----------------- -----------------
.. ocv:class:: cv::flann::Index_ .. ocv:class:: flann::Index_
The FLANN nearest neighbor index class. This class is templated with the type of elements for which the index is built. The FLANN nearest neighbor index class. This class is templated with the type of elements for which the index is built.
......
modules/gpu/doc/camera_calibration_and_3d_reconstruction.rst
View file @ d3b14b71
...@@ -193,7 +193,7 @@ gpu::StereoBeliefPropagation::StereoBeliefPropagation ...@@ -193,7 +193,7 @@ gpu::StereoBeliefPropagation::StereoBeliefPropagation
For more details, see [Felzenszwalb2006]_. For more details, see [Felzenszwalb2006]_.
By default, :ocv:class:`StereoBeliefPropagation` uses floating-point arithmetics and the ``CV_32FC1`` type for messages. But it can also use fixed-point arithmetics and the ``CV_16SC1`` message type for better performance. To avoid an overflow in this case, the parameters must satisfy the following requirement: By default, :ocv:class:`gpu::StereoBeliefPropagation` uses floating-point arithmetics and the ``CV_32FC1`` type for messages. But it can also use fixed-point arithmetics and the ``CV_16SC1`` message type for better performance. To avoid an overflow in this case, the parameters must satisfy the following requirement:
.. math:: .. math::
......
modules/gpu/doc/data_structures.rst
View file @ d3b14b71
...@@ -48,7 +48,7 @@ gpu::PtrStep\_ ...@@ -48,7 +48,7 @@ gpu::PtrStep\_
.. ocv:class:: gpu::PtrStep\_ .. ocv:class:: gpu::PtrStep\_
Structure similar to Structure similar to
:ocv:class:`DevMem2D_` but containing only a pointer and row step. Width and height fields are excluded due to performance reasons. The structure is intended for internal use or for users who write device code. :ocv:class:`gpu::DevMem2D_` but containing only a pointer and row step. Width and height fields are excluded due to performance reasons. The structure is intended for internal use or for users who write device code.
:: ::
template<typename T> struct PtrStep_ template<typename T> struct PtrStep_
...@@ -79,7 +79,7 @@ gpu::PtrElemStrp\_ ...@@ -79,7 +79,7 @@ gpu::PtrElemStrp\_
.. ocv:class:: gpu::PtrElemStrp\_ .. ocv:class:: gpu::PtrElemStrp\_
Structure similar to Structure similar to
:ocv:class:`DevMem2D_` but containing only a pointer and a row step in elements. Width and height fields are excluded due to performance reasons. This class can only be constructed if ``sizeof(T)`` is a multiple of 256. The structure is intended for internal use or for users who write device code. :ocv:class:`gpu::DevMem2D_` but containing only a pointer and a row step in elements. Width and height fields are excluded due to performance reasons. This class can only be constructed if ``sizeof(T)`` is a multiple of 256. The structure is intended for internal use or for users who write device code.
:: ::
template<typename T> struct PtrElemStep_ : public PtrStep_<T> template<typename T> struct PtrElemStep_ : public PtrStep_<T>
...@@ -97,7 +97,7 @@ gpu::GpuMat ...@@ -97,7 +97,7 @@ gpu::GpuMat
.. ocv:class:: gpu::GpuMat .. ocv:class:: gpu::GpuMat
Base storage class for GPU memory with reference counting. Its interface matches the Base storage class for GPU memory with reference counting. Its interface matches the
:c:type:`Mat` interface with the following limitations: :ocv:class:`Mat` interface with the following limitations:
* *
no arbitrary dimensions support (only 2D) no arbitrary dimensions support (only 2D)
......
modules/gpu/doc/image_filtering.rst
View file @ d3b14b71
...@@ -240,7 +240,7 @@ gpu::boxFilter ...@@ -240,7 +240,7 @@ gpu::boxFilter
:param anchor: Anchor point. The default value ``Point(-1, -1)`` means that the anchor is at the kernel center. :param anchor: Anchor point. The default value ``Point(-1, -1)`` means that the anchor is at the kernel center.
.. note:: This filter does not check out-of-border accesses, so only a proper sub-matrix of a bigger matrix has to be passed to it. .. note:: This filter does not check out-of-border accesses, so only a proper sub-matrix of a bigger matrix has to be passed to it.
.. seealso:: :ocv:func:`boxFilter` .. seealso:: :ocv:func:`boxFilter`
...@@ -541,7 +541,7 @@ gpu::sepFilter2D ...@@ -541,7 +541,7 @@ gpu::sepFilter2D
gpu::createDerivFilter_GPU gpu::createDerivFilter_GPU
------------------------------ ------------------------------
.. ocv:function:: Ptr<FilterEngine_GPU> createDerivFilter_GPU(int srcType, int dstType, int dx, int dy, int ksize, int rowBorderType = BORDER_DEFAULT, int columnBorderType = -1) .. ocv:function:: Ptr<FilterEngine_GPU> gpu::createDerivFilter_GPU(int srcType, int dstType, int dx, int dy, int ksize, int rowBorderType = BORDER_DEFAULT, int columnBorderType = -1)
Creates a filter engine for the generalized Sobel operator. Creates a filter engine for the generalized Sobel operator.
......
modules/gpu/doc/image_processing.rst
View file @ d3b14b71
...@@ -278,12 +278,12 @@ gpu::ConvolveBuf::ConvolveBuf ...@@ -278,12 +278,12 @@ gpu::ConvolveBuf::ConvolveBuf
.. ocv:function:: ConvolveBuf::ConvolveBuf() .. ocv:function:: ConvolveBuf::ConvolveBuf()
Constructs an empty buffer that is properly resized after the first call of the Constructs an empty buffer that is properly resized after the first call of the
:ocv:func:`convolve` function. :ocv:func:`gpu::convolve` function.
.. ocv:function:: ConvolveBuf::ConvolveBuf(Size image_size, Size templ_size) .. ocv:function:: ConvolveBuf::ConvolveBuf(Size image_size, Size templ_size)
Constructs a buffer for the Constructs a buffer for the
:ocv:func:`convolve` function with respective arguments. :ocv:func:`gpu::convolve` function with respective arguments.
......
modules/gpu/doc/initalization_and_information.rst
View file @ d3b14b71
...@@ -7,7 +7,7 @@ Initalization and Information ...@@ -7,7 +7,7 @@ Initalization and Information
gpu::getCudaEnabledDeviceCount gpu::getCudaEnabledDeviceCount
---------------------------------- ----------------------------------
.. ocv:function:: int getCudaEnabledDeviceCount() .. ocv:function:: int gpu::getCudaEnabledDeviceCount()
Returns the number of installed CUDA-enabled devices. Use this function before any other GPU functions calls. If OpenCV is compiled without GPU support, this function returns 0. Returns the number of installed CUDA-enabled devices. Use this function before any other GPU functions calls. If OpenCV is compiled without GPU support, this function returns 0.
...@@ -15,7 +15,7 @@ gpu::getCudaEnabledDeviceCount ...@@ -15,7 +15,7 @@ gpu::getCudaEnabledDeviceCount
gpu::setDevice gpu::setDevice
------------------ ------------------
.. ocv:function:: void setDevice(int device) .. ocv:function:: void gpu::setDevice(int device)
Sets a device and initializes it for the current thread. If the call of this function is omitted, a default device is initialized at the fist GPU usage. Sets a device and initializes it for the current thread. If the call of this function is omitted, a default device is initialized at the fist GPU usage.
...@@ -25,7 +25,7 @@ gpu::setDevice ...@@ -25,7 +25,7 @@ gpu::setDevice
gpu::getDevice gpu::getDevice
------------------ ------------------
.. ocv:function:: int getDevice() .. ocv:function:: int gpu::getDevice()
Returns the current device index set by ``{gpu::getDevice}`` or initialized by default. Returns the current device index set by ``{gpu::getDevice}`` or initialized by default.
......
modules/gpu/doc/introduction.rst
View file @ d3b14b71
...@@ -15,7 +15,7 @@ The GPU module depends on the CUDA Toolkit and NVIDIA Performance Primitives lib ...@@ -15,7 +15,7 @@ The GPU module depends on the CUDA Toolkit and NVIDIA Performance Primitives lib
The OpenCV GPU module is designed for ease of use and does not require any knowledge of CUDA. Though, such a knowledge will certainly be useful to handle non-trivial cases or achieve the highest performance. It is helpful to understand the cost of various operations, what the GPU does, what the preferred data formats are, and so on. The GPU module is an effective instrument for quick implementation of GPU-accelerated computer vision algorithms. However, if your algorithm involves many simple operations, then, for the best possible performance, you may still need to write your own kernels to avoid extra write and read operations on the intermediate results. The OpenCV GPU module is designed for ease of use and does not require any knowledge of CUDA. Though, such a knowledge will certainly be useful to handle non-trivial cases or achieve the highest performance. It is helpful to understand the cost of various operations, what the GPU does, what the preferred data formats are, and so on. The GPU module is an effective instrument for quick implementation of GPU-accelerated computer vision algorithms. However, if your algorithm involves many simple operations, then, for the best possible performance, you may still need to write your own kernels to avoid extra write and read operations on the intermediate results.
To enable CUDA support, configure OpenCV using ``CMake`` with ``WITH_CUDA=ON`` . When the flag is set and if CUDA is installed, the full-featured OpenCV GPU module is built. Otherwise, the module is still built but at runtime all functions from the module throw To enable CUDA support, configure OpenCV using ``CMake`` with ``WITH_CUDA=ON`` . When the flag is set and if CUDA is installed, the full-featured OpenCV GPU module is built. Otherwise, the module is still built but at runtime all functions from the module throw
:ocv:func:`Exception` with ``CV_GpuNotSupported`` error code, except for :ocv:class:`Exception` with ``CV_GpuNotSupported`` error code, except for
:ocv:func:`gpu::getCudaEnabledDeviceCount()`. The latter function returns zero GPU count in this case. Building OpenCV without CUDA support does not perform device code compilation, so it does not require the CUDA Toolkit installed. Therefore, using the :ocv:func:`gpu::getCudaEnabledDeviceCount()`. The latter function returns zero GPU count in this case. Building OpenCV without CUDA support does not perform device code compilation, so it does not require the CUDA Toolkit installed. Therefore, using the
:ocv:func:`gpu::getCudaEnabledDeviceCount()` function, you can implement a high-level algorithm that will detect GPU presence at runtime and choose an appropriate implementation (CPU or GPU) accordingly. :ocv:func:`gpu::getCudaEnabledDeviceCount()` function, you can implement a high-level algorithm that will detect GPU presence at runtime and choose an appropriate implementation (CPU or GPU) accordingly.
......
modules/highgui/doc/reading_and_writing_images_and_video.rst
View file @ d3b14b71
...@@ -205,7 +205,7 @@ Open video file or a capturing device for video capturing ...@@ -205,7 +205,7 @@ Open video file or a capturing device for video capturing
:param device: id of the opened video capturing device (i.e. a camera index). :param device: id of the opened video capturing device (i.e. a camera index).
The methods first call :ocv:cfunc:`VideoCapture::release` to close the already opened file or camera. The methods first call :ocv:func:`VideoCapture::release` to close the already opened file or camera.
VideoCapture::isOpened VideoCapture::isOpened
......
modules/imgproc/doc/feature_detection.rst
View file @ d3b14b71
...@@ -273,9 +273,9 @@ The function can be used to initialize a point-based tracker of an object. ...@@ -273,9 +273,9 @@ The function can be used to initialize a point-based tracker of an object.
:ocv:func:`cornerMinEigenVal`, :ocv:func:`cornerMinEigenVal`,
:ocv:func:`cornerHarris`, :ocv:func:`cornerHarris`,
:ocv:func:`calcOpticalFlowPyrLK`, :ocv:func:`calcOpticalFlowPyrLK`,
:ocv:func:`estimateRigidMotion`, :ocv:func:`estimateRigidTransform`,
:ocv:func:`PlanarObjectDetector`, :ocv:class:`PlanarObjectDetector`,
:ocv:func:`OneWayDescriptor` :ocv:class:`OneWayDescriptor`
......
modules/imgproc/doc/filtering.rst
View file @ d3b14b71
This diff is collapsed.
modules/imgproc/doc/geometric_transformations.rst
View file @ d3b14b71
...@@ -70,7 +70,7 @@ The function converts a pair of maps for ...@@ -70,7 +70,7 @@ The function converts a pair of maps for
.. seealso:: .. seealso::
:ocv:func:`remap`, :ocv:func:`remap`,
:ocv:func:`undisort`, :ocv:func:`undistort`,
:ocv:func:`initUndistortRectifyMap` :ocv:func:`initUndistortRectifyMap`
......
modules/imgproc/doc/histograms.rst
View file @ d3b14b71
...@@ -143,7 +143,7 @@ The functions ``calcBackProject`` calculate the back project of the histogram. T ...@@ -143,7 +143,7 @@ The functions ``calcBackProject`` calculate the back project of the histogram. T
Find connected components in the resulting picture and choose, for example, the largest component. Find connected components in the resulting picture and choose, for example, the largest component.
This is an approximate algorithm of the This is an approximate algorithm of the
:ocv:func:`CAMShift` color object tracker. :ocv:func:`CamShift` color object tracker.
.. seealso:: :ocv:func:`calcHist` .. seealso:: :ocv:func:`calcHist`
.. _compareHist: .. _compareHist:
...@@ -315,7 +315,7 @@ Locates a template within an image by using a histogram comparison. ...@@ -315,7 +315,7 @@ Locates a template within an image by using a histogram comparison.
:param factor: Normalization factor for histograms that affects the normalization scale of the destination image. Pass 1 if not sure. :param factor: Normalization factor for histograms that affects the normalization scale of the destination image. Pass 1 if not sure.
The function calculates the back projection by comparing histograms of the source image patches with the given histogram. The function is similar to :ocv:func:`MatchTemplate`, but instead of comparing the raster patch with all its possible positions within the search window, the function ``CalcBackProjectPatch`` compares histograms. See the algorithm diagram below: The function calculates the back projection by comparing histograms of the source image patches with the given histogram. The function is similar to :ocv:func:`matchTemplate`, but instead of comparing the raster patch with all its possible positions within the search window, the function ``CalcBackProjectPatch`` compares histograms. See the algorithm diagram below:
.. image:: pics/backprojectpatch.png .. image:: pics/backprojectpatch.png
......
modules/ml/doc/boosting.rst
View file @ d3b14b71
...@@ -142,7 +142,7 @@ Default and training constructors. ...@@ -142,7 +142,7 @@ Default and training constructors.
.. ocv:function:: CvBoost::CvBoost( const Mat& trainData, int tflag, const Mat& responses, const Mat& varIdx=Mat(), const Mat& sampleIdx=Mat(), const Mat& varType=Mat(), const Mat& missingDataMask=Mat(), CvBoostParams params=CvBoostParams() ) .. ocv:function:: CvBoost::CvBoost( const Mat& trainData, int tflag, const Mat& responses, const Mat& varIdx=Mat(), const Mat& sampleIdx=Mat(), const Mat& varType=Mat(), const Mat& missingDataMask=Mat(), CvBoostParams params=CvBoostParams() )
.. ocv:function::CvBoost::CvBoost( const CvMat* trainData, int tflag, const CvMat* responses, const CvMat* varIdx=0, const CvMat* sampleIdx=0, const CvMat* varType=0, const CvMat* missingDataMask=0, CvBoostParams params=CvBoostParams() ) .. ocv:function:: CvBoost::CvBoost( const CvMat* trainData, int tflag, const CvMat* responses, const CvMat* varIdx=0, const CvMat* sampleIdx=0, const CvMat* varType=0, const CvMat* missingDataMask=0, CvBoostParams params=CvBoostParams() )
.. ocv:pyfunction:: cv2.Boost(trainData, tflag, responses[, varIdx[, sampleIdx[, varType[, missingDataMask[, params]]]]]) -> <Boost object> .. ocv:pyfunction:: cv2.Boost(trainData, tflag, responses[, varIdx[, sampleIdx[, varType[, missingDataMask[, params]]]]]) -> <Boost object>
...@@ -155,9 +155,9 @@ Trains a boosted tree classifier. ...@@ -155,9 +155,9 @@ Trains a boosted tree classifier.
.. ocv:function:: bool CvBoost::train( const Mat& trainData, int tflag, const Mat& responses, const Mat& varIdx=Mat(), const Mat& sampleIdx=Mat(), const Mat& varType=Mat(), const Mat& missingDataMask=Mat(), CvBoostParams params=CvBoostParams(), bool update=false ) .. ocv:function:: bool CvBoost::train( const Mat& trainData, int tflag, const Mat& responses, const Mat& varIdx=Mat(), const Mat& sampleIdx=Mat(), const Mat& varType=Mat(), const Mat& missingDataMask=Mat(), CvBoostParams params=CvBoostParams(), bool update=false )
.. ocv:function::bool CvBoost::train( const CvMat* trainData, int tflag, const CvMat* responses, const CvMat* varIdx=0, const CvMat* sampleIdx=0, const CvMat* varType=0, const CvMat* missingDataMask=0, CvBoostParams params=CvBoostParams(), bool update=false ) .. ocv:function:: bool CvBoost::train( const CvMat* trainData, int tflag, const CvMat* responses, const CvMat* varIdx=0, const CvMat* sampleIdx=0, const CvMat* varType=0, const CvMat* missingDataMask=0, CvBoostParams params=CvBoostParams(), bool update=false )
.. ocv:function::bool CvBoost::train( CvMLData* data, CvBoostParams params=CvBoostParams(), bool update=false ) .. ocv:function:: bool CvBoost::train( CvMLData* data, CvBoostParams params=CvBoostParams(), bool update=false )
.. ocv:pyfunction:: cv2.Boost.train(trainData, tflag, responses[, varIdx[, sampleIdx[, varType[, missingDataMask[, params[, update]]]]]]) -> retval .. ocv:pyfunction:: cv2.Boost.train(trainData, tflag, responses[, varIdx[, sampleIdx[, varType[, missingDataMask[, params[, update]]]]]]) -> retval
...@@ -171,7 +171,7 @@ Predicts a response for an input sample. ...@@ -171,7 +171,7 @@ Predicts a response for an input sample.
.. ocv:function:: float CvBoost::predict( const Mat& sample, const Mat& missing=Mat(), const Range& slice=Range::all(), bool rawMode=false, bool returnSum=false ) const .. ocv:function:: float CvBoost::predict( const Mat& sample, const Mat& missing=Mat(), const Range& slice=Range::all(), bool rawMode=false, bool returnSum=false ) const
.. ocv:function::float CvBoost::predict( const CvMat* sample, const CvMat* missing=0, CvMat* weak_responses=0, CvSlice slice=CV_WHOLE_SEQ, bool raw_mode=false, bool return_sum=false ) const .. ocv:function:: float CvBoost::predict( const CvMat* sample, const CvMat* missing=0, CvMat* weak_responses=0, CvSlice slice=CV_WHOLE_SEQ, bool raw_mode=false, bool return_sum=false ) const
.. ocv:pyfunction:: cv2.Boost.predict(sample[, missing[, slice[, rawMode[, returnSum]]]]) -> retval .. ocv:pyfunction:: cv2.Boost.predict(sample[, missing[, slice[, rawMode[, returnSum]]]]) -> retval
...@@ -193,7 +193,7 @@ CvBoost::prune ...@@ -193,7 +193,7 @@ CvBoost::prune
-------------- --------------
Removes the specified weak classifiers. Removes the specified weak classifiers.
.. ocv:function::void CvBoost::prune( CvSlice slice ) .. ocv:function:: void CvBoost::prune( CvSlice slice )
.. ocv:pyfunction:: cv2.Boost.prune(slice) -> None .. ocv:pyfunction:: cv2.Boost.prune(slice) -> None
...@@ -208,7 +208,7 @@ CvBoost::calc_error ...@@ -208,7 +208,7 @@ CvBoost::calc_error
------------------- -------------------
Returns error of the boosted tree classifier. Returns error of the boosted tree classifier.
.. ocv:function::float CvBoost::calc_error( CvMLData* _data, int type , std::vector<float> *resp = 0 ) .. ocv:function:: float CvBoost::calc_error( CvMLData* _data, int type , std::vector<float> *resp = 0 )
The method is identical to :ocv:func:`CvDTree::calc_error` but uses the boosted tree classifier as predictor. The method is identical to :ocv:func:`CvDTree::calc_error` but uses the boosted tree classifier as predictor.
...@@ -217,7 +217,7 @@ CvBoost::get_weak_predictors ...@@ -217,7 +217,7 @@ CvBoost::get_weak_predictors
---------------------------- ----------------------------
Returns the sequence of weak tree classifiers. Returns the sequence of weak tree classifiers.
.. ocv:function::CvSeq* CvBoost::get_weak_predictors() .. ocv:function:: CvSeq* CvBoost::get_weak_predictors()
The method returns the sequence of weak classifiers. Each element of the sequence is a pointer to the :ocv:class:`CvBoostTree` class or to some of its derivatives. The method returns the sequence of weak classifiers. Each element of the sequence is a pointer to the :ocv:class:`CvBoostTree` class or to some of its derivatives.
...@@ -232,5 +232,5 @@ CvBoost::get_data ...@@ -232,5 +232,5 @@ CvBoost::get_data
----------------- -----------------
Returns used train data of the boosted tree classifier. Returns used train data of the boosted tree classifier.
.. ocv:function::const CvDTreeTrainData* CvBoost::get_data() const .. ocv:function:: const CvDTreeTrainData* CvBoost::get_data() const
modules/ml/doc/decision_trees.rst
View file @ d3b14b71
...@@ -80,23 +80,21 @@ The structure represents a possible decision tree node split. It has public memb ...@@ -80,23 +80,21 @@ The structure represents a possible decision tree node split. It has public memb
.. ocv:member:: int[] subset .. ocv:member:: int[] subset
Bit array indicating the value subset in case of split on a categorical variable. The rule is: Bit array indicating the value subset in case of split on a categorical variable. The rule is: ::
:: if var_value in subset
then next_node <- left
if var_value in subset else next_node <- right
then next_node <- left
else next_node <- right
.. ocv:member:: float ord.c .. ocv:member:: float ord::c
The threshold value in case of split on an ordered variable. The rule is: :: The threshold value in case of split on an ordered variable. The rule is: ::
if var_value < c if var_value < ord.c
then next_node<-left then next_node<-left
else next_node<-right else next_node<-right
.. ocv:member:: int ord.split_point .. ocv:member:: int ord::split_point
Used internally by the training algorithm. Used internally by the training algorithm.
...@@ -225,11 +223,11 @@ Trains a decision tree. ...@@ -225,11 +223,11 @@ Trains a decision tree.
.. ocv:function:: bool CvDTree::train( const Mat& train_data, int tflag, const Mat& responses, const Mat& var_idx=Mat(), const Mat& sample_idx=Mat(), const Mat& var_type=Mat(), const Mat& missing_mask=Mat(), CvDTreeParams params=CvDTreeParams() ) .. ocv:function:: bool CvDTree::train( const Mat& train_data, int tflag, const Mat& responses, const Mat& var_idx=Mat(), const Mat& sample_idx=Mat(), const Mat& var_type=Mat(), const Mat& missing_mask=Mat(), CvDTreeParams params=CvDTreeParams() )
.. ocv:function::bool CvDTree::train( const CvMat* trainData, int tflag, const CvMat* responses, const CvMat* varIdx=0, const CvMat* sampleIdx=0, const CvMat* varType=0, const CvMat* missingDataMask=0, CvDTreeParams params=CvDTreeParams() ) .. ocv:function:: bool CvDTree::train( const CvMat* trainData, int tflag, const CvMat* responses, const CvMat* varIdx=0, const CvMat* sampleIdx=0, const CvMat* varType=0, const CvMat* missingDataMask=0, CvDTreeParams params=CvDTreeParams() )
.. ocv:function::bool CvDTree::train( CvMLData* trainData, CvDTreeParams params=CvDTreeParams() ) .. ocv:function:: bool CvDTree::train( CvMLData* trainData, CvDTreeParams params=CvDTreeParams() )
.. ocv:function::bool CvDTree::train( CvDTreeTrainData* trainData, const CvMat* subsampleIdx ) .. ocv:function:: bool CvDTree::train( CvDTreeTrainData* trainData, const CvMat* subsampleIdx )
.. ocv:pyfunction:: cv2.DTree.train(trainData, tflag, responses[, varIdx[, sampleIdx[, varType[, missingDataMask[, params]]]]]) -> retval .. ocv:pyfunction:: cv2.DTree.train(trainData, tflag, responses[, varIdx[, sampleIdx[, varType[, missingDataMask[, params]]]]]) -> retval
...@@ -249,7 +247,7 @@ Returns the leaf node of a decision tree corresponding to the input vector. ...@@ -249,7 +247,7 @@ Returns the leaf node of a decision tree corresponding to the input vector.
.. ocv:function:: CvDTreeNode* CvDTree::predict( const Mat& sample, const Mat& missingDataMask=Mat(), bool preprocessedInput=false ) const .. ocv:function:: CvDTreeNode* CvDTree::predict( const Mat& sample, const Mat& missingDataMask=Mat(), bool preprocessedInput=false ) const
.. ocv:function::CvDTreeNode* CvDTree::predict( const CvMat* sample, const CvMat* missingDataMask=0, bool preprocessedInput=false ) const .. ocv:function:: CvDTreeNode* CvDTree::predict( const CvMat* sample, const CvMat* missingDataMask=0, bool preprocessedInput=false ) const
.. ocv:pyfunction:: cv2.DTree.predict(sample[, missingDataMask[, preprocessedInput]]) -> retval .. ocv:pyfunction:: cv2.DTree.predict(sample[, missingDataMask[, preprocessedInput]]) -> retval
...@@ -267,7 +265,7 @@ CvDTree::calc_error ...@@ -267,7 +265,7 @@ CvDTree::calc_error
------------------- -------------------
Returns error of the decision tree. Returns error of the decision tree.
.. ocv:function::float CvDTree::calc_error( CvMLData* trainData, int type, std::vector<float> *resp = 0 ) .. ocv:function:: float CvDTree::calc_error( CvMLData* trainData, int type, std::vector<float> *resp = 0 )
:param data: Data for the decision tree. :param data: Data for the decision tree.
...@@ -288,7 +286,7 @@ Returns the variable importance array. ...@@ -288,7 +286,7 @@ Returns the variable importance array.
.. ocv:function:: Mat CvDTree::getVarImportance() .. ocv:function:: Mat CvDTree::getVarImportance()
.. ocv:function::const CvMat* CvDTree::get_var_importance() .. ocv:function:: const CvMat* CvDTree::get_var_importance()
.. ocv:pyfunction:: cv2.DTree.getVarImportance() -> importanceVector .. ocv:pyfunction:: cv2.DTree.getVarImportance() -> importanceVector
...@@ -311,7 +309,7 @@ CvDTree::get_data ...@@ -311,7 +309,7 @@ CvDTree::get_data
----------------- -----------------
Returns used train data of the decision tree. Returns used train data of the decision tree.
.. ocv:function::const CvDTreeTrainData* CvDTree::get_data() const .. ocv:function:: const CvDTreeTrainData* CvDTree::get_data() const
Example: building a tree for classifying mushrooms. See the ``mushroom.cpp`` sample that demonstrates how to build and use the Example: building a tree for classifying mushrooms. See the ``mushroom.cpp`` sample that demonstrates how to build and use the
decision tree. decision tree.
......
modules/ml/doc/expectation_maximization.rst
View file @ d3b14b71
...@@ -176,7 +176,7 @@ Unlike many of the ML models, EM is an unsupervised learning algorithm and it do ...@@ -176,7 +176,7 @@ Unlike many of the ML models, EM is an unsupervised learning algorithm and it do
:math:`\texttt{labels}_i=\texttt{arg max}_k(p_{i,k}), i=1..N` (indices of the most probable mixture component for each sample). :math:`\texttt{labels}_i=\texttt{arg max}_k(p_{i,k}), i=1..N` (indices of the most probable mixture component for each sample).
The trained model can be used further for prediction, just like any other classifier. The trained model is similar to the The trained model can be used further for prediction, just like any other classifier. The trained model is similar to the
:ocv:class:`CvBayesClassifier`. :ocv:class:`CvNormalBayesClassifier`.
For an example of clustering random samples of the multi-Gaussian distribution using EM, see ``em.cpp`` sample in the OpenCV distribution. For an example of clustering random samples of the multi-Gaussian distribution using EM, see ``em.cpp`` sample in the OpenCV distribution.
......
modules/ml/doc/gradient_boosted_trees.rst
View file @ d3b14b71
...@@ -161,7 +161,7 @@ Default and training constructors. ...@@ -161,7 +161,7 @@ Default and training constructors.
.. ocv:function:: CvGBTrees::CvGBTrees( const Mat& trainData, int tflag, const Mat& responses, const Mat& varIdx=Mat(), const Mat& sampleIdx=Mat(), const Mat& varType=Mat(), const Mat& missingDataMask=Mat(), CvGBTreesParams params=CvGBTreesParams() ) .. ocv:function:: CvGBTrees::CvGBTrees( const Mat& trainData, int tflag, const Mat& responses, const Mat& varIdx=Mat(), const Mat& sampleIdx=Mat(), const Mat& varType=Mat(), const Mat& missingDataMask=Mat(), CvGBTreesParams params=CvGBTreesParams() )
.. ocv:function::CvGBTrees::CvGBTrees( const CvMat* trainData, int tflag, const CvMat* responses, const CvMat* varIdx=0, const CvMat* sampleIdx=0, const CvMat* varType=0, const CvMat* missingDataMask=0, CvGBTreesParams params=CvGBTreesParams() ) .. ocv:function:: CvGBTrees::CvGBTrees( const CvMat* trainData, int tflag, const CvMat* responses, const CvMat* varIdx=0, const CvMat* sampleIdx=0, const CvMat* varType=0, const CvMat* missingDataMask=0, CvGBTreesParams params=CvGBTreesParams() )
.. ocv:pyfunction:: cv2.GBTrees([trainData, tflag, responses[, varIdx[, sampleIdx[, varType[, missingDataMask[, params]]]]]]) -> <GBTrees object> .. ocv:pyfunction:: cv2.GBTrees([trainData, tflag, responses[, varIdx[, sampleIdx[, varType[, missingDataMask[, params]]]]]]) -> <GBTrees object>
...@@ -173,9 +173,9 @@ Trains a Gradient boosted tree model. ...@@ -173,9 +173,9 @@ Trains a Gradient boosted tree model.
.. ocv:function:: bool CvGBTrees::train(const Mat& trainData, int tflag, const Mat& responses, const Mat& varIdx=Mat(), const Mat& sampleIdx=Mat(), const Mat& varType=Mat(), const Mat& missingDataMask=Mat(), CvGBTreesParams params=CvGBTreesParams(), bool update=false) .. ocv:function:: bool CvGBTrees::train(const Mat& trainData, int tflag, const Mat& responses, const Mat& varIdx=Mat(), const Mat& sampleIdx=Mat(), const Mat& varType=Mat(), const Mat& missingDataMask=Mat(), CvGBTreesParams params=CvGBTreesParams(), bool update=false)
.. ocv:function::bool CvGBTrees::train( const CvMat* trainData, int tflag, const CvMat* responses, const CvMat* varIdx=0, const CvMat* sampleIdx=0, const CvMat* varType=0, const CvMat* missingDataMask=0, CvGBTreesParams params=CvGBTreesParams(), bool update=false ) .. ocv:function:: bool CvGBTrees::train( const CvMat* trainData, int tflag, const CvMat* responses, const CvMat* varIdx=0, const CvMat* sampleIdx=0, const CvMat* varType=0, const CvMat* missingDataMask=0, CvGBTreesParams params=CvGBTreesParams(), bool update=false )
.. ocv:function::bool CvGBTrees::train(CvMLData* data, CvGBTreesParams params=CvGBTreesParams(), bool update=false) .. ocv:function:: bool CvGBTrees::train(CvMLData* data, CvGBTreesParams params=CvGBTreesParams(), bool update=false)
.. ocv:pyfunction:: cv2.GBTrees.train(trainData, tflag, responses[, varIdx[, sampleIdx[, varType[, missingDataMask[, params[, update]]]]]]) -> retval .. ocv:pyfunction:: cv2.GBTrees.train(trainData, tflag, responses[, varIdx[, sampleIdx[, varType[, missingDataMask[, params[, update]]]]]]) -> retval
...@@ -200,7 +200,7 @@ Predicts a response for an input sample. ...@@ -200,7 +200,7 @@ Predicts a response for an input sample.
.. ocv:function:: float CvGBTrees::predict(const Mat& sample, const Mat& missing=Mat(), const Range& slice = Range::all(), int k=-1) const .. ocv:function:: float CvGBTrees::predict(const Mat& sample, const Mat& missing=Mat(), const Range& slice = Range::all(), int k=-1) const
.. ocv:function::float CvGBTrees::predict( const CvMat* sample, const CvMat* missing=0, CvMat* weakResponses=0, CvSlice slice = CV_WHOLE_SEQ, int k=-1 ) const .. ocv:function:: float CvGBTrees::predict( const CvMat* sample, const CvMat* missing=0, CvMat* weakResponses=0, CvSlice slice = CV_WHOLE_SEQ, int k=-1 ) const
.. ocv:pyfunction:: cv2.GBTrees.predict(sample[, missing[, slice[, k]]]) -> retval .. ocv:pyfunction:: cv2.GBTrees.predict(sample[, missing[, slice[, k]]]) -> retval
...@@ -232,7 +232,7 @@ Predicts a response for an input sample. ...@@ -232,7 +232,7 @@ Predicts a response for an input sample.
The method predicts the response corresponding to the given sample The method predicts the response corresponding to the given sample
(see :ref:`Predicting with GBT`). (see :ref:`Predicting with GBT`).
The result is either the class label or the estimated function value. The The result is either the class label or the estimated function value. The
:ocv:func:`predict` method enables using the parallel version of the GBT model :ocv:func:`CvGBTrees::predict` method enables using the parallel version of the GBT model
prediction if the OpenCV is built with the TBB library. In this case, predictions prediction if the OpenCV is built with the TBB library. In this case, predictions
of single trees are computed in a parallel fashion. of single trees are computed in a parallel fashion.
...@@ -264,7 +264,7 @@ Calculates a training or testing error. ...@@ -264,7 +264,7 @@ Calculates a training or testing error.
:param resp: If non-zero, a vector of predictions on the corresponding data set is :param resp: If non-zero, a vector of predictions on the corresponding data set is
returned. returned.
If the :ocv:class:`CvMLData` data is used to store the data set, :ocv:func:`calc_error` can be If the :ocv:class:`CvMLData` data is used to store the data set, :ocv:func:`CvGBTrees::calc_error` can be
used to get a training/testing error easily and (optionally) all predictions used to get a training/testing error easily and (optionally) all predictions
on the training/testing set. If the Intel* TBB* library is used, the error is computed in a on the training/testing set. If the Intel* TBB* library is used, the error is computed in a
parallel way, namely, predictions for different samples are computed at the same time. parallel way, namely, predictions for different samples are computed at the same time.
......
modules/ml/doc/k_nearest_neighbors.rst
View file @ d3b14b71
...@@ -19,7 +19,7 @@ Default and training constructors. ...@@ -19,7 +19,7 @@ Default and training constructors.
.. ocv:function:: CvKNearest::CvKNearest( const Mat& trainData, const Mat& responses, const Mat& sampleIdx=Mat(), bool isRegression=false, int max_k=32 ) .. ocv:function:: CvKNearest::CvKNearest( const Mat& trainData, const Mat& responses, const Mat& sampleIdx=Mat(), bool isRegression=false, int max_k=32 )
.. ocv:function::CvKNearest::CvKNearest( const CvMat* trainData, const CvMat* responses, const CvMat* sampleIdx=0, bool isRegression=false, int max_k=32 ) .. ocv:function:: CvKNearest::CvKNearest( const CvMat* trainData, const CvMat* responses, const CvMat* sampleIdx=0, bool isRegression=false, int max_k=32 )
See :ocv:func:`CvKNearest::train` for additional parameters descriptions. See :ocv:func:`CvKNearest::train` for additional parameters descriptions.
...@@ -29,7 +29,7 @@ Trains the model. ...@@ -29,7 +29,7 @@ Trains the model.
.. ocv:function:: bool CvKNearest::train( const Mat& trainData, const Mat& responses, const Mat& sampleIdx=Mat(), bool isRegression=false, int maxK=32, bool updateBase=false ) .. ocv:function:: bool CvKNearest::train( const Mat& trainData, const Mat& responses, const Mat& sampleIdx=Mat(), bool isRegression=false, int maxK=32, bool updateBase=false )
.. ocv:function::bool CvKNearest::train( const CvMat* trainData, const CvMat* responses, const CvMat* sampleIdx=0, bool is_regression=false, int maxK=32, bool updateBase=false ) .. ocv:function:: bool CvKNearest::train( const CvMat* trainData, const CvMat* responses, const CvMat* sampleIdx=0, bool is_regression=false, int maxK=32, bool updateBase=false )
.. ocv:pyfunction:: cv2.KNearest.train(trainData, responses[, sampleIdx[, isRegression[, maxK[, updateBase]]]]) -> retval .. ocv:pyfunction:: cv2.KNearest.train(trainData, responses[, sampleIdx[, isRegression[, maxK[, updateBase]]]]) -> retval
...@@ -39,7 +39,7 @@ Trains the model. ...@@ -39,7 +39,7 @@ Trains the model.
:param updateBase: Specifies whether the model is trained from scratch (``update_base=false``), or it is updated using the new training data (``update_base=true``). In the latter case, the parameter ``maxK`` must not be larger than the original value. :param updateBase: Specifies whether the model is trained from scratch (``update_base=false``), or it is updated using the new training data (``update_base=true``). In the latter case, the parameter ``maxK`` must not be larger than the original value.
The method trains the K-Nearest model. It follows the conventions of the generic :ocv:func:`CvStataModel::train` approach with the following limitations: The method trains the K-Nearest model. It follows the conventions of the generic :ocv:func:`CvStatModel::train` approach with the following limitations:
* Only ``CV_ROW_SAMPLE`` data layout is supported. * Only ``CV_ROW_SAMPLE`` data layout is supported.
* Input variables are all ordered. * Input variables are all ordered.
...@@ -54,7 +54,7 @@ Finds the neighbors and predicts responses for input vectors. ...@@ -54,7 +54,7 @@ Finds the neighbors and predicts responses for input vectors.
.. ocv:function:: float CvKNearest::find_nearest( const Mat& samples, int k, Mat& results, Mat& neighborResponses, Mat& dists) const .. ocv:function:: float CvKNearest::find_nearest( const Mat& samples, int k, Mat& results, Mat& neighborResponses, Mat& dists) const
.. ocv:function::float CvKNearest::find_nearest( const CvMat* samples, int k, CvMat* results=0, const float** neighbors=0, CvMat* neighborResponses=0, CvMat* dist=0 ) const .. ocv:function:: float CvKNearest::find_nearest( const CvMat* samples, int k, CvMat* results=0, const float** neighbors=0, CvMat* neighborResponses=0, CvMat* dist=0 ) const
.. ocv:pyfunction:: cv2.KNearest.find_nearest(samples, k[, results[, neighborResponses[, dists]]]) -> retval, results, neighborResponses, dists .. ocv:pyfunction:: cv2.KNearest.find_nearest(samples, k[, results[, neighborResponses[, dists]]]) -> retval, results, neighborResponses, dists
......
modules/ml/doc/neural_networks.rst
View file @ d3b14b71
...@@ -71,7 +71,7 @@ so the error on the test set usually starts increasing after the network ...@@ -71,7 +71,7 @@ so the error on the test set usually starts increasing after the network
size reaches a limit. Besides, the larger networks are trained much size reaches a limit. Besides, the larger networks are trained much
longer than the smaller ones, so it is reasonable to pre-process the data, longer than the smaller ones, so it is reasonable to pre-process the data,
using using
:ocv:func:`PCA::operator()` or similar technique, and train a smaller network :ocv:funcx:`PCA::operator()` or similar technique, and train a smaller network
on only essential features. on only essential features.
Another MPL feature is an inability to handle categorical Another MPL feature is an inability to handle categorical
...@@ -182,7 +182,7 @@ The constructors. ...@@ -182,7 +182,7 @@ The constructors.
.. ocv:function:: CvANN_MLP::CvANN_MLP() .. ocv:function:: CvANN_MLP::CvANN_MLP()
.. ocv:function::CvANN_MLP::CvANN_MLP( const CvMat* layerSizes, int activateFunc=CvANN_MLP::SIGMOID_SYM, double fparam1=0, double fparam2=0 ) .. ocv:function:: CvANN_MLP::CvANN_MLP( const CvMat* layerSizes, int activateFunc=CvANN_MLP::SIGMOID_SYM, double fparam1=0, double fparam2=0 )
.. ocv:pyfunction:: cv2.ANN_MLP(layerSizes[, activateFunc[, fparam1[, fparam2]]]) -> <ANN_MLP object> .. ocv:pyfunction:: cv2.ANN_MLP(layerSizes[, activateFunc[, fparam1[, fparam2]]]) -> <ANN_MLP object>
...@@ -194,7 +194,7 @@ Constructs MLP with the specified topology. ...@@ -194,7 +194,7 @@ Constructs MLP with the specified topology.
.. ocv:function:: void CvANN_MLP::create( const Mat& layerSizes, int activateFunc=CvANN_MLP::SIGMOID_SYM, double fparam1=0, double fparam2=0 ) .. ocv:function:: void CvANN_MLP::create( const Mat& layerSizes, int activateFunc=CvANN_MLP::SIGMOID_SYM, double fparam1=0, double fparam2=0 )
.. ocv:function::void CvANN_MLP::create( const CvMat* layerSizes, int activateFunc=CvANN_MLP::SIGMOID_SYM, double fparam1=0, double fparam2=0 ) .. ocv:function:: void CvANN_MLP::create( const CvMat* layerSizes, int activateFunc=CvANN_MLP::SIGMOID_SYM, double fparam1=0, double fparam2=0 )
.. ocv:pyfunction:: cv2.ANN_MLP.create(layerSizes[, activateFunc[, fparam1[, fparam2]]]) -> None .. ocv:pyfunction:: cv2.ANN_MLP.create(layerSizes[, activateFunc[, fparam1[, fparam2]]]) -> None
...@@ -212,7 +212,7 @@ Trains/updates MLP. ...@@ -212,7 +212,7 @@ Trains/updates MLP.
.. ocv:function:: int CvANN_MLP::train( const Mat& inputs, const Mat& outputs, const Mat& sampleWeights, const Mat& sampleIdx=Mat(), CvANN_MLP_TrainParams params = CvANN_MLP_TrainParams(), int flags=0 ) .. ocv:function:: int CvANN_MLP::train( const Mat& inputs, const Mat& outputs, const Mat& sampleWeights, const Mat& sampleIdx=Mat(), CvANN_MLP_TrainParams params = CvANN_MLP_TrainParams(), int flags=0 )
.. ocv:function::int CvANN_MLP::train( const CvMat* inputs, const CvMat* outputs, const CvMat* sampleWeights, const CvMat* sampleIdx=0, CvANN_MLP_TrainParams params = CvANN_MLP_TrainParams(), int flags=0 ) .. ocv:function:: int CvANN_MLP::train( const CvMat* inputs, const CvMat* outputs, const CvMat* sampleWeights, const CvMat* sampleIdx=0, CvANN_MLP_TrainParams params = CvANN_MLP_TrainParams(), int flags=0 )
.. ocv:pyfunction:: cv2.ANN_MLP.train(inputs, outputs, sampleWeights[, sampleIdx[, params[, flags]]]) -> niterations .. ocv:pyfunction:: cv2.ANN_MLP.train(inputs, outputs, sampleWeights[, sampleIdx[, params[, flags]]]) -> niterations
...@@ -242,7 +242,7 @@ Predicts responses for input samples. ...@@ -242,7 +242,7 @@ Predicts responses for input samples.
.. ocv:function:: float CvANN_MLP::predict( const Mat& inputs, Mat& outputs ) const .. ocv:function:: float CvANN_MLP::predict( const Mat& inputs, Mat& outputs ) const
.. ocv:function::float CvANN_MLP::predict( const CvMat* inputs, CvMat* outputs ) const .. ocv:function:: float CvANN_MLP::predict( const CvMat* inputs, CvMat* outputs ) const
.. ocv:pyfunction:: cv2.ANN_MLP.predict(inputs, outputs) -> retval .. ocv:pyfunction:: cv2.ANN_MLP.predict(inputs, outputs) -> retval
...@@ -262,7 +262,7 @@ CvANN_MLP::get_layer_sizes ...@@ -262,7 +262,7 @@ CvANN_MLP::get_layer_sizes
-------------------------- --------------------------
Returns numbers of neurons in each layer of the MLP. Returns numbers of neurons in each layer of the MLP.
.. ocv:function::const CvMat* CvANN_MLP::get_layer_sizes() .. ocv:function:: const CvMat* CvANN_MLP::get_layer_sizes()
The method returns the integer vector specifying the number of neurons in each layer including the input and output layers of the MLP. The method returns the integer vector specifying the number of neurons in each layer including the input and output layers of the MLP.
......
modules/ml/doc/normal_bayes_classifier.rst
View file @ d3b14b71
...@@ -23,7 +23,7 @@ Default and training constructors. ...@@ -23,7 +23,7 @@ Default and training constructors.
.. ocv:function:: CvNormalBayesClassifier::CvNormalBayesClassifier( const Mat& trainData, const Mat& responses, const Mat& varIdx=Mat(), const Mat& sampleIdx=Mat() ) .. ocv:function:: CvNormalBayesClassifier::CvNormalBayesClassifier( const Mat& trainData, const Mat& responses, const Mat& varIdx=Mat(), const Mat& sampleIdx=Mat() )
.. ocv:function::CvNormalBayesClassifier::CvNormalBayesClassifier( const CvMat* trainData, const CvMat* responses, const CvMat* varIdx=0, const CvMat* sampleIdx=0 ) .. ocv:function:: CvNormalBayesClassifier::CvNormalBayesClassifier( const CvMat* trainData, const CvMat* responses, const CvMat* varIdx=0, const CvMat* sampleIdx=0 )
.. ocv:pyfunction:: cv2.NormalBayesClassifier(trainData, responses[, varIdx[, sampleIdx]]) -> <NormalBayesClassifier object> .. ocv:pyfunction:: cv2.NormalBayesClassifier(trainData, responses[, varIdx[, sampleIdx]]) -> <NormalBayesClassifier object>
...@@ -35,7 +35,7 @@ Trains the model. ...@@ -35,7 +35,7 @@ Trains the model.
.. ocv:function:: bool CvNormalBayesClassifier::train( const Mat& trainData, const Mat& responses, const Mat& varIdx = Mat(), const Mat& sampleIdx=Mat(), bool update=false ) .. ocv:function:: bool CvNormalBayesClassifier::train( const Mat& trainData, const Mat& responses, const Mat& varIdx = Mat(), const Mat& sampleIdx=Mat(), bool update=false )
.. ocv:function::bool CvNormalBayesClassifier::train( const CvMat* trainData, const CvMat* responses, const CvMat* varIdx = 0, const CvMat* sampleIdx=0, bool update=false ) .. ocv:function:: bool CvNormalBayesClassifier::train( const CvMat* trainData, const CvMat* responses, const CvMat* varIdx = 0, const CvMat* sampleIdx=0, bool update=false )
.. ocv:pyfunction:: cv2.NormalBayesClassifier.train(trainData, responses[, varIdx[, sampleIdx[, update]]]) -> retval .. ocv:pyfunction:: cv2.NormalBayesClassifier.train(trainData, responses[, varIdx[, sampleIdx[, update]]]) -> retval
...@@ -54,7 +54,7 @@ Predicts the response for sample(s). ...@@ -54,7 +54,7 @@ Predicts the response for sample(s).
.. ocv:function:: float CvNormalBayesClassifier::predict( const Mat& samples, Mat* results=0 ) const .. ocv:function:: float CvNormalBayesClassifier::predict( const Mat& samples, Mat* results=0 ) const
.. ocv:function::float CvNormalBayesClassifier::predict( const CvMat* samples, CvMat* results=0 ) const .. ocv:function:: float CvNormalBayesClassifier::predict( const CvMat* samples, CvMat* results=0 ) const
.. ocv:pyfunction:: cv2.NormalBayesClassifier.predict(samples) -> retval, results .. ocv:pyfunction:: cv2.NormalBayesClassifier.predict(samples) -> retval, results
......
modules/ml/doc/random_trees.rst
View file @ d3b14b71
...@@ -98,9 +98,9 @@ Trains the Random Trees model. ...@@ -98,9 +98,9 @@ Trains the Random Trees model.
.. ocv:function:: bool CvRTrees::train( const Mat& trainData, int tflag, const Mat& responses, const Mat& varIdx=Mat(), const Mat& sampleIdx=Mat(), const Mat& varType=Mat(), const Mat& missingDataMask=Mat(), CvRTParams params=CvRTParams() ) .. ocv:function:: bool CvRTrees::train( const Mat& trainData, int tflag, const Mat& responses, const Mat& varIdx=Mat(), const Mat& sampleIdx=Mat(), const Mat& varType=Mat(), const Mat& missingDataMask=Mat(), CvRTParams params=CvRTParams() )
.. ocv:function::bool CvRTrees::train( const CvMat* trainData, int tflag, const CvMat* responses, const CvMat* varIdx=0, const CvMat* sampleIdx=0, const CvMat* varType=0, const CvMat* missingDataMask=0, CvRTParams params=CvRTParams() ) .. ocv:function:: bool CvRTrees::train( const CvMat* trainData, int tflag, const CvMat* responses, const CvMat* varIdx=0, const CvMat* sampleIdx=0, const CvMat* varType=0, const CvMat* missingDataMask=0, CvRTParams params=CvRTParams() )
.. ocv:function::bool CvRTrees::train( CvMLData* data, CvRTParams params=CvRTParams() ) .. ocv:function:: bool CvRTrees::train( CvMLData* data, CvRTParams params=CvRTParams() )
.. ocv:pyfunction:: cv2.RTrees.train(trainData, tflag, responses[, varIdx[, sampleIdx[, varType[, missingDataMask[, params]]]]]) -> retval .. ocv:pyfunction:: cv2.RTrees.train(trainData, tflag, responses[, varIdx[, sampleIdx[, varType[, missingDataMask[, params]]]]]) -> retval
...@@ -112,7 +112,7 @@ Predicts the output for an input sample. ...@@ -112,7 +112,7 @@ Predicts the output for an input sample.
.. ocv:function:: double CvRTrees::predict( const Mat& sample, const Mat& missing=Mat() ) const .. ocv:function:: double CvRTrees::predict( const Mat& sample, const Mat& missing=Mat() ) const
.. ocv:function::float CvRTrees::predict( const CvMat* sample, const CvMat* missing = 0 ) const .. ocv:function:: float CvRTrees::predict( const CvMat* sample, const CvMat* missing = 0 ) const
.. ocv:pyfunction:: cv2.RTrees.predict(sample[, missing]) -> retval .. ocv:pyfunction:: cv2.RTrees.predict(sample[, missing]) -> retval
...@@ -129,7 +129,7 @@ Returns a fuzzy-predicted class label. ...@@ -129,7 +129,7 @@ Returns a fuzzy-predicted class label.
.. ocv:function:: float CvRTrees::predict_prob( const cv::Mat& sample, const cv::Mat& missing = cv::Mat() ) const .. ocv:function:: float CvRTrees::predict_prob( const cv::Mat& sample, const cv::Mat& missing = cv::Mat() ) const
.. ocv:function::float CvRTrees::predict_prob( const CvMat* sample, const CvMat* missing = 0 ) const .. ocv:function:: float CvRTrees::predict_prob( const CvMat* sample, const CvMat* missing = 0 ) const
.. ocv:pyfunction:: cv2.RTrees.predict_prob(sample[, missing]) -> retval .. ocv:pyfunction:: cv2.RTrees.predict_prob(sample[, missing]) -> retval
...@@ -146,7 +146,7 @@ Returns the variable importance array. ...@@ -146,7 +146,7 @@ Returns the variable importance array.
.. ocv:function:: Mat CvRTrees::getVarImportance() .. ocv:function:: Mat CvRTrees::getVarImportance()
.. ocv:function::const CvMat* CvRTrees::get_var_importance() .. ocv:function:: const CvMat* CvRTrees::get_var_importance()
.. ocv:pyfunction:: cv2.RTrees.getVarImportance() -> importanceVector .. ocv:pyfunction:: cv2.RTrees.getVarImportance() -> importanceVector
...@@ -157,7 +157,7 @@ CvRTrees::get_proximity ...@@ -157,7 +157,7 @@ CvRTrees::get_proximity
----------------------- -----------------------
Retrieves the proximity measure between two training samples. Retrieves the proximity measure between two training samples.
.. ocv:function::float CvRTrees::get_proximity( const CvMat* sample1, const CvMat* sample2, const CvMat* missing1 = 0, const CvMat* missing2 = 0 ) const .. ocv:function:: float CvRTrees::get_proximity( const CvMat* sample1, const CvMat* sample2, const CvMat* missing1 = 0, const CvMat* missing2 = 0 ) const
:param sample_1: The first sample. :param sample_1: The first sample.
...@@ -173,7 +173,7 @@ CvRTrees::calc_error ...@@ -173,7 +173,7 @@ CvRTrees::calc_error
-------------------- --------------------
Returns error of the random forest. Returns error of the random forest.
.. ocv:function::float CvRTrees::calc_error( CvMLData* data, int type, std::vector<float> *resp = 0 ) .. ocv:function:: float CvRTrees::calc_error( CvMLData* data, int type, std::vector<float> *resp = 0 )
The method is identical to :ocv:func:`CvDTree::calc_error` but uses the random forest as predictor. The method is identical to :ocv:func:`CvDTree::calc_error` but uses the random forest as predictor.
...@@ -191,7 +191,7 @@ CvRTrees::get_rng ...@@ -191,7 +191,7 @@ CvRTrees::get_rng
----------------- -----------------
Returns the state of the used random number generator. Returns the state of the used random number generator.
.. ocv:function::CvRNG* CvRTrees::get_rng() .. ocv:function:: CvRNG* CvRTrees::get_rng()
CvRTrees::get_tree_count CvRTrees::get_tree_count
......
modules/ml/doc/statistical_models.rst
View file @ d3b14b71
...@@ -120,7 +120,7 @@ Reads the model from the file storage. ...@@ -120,7 +120,7 @@ Reads the model from the file storage.
.. ocv:function:: void CvStatModel::read( CvFileStorage* storage, CvFileNode* node ) .. ocv:function:: void CvStatModel::read( CvFileStorage* storage, CvFileNode* node )
The method ``read`` restores the complete model state from the specified node of the file storage. Use the function The method ``read`` restores the complete model state from the specified node of the file storage. Use the function
:ocv:func:`GetFileNodeByName` to locate the node. :ocv:cfunc:`GetFileNodeByName` to locate the node.
The previous model state is cleared by :ocv:func:`CvStatModel::clear`. The previous model state is cleared by :ocv:func:`CvStatModel::clear`.
......
modules/ml/doc/support_vector_machines.rst
View file @ d3b14b71
...@@ -158,7 +158,7 @@ Default and training constructors. ...@@ -158,7 +158,7 @@ Default and training constructors.
.. ocv:function:: CvSVM::CvSVM( const Mat& trainData, const Mat& responses, const Mat& varIdx=Mat(), const Mat& sampleIdx=Mat(), CvSVMParams params=CvSVMParams() ) .. ocv:function:: CvSVM::CvSVM( const Mat& trainData, const Mat& responses, const Mat& varIdx=Mat(), const Mat& sampleIdx=Mat(), CvSVMParams params=CvSVMParams() )
.. ocv:function::CvSVM::CvSVM( const CvMat* trainData, const CvMat* responses, const CvMat* varIdx=0, const CvMat* sampleIdx=0, CvSVMParams params=CvSVMParams() ) .. ocv:function:: CvSVM::CvSVM( const CvMat* trainData, const CvMat* responses, const CvMat* varIdx=0, const CvMat* sampleIdx=0, CvSVMParams params=CvSVMParams() )
.. ocv:pyfunction:: cv2.SVM(trainData, responses[, varIdx[, sampleIdx[, params]]]) -> <SVM object> .. ocv:pyfunction:: cv2.SVM(trainData, responses[, varIdx[, sampleIdx[, params]]]) -> <SVM object>
...@@ -170,7 +170,7 @@ Trains an SVM. ...@@ -170,7 +170,7 @@ Trains an SVM.
.. ocv:function:: bool CvSVM::train( const Mat& trainData, const Mat& responses, const Mat& varIdx=Mat(), const Mat& sampleIdx=Mat(), CvSVMParams params=CvSVMParams() ) .. ocv:function:: bool CvSVM::train( const Mat& trainData, const Mat& responses, const Mat& varIdx=Mat(), const Mat& sampleIdx=Mat(), CvSVMParams params=CvSVMParams() )
.. ocv:function::bool CvSVM::train( const CvMat* trainData, const CvMat* responses, const CvMat* varIdx=0, const CvMat* sampleIdx=0, CvSVMParams params=CvSVMParams() ) .. ocv:function:: bool CvSVM::train( const CvMat* trainData, const CvMat* responses, const CvMat* varIdx=0, const CvMat* sampleIdx=0, CvSVMParams params=CvSVMParams() )
.. ocv:pyfunction:: cv2.SVM.train(trainData, responses[, varIdx[, sampleIdx[, params]]]) -> retval .. ocv:pyfunction:: cv2.SVM.train(trainData, responses[, varIdx[, sampleIdx[, params]]]) -> retval
...@@ -194,7 +194,7 @@ Trains an SVM with optimal parameters. ...@@ -194,7 +194,7 @@ Trains an SVM with optimal parameters.
.. ocv:function:: bool CvSVM::train_auto( const Mat& trainData, const Mat& responses, const Mat& varIdx, const Mat& sampleIdx, CvSVMParams params, int k_fold = 10, CvParamGrid Cgrid = CvSVM::get_default_grid(CvSVM::C), CvParamGrid gammaGrid = CvSVM::get_default_grid(CvSVM::GAMMA), CvParamGrid pGrid = CvSVM::get_default_grid(CvSVM::P), CvParamGrid nuGrid = CvSVM::get_default_grid(CvSVM::NU), CvParamGrid coeffGrid = CvSVM::get_default_grid(CvSVM::COEF), CvParamGrid degreeGrid = CvSVM::get_default_grid(CvSVM::DEGREE), bool balanced=false) .. ocv:function:: bool CvSVM::train_auto( const Mat& trainData, const Mat& responses, const Mat& varIdx, const Mat& sampleIdx, CvSVMParams params, int k_fold = 10, CvParamGrid Cgrid = CvSVM::get_default_grid(CvSVM::C), CvParamGrid gammaGrid = CvSVM::get_default_grid(CvSVM::GAMMA), CvParamGrid pGrid = CvSVM::get_default_grid(CvSVM::P), CvParamGrid nuGrid = CvSVM::get_default_grid(CvSVM::NU), CvParamGrid coeffGrid = CvSVM::get_default_grid(CvSVM::COEF), CvParamGrid degreeGrid = CvSVM::get_default_grid(CvSVM::DEGREE), bool balanced=false)
.. ocv:function::bool CvSVM::train_auto( const CvMat* trainData, const CvMat* responses, const CvMat* varIdx, const CvMat* sampleIdx, CvSVMParams params, int kfold = 10, CvParamGrid Cgrid = get_default_grid(CvSVM::C), CvParamGrid gammaGrid = get_default_grid(CvSVM::GAMMA), CvParamGrid pGrid = get_default_grid(CvSVM::P), CvParamGrid nuGrid = get_default_grid(CvSVM::NU), CvParamGrid coeffGrid = get_default_grid(CvSVM::COEF), CvParamGrid degreeGrid = get_default_grid(CvSVM::DEGREE), bool balanced=false ) .. ocv:function:: bool CvSVM::train_auto( const CvMat* trainData, const CvMat* responses, const CvMat* varIdx, const CvMat* sampleIdx, CvSVMParams params, int kfold = 10, CvParamGrid Cgrid = get_default_grid(CvSVM::C), CvParamGrid gammaGrid = get_default_grid(CvSVM::GAMMA), CvParamGrid pGrid = get_default_grid(CvSVM::P), CvParamGrid nuGrid = get_default_grid(CvSVM::NU), CvParamGrid coeffGrid = get_default_grid(CvSVM::COEF), CvParamGrid degreeGrid = get_default_grid(CvSVM::DEGREE), bool balanced=false )
.. ocv:pyfunction:: cv2.SVM.train_auto(trainData, responses, varIdx, sampleIdx, params[, k_fold[, Cgrid[, gammaGrid[, pGrid[, nuGrid[, coeffGrid[, degreeGrid[, balanced]]]]]]]]) -> retval .. ocv:pyfunction:: cv2.SVM.train_auto(trainData, responses, varIdx, sampleIdx, params[, k_fold[, Cgrid[, gammaGrid[, pGrid[, nuGrid[, coeffGrid[, degreeGrid[, balanced]]]]]]]]) -> retval
...@@ -226,9 +226,9 @@ Predicts the response for input sample(s). ...@@ -226,9 +226,9 @@ Predicts the response for input sample(s).
.. ocv:function:: float CvSVM::predict( const Mat& sample, bool returnDFVal=false ) const .. ocv:function:: float CvSVM::predict( const Mat& sample, bool returnDFVal=false ) const
.. ocv:function::float CvSVM::predict( const CvMat* sample, bool returnDFVal=false ) const .. ocv:function:: float CvSVM::predict( const CvMat* sample, bool returnDFVal=false ) const
.. ocv:function::float CvSVM::predict( const CvMat* samples, CvMat* results ) const .. ocv:function:: float CvSVM::predict( const CvMat* samples, CvMat* results ) const
.. ocv:pyfunction:: cv2.SVM.predict(sample[, returnDFVal]) -> retval .. ocv:pyfunction:: cv2.SVM.predict(sample[, returnDFVal]) -> retval
......
modules/video/doc/motion_analysis_and_object_tracking.rst
View file @ d3b14b71
...@@ -283,7 +283,7 @@ The function calculates a gradient orientation at each pixel ...@@ -283,7 +283,7 @@ The function calculates a gradient orientation at each pixel
\texttt{orientation} (x,y)= \arctan{\frac{d\texttt{mhi}/dy}{d\texttt{mhi}/dx}} \texttt{orientation} (x,y)= \arctan{\frac{d\texttt{mhi}/dy}{d\texttt{mhi}/dx}}
In fact, In fact,
:ocv:func:`fastArctan` and :ocv:func:`fastAtan2` and
:ocv:func:`phase` are used so that the computed angle is measured in degrees and covers the full range 0..360. Also, the ``mask`` is filled to indicate pixels where the computed angle is valid. :ocv:func:`phase` are used so that the computed angle is measured in degrees and covers the full range 0..360. Also, the ``mask`` is filled to indicate pixels where the computed angle is valid.
...@@ -562,7 +562,7 @@ Updates the background model and returns the foreground mask ...@@ -562,7 +562,7 @@ Updates the background model and returns the foreground mask
.. ocv:function:: void BackgroundSubtractorMOG::operator()(InputArray image, OutputArray fgmask, double learningRate=0) .. ocv:function:: void BackgroundSubtractorMOG::operator()(InputArray image, OutputArray fgmask, double learningRate=0)
Parameters are the same as in ``BackgroundSubtractor::operator()`` Parameters are the same as in :ocv:funcx:`BackgroundSubtractor::operator()`
BackgroundSubtractorMOG2 BackgroundSubtractorMOG2
...@@ -573,39 +573,39 @@ Gaussian Mixture-based Backbround/Foreground Segmentation Algorithm. ...@@ -573,39 +573,39 @@ Gaussian Mixture-based Backbround/Foreground Segmentation Algorithm.
Here are important members of the class that control the algorithm, which you can set after constructing the class instance: Here are important members of the class that control the algorithm, which you can set after constructing the class instance:
:ocv:member:: nmixtures .. ocv:member:: int nmixtures
Maximum allowed number of mixture comonents. Actual number is determined dynamically per pixel. Maximum allowed number of mixture comonents. Actual number is determined dynamically per pixel.
:ocv:member:: backgroundRatio .. ocv:member:: float backgroundRatio
Threshold defining whether the component is significant enough to be included into the background model ( corresponds to ``TB=1-cf`` from the paper??which paper??). ``cf=0.1 => TB=0.9`` is default. For ``alpha=0.001``, it means that the mode should exist for approximately 105 frames before it is considered foreground. Threshold defining whether the component is significant enough to be included into the background model ( corresponds to ``TB=1-cf`` from the paper??which paper??). ``cf=0.1 => TB=0.9`` is default. For ``alpha=0.001``, it means that the mode should exist for approximately 105 frames before it is considered foreground.
:ocv:member:: varThresholdGen .. ocv:member:: float varThresholdGen
Threshold for the squared Mahalanobis distance that helps decide when a sample is close to the existing components (corresponds to ``Tg``). If it is not close to any component, a new component is generated. ``3 sigma => Tg=3*3=9`` is default. A smaller ``Tg`` value generates more components. A higher ``Tg`` value may result in a small number of components but they can grow too large. Threshold for the squared Mahalanobis distance that helps decide when a sample is close to the existing components (corresponds to ``Tg``). If it is not close to any component, a new component is generated. ``3 sigma => Tg=3*3=9`` is default. A smaller ``Tg`` value generates more components. A higher ``Tg`` value may result in a small number of components but they can grow too large.
:ocv:member:: fVarInit .. ocv:member:: float fVarInit
Initial variance for the newly generated components. It affects the speed of adaptation. The parameter value is based on your estimate of the typical standard deviation from the images. OpenCV uses 15 as a reasonable value. Initial variance for the newly generated components. It affects the speed of adaptation. The parameter value is based on your estimate of the typical standard deviation from the images. OpenCV uses 15 as a reasonable value.
:ocv:member:: .. ocv:member:: float fVarMin
fVarMin Parameter used to further control the variance. Parameter used to further control the variance.
:ocv:member:: .. ocv:member:: float fVarMax
fVarMax Parameter used to further control the variance. Parameter used to further control the variance.
:ocv:member:: fCT .. ocv:member:: float fCT
Complexity reduction parameter. This parameter defines the number of samples needed to accept to prove the component exists. ``CT=0.05`` is a default value for all the samples. By setting ``CT=0`` you get an algorithm very similar to the standard Stauffer&Grimson algorithm. Complexity reduction parameter. This parameter defines the number of samples needed to accept to prove the component exists. ``CT=0.05`` is a default value for all the samples. By setting ``CT=0`` you get an algorithm very similar to the standard Stauffer&Grimson algorithm.
:param nShadowDetection .. ocv:member:: uchar nShadowDetection
The value for marking shadow pixels in the output foreground mask. Default value is 127. The value for marking shadow pixels in the output foreground mask. Default value is 127.
:param fTau .. ocv:member:: float fTau
Shadow threshold. The shadow is detected if the pixel is a darker version of the background. ``Tau`` is a threshold defining how much darker the shadow can be. ``Tau= 0.5`` means that if a pixel is more than twice darker then it is not shadow. See Prati,Mikic,Trivedi,Cucchiarra, *Detecting Moving Shadows...*, IEEE PAMI,2003. Shadow threshold. The shadow is detected if the pixel is a darker version of the background. ``Tau`` is a threshold defining how much darker the shadow can be. ``Tau= 0.5`` means that if a pixel is more than twice darker then it is not shadow. See Prati,Mikic,Trivedi,Cucchiarra, *Detecting Moving Shadows...*, IEEE PAMI,2003.
...@@ -639,7 +639,7 @@ Updates the background model and computes the foreground mask ...@@ -639,7 +639,7 @@ Updates the background model and computes the foreground mask
.. ocv:function:: void BackgroundSubtractorMOG2::operator()(InputArray image, OutputArray fgmask, double learningRate=-1) .. ocv:function:: void BackgroundSubtractorMOG2::operator()(InputArray image, OutputArray fgmask, double learningRate=-1)
See :ocv:func:`BackgroundSubtractor::operator()`. See :ocv:funcx:`BackgroundSubtractor::operator()`.
BackgroundSubtractorMOG2::getBackgroundImage BackgroundSubtractorMOG2::getBackgroundImage
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment