diff options
author | Tim Rault <tim.rault@cengn.ca> | 2016-07-15 16:32:51 -0400 |
---|---|---|
committer | Tim Rault <tim.rault@cengn.ca> | 2016-07-15 16:41:16 -0400 |
commit | aa20b986cebf031489f4280988b4574a9acbc647 (patch) | |
tree | 354c6b521d83735a1be29183b447d3b35bf320ac /storperf/utilities/steady_state.py | |
parent | 2227414bd57f4b7f5f275d915fa8f6a2aa21f8f7 (diff) |
Add Steady State Detection module
Added a Steady State Detection module containing a steady_state(data_series)
function that is able to return a boolean indicating wether or not steady
state is reached with the data_series being passed.
This module requires a data_treatment(data_series) and an average(data_series)
modules that have been added in this commit as well. The data treatment function
aims at formatting the data series that is passed to the high level steady_state
function to reach the requirement of each sub-module (slope, average and range).
Modified the Slope and Range functions so they return None when passed an empty
data series instead of 0 which was wrong. Modified the corresponding test cases.
Modified the math_range_test.py file to fix a bug in the 2 last tests.
Change-Id: I9c3854cb0a21cc37b0787b8afca0821eefaa203d
JIRA: STORPERF-60
JIRA: STORPERF-59
JIRA: STORPERF-61
JIRA: STORPERF-62
Signed-off-by: Tim Rault <tim.rault@cengn.ca>
Diffstat (limited to 'storperf/utilities/steady_state.py')
-rw-r--r-- | storperf/utilities/steady_state.py | 45 |
1 files changed, 45 insertions, 0 deletions
diff --git a/storperf/utilities/steady_state.py b/storperf/utilities/steady_state.py new file mode 100644 index 0000000..8bfcb93 --- /dev/null +++ b/storperf/utilities/steady_state.py @@ -0,0 +1,45 @@ +############################################################################## +# Copyright (c) 2016 CENGN and others. +# +# All rights reserved. This program and the accompanying materials +# are made available under the terms of the Apache License, Version 2.0 +# which accompanies this distribution, and is available at +# http://www.apache.org/licenses/LICENSE-2.0 +############################################################################## +from storperf.utilities import data_treatment as DataTreatment +from storperf.utilities import math as math + + +def steady_state(data_series): + """ + This function seeks to detect steady state given on a measurement + window given the data series of that measurement window following + the pattern : [[x1,y1], [x2,y2], ..., [xm,ym]]. m represents the number + of points recorded in the measurement window, x which represents the + time, and y which represents the Volume performance variable being + tested e.g. IOPS, latency... + The function returns a boolean describing wether or not steady state + has been reached with the data that is passed to it. + """ + + # Pre conditioning the data to match the algorithms + treated_data = DataTreatment.data_treatment(data_series) + + # Calculating useful values invoking dedicated functions + slope_value = math.slope(treated_data['slope_data']) + range_value = math.range_value(treated_data['range_data']) + average_value = math.average(treated_data['average_data']) + + if (slope_value is not None and range_value is not None and + average_value is not None): + # Verification of the Steady State conditions following the SNIA + # definition + range_condition = range_value < 0.20 * abs(average_value) + slope_condition = slope_value < 0.10 * abs(average_value) + + steady_state = range_condition and slope_condition + + else: + steady_state = False + + return steady_state |