https://vitaldb.github.io/vitalutils
This repository contains utilities and libraries for working with VitalDB files, implemented in various programming languages.
The Python library (v1.6.0) is the primary interface for interacting with VitalDB files and the VitalDB open dataset.
pip install vitaldbFor MCP (Model Context Protocol) server support:
pip install vitaldb[mcp]import vitaldb
# Load a local .vital file
vf = vitaldb.VitalFile("path/to/your/file.vital")
# Get track names
track_names = vf.get_track_names()
print(track_names)
# Get samples for a specific track
ecg_samples = vf.to_numpy('SNUADC/ECG_II', 1/500)
print(ecg_samples)
# Convert to pandas DataFrame
df = vf.to_pandas(['SNUADC/ECG_II', 'Solar8000/HR'], 1)
print(df.head())Access the VitalDB open dataset containing 6,388 surgical cases:
import vitaldb
# Find cases with specific tracks
caseids = vitaldb.find_cases("SNUADC/ECG_II,Solar8000/HR")
# Load case data
data = vitaldb.load_case(1, "SNUADC/ECG_II,Solar8000/HR", interval=1.0)
# Load clinical data
clinical_df = vitaldb.load_clinical_data()
# Load lab data
lab_df = vitaldb.load_lab_data()
# Get all available track names
tracks = vitaldb.get_track_names()VitalDB provides an MCP server for integration with AI assistants like Claude:
# Run as MCP server
vitaldbConfigure in your MCP client (e.g., Claude Desktop):
{
"mcpServers": {
"vitaldb": {
"command": "vitaldb"
}
}
}Available MCP tools:
find_cases- Find cases with specific track namesload_case- Load case data from VitalDB open datasetload_clinical_data- Load clinical informationload_lab_data- Load lab resultsget_track_names- Get available track namesread_vital- Read local .vital filesget_vital_track_names- Get track names from local filevital_to_csv- Convert .vital to CSVlogin- Login to VitalDB serverfilelist/tracklist/receive- Server data access
Refer to the python/examples directory for more usage examples.
The C++ code provides core utilities for performance-critical tasks like file parsing and data processing.
Requires a C++ compiler and zlib library:
# Linux/macOS (g++)
g++ -o vital_list C++/vital_list.cpp -lz
# Windows (MSVC - Visual Studio command prompt)
cl vital_list.cpp /link zlib.lib./vital_list path/to/your/file.vitalRefer to the C++ source files for specific utility usage.
Browser-based visualization tool for .vital files with drag-and-drop interface.
cd vitalfile_webviewer
npm install
node build-bundle.jsOpen vitalfile_webviewer.html in your browser and drag-drop a .vital file to visualize tracks.
Features:
- Drag-and-drop file loading
- Monitor view and track view modes
- Canvas-based waveform rendering
R scripts for data analysis and visualization.
Rscript R/load_vital.r path/to/your/file.vitalWindows-specific GUI utilities. Build using Visual Studio.
Full documentation available at: https://vitaldb.github.io/vitalutils
For the .vital file format specification, see Vital File Format.pdf.
MIT License - see LICENSE for details.