Changeset e4afb4 for src/Actions/CommandAction

Timestamp:

Oct 30, 2010, 8:42:44 PM (14 years ago)

Author:

Frederik Heber <heber@…>

Branches:

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

Children:

76cec6, c38826

Parents:

23359f

git-author:

Frederik Heber <heber@…> (10/30/10 19:55:54)

git-committer:

Frederik Heber <heber@…> (10/30/10 20:42:44)

Message:

Huge refactoring: Introduction of Traits to Actions.

This change is really big but the introduction of the Trait concept (at least
in its current light form) is so fundamental that lots of pieces had to be
changed in order to get everything working.

The main point why it was necessary to add these traits in the first place was
to comfortably allow for adding extension of Actions information-wise, i.e.
with stuff that is only important for the QtUI, such as icons, or tooltips, ...
This extra information should not be stored with Action itself, as it has
nothing to do with the workings of the Action. And neither should it get
stored with some blown-out-of-proportions MapOfActions class ...

The gist of the change is as follows:

• OptionTrait contains the token, description, shortform and type of an option, such as ("position", "position in space, none, typeid(Vector)).
• ActionTrait is the derived form for actions where additionally MenuPosition and MenuName are stored (and probably more to come for the GUI), also we have a set of OptionTrait instances, one for each option of the Action.
• Action then contains this ActionTrait, specialized for each Action.
• the preprocessor macros have been enhanced to gather all this information from the .def files.
• MapOfActions is gone. Completely. Most of its use was to store this extra information and the ValueStorage part now is just in class ValueStorage.
• ValueStorage is no more an interface to MapOfActions but as the name says a (type-safe) ValueStorage.

Listing the (remaining) changes in alphabetical order of the class:

• Action
  • member value ::name dropped, ::getName() uses ActionTraits::getName()
  • new define NODEFAULT which is used in paramdefaults in .def files
  • all derived actions classes such as Process, Calculations, MakroAction,... have been adapated to use the ActionTrait concept as well.

• ActionHistory
  • extraced RedoAction and UndoAction, shifted implementation into their own object files and they use .def files as well (i.e. streamlined with method used for other actions)

• CommandLineParser
  • CommandLineParser goes through ActionRegistry to get arguments and types to add
  • we use TypeEnumContainer which before was present in MapOfActions, as CommandLineParser::AddOptionsToParser() needs enums in its switch statement, we can't switch on types and types are not known until run-time. Hence, templates won't do either.
  • ShortFormMap is created here now (and used here only)
  • File was moved over to UIElements/CommandLineUI.

• MenuDescription
  • contain information on Menus such as name, ...
  • new unit test checks for consistency

• molecule
  • const member functions: Copy(), Output() and OutputBonds()

• OptionRegistry
  • new registry class for options only
  • we want the same type throughout the code for each token, e.g. "position"
  • the registry containts checks for consistency

• OptionTrait
  • default values are specified in paramdefaults, none are given by NODEFAULT
  • introduced default for translate-atoms, point-correlation, pair-correlation

• Registry pattern
  • new unit test, but only sceleton code so far

• ...Query, also ...Pipe
  • atoms, molecule and elements are now all const
  • also ValueStorage's signatures all have const therein

• ValueStorage
  • set/queryCurrentValue from MapOfActions
  • at times VectorValue has been in .def files where Vector was in the signature. This is cleared. Such stuff is only present for e.g. BoxVector being queried as a Vector. But this is a feature and intended.

• World
  • most of the (un)selection functions now work on const atoms and molecules
  • in one case we need a const_cast to remove this, but this is intentional, as the vector of selected atoms stores non-const pointers and this is ok.

There is only one test which had to be changed slightly because a specific
option token as "position" must now have the same type everywhere, e.g. always
Vector.

• TESTFIX: Simple_configuration/2: --position -> --domain-position (and associated to BoxVector)

Location:

src/Actions/CommandAction

Files:

• BondLengthTableAction.cpp (modified) (2 diffs)
• BondLengthTableAction.def (modified) (2 diffs)
• ElementDbAction.cpp (modified) (2 diffs)
• ElementDbAction.def (modified) (2 diffs)
• FastParsingAction.cpp (modified) (1 diff)
• FastParsingAction.def (modified) (2 diffs)
• HelpAction.cpp (modified) (2 diffs)
• HelpAction.def (modified) (2 diffs)
• VerboseAction.cpp (modified) (1 diff)
• VerboseAction.def (modified) (2 diffs)
• VersionAction.cpp (modified) (1 diff)
• VersionAction.def (modified) (2 diffs)
• WarrantyAction.cpp (modified) (2 diffs)
• WarrantyAction.def (modified) (2 diffs)

src/Actions/CommandAction/BondLengthTableAction.cpp

@@ -47 +47 @@
   if (configuration->BG == NULL) {
     configuration->BG = new BondGraph(configuration->GetIsAngstroem());
-    if ((!params.BondGraphFileName.empty()) && (configuration->BG->LoadBondLengthTable(params.BondGraphFileName))) {
+    if ((!params.BondGraphFileName.empty()) && (configuration->BG->LoadBondLengthTable(params.BondGraphFileName.string()))) {
       DoLog(0) && (Log() << Verbose(0) << "Bond length table loaded successfully." << endl);
       return Action::success;
@@ -81 +81 @@
   return false;
 }
-
-const string CommandBondLengthTableAction::getName() {
-  return NAME;
-}
 /** =========== end of function ====================== */

src/Actions/CommandAction/BondLengthTableAction.def

@@ -11 +11 @@
 // i.e. there is an integer with variable name Z that can be found in
 // ValueStorage by the token "Z" -> first column: int, Z, "Z"
-// "undefine" if no parameters are required
-#define paramtypes (std::string)
+// "undefine" if no parameters are required, use (NODEFAULT) for each (undefined) default value
+#define paramtypes (boost::filesystem::path)
 #define paramtokens ("bond-table")
-#define paramdescriptions ("setting name of the bond length table file")
+#define paramdescriptions ("name of the bond length table file")
+#undef paramdefaults
 #define paramreferences (BondGraphFileName)
 
@@ -29 +30 @@
 
 // finally the information stored in the ActionTrait specialization
-#undef DEFAULTVALUE
-#define DESCRIPTION "setting name of the bond length table file"
+#define DESCRIPTION "specifying a table file with specific bond lengths to use in bond structure analysis"
 #define SHORTFORM "g"
-#define TYPEINFO &typeid(std::string)

src/Actions/CommandAction/ElementDbAction.cpp

@@ -46 +46 @@
   // TODO: Make databasepath a std::string
   config *configuration = World::getInstance().getConfig();
-  strcpy(configuration->databasepath, params.databasepath.c_str());
+  strcpy(configuration->databasepath, params.databasepath.branch_path().string().c_str());
 
   // load table
@@ -82 +82 @@
   return false;
 }
-
-const string CommandElementDbAction::getName() {
-  return NAME;
-}
 /** =========== end of function ====================== */

src/Actions/CommandAction/ElementDbAction.def

@@ -11 +11 @@
 // i.e. there is an integer with variable name Z that can be found in
 // ValueStorage by the token "Z" -> first column: int, Z, "Z"
-// "undefine" if no parameters are required
-#define paramtypes (std::string)
+// "undefine" if no parameters are required, use (NODEFAULT) for each (undefined) default value
+#define paramtypes (boost::filesystem::path)
 #define paramtokens ("element-db")
-#define paramdescriptions ("setting the path where the element databases can be found")
+#define paramdescriptions ("path where the element databases can be found")
+#undef paramdefaults
 #define paramreferences (databasepath)
 
@@ -29 +30 @@
 
 // finally the information stored in the ActionTrait specialization
-#undef DEFAULTVALUE
-#define DESCRIPTION "setting the path where the element databases can be found"
+#define DESCRIPTION "specify the path to a different element databases"
 #define SHORTFORM "e"
-#define TYPEINFO &typeid(std::string)

src/Actions/CommandAction/FastParsingAction.cpp

@@ -84 +84 @@
   return true;
 }
-
-const string CommandFastParsingAction::getName() {
-  return NAME;
-}
 /** =========== end of function ====================== */

src/Actions/CommandAction/FastParsingAction.def

@@ -11 +11 @@
 // i.e. there is an integer with variable name Z that can be found in
 // ValueStorage by the token "Z" -> first column: int, Z, "Z"
-// "undefine" if no parameters are required
+// "undefine" if no parameters are required, use (NODEFAULT) for each (undefined) default value
 #define paramtypes (bool)
 #define paramtokens ("fastparsing")
 #define paramdescriptions ("setting whether trajectories shall be parsed completely (n) or just first step (y)")
+#undef paramdefaults
 #define paramreferences (fastparsing)
 
@@ -29 +30 @@
 
 // finally the information stored in the ActionTrait specialization
-#define DEFAULTVALUE "0"
 #define DESCRIPTION "setting whether trajectories shall be parsed completely (n) or just first step (y)"
 #define SHORTFORM "n"
-#define TYPEINFO &typeid(bool)

src/Actions/CommandAction/HelpAction.cpp

@@ -19 +19 @@
 
 #include "Helpers/MemDebug.hpp"
-
-#include "CommandLineParser.hpp"
 
 #include <iostream>
@@ -55 +53 @@
   return false;
 }
-
-const string CommandHelpAction::getName() {
-  return NAME;
-}
 /** =========== end of function ====================== */

src/Actions/CommandAction/HelpAction.def

@@ -11 +11 @@
 // i.e. there is an integer with variable name Z that can be found in
 // ValueStorage by the token "Z" -> first column: int, Z, "Z"
-// "undefine" if no parameters are required
+// "undefine" if no parameters are required, use (NODEFAULT) for each (undefined) default value
 #undef paramtypes
 #undef paramtokens
 #undef paramdescriptions
+#undef paramdefaults
 #undef paramreferences
 
@@ -29 +30 @@
 
 // finally the information stored in the ActionTrait specialization
-#undef DEFAULTVALUE
 #define DESCRIPTION "help screen"
 #define SHORTFORM "h"
-#define TYPEINFO &typeid(void)

src/Actions/CommandAction/VerboseAction.cpp

@@ -76 +76 @@
   return true;
 }
-
-const string CommandVerboseAction::getName() {
-  return NAME;
-}
 /** =========== end of function ====================== */

src/Actions/CommandAction/VerboseAction.def

@@ -11 +11 @@
 // i.e. there is an integer with variable name Z that can be found in
 // ValueStorage by the token "Z" -> first column: int, Z, "Z"
-// "undefine" if no parameters are required
+// "undefine" if no parameters are required, use (NODEFAULT) for each (undefined) default value
 #define paramtypes (int)
 #define paramtokens ("verbose")
 #define paramdescriptions ("set verbosity level")
+#undef paramdefaults
 #define paramreferences (verbosity)
 
@@ -29 +30 @@
 
 // finally the information stored in the ActionTrait specialization
-#undef DEFAULTVALUE
 #define DESCRIPTION "set verbosity level"
 #define SHORTFORM "v"
-#define TYPEINFO &typeid(int)

src/Actions/CommandAction/VersionAction.cpp

@@ -55 +55 @@
   return false;
 }
-
-const string CommandVersionAction::getName() {
-  return NAME;
-}
 /** =========== end of function ====================== */

src/Actions/CommandAction/VersionAction.def

@@ -11 +11 @@
 // i.e. there is an integer with variable name Z that can be found in
 // ValueStorage by the token "Z" -> first column: int, Z, "Z"
-// "undefine" if no parameters are required
+// "undefine" if no parameters are required, use (NODEFAULT) for each (undefined) default value
 #undef paramtypes
 #undef paramtokens
 #undef paramdescriptions
+#undef paramdefaults
 #undef paramreferences
 
@@ -29 +30 @@
 
 // finally the information stored in the ActionTrait specialization
-#undef DEFAULTVALUE
 #define DESCRIPTION "show version"
 #define SHORTFORM "V"
-#define TYPEINFO &typeid(void)

src/Actions/CommandAction/WarrantyAction.cpp

@@ -19 +19 @@
 
 #include "Helpers/MemDebug.hpp"
-
-#include "CommandLineParser.hpp"
 
 #include <iostream>
@@ -61 +59 @@
   return false;
 }
-
-const string CommandWarrantyAction::getName() {
-  return NAME;
-}
 /** =========== end of function ====================== */

src/Actions/CommandAction/WarrantyAction.def

@@ -10 +10 @@
 // i.e. there is an integer with variable name Z that can be found in
 // ValueStorage by the token "Z" -> first column: int, Z, "Z"
-// "undefine" if no parameters are required
+// "undefine" if no parameters are required, use (NODEFAULT) for each (undefined) default value
 #undef paramtypes
 #undef paramtokens
 #undef paramdescriptions
+#undef paramdefaults
 #undef paramreferences
 
@@ -28 +29 @@
 
 // finally the information stored in the ActionTrait specialization
-#undef DEFAULTVALUE
 #define DESCRIPTION "statement concerning warranty of the software"
 #undef SHORTFORM
-#define TYPEINFO &typeid(void)