API Reference

Core Modules

exception main.TimeoutException

Bases: Exception

class main.ViewerApp

Bases: object

get_metadata_summary()

run()

setup_callbacks()

setup_help_modal_callback()

setup_variable_metadata_callback()

update_variable_dropdown()

Data Loading and Processing

class data.DataManager(app, dataset_getter)

Bases: object

Unified data management class that handles subsetting, statistics, and plotting. This consolidates the previously scattered functionality into a clean, simple API.

create_raster_image(data_array, variable_name, lat_dim, lon_dim)

Create a raster image from the data array and save it

setup_callbacks()

Setup all data-related callbacks in one place

class data.DataPlot(app, data_array, dimension_selection, dataseturl_getter, dataset_engine_getter)

Bases: object

Legacy class - use DataManager instead

setup_callbacks()

class data.DataQuickStats(app, ds_getter, dataseturl_getter, dataset_engine_getter)

Bases: object

Legacy class - use DataManager instead

setup_callbacks()

class data.DataSubsetter(dataset)

Bases: object

Legacy class - use DataManager instead

subset_data(selected_var, user_selection, compute=True)

class data.DatasetLoader

Bases: object

Handles dataset loading with multiple backends and error handling

clear_logs()

Clear the log output buffer

get_logs()

Get the current log output

load_dataset(url, backend='xarray', engine='auto', **kwargs)

Load dataset with specified backend and engine

Parameters:

• url – Dataset URL or path

• backend – Backend to use (‘xarray’, ‘copernicusmarine’, etc.)

• engine – Engine to use with the backend

• **kwargs – Additional arguments passed to the dataset loader

setup_logging()

Setup logging to capture output

Variable and Dimension Handling

class variables.VariableSelection(app, ds_getter)

Bases: object

setup_callbacks()

class dimension.DimensionSelection(app, ds_getter)

Bases: object

create_dropdown(ds, dim, selected_var)

create_range_slider(ds, dim, selected_var)

generate_dimension_checklist(ds, selected_var)

generate_dimension_controls(ds, selected_dims, selected_var)

setup_callbacks()

Main Application Class

The main application class ViewerApp provides the following key methods:

• setup_layout(): Creates the main application layout

• setup_callbacks(): Sets up all interactive callbacks

• load_dataset(): Handles dataset loading with error handling

• run(): Starts the Dash application server

For detailed implementation, see the source code in src/main.py.