ondas 1.0.2

Read-only, format-independent waveform analysis library
Documentation

ondas

A read-only Rust library for waveform analysis. The goal is to support more waveform formats than any other library, including proprietary formats, through one API with consistent query semantics.

Ondas architecture: backends open a Waveform with metadata and hierarchy; signal selections and backend observations feed the private query engine to produce public results.

API documentation · Library model

Usage

[dependencies]
ondas = "1"

See the API examples for opening waveforms, resolving signals and querying values.

Cargo features

No Cargo features are enabled by default. VCD and FST readers are always included, even with default-features = false.

  • fsdb-lib: adds the FSDB reader. Requires a local Verdi FSDB Reader SDK selected by VERDI_HOME; see SDK requirements.
[dependencies]
ondas = { version = "1", features = ["fsdb-lib"] }

Backends

Backend Format Implementation Documentation
vcd-native VCD Built-in Rust parser; no external parser dependency docs/vcd-native.md
fst-lib FST fst-reader 0.17.0 docs/fst-lib.md
fsdb-lib FSDB Optional fsdb-lib feature; local Verdi FSDB Reader SDK, file-only docs/fsdb-lib.md

Development

Requires Linux, Git, Docker and the Dev Container CLI. Rust 1.88 or newer is required; the container supplies the toolchain.

./dev --install-hooks
./dev just check-local
git submodule update --init fixtures
./dev just fixtures-install
./dev just ci
./dev just msrv

check-local needs no initialized submodule or waveform payloads. ci includes conformance; ./dev just conformance runs that suite on its own.

Development setup · Testing

Licensed under Apache License 2.0.