API Reference

General APIs

optuna_dashboard.run_server

Start running optuna-dashboard and blocks until the server terminates.

optuna_dashboard.wsgi

This function exposes WSGI interface for people who want to run on the production-class WSGI servers like Gunicorn or uWSGI.

optuna_dashboard.set_objective_names

Set the names of objectives.

optuna_dashboard.save_note

Save the note (Markdown format) to the Study or Trial.

optuna_dashboard.save_plotly_graph_object

Save the user-defined plotly's graph object to the study.

Human-in-the-loop

Form Widgets

optuna_dashboard.register_objective_form_widgets

Register a list of form widgets to an Optuna study.

optuna_dashboard.register_user_attr_form_widgets

Register a list of form widgets to an Optuna study.

optuna_dashboard.dict_to_form_widget

Restore form widget objects from the dictionary.

optuna_dashboard.ChoiceWidget

A widget representing a choice with associated values.

optuna_dashboard.SliderWidget

A widget representing a slider for selecting a value within a range.

optuna_dashboard.TextInputWidget

A text input widget class that defines a text input field.

optuna_dashboard.ObjectiveUserAttrRef

A class representing a reference to a value of trial.user_attrs.

Preferential Optimization

optuna_dashboard.preferential.create_study

Like optuna.create_study(), but for preferential optimization.

optuna_dashboard.preferential.load_study

Like optuna.load_study(), but for preferential optimization.

optuna_dashboard.preferential.PreferentialStudy

A Study-like class for preferential optimization.

optuna_dashboard.preferential.samplers.gp.PreferentialGPSampler

Sampler for preferential optimization using Gaussian process.

optuna_dashboard.register_preference_feedback_component

Register a preference feedback component to the study.

Streamlit

optuna_dashboard.streamlit.render_trial_note

Write a trial note to UI with streamlit as a markdown format.

optuna_dashboard.streamlit.render_objective_form_widgets

Render user input widgets to UI with streamlit.

optuna_dashboard.streamlit.render_user_attr_form_widgets

Render user input widgets to UI with streamlit.

Artifact

optuna_dashboard.artifact.upload_artifact

Upload an artifact (files), which is associated with the trial.

optuna_dashboard.artifact.file_system.FileSystemBackend

An artifact backend for file systems.

optuna_dashboard.artifact.boto3.Boto3Backend

An artifact backend for S3.

optuna_dashboard.artifact.backoff.Backoff

An artifact backend middleware for exponential backoff.

optuna_dashboard.artifact.prefix.AppendPrefix

An artifact backend middleware that appends a prefix string to artifact ids.

optuna_dashboard.artifact.protocol.ArtifactBackend

A protocol defining the interface for an artifact backend.

optuna_dashboard.artifact.exceptions.ArtifactNotFound

Exception raised when an artifact is not found.