Metadata-Version: 2.1
Name: kerashistoryplot
Version: 0.0.10
Summary: Plot Keras model losses and metrics live in Jupyter
Home-page: https://github.com/ig248/kerashistoryplot
Author: Igor Gotlibovych
Author-email: igor.gotlibovych@gmail.com
License: MIT
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/markdown
Provides-Extra: matplotlib
Requires-Dist: matplotlib ; extra == 'matplotlib'

[![PyPI version](https://badge.fury.io/py/kerashistoryplot.svg)](https://badge.fury.io/py/kerashistoryplot)
[![Build Status](https://travis-ci.com/ig248/kerashistoryplot.svg?branch=master)](https://travis-ci.com/ig248/kerashistoryplot)
[![Coverage Status](https://codecov.io/gh/ig248/kerashistoryplot/branch/master/graph/badge.svg)](https://codecov.io/gh/ig248/kerashistoryplot)

# History plot for Keras model training

![history plot with batches](https://raw.githubusercontent.com/ig248/kerashistoryplot/master/kerashistoryplot.png)

Plots training losses and metrics in Jupyter while training your `keras` model.

This project started as an attempt to extend [`livelossplot`](https://github.com/stared/livelossplot), but I realized that a rewrite was easier. Key improvements are:

- keeps full history, including losses for each batch in each epoch
- plots scatter of batch losses
- plots arbitrary log entries, such a `lr` (learning rate)
- simplifies codebase extendibility

## Basic Usage
Install package from source:

```
pip install git+https://github.com/ig248/kerashistoryplot
```

Or from PyPi:

```
pip install kerashistoryplot
```

Import function:

```python
from livehistoryplot.callbacks import PlotHistory
```

Use in callbacks:

```python
model.fit(
    X, y,
    epochs=20,
    callbacks=[
        ReduceLROnPlateau(),
        PlotHistory(batches=True, n_cols=3, figsize=(15, 7))
    ]
)
```

## More Examples
See `notebooks/`

## Tests
Run
```bash
make dev-install
make test
```

## References
Original `livelossplot`: https://github.com/stared/livelossplot


