Skip to content

Data displays ​

datasetBrowser ​

tsx
function datasetBrowser(
  dataset: Dataset<InputType, string>,
  options: {
    batchSize: number;
  },
): DatasetBrowser;

A Dataset browser provides an interface to visualize the contents of a dataset. It takes a dataset as argument, assuming that each instance contains a thumbnail property that can be displayed as an image (typically, a base64 dataURI).

Parameters ​

OptionTypeDescriptionRequired
datasetDatasetThe dataset to visualize✓
options.batchSizenumberThe number of images per batch. If 0, all images are loaded. Defaults to 6.✓

Screenshot ​

Screenshot of the datasetBrowser component

Example ​

js
const trainingSetBrowser = marcelle.datasetBrowser(trainingSet);
dashboard.page('Data Management').use(trainingSetBrowser);

datasetScatter ​

tsx
function datasetScatter<T extends Instance>(dataset: Dataset<T>): DatasetScatter<T>;

Visualize the contents of a dataset using a scatter plot visualization. The mapping between the fields of dataset instances and the x, y position, as well as the label, can be specified using transformer functions.

Parameters ​

OptionTypeDescriptionRequired
datasetDataset -The dataset to visualize✓

Methods ​

.setTransforms() ​

tsx
function setTransforms(t: Partial<Transforms<T>>): void;

Set one or several data transformations for xy coordinates, and label. Transforms have the following signature:

ts
interface Transforms<T extends Instance> {
  xy: (value: T) => [number, number] | Promise<[number, number]>;
  label: (value: T) => number | string | Promise<number | string>;
}

Screenshot ​

Screenshot of the datasetScatter component

Example ​

js
const trainingScatter = marcelle.datasetScatter(trainingSet);
dashboard.page('Data Management').use(trainingScatter);

datasetTable ​

tsx
function datasetTable(dataset: Dataset, columns?: string[]): DatasetTable;

This components provides a visualization of a dataset as a paginated data table, where each row describes an instance. It takes a dataset as argument, and optionally the list of columns to display.

Parameters ​

OptionTypeDescriptionRequired
datasetDatasetThe dataset to visualize✓
columnsstring[]The fields to display as columns in the visualization. Defaults to ['x', 'y', 'thumbnail', 'updatedAt'].

Screenshot ​

Screenshot of the datasetTable component

Example ​

js
const tst = marcelle.datasetTable(trainingSet);
dashboard.page('Data Management').use(tst);

imageDisplay ​

tsx
function imageDisplay(imageStream: Stream<ImageData> | Stream<ImageData[]>): DatasetBrowser;

An Image Display allows for displaying an image on screen provided by an input stream.

Parameters ​

OptionTypeDescriptionRequired
imageStreamStream<ImageData> | Stream<ImageData[]>Stream of images of ImageData format✓

Example ​

js
const source = imageUpload({ width: 224, height: 224 });
const instanceViewer = marcelle.imageDisplay(source.$images);
dashboard.page('Data').use(instanceViewer);

videoPlayer ​

tsx
function videoPlayer(src: string): VideoPlayer;

A simple video player.

Parameters ​

OptionTypeDescriptionRequired
srcstringVideo source

Screenshot ​

Screenshot of the videoPlayer component

Example ​

js
const player = videoPlayer();
player.$src.set('http://localhost:3030/assets/65533254bbcc10126bd44ad3/asset.webm');