source: src/Actions/Reaction.hpp@ c09f94

Action_Thermostats Add_AtomRandomPerturbation Add_FitFragmentPartialChargesAction Add_RotateAroundBondAction Add_SelectAtomByNameAction Added_ParseSaveFragmentResults AddingActions_SaveParseParticleParameters Adding_Graph_to_ChangeBondActions Adding_MD_integration_tests Adding_ParticleName_to_Atom Adding_StructOpt_integration_tests AtomFragments Automaking_mpqc_open AutomationFragmentation_failures Candidate_v1.5.4 Candidate_v1.6.0 Candidate_v1.6.1 ChangeBugEmailaddress ChangingTestPorts ChemicalSpaceEvaluator CombiningParticlePotentialParsing Combining_Subpackages Debian_Package_split Debian_package_split_molecuildergui_only Disabling_MemDebug Docu_Python_wait EmpiricalPotential_contain_HomologyGraph EmpiricalPotential_contain_HomologyGraph_documentation Enable_parallel_make_install Enhance_userguide Enhanced_StructuralOptimization Enhanced_StructuralOptimization_continued Example_ManyWaysToTranslateAtom Exclude_Hydrogens_annealWithBondGraph FitPartialCharges_GlobalError Fix_BoundInBox_CenterInBox_MoleculeActions Fix_ChargeSampling_PBC Fix_ChronosMutex Fix_FitPartialCharges Fix_FitPotential_needs_atomicnumbers Fix_ForceAnnealing Fix_IndependentFragmentGrids Fix_ParseParticles Fix_ParseParticles_split_forward_backward_Actions Fix_PopActions Fix_QtFragmentList_sorted_selection Fix_Restrictedkeyset_FragmentMolecule Fix_StatusMsg Fix_StepWorldTime_single_argument Fix_Verbose_Codepatterns Fix_fitting_potentials Fixes ForceAnnealing_goodresults ForceAnnealing_oldresults ForceAnnealing_tocheck ForceAnnealing_with_BondGraph ForceAnnealing_with_BondGraph_continued ForceAnnealing_with_BondGraph_continued_betteresults ForceAnnealing_with_BondGraph_contraction-expansion FragmentAction_writes_AtomFragments FragmentMolecule_checks_bonddegrees GeometryObjects Gui_Fixes Gui_displays_atomic_force_velocity ImplicitCharges IndependentFragmentGrids IndependentFragmentGrids_IndividualZeroInstances IndependentFragmentGrids_IntegrationTest IndependentFragmentGrids_Sole_NN_Calculation JobMarket_RobustOnKillsSegFaults JobMarket_StableWorkerPool JobMarket_unresolvable_hostname_fix MoreRobust_FragmentAutomation ODR_violation_mpqc_open PartialCharges_OrthogonalSummation PdbParser_setsAtomName PythonUI_with_named_parameters QtGui_reactivate_TimeChanged_changes Recreated_GuiChecks Rewrite_FitPartialCharges RotateToPrincipalAxisSystem_UndoRedo SaturateAtoms_findBestMatching SaturateAtoms_singleDegree StoppableMakroAction Subpackage_CodePatterns Subpackage_JobMarket Subpackage_LinearAlgebra Subpackage_levmar Subpackage_mpqc_open Subpackage_vmg Switchable_LogView ThirdParty_MPQC_rebuilt_buildsystem TrajectoryDependenant_MaxOrder TremoloParser_IncreasedPrecision TremoloParser_MultipleTimesteps TremoloParser_setsAtomName Ubuntu_1604_changes stable
Last change on this file since c09f94 was af5384, checked in by Frederik Heber <heber@…>, 11 years ago

Actions can now clone() and split off prepare() from call().

  • ActionQueue now separates call phase into clone(), prepare(), and call().
  • ActionQueue's dstor releases Actions in deque.
  • CurrentAction is an index as push_back always invalidates iterator.
  • ActionQueue_t is now a simple vector of ptrs.
  • call() is now non-interactive, (maybe) interactive part is placed in prepare() where dialogs are used to fill parameters.
  • only fully prepared Actions are placed in ActionQueue.
  • ActionQueue obtains action instances from Registry, copies, prepares them, and places them in the queue.
  • Action::clone() gets QueryOptions as param. This lets us either clone without params or really copy the instance.
  • If action is called as COMMAND, params have been filled already.
  • Reactions require a ActionQueue::getLastAction() to actually obtain result of (cloned) Action.
  • FIX: Calculation now has const has...() and getResult().
  • Property mode set to 100644
File size: 2.1 KB
Line 
1/*
2 * Reaction.hpp
3 *
4 * Created on: Oct 13, 2011
5 * Author: heber
6 */
7
8#ifndef REACTION_HPP_
9#define REACTION_HPP_
10
11// include config.h
12#ifdef HAVE_CONFIG_H
13#include <config.h>
14#endif
15
16
17#include "Actions/Action.hpp"
18
19namespace MoleCuilder {
20
21/**
22 * A Reaction is an Action with a return value that is set during the call and may be
23 * inspected afterwards.
24 *
25 * This class can be used in the same way as any other Action, but has some special methods
26 * for inspecting the result of the calculation.
27 */
28template<typename T>
29class Reaction : public Action
30{
31public:
32 Reaction(const ActionTrait &_trait);
33 virtual ~Reaction();
34
35 /**
36 * Reimplemented call method for Action Base class.
37 * Resets the result and then redoes the calculation. Can be used to retrigger calculations
38 * from menu Items or other places.
39 */
40 virtual bool canUndo();
41 virtual bool shouldUndo();
42
43 virtual Action* clone(enum QueryOptions flag = Interactive) const=0;
44
45 virtual void outputAsCLI(std::ostream &ost) const;
46 virtual void outputAsPython(std::ostream &ost, const std::string &prefix) const;
47
48 /**
49 * Does the actual calculation and returns the result.
50 * When the calculation has been done before it is not redone, but the previous cached result is returned.
51 * Call reset to delete the cached value.
52 */
53 virtual T operator()();
54
55 /**
56 * Check if a cached result is available.
57 */
58 virtual bool hasResult() const;
59
60 /**
61 * Get the cached result.
62 * Fails if there is no cached result.
63 */
64 virtual T getResult() const;
65
66 /**
67 * Delete a previously calculated result from the cache.
68 */
69 virtual void reset();
70
71protected:
72 virtual Dialog *fillDialog(Dialog *dialog)=0;
73
74protected:
75 //!> result of the calculation
76 T* result;
77
78 /**
79 * Pure virtual method for implementation of the actual calculation procedure.
80 */
81 virtual T* doCalc()=0;
82private:
83 virtual ActionState::ptr performCall();
84 virtual ActionState::ptr performUndo(ActionState::ptr);
85 virtual ActionState::ptr performRedo(ActionState::ptr);
86
87 //!> states whether result is done or not (i.e. \a result contains valid result
88 bool done;
89};
90
91}
92
93#endif /* REACTION_HPP_ */
Note: See TracBrowser for help on using the repository browser.