/usr/include/visp/vpMomentCentered.h is in libvisp-dev 2.9.0-3+b2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 | /****************************************************************************
*
* $Id: vpMomentCentered.h 4574 2014-01-09 08:48:51Z fspindle $
*
* This file is part of the ViSP software.
* Copyright (C) 2005 - 2014 by INRIA. All rights reserved.
*
* This software is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* ("GPL") version 2 as published by the Free Software Foundation.
* See the file LICENSE.txt at the root directory of this source
* distribution for additional information about the GNU GPL.
*
* For using ViSP with software that can not be combined with the GNU
* GPL, please contact INRIA about acquiring a ViSP Professional
* Edition License.
*
* See http://www.irisa.fr/lagadic/visp/visp.html for more information.
*
* This software was developed at:
* INRIA Rennes - Bretagne Atlantique
* Campus Universitaire de Beaulieu
* 35042 Rennes Cedex
* France
* http://www.irisa.fr/lagadic
*
* If you have questions regarding the use of this file, please contact
* INRIA at visp@inria.fr
*
* This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
* WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
*
*
* Description:
* Centered moment descriptor
*
* Authors:
* Filip Novotny
*
*****************************************************************************/
#ifndef __MOMENTCENTERED_H__
#define __MOMENTCENTERED_H__
#include <visp/vpMoment.h>
/*!
\file vpMomentCentered.h
\brief Centered moment descriptor (also refered to as \f$\mu_{ij}\f$).
*/
class vpMomentObject;
/*!
\class vpMomentCentered
\ingroup TrackingMoments
\brief This class defines the double-indexed centered moment descriptor \f$\mu_{ij}\f$.
In the case of a dense object \e O, centered moments are defined by:
\f[\mu_{ij}= \int \int_{O} (x_k-x_g)^j (y_k-y_g)^j\f]
In the case of a discrete set of \e n points, centered moments are defined by:
\f[\mu_{ij}= \sum_{k=1}^{n} (x_k-x_g)^j (y_k-y_g)^j\f]
where \f$(x_g,y_g)\f$ are the coordinates of the center of gravity.
The centered moments are computed from the object at the highest possible order.
For example if the vpMomentObject is defined up to order 5, vpMomentCentered will be too.
Values of vpMomentCentered may be accessed by one of the two vpMomentCentered::get methods.
When using vpMomentCentered::get (), the format of the return vector is the following:
\f$ \mu_{ij} \f$ is stored at vpMomentCentered::get ()[j* (vpMomentObject::getOrder () +1)+i]
vpMomentCentered depends on vpMomentGravityCenter.
*/
class VISP_EXPORT vpMomentCentered : public vpMoment {
public:
vpMomentCentered();
void compute();
double get(unsigned int i,unsigned int j) const;
inline const std::vector<double>& get() const;
/*!
Moment name.
*/
inline const char* name() const {return "vpMomentCentered";}
friend VISP_EXPORT std::ostream & operator<<(std::ostream & os, vpMomentCentered& v);
protected:
void set(unsigned int i, unsigned int j, double value);
};
/*!
Returns all centered moment values \f$\mu_{ij}\f$ with \f$i+j \leq order\f$ where order is the object's order.
\return Vector of moment values. To access \f$\mu_{ij}\f$, you have to read vpMomentObject::get()[j*order+i].
For example, if the maximal order is 3, the following values are provided:
\code
u00 u10 u20 u01 u11 u21 u02 u12 u12 u30 u03
\endcode
To have a better reading of the moments you can picture them as a triangular matrix:
\code
u00 u10 u20 u30
u01 u11 u21 x
u02 u12 x x
u30 x x x
\endcode
The moments of the same order are on each of the matrix reverse diagonals.
To access for example to the centered moment \f$\mu_{12}\f$, you should use this kind of code:
\code
vpMomentCentered mc;
//[...]
mc.compute();
double mu12;
mu12 = mc.get()[2*(obj.getOrder()+1)+1]; // i=1 and j=2
mu12 = mc.get(1,2); // the same
\endcode
*/
inline const std::vector<double>& vpMomentCentered::get() const
{
return vpMoment::get();
}
#endif
|