KarrLab/wc_sim

View on GitHub
wc_sim/testing/analyze_tolerances.py

Summary

Maintainability
C
1 day
Test Coverage
""" Analyze ODE tolerances on SBML test suite

:Author: Arthur Goldberg <Arthur.Goldberg@mssm.edu>
:Date: 2020-01-07
:Copyright: 2020, Karr Lab
:License: MIT
"""

from matplotlib.backends.backend_pdf import PdfPages
from matplotlib.colors import LogNorm
import matplotlib
import matplotlib.pyplot as plt
import numpy
import os
import pandas

FILE = '2020-01-08_test_tols_all.txt'


def analyze(file):  # pragma: no cover
    atols = set()
    rtols = set()
    cases = set()
    data = {}
    with open(file, 'r') as fh:
        for line in fh:
            fields = line.strip().split('\t')
            if len(fields) == 5 or len(fields) == 4:
                # atol    rtol    case_num    verified    [run_time]
                verified = fields[3]
                if verified == 'Simulation terminated with error:':
                    verified = 'Error'
                if verified in ['True', 'False', 'Error']:
                    atol = float(fields[0])
                    rtol = float(fields[1])
                    atols.add(atol)
                    rtols.add(rtol)
                    case = fields[2]
                    cases.add(case)
                    try:
                        run_time = float(fields[4])
                    except:
                        run_time = float('nan')
                    data[(atol, rtol, case)] = (verified, run_time)

    print('atols', list(reversed(sorted(atols))))
    print('rtols', list(sorted(rtols)))

    # get fraction of cases verified vs. atol & rtol
    num_solved_array = numpy.zeros((len(atols), len(rtols)))    # shape: row, column
    num_solved_df = pandas.DataFrame(num_solved_array,
                                     index=reversed(sorted(atols)),
                                     columns=sorted(rtols))
    for (atol, rtol, case), values in data.items():
        verified, _ = values
        verified = True if verified == 'True' else False
        if verified:
            num_solved_df.at[atol, rtol] = num_solved_df.at[atol, rtol] + 1

    # get ODE run time
    compute_time = numpy.zeros((len(atols), len(rtols)))
    compute_time_df = pandas.DataFrame(compute_time,
                                     index=reversed(sorted(atols)),
                                     columns=sorted(rtols))
    for (atol, rtol, _), values in data.items():
        verified, run_time = values
        verified = True if verified == 'True' else False
        if verified:
            compute_time_df.at[atol, rtol] = compute_time_df.at[atol, rtol] + run_time

    # get failure rates
    num_failures = numpy.zeros((len(atols), len(rtols)))
    num_failures_df = pandas.DataFrame(num_failures,
                                     index=reversed(sorted(atols)),
                                     columns=sorted(rtols))
    for (atol, rtol, _), values in data.items():
        verified, _ = values
        if verified == 'Error':
            num_failures_df.at[atol, rtol] = num_failures_df.at[atol, rtol] + 1

    return len(cases), num_solved_df / len(cases), compute_time_df, num_failures_df / len(cases)


# make heatmaps of tolerances vs. validation, failures & compute time
def plot(): # pragma: no cover
    file = os.path.join(os.path.dirname(os.path.abspath(__file__)), '..', '..', 'tests', 'testing',
                        'verification_results', 'ode_tuning', FILE)
    pathname = os.path.normpath(file)
    num_cases, fraction_solved_df, compute_time_df, failures_rate_df = analyze(pathname)

    columns = list(fraction_solved_df.columns)
    rows = list(fraction_solved_df.index)

    fig, axes = plt.subplots(2, 2)
    fig.suptitle('Evaluation of relative and absolute tolerances for ODE solver', fontsize=8, y=1)
    ((ax1, ax2), (ax3, ax4)) = axes
    size = 6
    font = {'family' : 'normal',
            'size'   : size}
    matplotlib.rc('font', **font)
    im, cbar = heatmap(fraction_solved_df.values, rows, columns, ax=ax1,
                       size=size, cmap="Greens", cbarlabel="Fraction cases validated",
                       xlabel='rel-tol', ylabel='abs-tol',
                       title=f'Verification rate on {num_cases} SBML test suite cases')
    # texts = annotate_heatmap(im, size=size, valfmt="{x:.2f}")

    im, cbar = heatmap(failures_rate_df.values, rows, columns, ax=ax2,
                       size=size, cmap="Reds", cbarlabel="Failure rate",
                       xlabel='rel-tol', ylabel='abs-tol',
                       title=f'Failure rate of ODE solver for {num_cases} SBML test suite cases')

    im, cbar = heatmap(compute_time_df.values, rows, columns, ax=ax3,
                       size=size, cmap="RdPu", cbarlabel="Compute time (sec)",
                       xlabel='rel-tol', ylabel='abs-tol',
                       title=f'Total cpu time (sec) for {num_cases} cases')

    # fig.delaxes(axes.flatten()[3])
    ax4.axis('off')
    dy = -0.05
    metadata = ['Metadata:',
                'Repo: wc_sim',
                'Commit: x',
                'ODE solver interface: scikits.odes.ode',
                'scikits.odes version: 2.4.0',
                'ODE solver: CVODE',
                'Date: 2020-01-08']
    y = 1
    x = 0
    indent_x = 0.1
    for text in metadata:
        ax4.text(x, y, text)
        y += dy
        x = indent_x
    fig.tight_layout()
    plot_file = os.path.join(os.path.dirname(pathname), FILE + '.pdf')
    fig.savefig(plot_file)
    plt.close(fig)
    print("Wrote: {}".format(plot_file))


# from https://matplotlib.org/3.1.1/gallery/images_contours_and_fields/image_annotated_heatmap.html
def heatmap(data, row_labels, col_labels, ax=None, size=None,
            cbar_kw={}, cbarlabel="", xlabel=None, ylabel=None, title=None, **kwargs):  # pragma: no cover
    """
    Create a heatmap from a numpy array and two lists of labels.

    Parameters
    ----------
    data
        A 2D numpy array of shape (N, M).
    row_labels
        A list or array of length N with the labels for the rows.
    col_labels
        A list or array of length M with the labels for the columns.
    ax
        A `matplotlib.axes.Axes` instance to which the heatmap is plotted.  If
        not provided, use current axes or create a new one.  Optional.
    cbar_kw
        A dictionary with arguments to `matplotlib.Figure.colorbar`.  Optional.
    cbarlabel
        The label for the colorbar.  Optional.
    **kwargs
        All other arguments are forwarded to `imshow`.
    """

    if not ax:
        ax = plt.gca()

    # Plot the heatmap
    im = ax.imshow(data, **kwargs)

    # Create colorbar
    cbar = ax.figure.colorbar(im, ax=ax, **cbar_kw)
    cbar.ax.set_ylabel(cbarlabel, rotation=-90, va="bottom")

    # We want to show all ticks...
    ax.set_xticks(numpy.arange(data.shape[1]))
    ax.set_yticks(numpy.arange(data.shape[0]))
    # ... and label them with the respective list entries.
    ax.set_xticklabels(col_labels)
    ax.set_yticklabels(row_labels)
    if size:
        ax.tick_params(axis='both', which='major', labelsize=size)
    if xlabel:
        ax.set_xlabel(xlabel, fontsize=size)
    if ylabel:
        ax.set_ylabel(ylabel, fontsize=size)
    if title:
        ax.set_title(title)

    # Let the horizontal axes labeling appear on top.
    ax.tick_params(top=True, bottom=False,
                   labeltop=True, labelbottom=False)

    # Rotate the tick labels and set their alignment.
    plt.setp(ax.get_xticklabels(), rotation=-30, ha="right",
             rotation_mode="anchor")

    # Turn spines off and create white grid.
    for edge, spine in ax.spines.items():
        spine.set_visible(False)

    ax.set_xticks(numpy.arange(data.shape[1]+1)-.5, minor=True)
    ax.set_yticks(numpy.arange(data.shape[0]+1)-.5, minor=True)
    ax.grid(which="minor", color="w", linestyle='-', linewidth=3)
    ax.tick_params(which="minor", bottom=False, left=False)

    return im, cbar


def annotate_heatmap(im, data=None, valfmt="{x:.2f}",
                     textcolors=["black", "white"],
                     threshold=None, **textkw): # pragma: no cover
    """
    A function to annotate a heatmap.

    Parameters
    ----------
    im
        The AxesImage to be labeled.
    data
        Data used to annotate.  If None, the image's data is used.  Optional.
    valfmt
        The format of the annotations inside the heatmap.  This should either
        use the string format method, e.g. "$ {x:.2f}", or be a
        `matplotlib.ticker.Formatter`.  Optional.
    textcolors
        A list or array of two color specifications.  The first is used for
        values below a threshold, the second for those above.  Optional.
    threshold
        Value in data units according to which the colors from textcolors are
        applied.  If None (the default) uses the middle of the colormap as
        separation.  Optional.
    **kwargs
        All other arguments are forwarded to each call to `text` used to create
        the text labels.
    """

    if not isinstance(data, (list, numpy.ndarray)):
        data = im.get_array()

    # Normalize the threshold to the images color range.
    if threshold is not None:
        threshold = im.norm(threshold)
    else:
        threshold = im.norm(data.max())/2.

    # Set default alignment to center, but allow it to be
    # overwritten by textkw.
    kw = dict(horizontalalignment="center",
              verticalalignment="center")
    kw.update(textkw)

    # Get the formatter in case a string is supplied
    if isinstance(valfmt, str):
        valfmt = matplotlib.ticker.StrMethodFormatter(valfmt)

    # Loop over the data and create a `Text` for each "pixel".
    # Change the text's color depending on the data.
    texts = []
    for i in range(data.shape[0]):
        for j in range(data.shape[1]):
            kw.update(color=textcolors[int(im.norm(data[i, j]) > threshold)])
            text = im.axes.text(j, i, valfmt(data[i, j], None), **kw)
            texts.append(text)

    return texts


plot()