Function Repository Resource:

SportsFieldGraphics

Display information on the fields of play for various popular sports

Contributed by: Jon McLoone

ResourceFunction["SportsFieldGraphics"]["sport"]

displays the standard markings of the pitch for "sport".

ResourceFunction["SportsFieldGraphics"]["sport",gr]

displays the standard markings of the pitch for "sport" together with Graphics gr.

Details and Options

ResourceFunction["SportsFieldGraphics"] currently supports the following sports: “AerobicGymnastics”, “AmericanFootball”, “Archery”, “ArtisticGymnastics”, “AustralianFootball”, “Badminton”, “Bandy”, “Baseball”, “Basketball”, “BeachHandball”, “BeachSoccer”, “BeachVolleyball”, “Bocce”, “Boccia”, “Bowling”, “Boxing”, “BoxLacrosse”, “Canoeing”, “CanoePolo”, “CaromBilliards”, “Cheerleading”, “Cornhole”, “Cricket”, “Croquet”, “Curling”, “Darts”, “DiscGolf”, “Diving”, “Dodgeball”, “Dressage”, “EnglishBilliards”, “Fencing”, “FieldHockey”, “Floorball”, “Futsal”, “GaelicFootball”, “Goalball”, “Handball”, “Horseshoes”, “Hurling”, “IceHockey”, “IceSpeedSkating”, “JaiAlai”, “Judo”, “Kabaddi”, “Karate”, “Kayaking”, “Kendo”, “KhoKho”, “Korfball”, “Lacrosse”, “LawnBowls”, “MixedMartialArts”, “Netball”, “Padel”, “Petanque”, “Pickleball”, “Polo”, “Pool”, “Quadball”, “Racquetball”, “RhythmicGymnastics”, “RinkHockey”, “RollerDerby”, “Rounders”, “Rowing”, “RugbyLeague”, “RugbyUnion”, “SepakTakraw”, “Shinty”, “Shooting”, “Shuffleboard”, “SittingVolleyball”, “SlowPitchSoftball”, “Snooker”, “Soccer”, “Softball”, “Squash”, “Sumo”, “Swimming”, “TableTennis”, “Taekwondo”, “Tchoukball”, “TeeBall”, “TenMeterAirPistol”, “Tennis”, “Teqball”, “ThreeOnThreeBasketball”, “TrackAndField”, “TrackAndFieldDiscus”, “TrackAndFieldHammerThrow”, “TrackAndFieldHighJump”, “TrackAndFieldHurdles”, “TrackAndFieldJavelin”, “TrackAndFieldLongJump”, “TrackAndFieldPoleVault”, “TrackAndFieldShot”, “TrackAndFieldSteeplechase”, “TrackAndFieldTripleJump”, “TrampolineGymnastics”, “Ultimate”, “UnderwaterHockey”, “Volleyball”, “WaterPolo”, “Weightlifting”, “WheelchairBasketball”, “WheelchairRugby”, “Wrestling”, “Wushu”

The list of supported sports can be retrieved by evaluating ResourceFunction["SportsFieldGraphics"][].

In addition to standard Graphics options, the following options are supported:

"Units"

"Meters"

unit system used for coordinates

"Length"

Automatic

the length of the pitch for pitches that have variable sizes

"Width"

Automatic

the width of the pitch for pitches that have variable sizes

"PitchFontStyle"

Automatic

font information for text in pitch markings

Background

Automatic

background color or Texture for the pitch, usually dark green

"LineStyle"

Automatic

style for pitch markings, usually white

"PitchOrigin"

{Center,Center}

where {0, 0} lies on the pitch

"Tooltips"

False

whether to show tooltips for each element of the graphic

Examples

Basic Examples (2)

Create a blank sports pitch:

In[1]:=

Out[1]=

Combine the pitch with other graphics:

In[2]:=

Out[2]=

Scope (4)

Any Graphics object can be combined with SportsFieldGraphics:

In[3]:=

Out[3]=

A contour plot of the same data:

In[4]:=

Out[4]=

A range of sports is supported:

In[5]:=

Out[5]=

You can specify the sport using a "Sport" Entity:

In[6]:=

Out[6]=

Options (10)

Background (2)

Where pitches have multiple background colors, you can provide Background as a list:

In[7]:=

Out[7]=

Background can also be set to a Texture which will fill the field of play plus 10%:

In[8]:=

Out[8]=

Length (1)

Some sports do not prescribe exact dimensions. You can use "Length" and "Width" to override the default values:

In[9]:=

Out[9]=

In[10]:=

Out[10]=

LineStyle (1)

Pitch line styles can be specified:

In[11]:=

Out[11]=

PitchFontStyle (1)

Use "PitchFontStyle" to change the style of any text in a pitch:

In[12]:=

Out[12]=

PitchOrigin (1)

The default origin is in the center of the pitch, but you can change this with "PitchOrigin":

In[13]:=

Out[13]=

Units (2)

The default unit system for sports pitches is "Meters":

In[14]:=

Out[14]=

You can change this with the option "Units":

In[15]:=

Out[15]=

Width (1)

Some sports do not prescribe exact dimensions. You can use "Length" and "Width" to override the default values. If you exceed maximum or minimum sizes allowed for a sport, SportsFieldGraphic will use the closest allowed value:

In[16]:=

Out[16]=

Tooltips (1)

Each element of the graphic can explained via tooltips:

In[17]:=

Applications (1)

As well as visualizing sports analytics data in context, you can use graphics primitives to create sports-related diagrams:

In[18]:=

ResourceFunction["SportsFieldGraphics"]["Croquet", Graphics[{Yellow, Arrow[BSplineCurve@{{-12.19, 6.481}, {-7.729, 6.459}, {8.44, 6.397}, {10.89, 6.362}, {12.57, 4.569}, {12.75, -0.8702}, {11.05, -6.196}, {8.783, -6.53}, {-8.657, -6.658}, {-10.53, -6.434}, {-12.26, -3.666}, {-9.478, -0.1313}, {-6.191, 0.02759}, {-4.242, -0.1746}, {-0.6425, -2.082}, {6.171, -1.937}, {6.618, -0.03199}, {4.522, -0.04418}, {2.143, 0.1934}}]}],
PlotLabel -> Style["Croquet hoop order", 20, White],
PlotRange -> {{-17, 17}, {-15, 15}}]

Out[18]=

Possible Issues (3)

The full play area is used by default:

In[19]:=

Out[19]=

For cricket, you may wish to use PlotRange to show only the pitch:

In[20]:=

Out[20]=

If you specify settings for "Length" or "Width" that exceed maximum or minimum sizes allowed for a sport, SportsFieldGraphics will use the closest allowed value:

In[21]:=

Out[21]=

Some sports have only fixed choices for size:

In[22]:=

Out[22]=

Publisher

Jon McLoone

Requirements

Wolfram Language 12.3 (May 2021) or above

Version History

2.0.0 – 25 September 2026
1.3.1 – 05 July 2022
1.3.0 – 19 January 2022

License Information

This work is licensed under a Creative Commons Attribution 4.0 International License

Wolfram Function Repository

SportsFieldGraphics

Details and Options