From 20f35c6a12db82e49082f753d4fd999b0d68ef78 Mon Sep 17 00:00:00 2001
From: Paige Rubendall <prubenda@redhat.com>
Date: Tue, 14 May 2024 16:52:35 -0400
Subject: [PATCH] geting percent difference

rh-pre-commit.version: 2.2.0
rh-pre-commit.check-secrets: ENABLED

Signed-off-by: Auto User <auto@users.noreply.github.com>
---
 README.md                          |   7 +-
 orion.py                           |  12 +++-
 percentdiff.jpg                    | Bin 0 -> 28176 bytes
 pkg/algorithms/algorithmFactory.py |   3 +
 pkg/algorithms/cmr/__init__.py     |   4 ++
 pkg/algorithms/cmr/cmr.py          | 108 +++++++++++++++++++++++++++++
 pkg/constants.py                   |   1 +
 pkg/runTest.py                     |  24 +++++--
 pkg/utils.py                       |  21 +++++-
 9 files changed, 170 insertions(+), 10 deletions(-)
 create mode 100644 percentdiff.jpg
 create mode 100644 pkg/algorithms/cmr/__init__.py
 create mode 100644 pkg/algorithms/cmr/cmr.py

diff --git a/README.md b/README.md
index f6e9d02..22e144a 100644
--- a/README.md
+++ b/README.md
@@ -123,6 +123,11 @@ Additionally, users can specify a custom path for the output CSV file using the
 
 Orion now supports anomaly detection for your data. Use the ```--anomaly-detection``` command to start the anomaly detection process.
 
+
+To be able to find significant percent differences in workload runs, use the ```--cmr``` command. This will compare the most recent run with any previous matching runs or baseline UUIDs. If more than 1 other run is found from the most recent, the values will be meaned together and then compared with the previous run. Use with *direction: 0* (set in the config) when using ```-o json``` format to see percent differences
+
+![cmr percent difference](percentdiff.jpg)
+
 You can now constrain your look-back period using the ```--lookback``` option. The format for look-back is ```XdYh```, where X represents the number of days and Y represents the number of hours.
 
 To specify how many runs to look back, you can use the ```--lookback-size``` option. By default, this option is set to 10000.
@@ -156,7 +161,7 @@ This is similar to how car manufacturers warranty plays out such as 5years or 60
 
 You can open the match requirement by using the ```--node-count``` option to find any matching uuid based on the metadata and not have to have the same jobConfig.jobIterations. This variable is a ```True``` or ```False```, defaulted to False. 
 
-**_NOTE:_**  The ```--hunter-analyze``` and ```--anomaly-detection``` flags are mutually exclusive. They cannot be used together because they represent different algorithms designed for distinct use cases.
+**_NOTE:_**  The ```cmr```, ```--hunter-analyze``` and ```--anomaly-detection``` flags are mutually exclusive. They cannot be used together because they represent different algorithms designed for distinct use cases.
 
 ### Daemon mode
 The core purpose of Daemon mode is to operate Orion as a self-contained server, dedicated to handling incoming requests. By sending a POST request accompanied by a test name of predefined tests, users can trigger change point detection on the provided metadata and metrics. Following the processing, the response is formatted in JSON, providing a structured output for seamless integration and analysis. To trigger daemon mode just use the following commands
diff --git a/orion.py b/orion.py
index 4935372..2a66e66 100644
--- a/orion.py
+++ b/orion.py
@@ -69,6 +69,14 @@ def cli(max_content_width=120):  # pylint: disable=unused-argument
 
 # pylint: disable=too-many-locals
 @cli.command(name="cmd")
+@click.option(
+    "--cmr", 
+    is_flag=True,
+    help="Generate percent difference in comparison",
+    cls=MutuallyExclusiveOption,
+    mutually_exclusive=["anomaly_detection","hunter_analyze"],
+)
+@click.option("--filter", is_flag=True, help="Generate percent difference in comparison")
 @click.option("--config", default="config.yaml", help="Path to the configuration file")
 @click.option(
     "--save-data-path", default="data.csv", help="Path to save the output file"
@@ -79,7 +87,7 @@ def cli(max_content_width=120):  # pylint: disable=unused-argument
     is_flag=True,
     help="run hunter analyze",
     cls=MutuallyExclusiveOption,
-    mutually_exclusive=["anomaly_detection"],
+    mutually_exclusive=["anomaly_detection","cmr"],
 )
 @click.option("--anomaly-window", type=int, callback=validate_anomaly_options, help="set window size for moving average for anomaly-detection")
 @click.option("--min-anomaly-percent", type=int, callback=validate_anomaly_options, help="set minimum percentage difference from moving average for data point to be detected as anomaly")
@@ -88,7 +96,7 @@ def cli(max_content_width=120):  # pylint: disable=unused-argument
     is_flag=True,
     help="run anomaly detection algorithm powered by isolation forest",
     cls=MutuallyExclusiveOption,
-    mutually_exclusive=["hunter_analyze"],
+    mutually_exclusive=["hunter_analyze","cmr"],
 )
 @click.option(
     "-o",
diff --git a/percentdiff.jpg b/percentdiff.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..c66352bda405332140f7c0ff3ecdbbe001a88b2b
GIT binary patch
literal 28176
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
Ma{N!e{yqD@0OD(QC;$Ke

literal 0
HcmV?d00001

diff --git a/pkg/algorithms/algorithmFactory.py b/pkg/algorithms/algorithmFactory.py
index a4d47f8..720a35d 100644
--- a/pkg/algorithms/algorithmFactory.py
+++ b/pkg/algorithms/algorithmFactory.py
@@ -6,6 +6,7 @@
 import pkg.constants as cnsts
 from .edivisive import EDivisive
 from .isolationforest import IsolationForestWeightedMean
+from .cmr import CMR
 
 
 class AlgorithmFactory: # pylint: disable= too-few-public-methods, too-many-arguments, line-too-long
@@ -30,4 +31,6 @@ def instantiate_algorithm(self, algorithm: str, matcher: Matcher, dataframe:pd.D
             return EDivisive(matcher, dataframe, test, options, metrics_config)
         if algorithm == cnsts.ISOLATION_FOREST:
             return IsolationForestWeightedMean(matcher, dataframe, test, options, metrics_config)
+        if algorithm == cnsts.CMR:
+            return CMR(matcher, dataframe, test, options, metrics_config)
         raise ValueError("Invalid algorithm called")
diff --git a/pkg/algorithms/cmr/__init__.py b/pkg/algorithms/cmr/__init__.py
new file mode 100644
index 0000000..f93d771
--- /dev/null
+++ b/pkg/algorithms/cmr/__init__.py
@@ -0,0 +1,4 @@
+"""
+Init for CMR Algorithm
+"""
+from .cmr import CMR
diff --git a/pkg/algorithms/cmr/cmr.py b/pkg/algorithms/cmr/cmr.py
new file mode 100644
index 0000000..89f2ffc
--- /dev/null
+++ b/pkg/algorithms/cmr/cmr.py
@@ -0,0 +1,108 @@
+"""CMR - Comparing Mean Responses Algorithm"""
+
+# pylint: disable = line-too-long
+import pandas as pd
+import numpy
+
+from fmatch.logrus import SingletonLogger
+from hunter.series import  ChangePoint, ComparativeStats
+from pkg.algorithms.algorithm import Algorithm
+
+
+class CMR(Algorithm):
+    """Implementation of the CMR algorithm
+    Will Combine metrics into 2 lines and compare with a tolerancy to set pass fail
+
+    Args:
+        Algorithm (Algorithm): Inherits
+    """
+
+
+    def _analyze(self):
+        """Analyze the dataframe with meaning any previous data and generate percent change with a current uuid
+
+        Returns:
+            series: data series that contains attributes and full dataframe
+            change_points_by_metric: list of ChangePoints
+        """
+        logger_instance = SingletonLogger.getLogger("Orion")
+        logger_instance.info("Starting analysis using CMR")
+        self.dataframe["timestamp"] = pd.to_datetime(self.dataframe["timestamp"])
+        self.dataframe["timestamp"] = self.dataframe["timestamp"].astype(int) // 10**9
+
+        if len(self.dataframe.index) == 1:
+            series= self.setup_series()
+            series.data = self.dataframe
+            return series, {}
+        # if larger than 2 rows, need to get the mean of 0 through -2
+        self.dataframe = self.combine_and_average_runs(self.dataframe)
+
+        series= self.setup_series()
+
+        df, change_points_by_metric = self.run_cmr(self.dataframe)
+        series.data= df
+        return series, change_points_by_metric
+
+
+    def run_cmr(self, dataframe_list: pd.DataFrame):
+        """
+        Generate the percent difference in a 2 row dataframe
+
+        Args:
+            dataframe_list (pd.DataFrame): data frame of all data to compare on
+
+        Returns:
+            pd.Dataframe, dict[metric_name, ChangePoint]: Returned data frame and change points
+        """
+        metric_columns = self.metrics_config.keys()
+        change_points_by_metric={ k:[] for k in metric_columns }
+
+        for column in metric_columns:
+
+            change_point = ChangePoint(metric=column,
+                                            index=1,
+                                            time=0,
+                                            stats=ComparativeStats(
+                                                mean_1=dataframe_list[column][0],
+                                                mean_2=dataframe_list[column][1],
+                                                std_1=0,
+                                                std_2=0,
+                                                pvalue=1
+                                            ))
+            change_points_by_metric[column].append(change_point)
+
+        # based on change point generate pass/fail
+        return dataframe_list, change_points_by_metric
+
+    def combine_and_average_runs(self, dataFrame: pd.DataFrame):
+        """
+        If more than 1 previous run, mean data together into 1 single row
+        Combine with current run into 1 data frame (current run being -1 index)
+
+        Args:
+            dataFrame (pd.DataFrame): data to combine into 2 rows
+
+        Returns:
+            pd.Dataframe: data frame of most recent run and averaged previous runs
+        """
+        i = 0
+
+        last_row = dataFrame.tail(1)
+        dF = dataFrame[:-1]
+        data2 = {}
+
+        metric_columns = list(dataFrame.columns)
+        for column in metric_columns:
+
+            if isinstance(dF.loc[0, column], (numpy.float64, numpy.int64)):
+                mean = dF[column].mean()
+                data2[column] = [mean]
+            else:
+                column_list = dF[column].tolist()
+                non_numeric_joined_list = ','.join(column_list)
+                data2[column] = [non_numeric_joined_list]
+            i += 1
+        df2 = pd.DataFrame(data2)
+
+        result = pd.concat([df2, last_row], ignore_index=True)
+        return result
diff --git a/pkg/constants.py b/pkg/constants.py
index 87813a3..ea9a770 100644
--- a/pkg/constants.py
+++ b/pkg/constants.py
@@ -6,3 +6,4 @@
 JSON="json"
 TEXT="text"
 JUNIT="junit"
+CMR="cmr"
diff --git a/pkg/runTest.py b/pkg/runTest.py
index 5948651..990bfde 100644
--- a/pkg/runTest.py
+++ b/pkg/runTest.py
@@ -9,7 +9,24 @@
 import pkg.constants as cnsts
 from pkg.utils import get_datasource, process_test, get_subtracted_timestamp
 
+def get_algorithm_type(kwargs):
+    """Switch Case of getting algorithm name
 
+    Args:
+        kwargs (dict): passed command line arguments
+
+    Returns:
+        str: algorithm name
+    """
+    if kwargs["hunter_analyze"]:
+        algorithm_name = cnsts.EDIVISIVE
+    elif kwargs["anomaly_detection"]:
+        algorithm_name = cnsts.ISOLATION_FOREST
+    elif kwargs['cmr']:
+        algorithm_name = cnsts.CMR
+    else:
+        algorithm_name = None
+    return algorithm_name
 
 def run(**kwargs: dict[str, Any]) -> dict[str, Any]: #pylint: disable = R0914
     """run method to start the tests
@@ -48,11 +65,8 @@ def run(**kwargs: dict[str, Any]) -> dict[str, Any]: #pylint: disable = R0914
         if fingerprint_matched_df is None:
             sys.exit(3) # No data present
 
-        if kwargs["hunter_analyze"]:
-            algorithm_name = cnsts.EDIVISIVE
-        elif kwargs["anomaly_detection"]:
-            algorithm_name = cnsts.ISOLATION_FOREST
-        else:
+        algorithm_name = get_algorithm_type(kwargs)
+        if algorithm_name is None:
             return None, None
 
         algorithmFactory = AlgorithmFactory()
diff --git a/pkg/utils.py b/pkg/utils.py
index e4add5e..94cf457 100644
--- a/pkg/utils.py
+++ b/pkg/utils.py
@@ -258,10 +258,12 @@ def process_test(
     shortener = pyshorteners.Shortener(timeout=10)
     merged_df["buildUrl"] = merged_df["uuid"].apply(
         lambda uuid: (
-            shortener.tinyurl.short(buildUrls[uuid])
+            shorten_url(shortener, buildUrls[uuid])
             if options["convert_tinyurl"]
             else buildUrls[uuid]
-        )  # pylint: disable = cell-var-from-loop
+        )
+
+        # pylint: disable = cell-var-from-loop
     )
     merged_df=merged_df.reset_index(drop=True)
     #save the dataframe
@@ -269,6 +271,21 @@ def process_test(
     match.save_results(merged_df, csv_file_path=output_file_path)
     return merged_df, metrics_config
 
+def shorten_url(shortener: any, uuids: str) -> str:
+    """Shorten url if there is a list of buildUrls
+
+    Args:
+        shortener (any): shortener object to use tinyrl.short on
+        uuids (List[str]): List of uuids to shorten
+
+    Returns:
+        str: a combined string of shortened urls
+    """
+    short_url_list = []
+    for buildUrl in uuids.split(","):
+        short_url_list.append(shortener.tinyurl.short(buildUrl))
+    short_url = ','.join(short_url_list)
+    return short_url
 
 def get_metadata_with_uuid(uuid: str, match: Matcher) -> Dict[Any, Any]:
     """Gets metadata of the run from each test