AbstractTrajectoryInterp.h
Go to the documentation of this file.
1 /* Copyright (C) 2008 National Institute For Space Research (INPE) - Brazil.
2 
3  This file is part of the TerraLib - a Framework for building GIS enabled applications.
4 
5  TerraLib is free software: you can redistribute it and/or modify
6  it under the terms of the GNU Lesser General Public License as published by
7  the Free Software Foundation, either version 3 of the License,
8  or (at your option) any later version.
9 
10  TerraLib is distributed in the hope that it will be useful,
11  but WITHOUT ANY WARRANTY; without even the implied warranty of
12  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13  GNU Lesser General Public License for more details.
14 
15  You should have received a copy of the GNU Lesser General Public License
16  along with TerraLib. See COPYING. If not, write to
17  TerraLib Team at <terralib-team@terralib.org>.
18  */
19 
20 /*!
21  \file AbstractTrajectoryInterp.h
22 
23  \brief This file contains an abstract class for interpolation function
24  or interpolator that estimate geometries at non-observed times
25  of a trajectory.
26 */
27 
28 #ifndef __TERRALIB_ST_INTERNAL_ABSTRACTTRAJECTORYINTERP_H
29 #define __TERRALIB_ST_INTERNAL_ABSTRACTTRAJECTORYINTERP_H
30 
31 // ST
32 #include "../../Config.h"
33 
34 //STL
35 #include <memory>
36 
37 // Forward declarations
38 namespace te { namespace dt { class DateTime; } }
39 namespace te { namespace gm { class Geometry; } }
40 namespace te { namespace common { class AbstractParameters; } }
41 
42 namespace te
43 {
44  namespace st
45  {
46  // Forward declarations
47  class Trajectory;
48 
49  /*!
50  \class AbstractTrajectoryInterp
51 
52  \brief An abstract class for an interpolation function or interpolator
53  that estimates geometries at non-observed times of a trajectory.
54 
55  This is an abstract class for every class that implements
56  interpolation functions that estimate geometries at non-observaved times
57  of a trajectory.
58 
59  \ingroup st
60 
61  \sa Trajectory
62  */
64  {
65 
66  public:
67 
68  /*!
69  \brief It gets the parameters associated to the interpolator.
70 
71  \return It returns the parameters associated to the interpolator.
72 
73  \note The caller will not take the ownership of the returned pointer.
74  */
75  virtual te::common::AbstractParameters* getParams() = 0;
76 
77  /*!
78  \brief It sets the parameters associated to the interpolator.
79 
80  \param p The parameters to be associated to the interpolator.
81 
82  \note It will take the ownership of the given pointer.
83  */
84  virtual void setParams(te::common::AbstractParameters* p) = 0;
85 
86  /*!
87  \brief It estimates a geometry of a trajectory at a given non-observed time .
88 
89  \param tj A trajectory used in the estimation.
90  \param time The given non-observed time.
91 
92  \return The estimated geometry.
93 
94  \note It will NOT take the ownership of the given pointer.
95  \note The caller will take the ownership of the output Geometry pointer.
96  */
97  virtual std::auto_ptr<te::gm::Geometry> estimate(const Trajectory& tj, te::dt::DateTime* time) const = 0;
98 
99  /*! \brief Virtual destructor. */
100  virtual ~AbstractTrajectoryInterp();
101 
102  protected:
103 
104  /*! \brief Constructor. */
106  };
107 
108  } // end namespace st
109 } // end namespace te
110 
111 #endif // __TERRALIB_ST_INTERNAL_ABSTRACTTRAJECTORYINTERP_H
112 
#define TESTEXPORT
You can use this macro in order to export/import classes and functions from this module.
Definition: Config.h:88
An abstract class for an interpolation function or interpolator that estimates geometries at non-obse...
URI C++ Library.
Abstract parameters base interface.
A class to represent trajectory.
Definition: Trajectory.h:75