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 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225
|
/*****************************************************************************
* $CAMITK_LICENCE_BEGIN$
*
* CamiTK - Computer Assisted Medical Intervention ToolKit
* (c) 2001-2018 Univ. Grenoble Alpes, CNRS, TIMC-IMAG UMR 5525 (GMCAO)
*
* Visit http://camitk.imag.fr for more information
*
* This file is part of CamiTK.
*
* CamiTK is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License version 3
* only, as published by the Free Software Foundation.
*
* CamiTK is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License version 3 for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* version 3 along with CamiTK. If not, see <http://www.gnu.org/licenses/>.
*
* $CAMITK_LICENCE_END$
****************************************************************************/
#ifndef MANAGER_MONITORINGMANAGER_H
#define MANAGER_MONITORINGMANAGER_H
#include <memory> // std::auto_ptr
#include <vector>
#include <PhysicalModel.h>
#include <Loads.h>
#include <MonitorIn.hxx>
#include <MonitorOut.hxx>
class Monitor;
class Simulator;
#include "MMLAPI.h"
/**
* @ingroup group_cepmodeling_libraries_mml
*
* @brief
* Manager of the benchmark tests.
* Do simulation loop and tests
*
**/
class MML_API MonitoringManager {
public:
/**
* constructor
*@param mml mml file name
*@param sim simulator name (Sofa, Ansys...)
*/
MonitoringManager(const char* mml);
/// destructor
virtual ~MonitoringManager();
/** Initialize manager
* @return false if initialisation faild
*/
virtual bool init() = 0;
/// End manager
virtual void end() = 0;
/// perform simulation loop, make tests and save monitors' data into output file
void simulate();
/// Do one step of simulation and save monitors for this step
virtual void doMove() = 0;
/// Check if simulation is finished
virtual bool checkStop() = 0;
/// Rewind simulation
void rewind();
/** reload simulation with current parameters
* @param delPml true if pml object have to be deleted (perhaps used by others: physicalModel component...)
*/
void reload(bool delPml = true);
/// Save save monitors' state for the current time
void saveMonitors();
/// Write all saved monitors' states into mmlOut file
void writeOutput(const char* fileName);
/// Write all saved monitors'state into csv file
void writeCsv(const char* fileName);
/// save current version of mml in
void saveMmlIn(const char* fileName);
/// @name accessors for simulation parameters
///@{
double getDt();
double getRefresh();
double getCurrentTime();
double getCurrentStep();
double getStepComputingTime();
double getComputingTime();
PhysicalModel* getInitPml();
PhysicalModel* getPml();
/** This is nearly the same as getPml(), but it also transfers ownership of the pointer.
* After this method is called, this instance of MonitoringManager will not delete the pml.
* It is then the responsability of the caller (the instance which is taking ownership of the PhysicalModel).
* This is useful when transmitting to PMManagerDC Component for example.
*/
PhysicalModel* takePml();
Loads* getLml();
/** This is nearly the same as getLml(), but it also transfers ownership of the pointer.
* After this method is called, this instance of MonitoringManager will not delete the pml.
* It is then the responsability of the caller (the instance which is taking ownership of the Loads).
* This is useful when transmitting to PMManagerDC's Loads manager for example.
*/
Loads* takeLml();
std::string getPmlFileName();
std::string getLmlFileName();
std::string getMmlFileName();
std::string getmmlFileFolder();
Simulator* getSimulator();
/// get atom position for precedent step
void getOldPosition(double pos[3], unsigned int index);
///@}
///mutators for simulation parameters
void setCurrentTime(double time);
/// store old positions before next step
void storeOldPositions();
/// add dt to current time
void updateCurrentTime();
/// add step computing time to total computing time
void updateComputingTime();
/// increment step by one
void incStep();
///change dt and save modification into mmlIn
void setDt(double dt);
///change refresh and save modification into mmlIn
void setRefresh(double refresh);
///change pml file name and save modification into mmlIn
void setPmlFileName(const char* file);
///change lml file name and save modification into mmlIn
void setLmlFileName(const char* file);
//accessors and mutators for monitors
/// add a monitor to the list
void addMonitor(Monitor* monitor);
/// get a monitor by its index in the list
Monitor* getMonitor(const unsigned int i) const;
/// delete a monitor and remove it from the list using its index
void deleteMonitor(const unsigned int i);
/// get the number of monitors stored in the list
unsigned int numberOfMonitor() const;
/// check if a scn is present instead of pmlFileName
bool isPmlPresent();
/// check if a lml is present
bool isLmlPresent();
protected:
/// Object representing manager in the file generated by xsdcxx, can be used for serialization
std::unique_ptr<mml::MonitoringIn> mmlIn;
/// Vector that contains all monitors
std::vector<Monitor*> monitors;
/// Vector that contains information saved by saveMonitors method
std::vector<mml::TimeStep*> times;
/// integration step
double dt;
/// refreshing step
double refresh;
/// name of the simulator
std::string simulatorName;
/// current step
int step;
/// time at current moment
double currentTime;
/// computing time of last step
double stepComputingTime;
/// total computing time at current moment
double computingTime;
/// the simulator used for simualtion
Simulator* simul;
private:
/// build monitors
void buildMonitors();
/// build the loads if lml file was given
void buildLoads();
/** build physical model and simulator
* @param delPml true if pml object have to be deleted (perhaps used by others: physicalModel component...)
*/
void buildPmlAndSimulator(bool delPml = true);
/// build physical model and simulator from a pml file
void buildPmlAndSimulatorfromPml();
/// build physical model and simulator from a specific simulator file
void buildPmlAndSimulatorfromSimulator();
/// pml at current moment
PhysicalModel* pml;
/// is the pml "own" by this instance, which is the normal case when there are no visual representation. But ownership can also be taken by some other instance, see takePml()
bool ownPml;
/// old position pointer
double* oldPositionPointer;
/// initial pml
PhysicalModel* initPml;
/// Loads applied to pml
Loads* lml;
/// is the lml "own" by this is instance, which is the normal case when there are not visual representation. But ownership can also be taken by some other instance, see takeLml()
bool ownLml;
/// name of the pml file (complete path from working directory)
std::string pmlFileName;
/// name of the lml file (complete path from working directory)
std::string lmlFileName;
/// name of the mml in file (complete path from working directory)
std::string mmlFileName;
/// folder of mml file (complete path from working directory)
std::string mmlFileFolder;
};
#endif // MANAGER_MONITORINGMANAGERF_H
|