Merge pull request #128 from JW-Kraft/review/set-random-seed

Add seed parameter to UseCase

AUTHORS

@@ -23,3 +23,4 @@ Maria C.G. Hart, Leibniz Universität Hannover <[email protected]>
 Francesco Sanvito, TU Delft <[email protected]>
 Gregory Ireland, Reiner Lemoine Institut <[email protected]>
 Sergio Balderrama, Universidad Mayor de San Simon <[email protected]>
+Johann Kraft, Reiner Lemoine Institut <[email protected]>

ramp/core/core.py

@@ -53,6 +53,7 @@ def __init__(
         date_end: str = None,
         parallel_processing: bool = False,
         peak_enlarge: float = 0.15,
+        random_seed: int = None,
     ):
         """Creates a UseCase instance for gathering a list of User instances which own Appliance instances
 
@@ -70,6 +71,8 @@ def __init__(
             if set True, the profiles will be generated in parallel rather than sequencially
         peak_enlarge: float, optional
             percentage random enlargement or reduction of peak time range length, used in UseCase.calc_peak_time_range
+        random_seed: int, optional
+            specify seed for the random number generator to exactly reproduce results
 
         """
         self.name = name
@@ -90,6 +93,8 @@ def __init__(
         self.__num_days = None
         self.__datetimeindex = None
         self.daily_profiles = None
+        self.random_seed = random_seed
+
 
         self.appliances = []
         self.users = []
@@ -101,6 +106,10 @@ def __init__(
         if self.date_start is not None and self.date_end is not None:
             self.initialize()
 
+        # Set global random seed if it is specified
+        if self.random_seed:
+            random.seed(self.random_seed)
+
     @property
     def date_start(self):
         """Start date of the daily profiles generated by the UseCase instance"""