Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

linkml-map

Pyversions PyPi codecov

LinkML Map is a framework for specifying and executing declarative mappings between data models. At its core is the TransformationSpecification — a YAML-based language for describing how to map one data model to another, independent of serialization format or execution engine.

Features:

  • YAML-based lightweight transformation syntax
  • Python library for executing mappings on data files
  • Tabular data support (TSV/CSV) with streaming for large datasets
  • Experimental SQL compilation backend (DuckDB) for set-based transforms
  • Derivation of target (implicit) schemas, allowing easy customization of data models (profiling)
  • Simple YAML dictionaries for simple mappings
  • Automatic unit conversion
  • Use of subset of Python to specify complex mappings
  • Visualizations of mappings
  • Mappings are reversible (provided all expressions used are reversible)
  • Multiple output formats (YAML, JSON, JSONL, TSV, CSV)

For full documentation see linkml.io/linkml-map/.

Status:

The transformation data model is not yet fully stable, and may be subject to change. Not all parts of the model are implemented in the reference Python framework.

Quickstart

Install:

pip install linkml-map
# or, in a uv-managed project: uv add linkml-map

When using uv, prefix CLI invocations with uv run (e.g. uv run linkml-map --help).

Run the included example (the example files live in this repo):

git clone https://github.com/linkml/linkml-map.git
cd linkml-map/tests/input/examples/personinfo_basic
linkml-map map-data --unrestricted-eval \
  -T transform/personinfo-to-agent.transform.yaml \
  -s source/personinfo.yaml \
  data/Container-001.yaml

See the Quick Start guide for the expected output and next steps.

More

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

linkml_map-0.5.3rc2.tar.gz (579.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

linkml_map-0.5.3rc2-py3-none-any.whl (147.5 kB view details)

Uploaded Python 3

File details

Details for the file linkml_map-0.5.3rc2.tar.gz.

File metadata

  • Download URL: linkml_map-0.5.3rc2.tar.gz
  • Upload date:
  • Size: 579.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for linkml_map-0.5.3rc2.tar.gz
Algorithm Hash digest
SHA256 b33f1b76033497f63413d33687d93ed32c607151e62464dd94b733f37093a46d
MD5 64b0a432d301b031f2f1078fea5f7307
BLAKE2b-256 69947bc1874a534b3c3be3fe592a1a0c256c6b562be354e79d4726f201ef95a0

See more details on using hashes here.

Provenance

The following attestation bundles were made for linkml_map-0.5.3rc2.tar.gz:

Publisher: pypi-publish.yaml on linkml/linkml-map

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file linkml_map-0.5.3rc2-py3-none-any.whl.

File metadata

  • Download URL: linkml_map-0.5.3rc2-py3-none-any.whl
  • Upload date:
  • Size: 147.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for linkml_map-0.5.3rc2-py3-none-any.whl
Algorithm Hash digest
SHA256 f4f5a0226d0f8c4e2ad8db891a9fb3a070cd35842a16c6f6112078bcb3dd1551
MD5 956961a765d59c8c49f33201e7af0470
BLAKE2b-256 08327f88fa1a3a2bf7684867e13fdb343f6a1f60c55be9efbaf832a30baa96d8

See more details on using hashes here.

Provenance

The following attestation bundles were made for linkml_map-0.5.3rc2-py3-none-any.whl:

Publisher: pypi-publish.yaml on linkml/linkml-map

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page