> ## Documentation Index
> Fetch the complete documentation index at: https://www.canva.dev/opensource/flourish-charts/llms.txt
> Use this file to discover all available pages before exploring further.
# Bind sports data
## Usage
```python
def bind_sports_data(
self,
info: Union[list, str] = None,
color: str = None,
size: str = None,
squad_number: str = None,
position_x: str = None,
position_y: str = None,
filter: str = None,
photo: str = None,
metadata: Union[list, str] = None
)
```
```r
bind_sports_data(
.,
info = NULL,
color = NULL,
size = NULL,
squad_number = NULL,
position_x = NULL,
position_y = NULL,
filter = NULL,
photo = NULL,
metadata = NULL
)
```
## Arguments
| Arguments | Type hint | Description |
| -------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `self` | `Flourish` | Returns the Flourish object |
| `info` | `Union[list, str]`, optional | Name. A name to include on a label and/or popup. Suggested data type hints: string, number. Flourish type hint: columns |
| `color` | `str`, optional | Color by. An optional category column to color the dots by. For example if you have two different teams. Suggested data type hints: string. Flourish type hint: column |
| `size` | `str`, optional | Size by. An optional numeric column to size the dots. Suggested data type hints: number. Flourish type hint: column |
| `squad_number` | `str`, optional | Squad numbers. An optional squad number to appear within the dot. Suggested data type hints: number, string. Flourish type hint: column |
| `position_x` | `str`, optional | X position. Use this to column to set the X position of a dot on the pitch when creating shot charts. This column is ignored when the setting Position points by is set to FormationSuggested data type hints: number. Flourish type hint: column |
| `position_y` | `str`, optional | Y position. Use this to column to set the Y position of a dot on the pitch when creating shot charts. This column is ignored when the setting Position points by is set to FormationSuggested data type hints: number. Flourish type hint: column |
| `filter` | `str`, optional | Filter by. Setting a column here will add a control to the visualization to filter the dots. For example you could filter by team. Suggested data type hints: string, number. Flourish type hint: column |
| `photo` | `str`, optional | Image. Add an image to appear in the circles. To add an image, right click on a cell and click upload file Its also possible to add a image URL. Suggested data type hints: string. Flourish type hint: column |
| `metadata` | `Union[list, str]`, optional | Info for popups. One or more columns of information (text, image URLs, embedded charts etc) to include in popups and panels Suggested data type hints: string, number, datetime. Flourish type hint: columns |
| Arguments | Description |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `.` | Returns the Flourish object |
| `info` | Name. A name to include on a label and/or popup. Suggested data type hints: string, number. Flourish type hint: columns |
| `color` | Color by. An optional category column to color the dots by. For example if you have two different teams. Suggested data type hints: string. Flourish type hint: column |
| `size` | Size by. An optional numeric column to size the dots. Suggested data type hints: number. Flourish type hint: column |
| `squad_number` | Squad numbers. An optional squad number to appear within the dot. Suggested data type hints: number, string. Flourish type hint: column |
| `position_x` | X position. Use this to column to set the X position of a dot on the pitch when creating shot charts. This column is ignored when the setting Position points by is set to FormationSuggested data type hints: number. Flourish type hint: column |
| `position_y` | Y position. Use this to column to set the Y position of a dot on the pitch when creating shot charts. This column is ignored when the setting Position points by is set to FormationSuggested data type hints: number. Flourish type hint: column |
| `filter` | Filter by. Setting a column here will add a control to the visualization to filter the dots. For example you could filter by team. Suggested data type hints: string, number. Flourish type hint: column |
| `photo` | Image. Add an image to appear in the circles. To add an image, right click on a cell and click upload file Its also possible to add a image URL. Suggested data type hints: string. Flourish type hint: column |
| `metadata` | Info for popups. One or more columns of information (text, image URLs, embedded charts etc) to include in popups and panels Suggested data type hints: string, number, datetime. Flourish type hint: columns |