Report: Comparison tables
[csit.git] / resources / tools / presentation / generator_tables.py
index 0edf4da..14130e5 100644 (file)
@@ -23,6 +23,7 @@ from collections import OrderedDict
 from xml.etree import ElementTree as ET
 from datetime import datetime as dt
 from datetime import timedelta
+from copy import deepcopy
 
 import plotly.graph_objects as go
 import plotly.offline as ploff
@@ -58,7 +59,8 @@ def generate_tables(spec, data):
         u"table_last_failed_tests": table_last_failed_tests,
         u"table_failed_tests": table_failed_tests,
         u"table_failed_tests_html": table_failed_tests_html,
-        u"table_oper_data_html": table_oper_data_html
+        u"table_oper_data_html": table_oper_data_html,
+        u"table_comparison": table_comparison
     }
 
     logging.info(u"Generating the tables ...")
@@ -373,11 +375,13 @@ def table_merged_details(table, input_data):
     logging.info(u"  Done.")
 
 
-def _tpc_modify_test_name(test_name):
+def _tpc_modify_test_name(test_name, ignore_nic=False):
     """Modify a test name by replacing its parts.
 
     :param test_name: Test name to be modified.
+    :param ignore_nic: If True, NIC is removed from TC name.
     :type test_name: str
+    :type ignore_nic: bool
     :returns: Modified test name.
     :rtype: str
     """
@@ -395,7 +399,9 @@ def _tpc_modify_test_name(test_name):
         replace(u"4t4c", u"4c").\
         replace(u"8t4c", u"4c")
 
-    return re.sub(REGEX_NIC, u"", test_name_mod)
+    if ignore_nic:
+        return re.sub(REGEX_NIC, u"", test_name_mod)
+    return test_name_mod
 
 
 def _tpc_modify_displayed_test_name(test_name):
@@ -484,7 +490,7 @@ def _tpc_sort_table(table):
 
 
 def _tpc_generate_html_table(header, data, out_file_name, legend=u"",
-                             footnote=u""):
+                             footnote=u"", sort_data=True, title=u""):
     """Generate html table from input data with simple sorting possibility.
 
     :param header: Table header.
@@ -496,11 +502,15 @@ def _tpc_generate_html_table(header, data, out_file_name, legend=u"",
         generated html table is written.
     :param legend: The legend to display below the table.
     :param footnote: The footnote to display below the table (and legend).
+    :param sort_data: If True the data sorting is enabled.
+    :param title: The table (and file) title.
     :type header: list
     :type data: list of lists
     :type out_file_name: str
     :type legend: str
     :type footnote: str
+    :type sort_data: bool
+    :type title: str
     """
 
     try:
@@ -508,86 +518,111 @@ def _tpc_generate_html_table(header, data, out_file_name, legend=u"",
     except ValueError:
         idx = 0
     params = {
-        u"align-hdr": ([u"left", u"center"], [u"left", u"left", u"center"]),
-        u"align-itm": ([u"left", u"right"], [u"left", u"left", u"right"]),
-        u"width": ([28, 9], [4, 24, 10])
+        u"align-hdr": (
+            [u"left", u"right"],
+            [u"left", u"left", u"right"],
+            [u"left", u"left", u"left", u"right"]
+        ),
+        u"align-itm": (
+            [u"left", u"right"],
+            [u"left", u"left", u"right"],
+            [u"left", u"left", u"left", u"right"]
+        ),
+        u"width": ([28, 9], [4, 24, 10], [4, 4, 32, 10])
     }
 
     df_data = pd.DataFrame(data, columns=header)
 
-    df_sorted = [df_data.sort_values(
-        by=[key, header[idx]], ascending=[True, True]
-        if key != header[idx] else [False, True]) for key in header]
-    df_sorted_rev = [df_data.sort_values(
-        by=[key, header[idx]], ascending=[False, True]
-        if key != header[idx] else [True, True]) for key in header]
-    df_sorted.extend(df_sorted_rev)
+    if sort_data:
+        df_sorted = [df_data.sort_values(
+            by=[key, header[idx]], ascending=[True, True]
+            if key != header[idx] else [False, True]) for key in header]
+        df_sorted_rev = [df_data.sort_values(
+            by=[key, header[idx]], ascending=[False, True]
+            if key != header[idx] else [True, True]) for key in header]
+        df_sorted.extend(df_sorted_rev)
+    else:
+        df_sorted = df_data
 
     fill_color = [[u"#d4e4f7" if idx % 2 else u"#e9f1fb"
                    for idx in range(len(df_data))]]
     table_header = dict(
-        values=[f"<b>{item}</b>" for item in header],
+        values=[f"<b>{item.replace(u',', u',<br>')}</b>" for item in header],
         fill_color=u"#7eade7",
-        align=params[u"align-hdr"][idx]
+        align=params[u"align-hdr"][idx],
+        font=dict(
+            family=u"Courier New",
+            size=12
+        )
     )
 
     fig = go.Figure()
 
-    for table in df_sorted:
-        columns = [table.get(col) for col in header]
+    if sort_data:
+        for table in df_sorted:
+            columns = [table.get(col) for col in header]
+            fig.add_trace(
+                go.Table(
+                    columnwidth=params[u"width"][idx],
+                    header=table_header,
+                    cells=dict(
+                        values=columns,
+                        fill_color=fill_color,
+                        align=params[u"align-itm"][idx],
+                        font=dict(
+                            family=u"Courier New",
+                            size=12
+                        )
+                    )
+                )
+            )
+
+        buttons = list()
+        menu_items = [f"<b>{itm}</b> (ascending)" for itm in header]
+        menu_items_rev = [f"<b>{itm}</b> (descending)" for itm in header]
+        menu_items.extend(menu_items_rev)
+        for idx, hdr in enumerate(menu_items):
+            visible = [False, ] * len(menu_items)
+            visible[idx] = True
+            buttons.append(
+                dict(
+                    label=hdr.replace(u" [Mpps]", u""),
+                    method=u"update",
+                    args=[{u"visible": visible}],
+                )
+            )
+
+        fig.update_layout(
+            updatemenus=[
+                go.layout.Updatemenu(
+                    type=u"dropdown",
+                    direction=u"down",
+                    x=0.0,
+                    xanchor=u"left",
+                    y=1.045,
+                    yanchor=u"top",
+                    active=len(menu_items) - 1,
+                    buttons=list(buttons)
+                )
+            ],
+        )
+    else:
         fig.add_trace(
             go.Table(
                 columnwidth=params[u"width"][idx],
                 header=table_header,
                 cells=dict(
-                    values=columns,
+                    values=[df_sorted.get(col) for col in header],
                     fill_color=fill_color,
-                    align=params[u"align-itm"][idx]
+                    align=params[u"align-itm"][idx],
+                    font=dict(
+                        family=u"Courier New",
+                        size=12
+                    )
                 )
             )
         )
 
-    buttons = list()
-    menu_items = [f"<b>{itm}</b> (ascending)" for itm in header]
-    menu_items_rev = [f"<b>{itm}</b> (descending)" for itm in header]
-    menu_items.extend(menu_items_rev)
-    for idx, hdr in enumerate(menu_items):
-        visible = [False, ] * len(menu_items)
-        visible[idx] = True
-        buttons.append(
-            dict(
-                label=hdr.replace(u" [Mpps]", u""),
-                method=u"update",
-                args=[{u"visible": visible}],
-            )
-        )
-
-    fig.update_layout(
-        updatemenus=[
-            go.layout.Updatemenu(
-                type=u"dropdown",
-                direction=u"down",
-                x=0.0,  # 0.03,
-                xanchor=u"left",
-                y=1.045,
-                yanchor=u"top",
-                active=len(menu_items) - 1,
-                buttons=list(buttons)
-            )
-        ],
-        # annotations=[
-        #     go.layout.Annotation(
-        #         text=u"<b>Sort by:</b>",
-        #         x=0,
-        #         xref=u"paper",
-        #         y=1.035,
-        #         yref=u"paper",
-        #         align=u"left",
-        #         showarrow=False
-        #     )
-        # ]
-    )
-
     ploff.plot(
         fig,
         show_link=False,
@@ -607,10 +642,13 @@ def _tpc_generate_html_table(header, data, out_file_name, legend=u"",
             u".. |prein| raw:: html\n\n    <pre>\n\n\n"
             u".. |preout| raw:: html\n\n    </pre>\n\n"
         )
+        if title:
+            rst_file.write(f"{title}\n")
+            rst_file.write(f"{u'`' * len(title)}\n\n")
         rst_file.write(
             u".. raw:: html\n\n"
             f'    <iframe frameborder="0" scrolling="no" '
-            f'width="1600" height="1000" '
+            f'width="1600" height="1200" '
             f'src="../..{out_file_name.replace(u"_build", u"")}_in.html">'
             f'</iframe>\n\n'
         )
@@ -648,9 +686,9 @@ def table_perf_comparison(table, input_data):
         rca = table.get(u"rca", None)
         if rca:
             try:
-                with open(rca.get(u"data-file", ""), u"r") as rca_file:
+                with open(rca.get(u"data-file", u""), u"r") as rca_file:
                     rca_data = load(rca_file, Loader=FullLoader)
-                header.insert(0, rca.get(u"title", "RCA"))
+                header.insert(0, rca.get(u"title", u"RCA"))
                 legend += (
                     u"RCA: Reference to the Root Cause Analysis, see below.\n"
                 )
@@ -735,15 +773,14 @@ def table_perf_comparison(table, input_data):
                          u" 2n-" in table[u"title"].lower())):
                     tst_name_mod = tst_name_mod.replace(u"2n1l-", u"")
                 if tbl_dict.get(tst_name_mod, None) is None:
-                    groups = re.search(REGEX_NIC, tst_data[u"parent"])
-                    nic = groups.group(0) if groups else u""
-                    name = \
-                        f"{nic}-{u'-'.join(tst_data[u'name'].split(u'-')[:-1])}"
+                    name = tst_data[u'name'].rsplit(u'-', 1)[0]
                     if u"across testbeds" in table[u"title"].lower() or \
                             u"across topologies" in table[u"title"].lower():
                         name = _tpc_modify_displayed_test_name(name)
                     tbl_dict[tst_name_mod] = {
                         u"name": name,
+                        u"replace-ref": True,
+                        u"replace-cmp": True,
                         u"ref-data": list(),
                         u"cmp-data": list()
                     }
@@ -753,7 +790,6 @@ def table_perf_comparison(table, input_data):
 
     replacement = table[u"reference"].get(u"data-replacement", None)
     if replacement:
-        create_new_list = True
         rpl_data = input_data.filter_data(
             table, data=replacement, continue_on_error=True)
         for job, builds in replacement.items():
@@ -765,18 +801,19 @@ def table_perf_comparison(table, input_data):
                              u" 2n-" in table[u"title"].lower())):
                         tst_name_mod = tst_name_mod.replace(u"2n1l-", u"")
                     if tbl_dict.get(tst_name_mod, None) is None:
-                        name = \
-                            f"{u'-'.join(tst_data[u'name'].split(u'-')[:-1])}"
+                        name = tst_data[u'name'].rsplit(u'-', 1)[0]
                         if u"across testbeds" in table[u"title"].lower() or \
                                 u"across topologies" in table[u"title"].lower():
                             name = _tpc_modify_displayed_test_name(name)
                         tbl_dict[tst_name_mod] = {
                             u"name": name,
+                            u"replace-ref": False,
+                            u"replace-cmp": True,
                             u"ref-data": list(),
                             u"cmp-data": list()
                         }
-                    if create_new_list:
-                        create_new_list = False
+                    if tbl_dict[tst_name_mod][u"replace-ref"]:
+                        tbl_dict[tst_name_mod][u"replace-ref"] = False
                         tbl_dict[tst_name_mod][u"ref-data"] = list()
 
                     _tpc_insert_data(
@@ -794,15 +831,14 @@ def table_perf_comparison(table, input_data):
                          u" 2n-" in table[u"title"].lower())):
                     tst_name_mod = tst_name_mod.replace(u"2n1l-", u"")
                 if tbl_dict.get(tst_name_mod, None) is None:
-                    groups = re.search(REGEX_NIC, tst_data[u"parent"])
-                    nic = groups.group(0) if groups else u""
-                    name = \
-                        f"{nic}-{u'-'.join(tst_data[u'name'].split(u'-')[:-1])}"
+                    name = tst_data[u'name'].rsplit(u'-', 1)[0]
                     if u"across testbeds" in table[u"title"].lower() or \
                             u"across topologies" in table[u"title"].lower():
                         name = _tpc_modify_displayed_test_name(name)
                     tbl_dict[tst_name_mod] = {
                         u"name": name,
+                        u"replace-ref": False,
+                        u"replace-cmp": True,
                         u"ref-data": list(),
                         u"cmp-data": list()
                     }
@@ -814,7 +850,6 @@ def table_perf_comparison(table, input_data):
 
     replacement = table[u"compare"].get(u"data-replacement", None)
     if replacement:
-        create_new_list = True
         rpl_data = input_data.filter_data(
             table, data=replacement, continue_on_error=True)
         for job, builds in replacement.items():
@@ -826,18 +861,19 @@ def table_perf_comparison(table, input_data):
                              u" 2n-" in table[u"title"].lower())):
                         tst_name_mod = tst_name_mod.replace(u"2n1l-", u"")
                     if tbl_dict.get(tst_name_mod, None) is None:
-                        name = \
-                            f"{u'-'.join(tst_data[u'name'].split(u'-')[:-1])}"
+                        name = tst_data[u'name'].rsplit(u'-', 1)[0]
                         if u"across testbeds" in table[u"title"].lower() or \
                                 u"across topologies" in table[u"title"].lower():
                             name = _tpc_modify_displayed_test_name(name)
                         tbl_dict[tst_name_mod] = {
                             u"name": name,
+                            u"replace-ref": False,
+                            u"replace-cmp": False,
                             u"ref-data": list(),
                             u"cmp-data": list()
                         }
-                    if create_new_list:
-                        create_new_list = False
+                    if tbl_dict[tst_name_mod][u"replace-cmp"]:
+                        tbl_dict[tst_name_mod][u"replace-cmp"] = False
                         tbl_dict[tst_name_mod][u"cmp-data"] = list()
 
                     _tpc_insert_data(
@@ -964,8 +1000,8 @@ def table_perf_comparison(table, input_data):
         if rca_data:
             footnote = rca_data.get(u"footnote", u"")
             if footnote:
-                txt_file.write(footnote)
-        txt_file.write(u":END")
+                txt_file.write(f"\n{footnote}")
+        txt_file.write(u"\n:END")
 
     # Generate html table:
     _tpc_generate_html_table(
@@ -973,7 +1009,8 @@ def table_perf_comparison(table, input_data):
         tbl_lst,
         table[u'output-file'],
         legend=legend,
-        footnote=footnote
+        footnote=footnote,
+        title=table.get(u"title", u"")
     )
 
 
@@ -1088,18 +1125,20 @@ def table_perf_comparison_nic(table, input_data):
             for tst_name, tst_data in data[job][str(build)].items():
                 if table[u"reference"][u"nic"] not in tst_data[u"tags"]:
                     continue
-                tst_name_mod = _tpc_modify_test_name(tst_name)
+                tst_name_mod = _tpc_modify_test_name(tst_name, ignore_nic=True)
                 if (u"across topologies" in table[u"title"].lower() or
                         (u" 3n-" in table[u"title"].lower() and
                          u" 2n-" in table[u"title"].lower())):
                     tst_name_mod = tst_name_mod.replace(u"2n1l-", u"")
                 if tbl_dict.get(tst_name_mod, None) is None:
-                    name = f"{u'-'.join(tst_data[u'name'].split(u'-')[:-1])}"
+                    name = tst_data[u'name'].rsplit(u'-', 1)[0]
                     if u"across testbeds" in table[u"title"].lower() or \
                             u"across topologies" in table[u"title"].lower():
                         name = _tpc_modify_displayed_test_name(name)
                     tbl_dict[tst_name_mod] = {
                         u"name": name,
+                        u"replace-ref": True,
+                        u"replace-cmp": True,
                         u"ref-data": list(),
                         u"cmp-data": list()
                     }
@@ -1111,7 +1150,6 @@ def table_perf_comparison_nic(table, input_data):
 
     replacement = table[u"reference"].get(u"data-replacement", None)
     if replacement:
-        create_new_list = True
         rpl_data = input_data.filter_data(
             table, data=replacement, continue_on_error=True)
         for job, builds in replacement.items():
@@ -1119,24 +1157,26 @@ def table_perf_comparison_nic(table, input_data):
                 for tst_name, tst_data in rpl_data[job][str(build)].items():
                     if table[u"reference"][u"nic"] not in tst_data[u"tags"]:
                         continue
-                    tst_name_mod = _tpc_modify_test_name(tst_name)
+                    tst_name_mod = \
+                        _tpc_modify_test_name(tst_name, ignore_nic=True)
                     if (u"across topologies" in table[u"title"].lower() or
                             (u" 3n-" in table[u"title"].lower() and
                              u" 2n-" in table[u"title"].lower())):
                         tst_name_mod = tst_name_mod.replace(u"2n1l-", u"")
                     if tbl_dict.get(tst_name_mod, None) is None:
-                        name = \
-                            f"{u'-'.join(tst_data[u'name'].split(u'-')[:-1])}"
+                        name = tst_data[u'name'].rsplit(u'-', 1)[0]
                         if u"across testbeds" in table[u"title"].lower() or \
                                 u"across topologies" in table[u"title"].lower():
                             name = _tpc_modify_displayed_test_name(name)
                         tbl_dict[tst_name_mod] = {
                             u"name": name,
+                            u"replace-ref": False,
+                            u"replace-cmp": True,
                             u"ref-data": list(),
                             u"cmp-data": list()
                         }
-                    if create_new_list:
-                        create_new_list = False
+                    if tbl_dict[tst_name_mod][u"replace-ref"]:
+                        tbl_dict[tst_name_mod][u"replace-ref"] = False
                         tbl_dict[tst_name_mod][u"ref-data"] = list()
 
                     _tpc_insert_data(
@@ -1150,18 +1190,20 @@ def table_perf_comparison_nic(table, input_data):
             for tst_name, tst_data in data[job][str(build)].items():
                 if table[u"compare"][u"nic"] not in tst_data[u"tags"]:
                     continue
-                tst_name_mod = _tpc_modify_test_name(tst_name)
+                tst_name_mod = _tpc_modify_test_name(tst_name, ignore_nic=True)
                 if (u"across topologies" in table[u"title"].lower() or
                         (u" 3n-" in table[u"title"].lower() and
                          u" 2n-" in table[u"title"].lower())):
                     tst_name_mod = tst_name_mod.replace(u"2n1l-", u"")
                 if tbl_dict.get(tst_name_mod, None) is None:
-                    name = f"{u'-'.join(tst_data[u'name'].split(u'-')[:-1])}"
+                    name = tst_data[u'name'].rsplit(u'-', 1)[0]
                     if u"across testbeds" in table[u"title"].lower() or \
                             u"across topologies" in table[u"title"].lower():
                         name = _tpc_modify_displayed_test_name(name)
                     tbl_dict[tst_name_mod] = {
                         u"name": name,
+                        u"replace-ref": False,
+                        u"replace-cmp": True,
                         u"ref-data": list(),
                         u"cmp-data": list()
                     }
@@ -1173,7 +1215,6 @@ def table_perf_comparison_nic(table, input_data):
 
     replacement = table[u"compare"].get(u"data-replacement", None)
     if replacement:
-        create_new_list = True
         rpl_data = input_data.filter_data(
             table, data=replacement, continue_on_error=True)
         for job, builds in replacement.items():
@@ -1181,24 +1222,26 @@ def table_perf_comparison_nic(table, input_data):
                 for tst_name, tst_data in rpl_data[job][str(build)].items():
                     if table[u"compare"][u"nic"] not in tst_data[u"tags"]:
                         continue
-                    tst_name_mod = _tpc_modify_test_name(tst_name)
+                    tst_name_mod = \
+                        _tpc_modify_test_name(tst_name, ignore_nic=True)
                     if (u"across topologies" in table[u"title"].lower() or
                             (u" 3n-" in table[u"title"].lower() and
                              u" 2n-" in table[u"title"].lower())):
                         tst_name_mod = tst_name_mod.replace(u"2n1l-", u"")
                     if tbl_dict.get(tst_name_mod, None) is None:
-                        name = \
-                            f"{u'-'.join(tst_data[u'name'].split(u'-')[:-1])}"
+                        name = tst_data[u'name'].rsplit(u'-', 1)[0]
                         if u"across testbeds" in table[u"title"].lower() or \
                                 u"across topologies" in table[u"title"].lower():
                             name = _tpc_modify_displayed_test_name(name)
                         tbl_dict[tst_name_mod] = {
                             u"name": name,
+                            u"replace-ref": False,
+                            u"replace-cmp": False,
                             u"ref-data": list(),
                             u"cmp-data": list()
                         }
-                    if create_new_list:
-                        create_new_list = False
+                    if tbl_dict[tst_name_mod][u"replace-cmp"]:
+                        tbl_dict[tst_name_mod][u"replace-cmp"] = False
                         tbl_dict[tst_name_mod][u"cmp-data"] = list()
 
                     _tpc_insert_data(
@@ -1213,7 +1256,8 @@ def table_perf_comparison_nic(table, input_data):
                 for tst_name, tst_data in data[job][str(build)].items():
                     if item[u"nic"] not in tst_data[u"tags"]:
                         continue
-                    tst_name_mod = _tpc_modify_test_name(tst_name)
+                    tst_name_mod = \
+                        _tpc_modify_test_name(tst_name, ignore_nic=True)
                     if (u"across topologies" in table[u"title"].lower() or
                             (u" 3n-" in table[u"title"].lower() and
                              u" 2n-" in table[u"title"].lower())):
@@ -1327,8 +1371,8 @@ def table_perf_comparison_nic(table, input_data):
         if rca_data:
             footnote = rca_data.get(u"footnote", u"")
             if footnote:
-                txt_file.write(footnote)
-        txt_file.write(u":END")
+                txt_file.write(f"\n{footnote}")
+        txt_file.write(u"\n:END")
 
     # Generate html table:
     _tpc_generate_html_table(
@@ -1336,7 +1380,8 @@ def table_perf_comparison_nic(table, input_data):
         tbl_lst,
         table[u'output-file'],
         legend=legend,
-        footnote=footnote
+        footnote=footnote,
+        title=table.get(u"title", u"")
     )
 
 
@@ -1415,9 +1460,9 @@ def table_nics_comparison(table, input_data):
     for job, builds in table[u"data"].items():
         for build in builds:
             for tst_name, tst_data in data[job][str(build)].items():
-                tst_name_mod = _tpc_modify_test_name(tst_name)
+                tst_name_mod = _tpc_modify_test_name(tst_name, ignore_nic=True)
                 if tbl_dict.get(tst_name_mod, None) is None:
-                    name = u"-".join(tst_data[u"name"].split(u"-")[:-1])
+                    name = tst_data[u'name'].rsplit(u'-', 1)[0]
                     tbl_dict[tst_name_mod] = {
                         u"name": name,
                         u"ref-data": list(),
@@ -1502,7 +1547,7 @@ def table_nics_comparison(table, input_data):
                               f"{table[u'output-file']}.txt",
                               delimiter=u";")
 
-    with open(f"{table[u'output-file']}.txt", u'a') as txt_file:
+    with open(table[u'output-file'], u'a') as txt_file:
         txt_file.write(legend)
 
     # Generate html table:
@@ -1510,7 +1555,8 @@ def table_nics_comparison(table, input_data):
         header,
         tbl_lst,
         table[u'output-file'],
-        legend=legend
+        legend=legend,
+        title=table.get(u"title", u"")
     )
 
 
@@ -1690,7 +1736,8 @@ def table_soak_vs_ndr(table, input_data):
         header,
         tbl_lst,
         table[u'output-file'],
-        legend=legend
+        legend=legend,
+        title=table.get(u"title", u"")
     )
 
 
@@ -1771,13 +1818,13 @@ def table_perf_trending_dash(table, input_data):
             rel_change_last = nan
         else:
             rel_change_last = round(
-                ((last_avg - avg_week_ago) / avg_week_ago) * 100, 2)
+                ((last_avg - avg_week_ago) / avg_week_ago) * 1e2, 2)
 
         if isnan(max_long_avg) or isnan(last_avg) or max_long_avg == 0.0:
             rel_change_long = nan
         else:
             rel_change_long = round(
-                ((last_avg - max_long_avg) / max_long_avg) * 100, 2)
+                ((last_avg - max_long_avg) / max_long_avg) * 1e2, 2)
 
         if classification_lst:
             if isnan(rel_change_last) and isnan(rel_change_long):
@@ -2317,3 +2364,337 @@ def table_failed_tests_html(table, input_data):
     except KeyError:
         logging.warning(u"The output file is not defined.")
         return
+
+
+def table_comparison(table, input_data):
+    """Generate the table(s) with algorithm: table_comparison
+    specified in the specification file.
+
+    :param table: Table to generate.
+    :param input_data: Data to process.
+    :type table: pandas.Series
+    :type input_data: InputData
+    """
+    logging.info(f"  Generating the table {table.get(u'title', u'')} ...")
+
+    # Transform the data
+    logging.info(
+        f"    Creating the data set for the {table.get(u'type', u'')} "
+        f"{table.get(u'title', u'')}."
+    )
+
+    columns = table.get(u"columns", None)
+    if not columns:
+        logging.error(
+            f"No columns specified for {table.get(u'title', u'')}. Skipping."
+        )
+        return
+
+    cols = list()
+    for idx, col in enumerate(columns):
+        if col.get(u"data-set", None) is None:
+            logging.warning(f"No data for column {col.get(u'title', u'')}")
+            continue
+        data = input_data.filter_data(
+            table,
+            params=[u"throughput", u"result", u"name", u"parent", u"tags"],
+            data=col[u"data-set"],
+            continue_on_error=True
+        )
+        col_data = {
+            u"title": col.get(u"title", f"Column{idx}"),
+            u"data": dict()
+        }
+        for builds in data.values:
+            for build in builds:
+                for tst_name, tst_data in build.items():
+                    tst_name_mod = \
+                        _tpc_modify_test_name(tst_name).replace(u"2n1l-", u"")
+                    if col_data[u"data"].get(tst_name_mod, None) is None:
+                        name = tst_data[u'name'].rsplit(u'-', 1)[0]
+                        if u"across testbeds" in table[u"title"].lower() or \
+                                u"across topologies" in table[u"title"].lower():
+                            name = _tpc_modify_displayed_test_name(name)
+                        col_data[u"data"][tst_name_mod] = {
+                            u"name": name,
+                            u"replace": True,
+                            u"data": list(),
+                            u"mean": None,
+                            u"stdev": None
+                        }
+                    _tpc_insert_data(
+                        target=col_data[u"data"][tst_name_mod][u"data"],
+                        src=tst_data,
+                        include_tests=table[u"include-tests"]
+                    )
+
+        replacement = col.get(u"data-replacement", None)
+        if replacement:
+            rpl_data = input_data.filter_data(
+                table,
+                params=[u"throughput", u"result", u"name", u"parent", u"tags"],
+                data=replacement,
+                continue_on_error=True
+            )
+            for builds in rpl_data.values:
+                for build in builds:
+                    for tst_name, tst_data in build.items():
+                        tst_name_mod = \
+                            _tpc_modify_test_name(tst_name).\
+                            replace(u"2n1l-", u"")
+                        if col_data[u"data"].get(tst_name_mod, None) is None:
+                            name = tst_data[u'name'].rsplit(u'-', 1)[0]
+                            if u"across testbeds" in table[u"title"].lower() \
+                                    or u"across topologies" in \
+                                    table[u"title"].lower():
+                                name = _tpc_modify_displayed_test_name(name)
+                            col_data[u"data"][tst_name_mod] = {
+                                u"name": name,
+                                u"replace": False,
+                                u"data": list(),
+                                u"mean": None,
+                                u"stdev": None
+                            }
+                        if col_data[u"data"][tst_name_mod][u"replace"]:
+                            col_data[u"data"][tst_name_mod][u"replace"] = False
+                            col_data[u"data"][tst_name_mod][u"data"] = list()
+                        _tpc_insert_data(
+                            target=col_data[u"data"][tst_name_mod][u"data"],
+                            src=tst_data,
+                            include_tests=table[u"include-tests"]
+                        )
+
+        if table[u"include-tests"] in (u"NDR", u"PDR"):
+            for tst_name, tst_data in col_data[u"data"].items():
+                if tst_data[u"data"]:
+                    tst_data[u"mean"] = mean(tst_data[u"data"])
+                    tst_data[u"stdev"] = stdev(tst_data[u"data"])
+        elif table[u"include-tests"] in (u"MRR", ):
+            for tst_name, tst_data in col_data[u"data"].items():
+                if tst_data[u"data"]:
+                    tst_data[u"mean"] = tst_data[u"data"][0]
+                    tst_data[u"stdev"] = tst_data[u"data"][0]
+
+        cols.append(col_data)
+
+    tbl_dict = dict()
+    for col in cols:
+        for tst_name, tst_data in col[u"data"].items():
+            if tbl_dict.get(tst_name, None) is None:
+                tbl_dict[tst_name] = {
+                    "name": tst_data[u"name"]
+                }
+            tbl_dict[tst_name][col[u"title"]] = {
+                u"mean": tst_data[u"mean"],
+                u"stdev": tst_data[u"stdev"]
+            }
+
+    tbl_lst = list()
+    for tst_data in tbl_dict.values():
+        row = [tst_data[u"name"], ]
+        for col in cols:
+            row.append(tst_data.get(col[u"title"], None))
+        tbl_lst.append(row)
+
+    comparisons = table.get(u"comparisons", None)
+    if comparisons and isinstance(comparisons, list):
+        for idx, comp in enumerate(comparisons):
+            try:
+                col_ref = int(comp[u"reference"])
+                col_cmp = int(comp[u"compare"])
+            except KeyError:
+                logging.warning(u"Comparison: No references defined! Skipping.")
+                comparisons.pop(idx)
+                continue
+            if not (0 < col_ref <= len(cols) and
+                    0 < col_cmp <= len(cols)) or \
+                    col_ref == col_cmp:
+                logging.warning(f"Wrong values of reference={col_ref} "
+                                f"and/or compare={col_cmp}. Skipping.")
+                comparisons.pop(idx)
+                continue
+
+    tbl_cmp_lst = list()
+    if comparisons:
+        for row in tbl_lst:
+            new_row = deepcopy(row)
+            add_to_tbl = False
+            for comp in comparisons:
+                ref_itm = row[int(comp[u"reference"])]
+                if ref_itm is None and \
+                        comp.get(u"reference-alt", None) is not None:
+                    ref_itm = row[int(comp[u"reference-alt"])]
+                cmp_itm = row[int(comp[u"compare"])]
+                if ref_itm is not None and cmp_itm is not None and \
+                        ref_itm[u"mean"] is not None and \
+                        cmp_itm[u"mean"] is not None and \
+                        ref_itm[u"stdev"] is not None and \
+                        cmp_itm[u"stdev"] is not None:
+                    delta, d_stdev = relative_change_stdev(
+                        ref_itm[u"mean"], cmp_itm[u"mean"],
+                        ref_itm[u"stdev"], cmp_itm[u"stdev"]
+                    )
+                    new_row.append(
+                        {
+                            u"mean": delta * 1e6,
+                            u"stdev": d_stdev * 1e6
+                        }
+                    )
+                    add_to_tbl = True
+                else:
+                    new_row.append(None)
+            if add_to_tbl:
+                tbl_cmp_lst.append(new_row)
+
+    tbl_cmp_lst.sort(key=lambda rel: rel[0], reverse=False)
+    tbl_cmp_lst.sort(key=lambda rel: rel[-1][u'mean'], reverse=True)
+
+    rcas = list()
+    rca_in = table.get(u"rca", None)
+    if rca_in and isinstance(rca_in, list):
+        for idx, itm in enumerate(rca_in):
+            try:
+                with open(itm.get(u"data", u""), u"r") as rca_file:
+                    rcas.append(
+                        {
+                            u"title": itm.get(u"title", f"RCA{idx}"),
+                            u"data": load(rca_file, Loader=FullLoader)
+                        }
+                    )
+            except (YAMLError, IOError) as err:
+                logging.warning(
+                    f"The RCA file {itm.get(u'data', u'')} does not exist or "
+                    f"it is corrupted!"
+                )
+                logging.debug(repr(err))
+
+    tbl_for_csv = list()
+    for line in tbl_cmp_lst:
+        row = [line[0], ]
+        for idx, itm in enumerate(line[1:]):
+            if itm is None:
+                row.append(u"NT")
+                row.append(u"NT")
+            else:
+                row.append(round(float(itm[u'mean']) / 1e6, 3))
+                row.append(round(float(itm[u'stdev']) / 1e6, 3))
+        for rca in rcas:
+            rca_nr = rca[u"data"].get(row[0], u"-")
+            row.append(f"[{rca_nr}]" if rca_nr != u"-" else u"-")
+        tbl_for_csv.append(row)
+
+    header_csv = [u"Test Case", ]
+    for col in cols:
+        header_csv.append(f"Avg({col[u'title']})")
+        header_csv.append(f"Stdev({col[u'title']})")
+    for comp in comparisons:
+        header_csv.append(
+            f"Avg({comp.get(u'title', u'')})"
+        )
+        header_csv.append(
+            f"Stdev({comp.get(u'title', u'')})"
+        )
+    header_csv.extend([rca[u"title"] for rca in rcas])
+
+    legend_lst = table.get(u"legend", None)
+    if legend_lst is None:
+        legend = u""
+    else:
+        legend = u"\n" + u"\n".join(legend_lst) + u"\n"
+
+    footnote = u""
+    for rca in rcas:
+        footnote += f"\n{rca[u'title']}:\n"
+        footnote += rca[u"data"].get(u"footnote", u"")
+
+    csv_file = f"{table[u'output-file']}-csv.csv"
+    with open(csv_file, u"wt", encoding='utf-8') as file_handler:
+        file_handler.write(
+            u",".join([f'"{itm}"' for itm in header_csv]) + u"\n"
+        )
+        for test in tbl_for_csv:
+            file_handler.write(
+                u",".join([f'"{item}"' for item in test]) + u"\n"
+            )
+        if legend_lst:
+            for item in legend_lst:
+                file_handler.write(f'"{item}"\n')
+        if footnote:
+            for itm in footnote.split(u"\n"):
+                file_handler.write(f'"{itm}"\n')
+
+    tbl_tmp = list()
+    max_lens = [0, ] * len(tbl_cmp_lst[0])
+    for line in tbl_cmp_lst:
+        row = [line[0], ]
+        for idx, itm in enumerate(line[1:]):
+            if itm is None:
+                new_itm = u"NT"
+            else:
+                if idx < len(cols):
+                    new_itm = (
+                        f"{round(float(itm[u'mean']) / 1e6, 1)} "
+                        f"\u00B1{round(float(itm[u'stdev']) / 1e6, 1)}".
+                        replace(u"nan", u"NaN")
+                    )
+                else:
+                    new_itm = (
+                        f"{round(float(itm[u'mean']) / 1e6, 1):+} "
+                        f"\u00B1{round(float(itm[u'stdev']) / 1e6, 1)}".
+                        replace(u"nan", u"NaN")
+                    )
+            if len(new_itm.rsplit(u" ", 1)[-1]) > max_lens[idx]:
+                max_lens[idx] = len(new_itm.rsplit(u" ", 1)[-1])
+            row.append(new_itm)
+
+        tbl_tmp.append(row)
+
+    tbl_final = list()
+    for line in tbl_tmp:
+        row = [line[0], ]
+        for idx, itm in enumerate(line[1:]):
+            if itm in (u"NT", u"NaN"):
+                row.append(itm)
+                continue
+            itm_lst = itm.rsplit(u"\u00B1", 1)
+            itm_lst[-1] = \
+                f"{u' ' * (max_lens[idx] - len(itm_lst[-1]))}{itm_lst[-1]}"
+            row.append(u"\u00B1".join(itm_lst))
+        for rca in rcas:
+            rca_nr = rca[u"data"].get(row[0], u"-")
+            row.append(f"[{rca_nr}]" if rca_nr != u"-" else u"-")
+
+        tbl_final.append(row)
+
+    header = [u"Test Case", ]
+    header.extend([col[u"title"] for col in cols])
+    header.extend([comp.get(u"title", u"") for comp in comparisons])
+    header.extend([rca[u"title"] for rca in rcas])
+
+    # Generate csv tables:
+    csv_file = f"{table[u'output-file']}.csv"
+    with open(csv_file, u"wt", encoding='utf-8') as file_handler:
+        file_handler.write(u";".join(header) + u"\n")
+        for test in tbl_final:
+            file_handler.write(u";".join([str(item) for item in test]) + u"\n")
+
+    # Generate txt table:
+    txt_file_name = f"{table[u'output-file']}.txt"
+    convert_csv_to_pretty_txt(csv_file, txt_file_name, delimiter=u";")
+
+    with open(txt_file_name, u'a', encoding='utf-8') as txt_file:
+        txt_file.write(legend)
+        if footnote:
+            txt_file.write(footnote)
+        txt_file.write(u"\n:END")
+
+    # Generate html table:
+    _tpc_generate_html_table(
+        header,
+        tbl_final,
+        table[u'output-file'],
+        legend=legend,
+        footnote=footnote,
+        sort_data=False,
+        title=table.get(u"title", u"")
+    )