Quickstart

pip install "dataerai-sdk[metaextract-converters]"

from dataerai.metaextract import extract_metadata

# Format is auto-detected from the file extension
metadata = extract_metadata("data.ibw")
print(metadata)

from dataerai.metaextract import convert_file

# Convert and save to disk
dataset = convert_file("data.ibw", output_path="output.nc")

# …or just get the xarray.Dataset back without saving
dataset = convert_file("data.ibw")

from dataerai.metaextract import get_supported_formats

for ext, caps in get_supported_formats().items():
    print(f"{ext}: extract={caps['extract']}, convert={caps['convert']}")

from dataerai.metaextract import (
    calculate_checksum,
    calculate_multiple_checksums,
    verify_checksum,
)

# Single digest (defaults to blake3 if available, else sha256)
print(calculate_checksum("data.ibw"))
print(calculate_checksum("data.ibw", algorithm="sha256"))

# Several algorithms in one read of the file
print(calculate_multiple_checksums("data.ibw", ["sha256", "md5"]))

# Confirm a file matches an expected digest
verify_checksum("data.ibw", "abc123…", algorithm="sha256")   # -> True / False

from dataerai.metaextract import process_file

metadata = process_file("data.ibw", output="metadata")
dataset  = process_file("data.ibw", output="dataset", output_path="output.nc")

from pathlib import Path
from dataerai.metaextract import extract_metadata

results = [
    {"file": str(p), "metadata": extract_metadata(p)}
    for p in Path("data").glob("*.ibw")
]