Skip to content

CHANGELOG.md

Latest commit

 

History

History
706 lines (559 loc) · 31.3 KB

CHANGELOG.md

File metadata and controls

706 lines (559 loc) · 31.3 KB
Raw

🚀 Version 1.8.0

Breaking Changes

  • ❌ bin_statistic_positional now returns the flat zone statistics
    dictionary (the same as bin_statistic_zones) instead of a list of
    dictionaries, and heatmap_positional plots the zones as a single
    collection instead of a list of QuadMesh.
  • ❌ On inverted-y pitches ('statsbomb', 'wyscout', 'metricasports'),
    explicit y bin edges are now flipped along with the data in
    bin_statistic, bin_statistic_sonar, bin_statistic_positional
    and the zones methods. Results only change if you used asymmetric
    y edges (previously counted in the wrong bands) or have points
    exactly on the 'metricasports' positional band edges (previously
    assigned to a band by floating point rounding, now always the band
    displayed above the edge).

Added

  • 🎯 Added heatmaps for custom zones. The bin_statistic_zones
    method bins events into any rectangular layout.
    The heatmap_zones method plots the zones as a single collection so
    colorbars work, and label_heatmap works on the results.
  • Added the positional_zones method returning the Juego de Posición
    layout as (zones, names) for use with bin_statistic_zones.
  • Added the draw_zones method for drawing a zone layout without
    validating it, so you can build a layout iteratively.
  • Added the mirror_zones method for completing a zone layout by
    reflecting it about the middle of the pitch.
  • 🕶️ Added Sonars for zones. The bin_statistic_sonar_zones
    method bins the event angles within each zone and the sonar_zones
    method plots a sonar at the centre of each zone.
  • Added the sonar_zorder argument to sonar_grid and sonar_zones
    to control where the sonar axes are drawn amongst the other artists.

Fixed

  • Fixed artists drawing outside the pitch when parts of the pitch are
    hidden (negative pads or half pitches). The sonar_grid, sonar_zones
    (disable with exclude_outside=False) and formation methods skip
    out-of-view insets (returned as None) and label_heatmap labels are
    clipped to the axes (pass clip_on=False for the old behaviour).

🚀 Version 1.7.1

Fixes

  • Fixed curved text labels crashing on matplotlib 3.8 to 3.10
    (Text.get_linespacing is only available from matplotlib 3.11).

🚀 Version 1.7.0

Breaking Changes

  • Requires matplotlib 3.8 or above (curved radar labels use text
    antialiasing APIs added in matplotlib 3.8).
  • The undocumented Radar.rotation attribute now always holds the angle
    of each parameter around the chart (zero at the top, increasing clockwise).
    Previously the lower-half angles were flipped 180 degrees so the text
    labels are not upside down; this flip is now only applied to
    Radar.rotation_degrees.

Added

  • 😍 Added curved text labels for radar charts by
    PGupta-Git. The curved=True argument
    in Radar.draw_param_labels() curves parameter labels around the radar
    perimeter instead of using straight rotated text. Includes support for
    multi-line labels with automatic visual ordering and configurable
    letter spacing (curved_letter_spacing).
  • 🍕 Added curved parameter labels for pizza charts. The
    curved_params=True argument in PyPizza.make_pizza() curves the
    parameter labels around the chart (with curved_letter_spacing
    controlling the letter spacing). To support this, CurvedText
    works on polar axes, where the position is (x = theta, y = radius) like
    matplotlib's text and the text curves around the polar origin.

🚀 Version 1.6.1

Changes

  • Updated the minimum Python version to 3.10 as version 1.6.0 imports
    'KW_ONLY' from 'dataclasses, which is not available in python 3.9.

🚀 Version 1.6.0

Breaking Changes

  • Requires Python 3.10 or above.
  • ❌ dimension module moved to soccer.dimensions.
  • ❌ spot_scale argument of Pitch classes default changed
    to 0.024 from 0.002. This produces approximately the same size center
    spots as previously. The spot scale is now set in relation to the
    center circle, i.e. 2.4% of the center circle diameter, rather than in
    relation to the length of the pitch as previously.

🚀 Version 1.5.1

Added

  • 🍦 Adds alternative text values to PyPizza through the
    arguments alt_text_values and alt_text_compare_values.
    Sometimes you want to display actual values on the pizza chart, while
    still using percentiles for the visual representation. The additional
    arguments allow you to specify different values to display on the chart
    while keeping the percentile calculations for the slice sizes.

🚀 Version 1.5.0

Added

  • 🍦 Adds 15 formations: 532flat, 343flat, 3511flat,
    3421flat, 3412flat, 3322, 1234, 1324, 1432, 1423,
    2422, 2413, 2431, 2332, and 2233.

Changes

  • ❌ Changes two formations 541 (wing backs changed to flat back 5)
    and 541 (center attacking midfielders changed to center forwards).

🚀 Version 1.4.0

Added

  • 🍦 added Sonars for plotting the angles of football events.
    The bin_statistic_sonar method has been added for binning the data
    by pitch grid cells and the event angles. The sonar and sonar_grid
    methods have been added for plotting the Sonars.
  • 😍 added football markers for shirts and football boots by the
    wonderful Kalle Yrjänä.

Changes

  • ❌ Changed the default pitch standardizer to a 'custom' pitch (from 'uefa').
    This makes metricasports coordinate conversions more accurate, e.g. for flow diagrams.
  • ❌ Changed the label_heatmap method to return a list of matplotlib.text.Text
    instead of matplotlib.text.Annotation objects.
  • ❌ Removed the calculate_angle_and_distance method's standardized argument.
    Instead, the data is automatically standardized if the aspect ratio is unequal.
  • ❌ Internally the binned_stastics now use the BinnedStatisticResult
    dataclass rather than the _BinnedStatisticResult named tuple.
  • ❌ Changed the polar inset_axes zero location to 'N' for vertical pitches.

🚀 Version 1.3.0

Added

  • 🆕 The pitch_type argument now accepts custom dimensions in addition to strings ('statsbomb').
    For example:
    from mplsoccer.dimensions import center_scale_dims
    from mplsoccer import Pitch
    dim = center_scale_dims(pitch_width=68, pitch_length=105, width=2, length=2)
    pitch = Pitch(pitch_type=dim, label=True, axis=True)
    fig, ax = pitch.draw()
    See the mplsoccer.dimensions module for examples of how to define the dimensions. The custom dimensions must be a subclass of mplsoccer.dimensions.BaseDims.

Fixed

  • Fixed the padding validation for vertical pitches.
  • Fixed the padding scaling for vertical pitches with unequal aspect ratios.

🚀 Version 1.2.4

Added

  • Added the flip_side method to Pitch to flip coordinates to the other side of the pitch.

Fixed

  • Fixed the 424 formation so the front line is a line of four
    rather than two strikers and two attacking wingers.

🚀 Version 1.2.3

Added

  • Added the exclude_nan argument to Pitch.label_heatmap to exclude nan from text labels.
  • Added a spot_type argument to the Pitch class to enable plotting penalty and center
    spots as squares as well as circles.

Fixed

  • Fixed broken FontManager links.

🚀 Version 1.2.2

Fixed

  • Fixed an import error for matplotlib.docstring, which has been depreciated as an external module.
  • Fixed a pandas depreciation warning for the StatsBomb module.

🚀 Version 1.2.0

Added

  • 😍 Added the formation method, which plots formations as text, images, inset axes,
    scatter plots or pitches.
  • 🆕 Added the ability to return a dataframe for all the formations and player positions with the
    Pitch.formations_dataframe attribute and the Pitch.get_positions() method.
  • 🆕 Added the inset_axes and inset_image methods/functions for plotting
    inset axes and images.
  • 🆕 Added the Pitch.text wrapper for Axes.text, which automatically flips
    the x and y coordinates.
  • 🆕 Added the xoffset and yoffsetarguments to the label_heatmap method
    for plotting a heatmap's labels off-center.

Breaking Changes

  • ❌ Fixed the Matplotlib dependency to version 3.6 or higher.
  • ❌ The StatsBomb tactics_formation is changed from a numeric dtype to a string dtype,
    e.g. 442 changed to '442'

Changes

  • 🆗 Added the new pitch attributes positional_alpha and shade_alpha for
    controlling the transparency of the positional lines and shaded block in the middle of the pitch.
    Previously, the alpha was controlled by the line_alpha attribute.

Fixes

  • Fixed some deprecation warnings for Matplotlib (get_cmap) and Seaborn (kdeplot).

🚀 Version 1.1.12

Fixes

  • Fixed the timestamp conversion for match data.

🚀 Version 1.1.11

Added

  • Added the pitch type impect for plotting impect data.

🚀 Version 1.1.10

Fixes

  • Fixed the StatsBomb lineup parsers so when the player_nickname is missing
    the parsers still work.

🚀 Version 1.1.9

Fixes

  • Fixed positional pitch marking to remove extraneous lines when Pitch is created with positional=True

🚀 Version 1.1.8

Fixes

  • Fixed goal width dimensions for opta_dims definitions from (44.62,55.38) to (45.2,54.8)

🚀 Version 1.1.7

Fixes

  • Fixed the PyPizza class so that linewidths of zero are allowed values.
    see: #71
  • Fixed the HandlerFootball class so the football scatter method is compatible with
    Matplotlib 3.6 where transOffset was replaced with offset_transform.
    see: #72

Docs

  • Added a wedges example to the tutorials as an alternative to comet lines.

🚀 Version 1.1.5/1.1.6

Fixes

  • Fixes the FontManager URLs so that they can be imported in JupyterLite.

Changes

  • We now use hatch rather than setuptools for the mplsoccer build.

🚀 Version 1.1.4

Fixes

  • Fixed the Pitch.bin_statistic method so that it returns consistent binnumber results for
    the different pitch types. Now the binnumber indexing starts in the top-left hand corner
    as index 0, 0. Previously it depended on whether the pitch had an inverted y-axes whether the
    indexing started at the top or bottom left corner. This change is consistent with how indexing
    on a numpy array works (0, 0) is the top-left corner so this enables the bin statistics
    to be reconstructed from the binnumber via numpy indexing.

Changes

  • Bin numbers from Pitch.bin_statistic start in the top-left corner at index 0,0.
  • Statistics from Pitch.bin_statistic, now mirror the horizontal pitch layout, i.e. they match
    the output from Pitch.label_heatmap. The y coordinate center and edges have been flipped
    for inverted y-axis to allow this change (previously the statistic was flipped instead).

🚀 Version 1.1.3

Fixes

  • Fixed the broken links for the Roboto fonts in the docs and FontManager class.

🚀 Version 1.1.2

Fixes

  • Fixed the error message for Radar when min_range > max_range so that it notifies you
    to use the argument lower_is_better rather than greater_is_better.

Docs

  • 📃 Added an example of layering turbines and radar charts.

🚀 Version 1.1.1

Breaking Changes

  • ❌ The statsbomb module is completely overhauled to make it easier to use.
    The module now contains three classes Sbopen, Sbapi and Sblocal for retrieving data
    from the StatsBomb open-data, API, and local files.
  • ❌ Added the lower_is_better argument to Radar. If any of lower_is_better
    strings are in the parameter list then the radar object will flip the statistic.
    Previously you had to manually switch the order of the min_range and max_range
    to flip the statistic. In soccer, this is useful for parameters like miss-controls
    where fewer miss-controls is better than more.
    The default (None) does not flip any of the parameters.
  • 🆕 Added the grid module, which allows the grid function to be
    used with other types of charts.
  • ❌ The grid method is changed so if there is no endnote or title then the axes
    (or numpy array of axes) are returned rather than a dictionary.
  • ❌ Renamed calculate_grid_dimensions to grid_dimensions.

Added

  • 😍 Added a turbine chart, which is a Radar plot with multiple kernel density
    estimators plotted to show where in the distribution a person's skill falls.
    Inspired by Soumyajit Bose
  • 😍 Delaunay triangulation added to Pitch classes by
    Matthew Williamson using the triplot method.
  • 😍 Binnumbers added to the bin_statistic methods to give
    the bin indices for each event. If the event has a null coordinate or a coordinate
    outside the pitch the indices are set to negative one.
  • 🍦 corner_arcs Boolean argument added to pitches by
    Devin Pleuler for plotting corner arcs.
  • 🍦 Added the linestyle, goal_linestyle, and line_alpha
    arguments for styling of the pitches.
  • 🍦 Added spoke method to the Radar class for drawing lines from the center
    of the radar to the edges for each plotted statistic.
  • 🆕 Added the statistic=circmean argument to bin_statistic, which uses
    a nan safe version of scipy circmean.
  • 🆕 Added the draw_radar_solid method to Radar to more easily plot multiple radars
    on the same chart.

Changes

  • 🆗 polygon method of the Pitch class changed to plot multiple of
    matplotlib.patches.Polygon rather than one matplotlib.collections.PatchCollection
    so they can be clipped more easily to the shape of other patches.
  • 🆗 Removed warnings for figsize, tight_layout, contrained_layout,
    layout, view, and orientation as the arguments are deprecated.
  • 🆗 Changed how pitch lines are drawn from one continuous line to plotting some
    lines separately. The one continuous line way of plotting caused problems
    as the dotted linestyle was plotted incorrectly when the lines overlapped.
  • 🆗 Changed how the box goal is drawn from a rectangle to a line to allow
    goal_linestyle to work without it overlapping with the pitch
  • 🆗 Changed bin_statistic to use the nan safe versions of mean, std, median,
    sum, min, and max.

Docs

  • 📃 Added a new tutorial section and the first tutorial expected threat.
    Expected threat is based on the methods popularised by
    Karun Singh and Sarah Rudd.
  • 📃 Removed the matplotlib sub_plot_mosaic function from the docs.
    Many people reported that they had problems because it was not available in their
    version of matplotlib. It has been replaced with the new grid functions.

🚀 Version 1.0.7

Fixes

  • Fixed a memory leak in pitch.lines and pitch.quiver associated with assigning
    those collections to class-level legend handler map, so they never deallocated.
  • Fixed read_lineup so it works from reading from a local file.

🚀 Version 1.0.6

Fixes

  • Removed deprecated set indexer in statsbomb event reader.
  • Fixes for docs: simplified StatsBomb section, fixed broken StatsBomb logos,
    and fixed the standardizer example so that it works with the lastest version of kloppy.

🚀 Version 1.0.5

Fixes

  • Fixed the install process (setup.py) so it does not import mplsoccer. The version number is now
    contained in the _version.py file.

🚀 Version 1.0.4

Added

  • Added convexhull method to the Pitch classes. This creates a polygon with the smallest
    shape that contains the points.

🚀 Version 1.0.3

Added

  • Added **kwargs to Bumpy.plot() method.
    All the keyword arguments are passed for setting ticklabels and labels.
  • It is now possible to adjust the text in Pizza comparison charts if
    the the text overlaps through get_compare_value_texts.
    Four new methods have been added to PyPizza to enable this:
    • get_param_texts() : To fetch list of axes.text for params.
    • get_value_texts() : To fetch list of axes.text for values.
    • get_compare_value_texts() : To fetch list of axes.text for comparison-values.
    • get_theta() : To fetch list containing theta values (float) (x-coordinate for each text).
  • added line_alpha to control the transparency of the pitch lines.
  • added a cyberpunk example with glowing pitch lines.

Changes

  • increased the goal_alpha default to 1. goal_alpha can now be used with all goal_types.

Fixes

  • fixed the Pitch.grid method axis argument default to True to match the docstrings.

🚀 Version 1.0.2

This release is a major refactor of mplsoccer and a merger with soccerplots for plotting Radars.

Breaking Changes

  • ❌ orientation argument is removed.
    To plot on a vertical pitch use the new VerticalPitch class.
  • ❌ layout argument is removed. Use the Matplotlib style nrows and ncols instead.
    For example, Pitch(layout=(4, 5)) becomes pitch = Pitch() and pitch.draw(nrows=4, ncols=5).
  • ❌ view argument is removed. Use half=True to display half-a-pitch.
    For example, Pitch(view='half') becomes Pitch(half=True).
  • ❌ pitch_type=stats pitch_type option removed.
  • ❌ removed jointplot method and replaced with the more flexible jointgrid method.

Changes

  • ✅ hexbin now clips to the sides of the soccer pitch for a more
    attractive visualization.
  • ❗ wyscout goal width increased to 12 units (from 10 units)
    to align with ggsoccer. This matters as the new Standardizer
    class uses the goalpost dimensions.
  • ❗ fixed thebin_statistic_positional and heatmap_positional
    so the heatmaps are created consistently at the heatmap edges
    i.e. grid cells are created from the bottom to the top of the pitch, where the top edge
    always belongs to the cell above.

Added

  • 😍 Merged mplsoccer with soccerplots
    for wonderful radar charts and bumpy charts.
  • 🍓 Added Nightingale Rose Charts (also known as pizza charts).
  • 🍓 Added a jointgrid method to draw optional marginal axes on the four-sides
    of a soccer pitch. This replaces the old jointplot, which did not allow non-square pitches.
  • 🍓 Added the grid method to create a grid of pitches with more control
    than plt.subplots.
  • 🍓 Added FontManager from ridge_map
    by Colin Carroll for downloading and using google fonts.
  • 🍓 Added Standardizer for changing from one provider data format to another.
    For example, StatsBomb to Tracab.
  • 🍦 Added new pitch_types: skillcorner, secondspectrum, and a custom
    pitch type where the length and width can vary.
  • 🍦 Added goal_alpha for controlling the transparency of goal_type='box' goals.
  • 🍦 Added goal_type='circle' to plot the goalposts as circles.
  • 🆕 Added degrees=True option so calculate_angle_and_degrees can output the angle
    in degrees clockwise.
  • 🆕 Added create_transparent_cmap to create colormaps that vary from high transparency
    to low transparency.
  • 🆕 Added normalize option to bin_statistic and bin_statistic_positional
    so the results are divided by the total.
  • Added str_format option to label_heatmap to enable formatting of heatmap labels,
    e.g. % or rounding.
  • Added exclude_zeros option (default False) to label_heatmap to enable you to
    exclude drawing any labels equal to zero.

Fixes

  • 🆗 Changed Seaborn x and y from arguments to keyword arguments.
    This fixes a FutureWarning from Seaborn that the only valid positional argument will be data.
  • 🆗 Changed imports so that you do not need to reference the module.
    For example, you can now use: from mplsoccer import Pitch.
  • 🆗 Added repr methods for string representations of classes.
  • 🆗 Stopped the storage of the Matplotlib figure and axes in the pitch class attributes.
  • 🆗 Fixed a FutureWarning from Pandas that the lookup method will be deprecated.

Docs

  • 📃 Added examples for custom colormaps
  • 📃 Tweaked the StatsBomb data example to only update files if the
    JSON file has changed.
  • 📃 Added more beautiful scatter examples and chart titles.
  • 📃 Added examples for grid and jointgrid.

Refactoring

The pitch class has been split into multiple modules and classes to simplify the code. This helps reduce the number of conditional if/else switches.

  • pitch.py contains the new classes for plotting/ drawing pitches. The Pitch class is for a
    horizontally orientated soccer pitch, and the new VerticalPitch is for the
    vertical orientation. A change from the old API of Pitch(orientation='vertical').
  • The Pitch and VerticalPitch classes inherit their
    plotting methods from BasePitchPlot. While BasePitchPlot inherits attributes and methods
    for drawing a soccer pitch from BasePitch.
  • The soccer pitch dimensions are in a separate module (dimensions.py) for reuse within
    a new Standardizer class.
  • The code for heatmaps, arrows, lines, scatter_rotation, and scatter_football are now
    in separate modules (heatmap.py, quiver.py, linecollection.py, and scatterutils.py).

🚀 Version 0.0.23

Hot fix

Fixed the statsbomb module to allow a requests response to be used in read_event, read_match, read_competition and read_lineup. This should allow the statsbomb module to be used with the StatsBomb API via the requests library.

🚀 Version 0.0.22

Hot fix

Fixed statsbomb read_event to read the z location, as StatsBomb recently changed their data so it also records the shot impact height 'z' location.

🚀 Version 0.0.21

Changed

  1. changed the name of the 'statsperform' pitch_type to 'uefa'
  2. changed the background zorder from 0.8 -> 0.6 so it defaults to below the new Juego de posición pitch markings
  3. changed the center circle size for the opta, wyscout, statsbomb, and stats pitches to align with the edge of the six-yard box

Fixed

  1. amended the fbref plotting example to work for all five of the leagues.
  2. arrows can now take *args to allow colors to be set using C via a cmap.
  3. fixed a bug for the metricasports pitch so the center circle and arcs plot when the pitch_width and pitch_length are the same size
  4. fixed a bug for the Voronoi plot where the wyscout, opta, and metricasports data wasn't scaled appropriately to a full-sized pitch
  5. fixed bin_statistic so the binning of data is always consistent from the bottom to the top of the pitch. Previously pitches with an inverted axis were binned top to bottom. This does not currently apply to bin_statistic_positional.

Added

  1. added a method calculate_angles_and_distance to calculate the angle and distance from start and end locations.
  2. added an example for plotting a pass network contributed by DymondFormation.
  3. added parameters to shade the middle section of the pitch and draw Juego de posición pitch markings.
  4. added a method flow to plot a pass flow map and a new example using this method

🚀 Version 0.0.20

Fixed

  1. Fixed arrows so the arrows scale correctly when the dots per inches (dpi) of the figure is changed. Before the units were in dots so the arrow got smaller as the dots per inches increases. Fixed this so the arrow is in points (1/72th of an inch) so the arrow stays the same size when the dots per inch changes.

🚀 Version 0.0.19

Fixed

  1. Fixed arrows legend to work in recent versions of matplotlib.

🚀 Version 0.0.17 / 0.0.18

Changed

  1. changed the event_type_name/ event_type_id columns in the StatsBomb data to sub_type_name, sub_type_id.

🚀 Version 0.0.16

Changed

  1. combined the StatsBomb technique columns (pass_technique, goalkeeper_technique, shot_technique) into techique_id and technique_name
  2. combined the Statsbomb type columns (pass_type, duel_type_id, goalkeeper_type, shot_type) into event_type_name and event_type_id
  3. removed StatsBomb columns that repeat other columns: pass_through_ball, pass_outswinging, pass_inswinging, clearance_head, clearance_left_foot, clearance_right_foot, pass_straight, clearance_other, goalkeeper_punched_out, goalkeeper_shot_saved_off_target, shot_saved_off_target, goalkeeper_shot_saved_to_post, shot_saved_to_post, goalkeeper_lost_out, goalkeeper_lost_in_play, goalkeeper_success_out, goalkeeper_success_in_play, goalkeeper_saved_to_post, shot_kick_off, goalkeeper_penalty_saved_to_post

🚀 Version 0.0.15

Changed

  1. changed Pitch so axes aren't raveled when using subplots, e.g. layout=(2, 2). So colorbar can be used with subplots.

🚀 Version 0.0.14

Changed

  1. changed the internal workings of bin statistics and heatmaps so the results of bin_statistic can be used for other purposes.
  2. removed print function from Pitch.

🚀 Version 0.0.12

Changed

  1. changed the wyscout goal posts y locations to 45/ 55 for consistency with socceraction.

🚀 Version 0.0.11

Changed

  1. fixed the statsbomb module so the event dataset has simplified names for the end coordinates. Previously they were shot_end_x, pass_end_x etc. Now they are under three columns: end_x, end_y, end_z.

🚀 Version 0.0.10

Fixed

  1. fixed the statsbomb module so it works when the json is empty.

🚀 Version 0.0.9

Added

  1. Added Pitch.voronoi() for calculating Voronoi vertices.
  2. Added Pitch.goal_angle() for plotting the angle to the goal.
  3. Added Pitch.polygon() for plotting polygons on the pitch (e.g. goal angle and Voronoi)
  4. Added add_image for adding images to matplotlib figures.

🚀 Version 0.0.8

Fixed

  1. Made the statsbomb module clean the data faster.

🚀 Version 0.0.7

Fixed

  1. fixed Pitch.label_heatmap(). Now filters out labels outside of the pitch extent.

🚀 Version 0.0.6

Fixed

  1. fixed Pitch.bin_statistic(). Now works for statistic arguments other than 'count'.

🚀 Version 0.0.5

Fixed

  1. fixed Pitch.heatmap() bug. Now returns a mesh in horizontal orientation.

🚀 Version 0.0.4

Added

  1. Docs and gallery added.
  2. Added option to change the penalty and center spot size via spot_scale.
  3. Added legend handlers for plotting footballs in the scatter method, arrows in the arrows method, and lines in the lines method of the Pitch class.

Changed

  1. utils module renamed scatterutils
  2. Pitch.quiver() renamed Pitch.arrows()
  3. Default color of Pitch.lines() changed to rcparams['lines.color']
  4. Default hexbin cmap changed to viridis
  5. Pitch.lines() now takes alpha_start and alpha_end arguments. The line linearly increases in opacity from alpha_start to alpha_end if transparent=True. Previously these were hard coded as 0.1 and 0.5. The new defaults are 0.01 and 1.
  6. Pitch.lines() not takes cmap as an argument. You can either select cmap or color, but not both.
  7. Pitch.bin_statistic_positional() and Pitch.bin_statistic() return dictionaries rather than named tuples.
  8. Pitch defaults changed to tight_layout=True and constrained_layout=False.
  9. Default penalty and center spot size now smaller and can be adjusted.
  10. Pitch default colors changed, pitch_color is now not plotted by default ('None') and pitch lines are taken from the rcParams 'grid.color'.

🚀 Version 0.0.3

Minor pep8 fixes.

🚀 Version 0.0.2

Added

  1. Added constrained_layout option for Pitch class
  2. Added line_zorder so can raise or lower pitch markings in a plot. This was necessary so you could plot the pitch lines over a heatmap.
  3. Added support for 'statsperform' and 'metricasports' pitch types.
  4. Added support for grass texture with pitch_color='grass', e.g. Pitch(pitch_color='grass').
  5. Added heatmap and methods to bin data and create statistics to allow plotting of heatmaps over pitches.
  6. Added an arrowhead_marker. Example use: from mplsoccer.utils import arrowhead_marker; Pitch.scatter(x,y,marker='arrowhead_marker).
  7. Added support for marker rotation, e.g. Pitch.scatter(x,y,rotation_degrees=rotation_degrees). The rotation is in degrees and clockwise. Zero degrees is aligned with the direction of play, i.e. left to right in the horizontal orientation and bottom to top in vertical orientation.
  8. Added data checks around how padding is used so that you can't accidentally remove the pitch or flip the axis by setting pad_left, pad_right, pad_top,pad_bottom too negative in the Pitch class.
  9. Added Statsbomb data support to read data from the open-data repo (https://github.com/statsbomb/open-data).
  10. Added various ValueErrors to ensure that the size of input arrays for plots are the same.

Changed

  1. Default pitch_type is now 'statsbomb'. It was 'opta'.
  2. Changed defaults for Pitch class: tight_layout=False and constrained_layout=True
  3. Renamed Pitch.joint_plot() to Pitch.jointplot() to align with Seaborn.
  4. Pitch backgrounds now plotted internally with the method Pitch._set_background().

Fixed

  1. Fixed jointplot to clip to pitch outline.
  2. Fixed 'wyscout' pitch type. The 0,0 coordinate is meant to be top left.
  3. Fixed the Pitch.lines() method to take a non-sequence (e.g. one line).
  4. Fixed the Pitch.lines() method so that when transparent=True its consistent across pitch types. It is more transparent at the line start and more opaque at the line end.
  5. Fixed how dimensions are represented in the Pitch class internally (left, right, bottom, top) so they match the horizontal pitch orientation.

🚀 Version 0.0.1

Fixed

  1. Fixed the README so it loads pictures from the raw GitHub files.

🚀 Version 0.0.0

Initial version. Pitch class with plotting methods: scatter, lines, quiver, kdeplot, hexbin, and joint_plot. Scatter accepts marker='football' to plot footballs.