Skip to main content

Python Utilities for SSSOM

Tests PyPI PyPI - Python Version PyPI - License Code style: black DOI

A Python library and command line interface (CLI) for working with SSSOM (Simple Standard for Sharing Ontology Mappings).

Getting Started

A SSSOM TSV can be parsed with

import sssom

# other SSSOM files can be found on https://mapping-commons.github.io
url = "https://raw.githubusercontent.com/mapping-commons/mh_mapping_initiative/master/mappings/mp_hp_eye_impc.sssom.tsv"

# TSV can be parsed into a mapping set dataframe object,
# which includes a pandas DataFrame, a curies.Converter,
# and metadata
msdf = sssom.parse_tsv(url)

# SSSOM comes with several "write" functions
sssom.write_tsv(msdf, "test.tsv")
sssom.write_json(msdf, "test.json")
sssom.write_owl(msdf, "test.owl")
sssom.write_rdf(msdf, "test.ttl")

Documentation

See documentation

Deploy documentation

$ make sphinx
$ make deploy-docs

Schema

See the schema/ folder for source schema in YAML, plus derivations to JSON-Schema, ShEx, etc.

Testing

tox is similar to make, but specific for Python software projects. Its configuration is stored in tox.ini in different "environments" whose headers look like [testenv:...]. All tests can be run with:

$ pip install tox
$ tox

A specific environment can be run using the -e flag, such as tox -e lint to run the linting environment.

Outstanding Contributors

Outstanding contributors are groups and institutions that have helped with organising the SSSOM Python package's development, providing funding, advice and infrastructure. We are very grateful for all your contribution - the project would not exist without you!

Harvard Medical School

Harvard Medical School Logo

The INDRA Lab, a part of the Laboratory of Systems Pharmacology and the Harvard Program in Therapeutic Science (HiTS), is interested in natural language processing and large-scale knowledge assembly. Their work on SSSOM is funded by the DARPA Young Faculty Award W911NF2010255 (PI: Benjamin M. Gyori).

https://indralab.github.io

Citation

SSSOM itself can be cited with:

@article{10.1093/database/baac035,
    author = {Matentzoglu, Nicolas and Balhoff, James P and Bello, Susan M and Bizon, Chris and Brush, Matthew and Callahan, Tiffany J and Chute, Christopher G and Duncan, William D and Evelo, Chris T and Gabriel, Davera and Graybeal, John and Gray, Alasdair and Gyori, Benjamin M and Haendel, Melissa and Harmse, Henriette and Harris, Nomi L and Harrow, Ian and Hegde, Harshad B and Hoyt, Amelia L and Hoyt, Charles T and Jiao, Dazhi and Jiménez-Ruiz, Ernesto and Jupp, Simon and Kim, Hyeongsik and Koehler, Sebastian and Liener, Thomas and Long, Qinqin and Malone, James and McLaughlin, James A and McMurry, Julie A and Moxon, Sierra and Munoz-Torres, Monica C and Osumi-Sutherland, David and Overton, James A and Peters, Bjoern and Putman, Tim and Queralt-Rosinach, Núria and Shefchek, Kent and Solbrig, Harold and Thessen, Anne and Tudorache, Tania and Vasilevsky, Nicole and Wagner, Alex H and Mungall, Christopher J},
    title = {A Simple Standard for Sharing Ontological Mappings (SSSOM)},
    journal = {Database},
    volume = {2022},
    pages = {baac035},
    year = {2022},
    month = {05},
    issn = {1758-0463},
    doi = {10.1093/database/baac035},
    url = {https://doi.org/10.1093/database/baac035},
    eprint = {https://academic.oup.com/database/article-pdf/doi/10.1093/database/baac035/43832024/baac035.pdf},
}

To cite the SSSOM-py software package specifically, use:

@software{sssom-py,
  author       = {Harshad Hegde and
                  Nico Matentzoglu and
                  Charles Tapley Hoyt and
                  Chris Mungall and
                  Joe Flack and
                  Benjamin M. Gyori and
                  Damien Goutte-Gattat and
                  Glass and
                  Syphax Bouazzouni},
  title        = {mapping-commons/sssom-py: v0.4.15 release (minor
                   fixes)
                  },
  month        = dec,
  year         = 2024,
  publisher    = {Zenodo},
  version      = {v0.4.15},
  doi          = {10.5281/zenodo.14296666},
  url          = {https://doi.org/10.5281/zenodo.14296666},
}

Metadata

Release files for sssom 0.4.22

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

Source distribution (sdist)

Source distribution for sssom 0.4.22
File Size Uploaded Provenance Actions
sssom-0.4.22.tar.gz 230.6 kB With provenance Details for sssom-0.4.22.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for sssom 0.4.22
File Interpreter ABI Platform Actions
sssom-0.4.22-py3-none-any.whl Python 3 none any Details for sssom-0.4.22-py3-none-any.whl

Total release size: 474.2 kB

Release files / sssom-0.4.22.tar.gz

Download URL sssom-0.4.22.tar.gz
Size 230.6 kB
Tags Source
SHA-256 checksum
How to use checksums
f1d18825ce29d34883daf78ea012924bcfc9cfb38c4e17c88e0ff6be0084a9af
BLAKE2b-256 checksum
How to use checksums
cf049e18d6b15530ec671cc74a9ed565b8a21ba9301c9040b1a5595781968525
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

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 Oct 29, 2026.

Transparency log

Release files / sssom-0.4.22-py3-none-any.whl

Download URL sssom-0.4.22-py3-none-any.whl
Size 243.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
13dbe0043cbacfe8c6458e75327ad0aed4b4e48956603dc9bca06cb1d8e672ab
BLAKE2b-256 checksum
How to use checksums
497173098c171d116df09dab5a12a8bfc294cb92f42ffa3d6954a9e7ad2343fd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

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 Oct 29, 2026.

Transparency log

Security for sssom 0.4.22

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

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for sssom-0.4.22.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 Oct 29, 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.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.4.22 This release

2 release files Full provenance

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