Make constant tables in both markdown & latex format

Description

This is an alternative to !1034 (closed). Converting markdown tables to rst (to latex to pdf) is going wrong, so we want a workaround.

This uses Jupyter's machinery to produce both formats simultaneously, and store both in the notebook file. In the live notebook, markdown has higher priority (being based on HTML), so the Latex output is hidden. When converting to rst for the PDF report, the Latex format is preferred.

I've drafted this with the calcat_interface2 module, but we could extend it to anywhere we're generating tables.

How Has This Been Tested?

For now, just in a small test notebook. End to end tests still to be done.

Relevant Documents (optional)

Output snippet from nbconvert --to rst

.. code:: ipython3

    agipd_cd.summary_table()




.. math::

    \begin{tabular}{rll}
    \hline
       Modules & Offset                                                                                       & SlopesFF                                                                                     \\
    \hline
             0 & \href{https://in.xfel.eu/calibration/calibration_constant_versions/141880}{2022-09-02 07:42} & \href{https://in.xfel.eu/calibration/calibration_constant_versions/118111}{2022-02-05 13:07} \\
             1 & \href{https://in.xfel.eu/calibration/calibration_constant_versions/141821}{2022-09-02 07:42} & \href{https://in.xfel.eu/calibration/calibration_constant_versions/118138}{2022-02-05 13:07} \\

Types of changes

• New feature (non-breaking change which adds functionality)

Checklist:

• My code follows the code style of this project.

Reviewers

@ahmedk @schmidtp

src/cal_tools/calcat_interface.py

@@ -16,7 +16,7 @@ from calibration_client.modules import (
     PhysicalDetectorUnit,
 )
 
-from cal_tools.tools import module_index_to_qm
+from cal_tools.tools import module_index_to_qm, DisplayTables
 
 __all__ = [
     "CalCatError",
@@ -754,8 +754,7 @@ class CalibrationData:
                 Defaults to
                 "https://in.xfel.eu/calibration/calibration_constant_versions/".
         """
-        from IPython.display import Markdown, display
-        from tabulate import tabulate
+        from IPython.display import display
 
         if metadata is None:
             metadata = self.metadata()
@@ -768,6 +767,8 @@ class CalibrationData:
         cal_groups = [
             list(calibrations)[x:x+4] for x in range(0, len(calibrations), 4)]
 
+        tables = []
+
         # Loop over groups of calibrations.
         for cal_group in cal_groups:
             table = [["Modules"] + cal_group]
@@ -786,22 +787,17 @@ class CalibrationData:
                             c_mdata["begin_validity_at"]).strftime(
                                 "%Y-%m-%d %H:%M")
                         mod_consts.append(
-                            f"[{c_time}]({ccvs_url}/{c_mdata['ccv_id']})")
+                            (c_time, f"{ccvs_url}/{c_mdata['ccv_id']}")
+                        )
                     else:
                         # Constant is not available for this module.
                         mod_consts.append("___")
 
                 table.append([mod] + mod_consts)
 
-            display(
-                Markdown(
-                    tabulate(
-                        table,
-                        tablefmt="pipe",
-                        headers="firstrow",
-                        )
-                    )
-                )
+            tables.append(table)
+
+        display(DisplayTables(tables))
 
     def _build_condition(self, parameters):
         cond = dict()