summaryrefslogtreecommitdiff
path: root/src/Contraction/include/gudhi/Contraction/policies/Contraction_visitor.h
blob: ef670234eaad789854d4d95f485a05455375c818 (plain)
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
/*
 * Contraction_visitor.h
 *
 *  Created on: Feb 13, 2014
 *      Author: dsalinas
 */

#ifndef GUDHI_CONTRACTION_VISITOR_H_
#define GUDHI_CONTRACTION_VISITOR_H_

#include "gudhi/Contraction/Edge_profile.h"
#include "boost/optional.hpp"

namespace Gudhi{

namespace contraction {

/**
 *@class Contraction_visitor
 *@brief Interface for a visitor of the edge contraction process.
 */
template <typename EdgeProfile>
class Contraction_visitor {//: public Dummy_complex_visitor<typename EdgeProfile::Vertex_handle>  {
public:
	//typedef typename ComplexType::GeometryTrait GT;
	typedef EdgeProfile Profile;
	typedef double FT;
	typedef typename Profile::Complex Complex;
	typedef Complex ComplexType;
	typedef typename ComplexType::Point Point;


	virtual ~Contraction_visitor(){};

	/**
	 * @brief Called before the edge contraction process starts.
	 */
	virtual void on_started (ComplexType & complex){}

	/**
	 * @brief Called when the StopPredicate returned true (but not if the algorithm terminates because the surface could not be simplified any further).
	 */
	virtual void on_stop_condition_reached (const Profile &profile){}


	/**
	 * @brief Called during the collecting phase (when a cost is assigned to the edges), for each edge collected.
	 */
	virtual void on_collected (const Profile &profile, boost::optional< FT > cost){}

	/**
	 * @brief Called during the processing phase (when edges are contracted), for each edge that is selected.
	 */
	virtual void on_selected (const Profile &profile, boost::optional< FT > cost, int initial_count, int current_count){}


	/**
	 * @brief Called when an edge is about to be contracted and replaced by a vertex whose position is *placement.
	 */
	virtual void on_contracting(const Profile &profile, boost::optional< Point > placement){
	}

	/**
	 * @brief Called when after an edge has been contracted onto a new point placement.
	 * A possibility would to remove popable blockers at this point for instance.
	 */
	virtual void on_contracted(const Profile  &profile, boost::optional< Point > placement){

	}


	/**
	 * @brief Called for each selected edge which cannot be contracted because the ValidContractionPredicate is false
	 */
	virtual void on_non_valid(const Profile  &profile){}

};

}  // namespace contraction

}  // namespace GUDHI

#endif /* GUDHI_CONTRACTION_VISITOR_H_ */