cacaopod 0.11.0

Browser-based experimental data visualizer and analysis tool.

Cacaopod

Cacaopod is a local, browser-based data visualizer for experimental data analysis. It combines a Python-backed workspace, an interactive plotting board, file loaders, data tools, and an embedded Python console.

Features

• Load CSV, TSV, TXT/DAT/ASC, NPY, NPZ, JSON, MAT, image files, and custom file formats.
• View 1D traces and 2D heatmaps in a browser UI.
• Run Python code against the current board and loaded data.
• Save boards, waves, tool definitions, and UI state in the working directory.
• Create custom tools, file loaders, and naming rules in Python.

Installation

pip install cacaopod

Usage

Start Cacaopod in the directory you want to use as your workspace:

cacaopod --open

By default, Cacaopod serves the app on 127.0.0.1. If the browser does not open automatically, open the URL printed in the terminal.

You can also choose a workspace explicitly:

cacaopod --workdir /path/to/data --open

Control a running Cacaopod backend from another Python process:

import numpy as np
from cacaopod.remote import Cacaopod

cp = Cacaopod(port=8123)
cp.board.show(np.arange(100), name="name_of_pod")
wave = cp.Wave(np.arange(100), delta=0.1, offset=2.0, name="wave_name")
cp.board.show(wave, name="another_pod")
wave_on_board = cp.Wave(np.arange(50), name="wave_on_board", board="Existing Board")
cp.board.show(wave_on_board, name="pod_on_existing_board")
cp.execute("print(board.name)")
print(cp.is_alive())

Security Note

Cacaopod is designed for trusted local use. The web API can execute Python code from the embedded console and from user-defined tools. Do not expose the backend to an untrusted network or run it with a public host unless you have added your own access controls.

License

Apache-2.0. See LICENSE.

Third-party notices for the bundled web UI are included in THIRD_PARTY_NOTICES.md.