lx-data-models
lx-dtypes is the reusable data-model package for Lux Group medical research
projects. It provides typed Pydantic contracts, versioned clinical terminology,
report-template validation, FHIR interoperability, and optional Django host
integration.
Highlights
- Strict, reusable contracts for knowledge-base, ledger, reporting, and host integration boundaries.
- Version-aware YAML knowledge bases and deterministic loaders.
- Report-template graph, structure, coverage, and runtime validation.
- FHIR clinical and terminology conversion contracts.
- Typed package data with Pyright, pytest, and documentation checks in CI.
The package is currently in alpha. Public imports are kept stable where
possible, but releases before 1.0 may contain documented breaking changes.
Installation
lx-dtypes supports Python 3.12.
python -m pip install lx-dtypes
Quick start
Load a knowledge-base module shipped with the package:
from lx_dtypes import load_knowledge_base
knowledge_base = load_knowledge_base("report_template_examples")
print(knowledge_base.config.knowledge_base_identity)
print(sorted(knowledge_base.report_template))
Registry-backed deployments should supply the exact module version. See the knowledge-base authoring guide and graph API guide for the complete workflow.
Provision the packaged catalog before starting a registry-backed host:
export LX_DTYPES_KB_REGISTRY=/var/lib/my-host/terminology/registry.json
lx-dtypes-kb-registry bootstrap
This boundary is strict: invalid registry state or an unloadable packaged identity exits nonzero and must block host startup.
Documentation
Start with the documentation index. Key guides include:
- Package boundaries
- Data-model concept map
- Knowledge-base authoring
- Reproduce versioned classifications
- Report-template infrastructure
- FHIR to LXDM mapping
- Django host integration
Build the documentation locally with:
python -m pip install -e ".[docs]"
make -C docs html
Development
git clone https://github.com/wg-lux/lx-data-models.git
cd lx-data-models
uv sync --extra dev
uv run pyright
uv run pytest -q
uv run make -C docs html
Knowledge-base fixtures and tests must not contain patient data, credentials,
or machine-local paths. Generated output belongs in temp/generated_exports/
or a test-local temporary directory.
See CONTRIBUTING.md for the full contributor and release workflow, CHANGELOG.md for release notes, and SECURITY.md for responsible vulnerability reporting.
License and citation
Distributed under the MIT License. If you use lx-dtypes in
published work, cite the project using CITATION.cff.
Metadata
Release files for lx-dtypes 0.3.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| lx_dtypes-0.3.3.tar.gz | 2.7 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| lx_dtypes-0.3.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.6 MB
Release files / lx_dtypes-0.3.3.tar.gz
| Download URL | lx_dtypes-0.3.3.tar.gz |
|---|---|
| Size | 2.7 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9794612ba04a558cc11eb968e1ef328dcc1b91fc411f86fb46855ebfed856786
|
|
BLAKE2b-256 checksum How to use checksums |
30dabcf41631c364439686b178fb1f6c72247f5b19acc3ac29b5f7e7ad67f59c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
Release files / lx_dtypes-0.3.3-py3-none-any.whl
| Download URL | lx_dtypes-0.3.3-py3-none-any.whl |
|---|---|
| Size | 874.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2fc3310fcd33b962ec5a77fdd920df745d49954b29a0b80a87da7de5ef90c079
|
|
BLAKE2b-256 checksum How to use checksums |
4befc55cd732c32ea5ca8d965036067e7ec50f8c776a94171b47c77664f0dd52
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
