> ## 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 scatter data
## Usage
```python
def bind_scatter_data(
self,
x: str = None,
y: str = None,
name: Union[list, str] = None,
color: str = None,
size: str = None,
shape: str = None,
facet: str = None,
slider: str = None,
series: str = None,
filter: str = None,
metadata: Union[list, str] = None
)
```
```r
bind_scatter_data(
.,
x = NULL,
y = NULL,
name = NULL,
color = NULL,
size = NULL,
shape = NULL,
facet = NULL,
slider = NULL,
series = NULL,
filter = NULL,
metadata = NULL
)
```
## Arguments
| Arguments | Type hint | Description |
| ---------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `self` | `Flourish` | Returns the Flourish object |
| `x` | `str`, optional | X values. Suggested data type hints: number, string, datetime. Flourish type hint: column |
| `y` | `str`, optional | Y values. Suggested data type hints: number, string, datetime. Flourish type hint: column |
| `name` | `Union[list, str]`, optional | Name. Select multiple columns if required to make a unique name. Suggested data type hints: string. Flourish type hint: columns |
| `color` | `str`, optional | Color. Colors the dots based on numbers or categories. Suggested data type hints: string, number. Flourish type hint: column |
| `size` | `str`, optional | Size. Sizes the dots based on the numbers. Suggested data type hints: number, string. Flourish type hint: column |
| `shape` | `str`, optional | Shape. Sets the shape of the dots based on numbers or categories. Suggested data type hints: string. Flourish type hint: column |
| `facet` | `str`, optional | Grid of charts (facet). Creates a mini chart for each value in the selected column. Suggested data type hints: string. Flourish type hint: column |
| `slider` | `str`, optional | Time. Creates a time slider and connects/animates dots with the same name. Suggested data type hints: datetime, string, number. Flourish type hint: column |
| `series` | `str`, optional | Series (connect with line). Group dots into series based on the contents of a column. Suggested data type hints: string. Flourish type hint: column |
| `filter` | `str`, optional | Filter control. Creates a control based on the contents of any column. Suggested data type hints: string, number, datetime. 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 panelsSuggested data type hints: string, number, datetime. Flourish type hint: columns |
| Arguments | Description |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `.` | Returns the Flourish object |
| `x` | X values. Suggested data type hints: number, string, datetime. Flourish type hint: column |
| `y` | Y values. Suggested data type hints: number, string, datetime. Flourish type hint: column |
| `name` | Name. Select multiple columns if required to make a unique name. Suggested data type hints: string. Flourish type hint: columns |
| `color` | Color. Colors the dots based on numbers or categories. Suggested data type hints: string, number. Flourish type hint: column |
| `size` | Size. Sizes the dots based on the numbers. Suggested data type hints: number, string. Flourish type hint: column |
| `shape` | Shape. Sets the shape of the dots based on numbers or categories. Suggested data type hints: string. Flourish type hint: column |
| `facet` | Grid of charts (facet). Creates a mini chart for each value in the selected column. Suggested data type hints: string. Flourish type hint: column |
| `slider` | Time. Creates a time slider and connects/animates dots with the same name. Suggested data type hints: datetime, string, number. Flourish type hint: column |
| `series` | Series (connect with line). Group dots into series based on the contents of a column. Suggested data type hints: string. Flourish type hint: column |
| `filter` | Filter control. Creates a control based on the contents of any column. Suggested data type hints: string, number, datetime. 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 panelsSuggested data type hints: string, number, datetime. Flourish type hint: columns |