Add first plotting functions

[hagenw]

This adds a small usage section and the following plotting functions

• audplot.confusion_matrix()
• audplot.distribution()
• audplot.scatter()
• audplot.series()

Tests are only executed as doctests, which means we have only a code coverage of ~95%, but I think this is fine.

It uses the build in plot_directive sphinx plugin of `matplotlib in order to auto-generate figures for the docs:

[frankenjoe]

I find it quite convenient when I can pass an axes object to a plot function. I think we should support it here, too. Then we can do things like:

fig, axs = plt.subplots(2, 1)
confusion_matrix(..., ax=axs[0])
confusion_matrix(..., ax=axs[1])

[hagenw]

I find it quite convenient when I can pass an axes object to a plot function. I think we should support it here, too. Then we can do things like:

fig, axs = plt.subplots(2, 1)
confusion_matrix(..., ax=axs[0])
confusion_matrix(..., ax=axs[1])

As I'm not the expert on plotting with Python, I would propose that you add this in another pull request after we finished this one.

[frankenjoe]

As I'm not the expert on plotting with Python, I would propose that you add this in another pull request after we finished this one.

agree

[frankenjoe]

When I run the tests I get a DeprecationWarning:

/media/jwagner/Data/Git/pyaudplot/venv/lib/python3.6/site-packages/flake8/plugins/manager.py:254: DeprecationWarning: SelectableGroups dict interface is deprecated. Use select.
    eps = importlib_metadata.entry_points().get(self.namespace, ())

and a FutureWarning:

  /media/jwagner/Data/Git/pyaudplot/venv/lib/python3.6/site-packages/seaborn/distributions.py:2557: FutureWarning: `distplot` is a deprecated function and will be removed in a future version. Please adapt your code to use either `displot` (a figure-level function with similar flexibility) or `histplot` (an axes-level function for histograms).
    warnings.warn(msg, FutureWarning)

at least the second should be easy to get rid of by replacing distplot with histplot. Not sure what causes the first one.

[hagenw]

The deprecation warning we are getting for flake8 is nothing we can change, but something they have to fix in there package.