> ## 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 |