feat(Utils): Added utility function for parsing CSVLogger fitting fil…

…e to fitting dictionary

aucmedi/utils/callbacks.py

@@ -20,6 +20,7 @@
 #                   Library imports                   #
 #-----------------------------------------------------#
 from tensorflow.keras.callbacks import EarlyStopping
+import pandas as pd
 
 #-----------------------------------------------------#
 #                   Custom Callbacks                  #
@@ -67,3 +68,26 @@ def __init__(self, monitor='val_loss', min_delta=0, patience=0, verbose=0,
     def on_epoch_end(self, epoch, logs=None):
         if epoch > self.start_epoch:
             super(MinEpochEarlyStopping, self).on_epoch_end(epoch, logs)
+
+#-----------------------------------------------------#
+#                    Callback Utils                   #
+#-----------------------------------------------------#
+def csv_to_history(input_path):
+    """ Utility function for reading a CSV file from the
+    [CSVLogger](https://www.tensorflow.org/api_docs/python/tf/keras/callbacks/CSVLogger)
+    Callback and return a History dictionary object.
+
+    Can be utilized in order to pass returned dictionary object to the
+    [evaluate_fitting()][aucmedi.evaluation.fitting] function of the AUCMEDI
+    [evaluation][aucmedi.evaluation] submodule.
+
+    Args:
+        input_path (str):           Path to a CSV file generated by a CSVLogger Callback.
+
+    Returns:
+        history (dict):       A history dictionary from a Keras history object which contains several logs.
+    """
+    # Read logging data
+    dt = pd.read_csv(input_path, sep=",")
+    # Parse to dict and return results
+    return dt.to_dict(orient="list")