# SelectDataset
## Introduction
**`SelectDataset`** widget is a dropdown menu that allows users to select a dataset or multiple datasets from a list of available datasets in the current project. It displays the name of each dataset in the list.
## Function signature
```python
SelectDataset(
default_id=None,
project_id=None,
multiselect=False,
compact=False,
show_label=True,
size=None,
disabled=False,
widget_id=None,
select_all_datasets = False,
allowed_project_types = [],
)
```
## Parameters
| Parameters | Type | Description |
| :---------------------: | :---------------------------------------: | :---------------------------------------------: |
| `default_id` | `int` | `Dataset` ID |
| `project_id` | `int` | `Project` ID |
| `multiselect` | `bool` | Allow to select all datasets in current project |
| `compact` | `bool` | Show only dataset select |
| `show_label` | `bool` | Show label |
| `size` | `Literal["large", "small", "mini", None]` | Selector size |
| `disabled` | `bool` | Disable dataset select |
| `widget_id` | `str` | ID of the widget |
| `select_all_datasets` | `bool` | Select all datasets |
| `allowed_project_types` | `List[ProjectType]` | List of allowed project types |
### default\_id
Determine `Dataset` will be selected by default.
**type:** `int`
**default value:** `None`
```python
select_project = SelectDataset(default_id=dataset_id)
```
### project\_id
Determine `Project` will be selected by default.
**type:** `int`
**default value:** `None`
```python
select_project = SelectDataset(project_id=project_id)
```
### multiselect
Allow to select multiple datasets in current project.
**type:** `bool`
**default value:** `false`
```python
select_dataset = SelectDataset(default_id=dataset_id, project_id=project_id, multiselect=True)
```
### compact
Show only `Dataset` select.
**type:** `bool`
**default value:** `false`
```python
select_dataset = SelectDataset(default_id=dataset_id, project_id=project_id, compact=True)
```
### show\_label
Determine show text `Dataset` on widget or not, work only if `compact` is True.
**type:** `bool`
**default value:** `True`
```python
select_dataset = SelectDataset(
default_id=dataset_id, project_id=project_id, compact=True, show_label=False
)
```
### size
Size of input.
**type:** `Literal["large", "small", "mini", None]`
**default value:** `None`
```python
select_dataset = SelectDataset(
default_id=dataset_id, project_id=project_id, compact=True, show_label=False
)
select_mini = SelectDataset(
default_id=dataset_id, project_id=project_id, compact=True, show_label=False, size="mini"
)
select_small = SelectDataset(
default_id=dataset_id, project_id=project_id, compact=True, show_label=False, size="small"
)
select_large = SelectDataset(
default_id=dataset_id, project_id=project_id, compact=True, show_label=False, size="large"
)
card = Card(
title="Select Dataset",
content=Container(widgets=[select_dataset, select_mini, select_small, select_large]),
)
```
### disabled
Determine `Dataset` select ability.
**type:** `bool`
**default value:** `false`
```python
select_dataset = SelectDataset(default_id=dataset_id, project_id=project_id, disabled=True)
```
### select\_all\_datasets
Select all datasets in current project. Work only if `multiselect` is `True`.
**type:** `bool`
**default value:** `false`
```python
select_dataset = SelectDataset(
default_id=dataset_id,
project_id=project_id,
multiselect=True,
select_all_datasets=True
)
```
### allowed\_project\_types
List of allowed project types.
**type:** `List[ProjectType]`
**default value:** `None`
```python
select_dataset = SelectDataset(
default_id=dataset_id,
project_id=project_id,
allowed_project_types=[sly.ProjectType.POINT_CLOUD_EPISODES]
)
```
### widget\_id
ID of the widget.
**type:** `str`
**default value:** `None`
## Methods and attributes
| Attributes and Methods | Description |
| :-------------------------: | ------------------------------------------------------------------------------ |
| `get_selected_id()` | Return selected `dataset ID`, if `multiselect` is `True` raise `ValueError`. |
| `get_selected_ids()` | Return selected `dataset IDs`, if `multiselect` is `False` raise `ValueError`. |
| `get_selected_project_id()` | Return id of selected Project, if `compact` is `False`. |
| `set_project_id()` | Set current project id. |
| `disable()` | Set `disabled` attribute == `True`. |
| `enable()` | Set `disabled` attribute == `False`. |
| `@value_changed` | Decorator functions is handled when selected `dataset ID` is changed. |
## Mini App Example
You can find this example in our Github repository:
[ui-widgets-demos/selection/005\_select\_dataset/src/main.py](https://github.com/supervisely-ecosystem/ui-widgets-demos/blob/master/selection/005_select_dataset/src/main.py)
### Import libraries
```python
import os
import supervisely as sly
from dotenv import load_dotenv
from supervisely.app.widgets import Card, Container, SelectDataset
```
### Init API client
First, we load environment variables with credentials and init API for communicating with Supervisely Instance:
```python
load_dotenv("local.env")
load_dotenv(os.path.expanduser("~/supervisely.env"))
api = sly.Api()
```
### Prepare `project_id` and `dataset_id`
```python
project_id = sly.env.project_id()
dataset_id = sly.env.dataset_id()
```
### Initialize `SelectDataset` widget
```python
select_dataset = SelectDataset(
default_id=dataset_id,
project_id=project_id,
)
```
### Create app layout
Prepare a layout for app using `Card` widget with the `content` parameter and place widget that we've just created in the `Container` widget.
```python
card = Card(
title="Select Dataset",
content=Container(widgets=[select_dataset]),
)
layout = Container(widgets=[card])
```
### Create app using layout
Create an app object with layout parameter.
```python
app = sly.Application(layout=layout)
```