Changeset 3f9eba for src/Makefile.am

Timestamp:

Feb 3, 2011, 9:51:19 AM (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:

c9bc2b7

Parents:

1f91f4

git-author:

Frederik Heber <heber@…> (01/01/11 22:27:54)

git-committer:

Frederik Heber <heber@…> (02/03/11 09:51:19)

Message:

New classes for random number generation.

• we use boost::random as a basis. It implements a lot of pseudo-random engines and various distributions. However, everything is templated and there are no base classes to store prototypes of the instances in a map. We need these such that we are able to offer the user at run-time every choice possible.
• Hence, we need to encapsulate all engines, distributions and (engine, distribution) tuples: RandomNumber..._Encapsulation classes.
• each with an abstract base class as the interface: RandomNumber... classes.
• RandomNumberGeneratorFactory is then a singleton that contains all the Maps and tables:
  • from string (user input is string) to enum (storing enum is more efficient that a lengthy string)
  • from enum to instance (of the abstract class).
• RandomNumberGeneratorFactory is a singleton to allow for global control of what kind of numbers are generated, hence there are also two new Actions:
  • SetRandomNumbersDistributionAction
  • SetRandomNumbersEngineAction to specify which (engine,distribution) tuple to use. There are two new regression tests for these Actions.
• The user in the end only uses two classes: RandomNumberGeneratorFactory and RandomNumberGenerator. The first only for obtaining a specific variant of the latter and the latter to generate the numbers (operator() is passed on to boost::variate_generator::operator()).
• There is a unit test on the RandomNumberGeneratorFactory that checks some of the table entries and whether one of the RandomNumberGenerator is working (uniform_smallint so far).

Details:

• As there are ~25 engines and ~15 distributions this makes an enormous amount of possible combinations. To automatically construct these, we use some stuff from boost::preprocessor in order to generate enums, tables and maps automatically just from a sequence of the typenames.
• we have be-friended the unit test a lot to allow for easier testing, e.g. we need access to internal ..._type to test whether their type is correct.
• cleanUp() purges the instance of RandomNumberGeneratorFactory.
• in RandomNumber..._Encapsulation::name() functions are only used for the unit tests.
• this all resides in its own subfolder RandomNumbers. So far, it is completely independent of everything else.

File:

• src/Makefile.am (modified) (3 diffs)

src/Makefile.am

@@ -121 +121 @@
   Descriptors/MoleculePtrDescriptor_impl.hpp \
   Descriptors/MoleculeSelectionDescriptor_impl.hpp
+
+RANDOMSOURCE = \
+        RandomNumbers/RandomNumberGeneratorFactory.cpp
+
+RANDOMHEADER = \
+        RandomNumbers/RandomNumberGenerator.hpp \
+        RandomNumbers/TemplatePowerSetGenerator.hpp \
+        RandomNumbers/RandomNumberGenerator_Encapsulation.hpp \
+        RandomNumbers/RandomNumberGeneratorFactory.hpp
   
 THERMOSTATSOURCE = \
@@ -166 +175 @@
   ${ACTIONSSOURCE} \
   ${ATOMSOURCE} \
-  ${PATTERNSOURCE} \
-  ${SHAPESOURCE} \
   ${DESCRIPTORSOURCE} \
+  ${RANDOMSOURCE} \
   ${THERMOSTATSOURCE} \
   ${TESSELATIONSOURCE} \
@@ -203 +211 @@
   ${ACTIONSHEADER} \
   ${ATOMHEADER} \
-  ${PATTERNHEADER} \
-  ${SHAPEHEADER} \
   ${DESCRIPTORHEADER} \
   ${DESCRIPTORIMPLHEADER} \
+  ${RANDOMSOURCE} \
   ${THERMOSTATHEADER} \
   ${TESSELATIONHEADER} \