# RadioTable ## Introduction **`RadioTable`** widget in Supervisely is a user interface element that allows creating a table of options, each with a corresponding radio button. With `RadioTable` widget, developer can define multiple rows of options, and only one row option can be selected. The RadioTable widget provides a convenient and intuitive way to navigate and make selections within the table. ## Function signature ```python RadioTable( columns, rows, subtitles={}, column_formatters={}, widget_id=None, ) ```
## Parameters | Parameters | Type | Description | | :-----------------: | :---------------------------: | :-------------------------------------: | | `columns` | `List[str]` | `RadioTable` columns names | | `rows` | `List[List[str]]` | `RadioTable` rows content | | `subtitles` | `Union[Dict[str, str], List]` | Determine subtitles for columns | | `column_formatters` | `Dict` | Determine format of output `RadioTable` | | `widget_id` | `str` | ID of the widget | ### columns Determine `RadioTable` columns names. **type:** `List[str]` ### rows Determine `RadioTable` rows content. **type:** `List[List[str]]` ```python radio_table = RadioTable( columns=["Format", "Total Images", "Number of Classes", "Number of Objects"], rows=[ ["Supervisely", "245", "15", "5468"], ["PascalVOC", "76", "20", "387"], ["COCO", "128", "80", "786"], ["Cityscapes", "45", "35", "1334"], ] ) ```
### subtitles Determine subtitles for columns. **type:** `Union[Dict[str, str], List]` **default value:** `{}` ```python subtitles = {"Format": "Format subtitle", "Number of Classes": "Number of Classes subtitle"} radio_table = RadioTable( columns=["Format", "Total Images", "Number of Classes", "Number of Objects"], rows=[ ["Supervisely", "245", "15", "5468"], ["PascalVOC", "76", "20", "387"], ["COCO", "128", "80", "786"], ["Cityscapes", "45", "35", "1334"], ], subtitles=subtitles, ) ```
### column\_formatters Determine format of output `RadioTable`. **type:** `Dict` **default value:** `{}` ### widget\_id ID of the widget. **type:** `str` **default value:** `None` ## Methods and attributes | Attributes and Methods | Description | | :------------------------------------------------------------------------------------------------: | ------------------------------------------------------------------------------------------------------ | | `columns` | Get or set `columns` property. | | `subtitles` | Get or set `subtitles` property. | | `rows` | Get or set `rows` property. | | `format_value(column_name: str, value: list)` | Return column formatter function by given column name. | | `default_formatter(value: list)` | Return default column formatter. | | `get_selected_row()` | Return selected row data. | | `get_selected_row_index()` | Return selected row index. | | `set_columns(columns: List[str], subtitles: Union[Dict[str, str], List[str]])` | Set table columns by given list of column names. | | `set_data(columns: List[str], rows: List[List[str]], subtitles: Union[Dict[str, str], List[str]])` | Set table data. | | `select_row(row_index: int)` | Set row selected by given index. If row with given index does not exist raise `ValueError`. | | `@value_changed` | Decorator function is handled when widget value is changed | | `select_row_by_value` | Set row selected by given column and value. If row with given value does not exist raise `ValueError`. | ## Mini App Example You can find this example in our Github repository: [ui-widgets-demos/tables/003\_radio\_table/src/main.py](https://github.com/supervisely-ecosystem/ui-widgets-demos/blob/master/tables/003_radio_table/src/main.py) ### Import libraries ```python import os import time import supervisely as sly from dotenv import load_dotenv from supervisely.app.widgets import Button, Card, Container, DoneLabel, Progress, RadioTable ``` ### 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() ``` ### Initialize `RadioTable` widget ```python radio_table = RadioTable( columns=["Format", "Total Images", "Number of Classes", "Number of Objects"], rows=[ ["Supervisely", "245", "15", "5468"], ["PascalVOC", "76", "20", "387"], ["COCO", "128", "80", "786"], ["Cityscapes", "45", "35", "1334"], ], ) ``` ### Create additional widgets we will use in UI ```python button = Button("Button") progress = Progress(message="processing images", show_percents=True) progress.hide() done_label = DoneLabel() done_label.hide() ``` ### 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 radio_table_card = Card( title="Radio Table", content=Container([radio_table, button]), ) progress_card = Card( title="Progress", content=Container([progress, done_label]), ) layout = Container( widgets=[radio_table_card, progress_card], direction="horizontal", fractions=[1, 1], ) layout = Container(widgets=[card]) ``` ### Create app using layout Create an app object with layout parameter. ```python app = sly.Application(layout=layout) ``` ### Add functions to control widgets from code ```python @button.click def show_progress(): progress.show() selected_row = radio_table.get_selected_row() images_count = int(selected_row[1]) with progress(message="Downloading images from Flickr...", total=images_count) as pbar: for _ in range(images_count): time.sleep(0.01) pbar.update(1) done_label.text = f"{images_count} images processed from {selected_row[0]} format data." done_label.show() ```
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://developer.supervisely.com/app-development/widgets/tables/radiotable.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.