Skip to main content

TRAILED: Topological Regularization and Integrity Learning for EHR Data

Note: TRAILED is under active development. The current release provides the foundational ECT implementation. Healthcare-specific methods are in progress.

Topological representation learning for Electronic Health Record (EHR) data. Built on the differentiable Euler Characteristic Transform (ECT).

Installation

uv pip install trailed

# Optional extras
uv pip install trailed[sklearn]      # scikit-learn transformers
uv pip install trailed[dataframe]    # pandas/polars support
uv pip install trailed[all]          # all dependencies

Quick Start

from trailed import compute_ect_from_numpy

ect = compute_ect_from_numpy(points, num_thetas=32, resolution=32)
import polars as pl
from trailed.tabular import compute_ect_from_polars

df = pl.DataFrame({"x": [0.1, 0.2, 0.3], "y": [0.1, 0.3, 0.2], "group": [0, 0, 1]})
ect = compute_ect_from_polars(df, coord_columns=["x", "y"], group_column="group")
import pandas as pd
from trailed.tabular import compute_ect_from_pandas

df = pd.DataFrame({"x": [0.1, 0.2, 0.3], "y": [0.1, 0.3, 0.2], "group": [0, 0, 1]})
ect = compute_ect_from_pandas(df, coord_columns=["x", "y"], group_column="group")

Documentation

Full documentation: krv-analytics.github.io/trailed

Acknowledgment

This project builds on the original dect implementation and accompanying research.

@inproceedings{Roell24a,
  title         = {Differentiable Euler Characteristic Transforms for Shape Classification},
  author        = {Ernst R{\"o}ell and Bastian Rieck},
  year          = 2024,
  booktitle     = {International Conference on Learning Representations},
  eprint        = {2310.07630},
  archiveprefix = {arXiv},
  primaryclass  = {cs.LG},
  repository    = {https://github.com/aidos-lab/dect-evaluation},
  url           = {https://openreview.net/forum?id=MO632iPq3I},
}

Metadata

Release files for trailed 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for trailed 0.1.3
File Size Uploaded Provenance
trailed-0.1.3.tar.gz 666.1 kB With provenance Details

Built distributions (wheels)

Table of built distributions (wheels) for trailed 0.1.3
File
trailed-0.1.3-cp310-abi3-win_amd64.whl CPython 3.10 abi3 Windows x86-64 Details
trailed-0.1.3-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl CPython 3.10 abi3 Linux glibc 2.17+ x86-64 Details
trailed-0.1.3-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl CPython 3.10 abi3 Linux glibc 2.17+ ARM64 Details
trailed-0.1.3-cp310-abi3-macosx_11_0_arm64.whl CPython 3.10 abi3 macOS 11.0+ ARM64 Details
trailed-0.1.3-cp310-abi3-macosx_10_12_x86_64.whl CPython 3.10 abi3 macOS 10.12+ x86-64 Details

Total release size: 2.9 MB

Release files / trailed-0.1.3.tar.gz

Download URL trailed-0.1.3.tar.gz
Size 666.1 kB
Tags Source
SHA-256 checksum
How to use checksums
37902e618c16602dd712df0ca0adb269b9461b3963533b312d2c9adf795a2313
BLAKE2b-256 checksum
How to use checksums
12e2f2899346d82c65758584e3baf81ac08a11930e1be50e7790d7c60b5834e1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 18, 2026.

Transparency log

Release files / trailed-0.1.3-cp310-abi3-win_amd64.whl

Download URL trailed-0.1.3-cp310-abi3-win_amd64.whl
Size 355.2 kB
Tags CPython 3.10 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
af5ad35206078fc2727aff3c5c8ff82f7e1cf714466a36d8e44a55143183e640
BLAKE2b-256 checksum
How to use checksums
10a5c3a512907a2eaec8e4ec8fce45f95b17d3598513cf4358b002b0c2fe6a8a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 18, 2026.

Transparency log

Release files / trailed-0.1.3-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL trailed-0.1.3-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 510.4 kB
Tags CPython 3.10 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
7dd402f25341009bacbb282a3dfca8598ca8454e82a53116acfebbb436721206
BLAKE2b-256 checksum
How to use checksums
8f0480db359f5dd02b1115eca1ed24690463187ea7de4565954351683db33bf3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 18, 2026.

Transparency log

Release files / trailed-0.1.3-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL trailed-0.1.3-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 491.9 kB
Tags CPython 3.10 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum
How to use checksums
98374daa73822d7f199a6e2657682a6fa4bd65304fb3f78803d3679c361bc1be
BLAKE2b-256 checksum
How to use checksums
d1fc6620f1d61c74c0f7968523ec0456141e5e97d1bdc34a5b719b289a5018e9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 18, 2026.

Transparency log

Release files / trailed-0.1.3-cp310-abi3-macosx_11_0_arm64.whl

Download URL trailed-0.1.3-cp310-abi3-macosx_11_0_arm64.whl
Size 442.2 kB
Tags CPython 3.10 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
43ecbcb0bed4645437f9952a00ba24b272cebd41d7af2a986f899b7e64a50623
BLAKE2b-256 checksum
How to use checksums
954fa0fbd5ba2c9c3c607baf00b56047064d7c2a187f11c19d03f76f53a2042c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 18, 2026.

Transparency log

Release files / trailed-0.1.3-cp310-abi3-macosx_10_12_x86_64.whl

Download URL trailed-0.1.3-cp310-abi3-macosx_10_12_x86_64.whl
Size 457.7 kB
Tags CPython 3.10 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
fb8f622c804e7c4aed0a633e597c775e8fd8a6a1aa35be27594acc4e12d6ed0b
BLAKE2b-256 checksum
How to use checksums
2bf8cbfbe2753b905f98d74e7ac5833073d9539976b65062fb660a59fdc6ea12
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 18, 2026.

Transparency log

Security for trailed 0.1.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 6 files in this release have been uploaded with provenance metadata.

Select from 6 files

Attestation for trailed-0.1.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page