.. _plot:

Plot
====

The scrapenhl2.plot module contains methods useful for plotting.

Useful examples
---------------

First, import::

   from scrapenhl2.plot import *

Get the H2H for an in-progress game::

   live_h2h('WSH', 'EDM')

.. image:: _static/example_h2h.png

Get the Corsi timeline as well, but don't update data this time::

   live_timeline('WSH', 'EDM', update=False)

.. image:: _static/example_timeline.png

Save the timeline of a memorable game to file::

   game_timeline(2016, 30136, save_file='/Users/muneebalam/Desktop/WSH_TOR_G6.png')

More methods being added regularly.

App
----

This package contains a lightweight app for browsing charts and doing some data manipulations.

Launch using::

   import scrapenhl2.plot.app as app
   app.browse_game_charts()
   # app.browse_player_charts()
   # app.browse_team_charts()

It will print a link in your terminal--follow it. The page looks something like this:

.. image:: _static/game_page_screenshot.png

The dropdowns also allow you to search--just start typing.

Methods (games)
-----------------

Game H2H
~~~~~~~~
.. image:: _static/WSH-TOR_G6.png
   :width: 50%
   :align: right

.. automodule:: scrapenhl2.plot.game_h2h
   :members:

Corsi timeline
~~~~~~~~~~~~~~
.. image:: _static/WSH-TOR_G6_timeline.png
   :width: 50%
   :align: right

.. automodule:: scrapenhl2.plot.game_timeline
   :members:

Methods (teams)
---------------

Team TOI by score
~~~~~~~~~~~~~~~~~
.. image:: _static/Score_states_2015.png
   :width: 50%
   :align: right

.. automodule:: scrapenhl2.plot.team_score_state_toi
   :members:

Team lineup CF%
~~~~~~~~~~~~~~~
.. image:: _static/Caps_lineup_cf.png
   :width: 50%
   :align: right

.. automodule:: scrapenhl2.plot.team_lineup_cf
   :members:

Team shot rates by score
~~~~~~~~~~~~~~~~~~~~~~~~

.. image:: _static/Caps_shot_score_parallel.png
   :width: 49%
.. image:: _static/Caps_shot_rates_score_scatter.png
   :width: 49%


.. automodule:: scrapenhl2.plot.team_score_shot_rate
   :members:

Methods (individuals)
----------------------

Player rolling CF and GF
~~~~~~~~~~~~~~~~~~~~~~~~
.. image:: _static/Ovechkin_rolling_cf.png
   :width: 50%
   :align: right

.. automodule:: scrapenhl2.plot.rolling_cf_gf
   :members:

Player rolling boxcars
~~~~~~~~~~~~~~~~~~~~~~
.. image:: _static/Oshie_boxcars.png
   :width: 50%
   :align: right

.. automodule:: scrapenhl2.plot.rolling_boxcars
   :members:

Methods (individual comparisons)
--------------------------------

Team D-pair shot rates
~~~~~~~~~~~~~~~~~~~~~~

.. image:: _static/Caps_d_pairs.png
   :width: 50%
   :align: right

.. automodule:: scrapenhl2.plot.defense_pairs
   :members:

Usage
~~~~~
.. automodule:: scrapenhl2.plot.usage
   :members:

Helper methods
--------------

.. automodule:: scrapenhl2.plot.visualization_helper
   :members:

.. automodule:: scrapenhl2.plot.label_lines
   :members: