Skip to main content

meds_reader: A Pythonic interface for MEDS datasets

pypy docs Build wheels License

meds_reader is a fast and easy-to-use library for reading and processing subject data stored in MEDS (Medical Event Data Standard) format using a Python-native API.

Inspired by HuggingFace Datasets, meds_reader transforms MEDS datasets into collections of Python objects, that can then be processed using normal Python functions.

Example

# First we need to convert to a database
# That requires running the following command in a terminal
$ meds_reader_convert mimic_meds mimic_meds_reader --num_threads 4
# Now we can use Python to interact with our data
import meds_reader

# We can now construct a database
database = meds_reader.SubjectDatabase("mimic_meds_reader")

# Databases are dict-like objects that store subject data

# We can iterate through all the subject ids in the database
for subject_id in database:

    # We can retrieve subject data given a subject_id
    subject = database[subject_id]

    # Subject data can be manipulated with normal Python operations
    print(subject.subject_id)
    for event in subject.events:
        print(event.time, event.code)

        # We can also iterate through all properties in a generic manner
        for property_name, property_value in event:
            print(property_name, property_value)

To learn more, see our full documentation.

Installation

meds_reader can be installed using pip.

pip install meds_reader

Interactive Demo

An interactive demo can be found at Google Colab.

Metadata

Release files for meds-reader 0.2.0

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

Source distribution (sdist)

Source distribution for meds-reader 0.2.0
File Size Uploaded Provenance Actions
meds_reader-0.2.0.tar.gz 82.0 kB With provenance Details for meds_reader-0.2.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for meds-reader 0.2.0
File Actions
meds_reader-0.2.0-cp313-cp313-manylinux_2_28_x86_64.whl CPython 3.13 CPython 3.13 Linux glibc 2.28+ x86-64 Details for meds_reader-0.2.0-cp313-cp313-manylinux_2_28_x86_64.whl
meds_reader-0.2.0-cp313-cp313-macosx_12_0_arm64.whl CPython 3.13 CPython 3.13 macOS 12.0+ ARM64 Details for meds_reader-0.2.0-cp313-cp313-macosx_12_0_arm64.whl
meds_reader-0.2.0-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details for meds_reader-0.2.0-cp312-cp312-win_amd64.whl
meds_reader-0.2.0-cp312-cp312-manylinux_2_28_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.28+ x86-64 Details for meds_reader-0.2.0-cp312-cp312-manylinux_2_28_x86_64.whl
meds_reader-0.2.0-cp312-cp312-macosx_12_0_arm64.whl CPython 3.12 CPython 3.12 macOS 12.0+ ARM64 Details for meds_reader-0.2.0-cp312-cp312-macosx_12_0_arm64.whl
meds_reader-0.2.0-cp311-cp311-win_amd64.whl CPython 3.11 CPython 3.11 Windows x86-64 Details for meds_reader-0.2.0-cp311-cp311-win_amd64.whl
meds_reader-0.2.0-cp311-cp311-manylinux_2_28_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.28+ x86-64 Details for meds_reader-0.2.0-cp311-cp311-manylinux_2_28_x86_64.whl
meds_reader-0.2.0-cp311-cp311-macosx_12_0_arm64.whl CPython 3.11 CPython 3.11 macOS 12.0+ ARM64 Details for meds_reader-0.2.0-cp311-cp311-macosx_12_0_arm64.whl
meds_reader-0.2.0-cp310-cp310-win_amd64.whl CPython 3.10 CPython 3.10 Windows x86-64 Details for meds_reader-0.2.0-cp310-cp310-win_amd64.whl
meds_reader-0.2.0-cp310-cp310-manylinux_2_28_x86_64.whl CPython 3.10 CPython 3.10 Linux glibc 2.28+ x86-64 Details for meds_reader-0.2.0-cp310-cp310-manylinux_2_28_x86_64.whl
meds_reader-0.2.0-cp310-cp310-macosx_12_0_arm64.whl CPython 3.10 CPython 3.10 macOS 12.0+ ARM64 Details for meds_reader-0.2.0-cp310-cp310-macosx_12_0_arm64.whl

Total release size: 50.7 MB

Release files / meds_reader-0.2.0.tar.gz

Download URL meds_reader-0.2.0.tar.gz
Size 82.0 kB
Tags Source
SHA-256 checksum
How to use checksums
60c79a4b72a28332dfcf9a4cacd90a768c36ebc3e6824caf770dfae460401554
BLAKE2b-256 checksum
How to use checksums
50d8b5e2a7dc4f0c795196fd4e4748840af408becbff7511f1a19064d6f3e0f0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Aug 13, 2026.

Transparency log

Release files / meds_reader-0.2.0-cp313-cp313-manylinux_2_28_x86_64.whl

Download URL meds_reader-0.2.0-cp313-cp313-manylinux_2_28_x86_64.whl
Size 5.3 MB
Tags CPython 3.13 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
3213a781581af5d5a0bf8c6599948241d8141c179fd1d91ef80f77295681a4d5
BLAKE2b-256 checksum
How to use checksums
74fc61c1c45a88e888928fa51b74c085b2f24a9c46bbdebbe79214dd1daf2037
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Aug 13, 2026.

Transparency log

Release files / meds_reader-0.2.0-cp313-cp313-macosx_12_0_arm64.whl

Download URL meds_reader-0.2.0-cp313-cp313-macosx_12_0_arm64.whl
Size 3.5 MB
Tags CPython 3.13 macOS 12.0+ ARM64
SHA-256 checksum
How to use checksums
7846cee73caa9fcd6db2dae1a7b345d0c6e7e1ba7c1f6dea2eead00d76f9a796
BLAKE2b-256 checksum
How to use checksums
894747dc298e0e3269ca829758f614d7cde00e57e999031a6f138cf910f4f071
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Aug 13, 2026.

Transparency log

Release files / meds_reader-0.2.0-cp312-cp312-win_amd64.whl

Download URL meds_reader-0.2.0-cp312-cp312-win_amd64.whl
Size 5.1 MB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
e7bf3b4c6dca68e99abefcef5c2244d8ef5fb874ab8111b45aaf825754cc4cdb
BLAKE2b-256 checksum
How to use checksums
f75a79649444c3711383afc591d1b1fe379c7302a78708dee59aa45c80fd093f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Aug 13, 2026.

Transparency log

Release files / meds_reader-0.2.0-cp312-cp312-manylinux_2_28_x86_64.whl

Download URL meds_reader-0.2.0-cp312-cp312-manylinux_2_28_x86_64.whl
Size 5.3 MB
Tags CPython 3.12 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
4edeb6a4f1b0a2992b17d4c360a89a2c314690ee78db057028b81454cc06c11b
BLAKE2b-256 checksum
How to use checksums
18eab0bf682c44d275ca610ebfc196a0b52e449dc28f1d1101e23ee4768dd6a9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Aug 13, 2026.

Transparency log

Release files / meds_reader-0.2.0-cp312-cp312-macosx_12_0_arm64.whl

Download URL meds_reader-0.2.0-cp312-cp312-macosx_12_0_arm64.whl
Size 3.5 MB
Tags CPython 3.12 macOS 12.0+ ARM64
SHA-256 checksum
How to use checksums
5cf0c382bf0530fd21910de9e2d08590e49e0d4908fce7b636789b977cb52306
BLAKE2b-256 checksum
How to use checksums
2ff8099b818e1b57af9cc735356b41275cc073e87ff2d57c12a1268eda9330af
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Aug 13, 2026.

Transparency log

Release files / meds_reader-0.2.0-cp311-cp311-win_amd64.whl

Download URL meds_reader-0.2.0-cp311-cp311-win_amd64.whl
Size 5.1 MB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
35807ff7b54966b14e7b0673a745dca2ebdc160183ae38ab482aeb86e2457bec
BLAKE2b-256 checksum
How to use checksums
10e1b124a72726ae044835c6666564506af61c07cb436dcbe895700789850b0c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Aug 13, 2026.

Transparency log

Release files / meds_reader-0.2.0-cp311-cp311-manylinux_2_28_x86_64.whl

Download URL meds_reader-0.2.0-cp311-cp311-manylinux_2_28_x86_64.whl
Size 5.3 MB
Tags CPython 3.11 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
58002130dc6d8f59173d4783ba464c95745388bf1bad3c5d42af9430fedb5998
BLAKE2b-256 checksum
How to use checksums
02d7dd0f609684f5b03bd71caf76699794e7bf8e9fb01a06620753b75d535925
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Aug 13, 2026.

Transparency log

Release files / meds_reader-0.2.0-cp311-cp311-macosx_12_0_arm64.whl

Download URL meds_reader-0.2.0-cp311-cp311-macosx_12_0_arm64.whl
Size 3.5 MB
Tags CPython 3.11 macOS 12.0+ ARM64
SHA-256 checksum
How to use checksums
22575847e971f3f6e0f36076b433316ac927053040f2aab2b60bddbf99a246f6
BLAKE2b-256 checksum
How to use checksums
09571b11658ec3c3b415233d9fd0c57e8f98d1768e339ceaee57f3b50c5df1cc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Aug 13, 2026.

Transparency log

Release files / meds_reader-0.2.0-cp310-cp310-win_amd64.whl

Download URL meds_reader-0.2.0-cp310-cp310-win_amd64.whl
Size 5.1 MB
Tags CPython 3.10 Windows x86-64
SHA-256 checksum
How to use checksums
aa06f1f199dcca0b477599d563e4b55ed12a3b574edc847a22b886393f41a78e
BLAKE2b-256 checksum
How to use checksums
b44c07acc2a4e86f087e503a27c38b3f784344a50b19148027fe25dae63d7703
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Aug 13, 2026.

Transparency log

Release files / meds_reader-0.2.0-cp310-cp310-manylinux_2_28_x86_64.whl

Download URL meds_reader-0.2.0-cp310-cp310-manylinux_2_28_x86_64.whl
Size 5.3 MB
Tags CPython 3.10 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
96520d6c194162e4713aebac10905189478b14cab55fd57917346404dca1659f
BLAKE2b-256 checksum
How to use checksums
9059a4cf194a23b0f1268ccaefdffd4f18fd527bef349dbe98a1f85a72af7fb7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Aug 13, 2026.

Transparency log

Release files / meds_reader-0.2.0-cp310-cp310-macosx_12_0_arm64.whl

Download URL meds_reader-0.2.0-cp310-cp310-macosx_12_0_arm64.whl
Size 3.5 MB
Tags CPython 3.10 macOS 12.0+ ARM64
SHA-256 checksum
How to use checksums
f7a0cd8d19723c61a75596d9962b7c36cbf59389677bd6fbe668486f9851c042
BLAKE2b-256 checksum
How to use checksums
56c6e387390da28ad5c06f738c8be7d98604a542caae71c6374dca9ee87c269d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Aug 12, 2026.

Transparency log

Security for meds-reader 0.2.0

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 12 files in this release have been uploaded with provenance metadata.

Select from 12 files

Attestation for meds_reader-0.2.0.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 Aug 13, 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.

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