https://github.com/GPflow/GPflow
Revision 65532774c1b0257b20e50fb1f6f7b84502e9d700 authored by Jesper Nielsen on 17 October 2022, 10:33:06 UTC, committed by GitHub on 17 October 2022, 10:33:06 UTC
1 parent ca6c523
Tip revision: 65532774c1b0257b20e50fb1f6f7b84502e9d700 authored by Jesper Nielsen on 17 October 2022, 10:33:06 UTC
Rework GPflow introduction. (#1958)
Rework GPflow introduction. (#1958)
Tip revision: 6553277
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
Computing file changes ...