Blob Blame Raw


#ifndef TCG_POLYLINE_OPS
#define TCG_POLYLINE_OPS

// tcg includes
#include "traits.h"
#include "containers_reader.h"
#include "point.h"
#include "point_ops.h"

namespace tcg
{
namespace polyline_ops
{

//**************************************************************************************
//    Polyline Basic Operations
//**************************************************************************************

/*!
  Computes the length of the polyline between the specified point iterators.
  \return   The input polyline's length
*/

template <typename ForIt>
double length(ForIt begin, ForIt end)
{
	typedef typename std::iterator_traits<ForIt>::value_type point_type;

	double result = 0.0;

	for (ForIt jt = begin, it = ++jt; jt != end; it = jt, ++jt)
		result += tcg::point_ops::dist(*it, *jt);

	return result;
}

//-----------------------------------------------------------------------------

/*!
  Computes the area enclosed by the input polyline's \a closure.

  \note    The input polyline is implicitly \a connected at the endpoints
           with a straight segment. This has obviously makes no difference
           if the supplied polyline already had coincident endpoints.

  \return  The area enclosed by the polyline's \a closure.
*/

template <typename ForIt>
double area(ForIt begin, ForIt end)
{
	typedef typename std::iterator_traits<ForIt>::value_type point_type;

	double result = 0.0;

	if (begin != end) {
		ForIt jt = begin, it = jt++;

		for (; jt != end; it = jt++)
			result += 0.5 *
					  (tcg::point_traits<point_type>::y(*jt) + tcg::point_traits<point_type>::y(*it)) *
					  (tcg::point_traits<point_type>::x(*jt) - tcg::point_traits<point_type>::x(*it));

		result += 0.5 *
				  (tcg::point_traits<point_type>::y(*begin) + tcg::point_traits<point_type>::y(*it)) *
				  (tcg::point_traits<point_type>::x(*begin) - tcg::point_traits<point_type>::x(*it));
	}

	return result;
}

//**************************************************************************************
//    Quadratic Conversions
//**************************************************************************************

/*!
  Standard direct conversion function used in polyline-to-quadratics conversion.

  Point a has already been inserted in the output; this function must add the
  remaining part of a sequence of quadratics approximating the triplet (a, *bt, c).
*/

//Note: typename iter_type::value_type == point_type
template <typename point_type, typename iter_type>
void tripletToQuadratics(const point_type &a, const iter_type &bt, const point_type &c,
						 tcg::sequential_reader<std::vector<point_type>> &output)
{
	//Direct conversion
	output.addElement(*bt);
	output.addElement(c);
}

/*!
  Performs a conversion of the specified polyline into a sequence of quadratics, then
  applies a quadratics sub-sequence optimal merging algorithm.

  A user-made local triplet-to-quadratics conversion can be supplied to recognize corners
  or supply a tight starting approximation.

\warning Passed polylines with equal endpoints are interpreted as closed (circular) polylines;
         in this case, the resulting endpoints of the quadratic sequence will be displaced to
         the first segment mid-point.
*/

template <typename iter_type, typename containers_reader, typename toQuadsFunc>
void toQuadratics(iter_type begin, iter_type end, containers_reader &output,
				  toQuadsFunc &toQuads = &tripletToQuadratics<
										 typename iter_type::value_type, iter_type>,
				  double mergeTol = 1.0);

//**************************************************************************************
//    Standard Polyline Evaluators
//**************************************************************************************

/*!
  Calculates the (weighted) standard deviation of a polyline's sub-paths with respect
  to the segment connecting the endpoints.

  \warning For efficiency reasons, the returned value is the actual standard
  deviation, times the endpoints-segment length.
*/

template <typename RanIt>
class StandardDeviationEvaluator
{
public:
	typedef RanIt iterator_type;
	typedef typename std::iterator_traits<RanIt>::difference_type diff_type;
	typedef typename std::iterator_traits<RanIt>::value_type point_type;
	typedef typename tcg::point_traits<point_type>::value_type value_type;
	typedef double penalty_type;

protected:
	iterator_type m_begin, m_end;

	std::vector<double> m_sums_x, m_sums_y;   //!< Sums of the points coordinates
	std::vector<double> m_sums2_x, m_sums2_y; //!< Sums of the points coordinates' squares
	std::vector<double> m_sums_xy;			  //!< Sums of the coordinates products

public:
	StandardDeviationEvaluator(const iterator_type &begin, const iterator_type &end);

	penalty_type penalty(const iterator_type &a, const iterator_type &b);

	const iterator_type &begin() const { return m_begin; }
	const iterator_type &end() const { return m_end; }

	const std::vector<double> &sums_x() const { return m_sums_x; }
	const std::vector<double> &sums_y() const { return m_sums_y; }
	const std::vector<double> &sums2_x() const { return m_sums2_x; }
	const std::vector<double> &sums2_y() const { return m_sums2_y; }
	const std::vector<double> &sums_xy() const { return m_sums_xy; }
};
}
} //namespace tcg::polyline_ops

#ifdef INCLUDE_HPP
#include "hpp/polyline_ops.hpp"
#endif

#endif //TCG_POLYLINE_OPS