Raw File
plotter_api.py
# Copyright 2022 The GPflow Contributors. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""
Classes and other infrastructre for plotting results.

Concrete plotters are found in ``plotters.py``.
"""
from abc import ABC, abstractmethod
from typing import TYPE_CHECKING, Any, Callable, Collection, Tuple

import pandas as pd
from matplotlib.axes import Axes

from benchmark.metadata import BenchmarkMetadata
from benchmark.registry import Registry

# Avoid cyclic imports:
if TYPE_CHECKING:
    from benchmark.grouping import GroupingSpec
else:
    GroupingSpec = Any


class Plotter(ABC):
    """
    Strategy for how to create a plot.
    """

    name: str
    """
    Name of this plotter.
    """

    @abstractmethod
    def plot(
        self,
        ax: Axes,
        file_key: Tuple[str, ...],
        column_key: Tuple[str, ...],
        row_key: Tuple[str, ...],
        line_by: GroupingSpec,
        metrics_df: pd.DataFrame,
        metadata: Collection[BenchmarkMetadata],
    ) -> None:
        """ Plot the given data to the given `ax`. """


PLOTTERS: Registry[Plotter] = Registry()


PlotterFn = Callable[
    [
        Axes,
        Tuple[str, ...],  # file_key
        Tuple[str, ...],  # column_key
        Tuple[str, ...],  # row_key
        GroupingSpec,  # line_by
        pd.DataFrame,  # metrics_df
        Collection[BenchmarkMetadata],
    ],
    None,
]
"""
A function that can be used as a :class:`Plotter`.

Plot the given data to the given `Axes`.
"""


class FnPlotter(Plotter):
    """
    Adapter from a function to a :class:`Plotter`.
    """

    def __init__(self, name: str, fn: PlotterFn) -> None:
        self.name = name
        self._fn = fn

    def plot(
        self,
        ax: Axes,
        file_key: Tuple[str, ...],
        column_key: Tuple[str, ...],
        row_key: Tuple[str, ...],
        line_by: GroupingSpec,
        metrics_df: pd.DataFrame,
        metadata: Collection[BenchmarkMetadata],
    ) -> None:
        self._fn(ax, file_key, column_key, row_key, line_by, metrics_df, metadata)


def make_plotter(fn: PlotterFn) -> FnPlotter:
    """
    Decorator for turning a function into a :class:`Plotter`.
    """
    name = fn.__name__
    result = FnPlotter(name, fn)
    PLOTTERS.add(result)
    return result
back to top