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.3rc3.tar.gz (580.8 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.3rc3-py3-none-any.whl (148.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: linkml_map-0.5.3rc3.tar.gz
  • Upload date:
  • Size: 580.8 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.3rc3.tar.gz
Algorithm Hash digest
SHA256 fd211c18d0ede1a47ac504f2f868e381aa692fa1315edd3f0bacee3b10e96091
MD5 292eafe562649027482013a69c57664d
BLAKE2b-256 811df448f9233bd1fb03e414f7ceee31598812e91aee0dc000561cf6e0de761d

See more details on using hashes here.

Provenance

The following attestation bundles were made for linkml_map-0.5.3rc3.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.3rc3-py3-none-any.whl.

File metadata

  • Download URL: linkml_map-0.5.3rc3-py3-none-any.whl
  • Upload date:
  • Size: 148.3 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.3rc3-py3-none-any.whl
Algorithm Hash digest
SHA256 274ea755b7b9d8b34079e6c615a7a477aa5c7f21f005c13befca04449dca5284
MD5 7b0174ae98315c5b58824eb418715a27
BLAKE2b-256 ccc93249c5abd1807706eeb49963fcce9c34ab37048dfd120422ef5528bc48b1

See more details on using hashes here.

Provenance

The following attestation bundles were made for linkml_map-0.5.3rc3-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