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.

Project links

Data verified by PyPI on Aug 12, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for EthanSteinberg from gravatar.com EthanSteinberg

GitHub Statistics

Data verified by PyPI on Aug 12, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python >=3.10

Provides Extra

test

Report project as malware

Download files

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

Source Distribution

meds_reader-0.2.0.tar.gz (82.0 kB view details)

Uploaded Source

Built Distributions

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

meds_reader-0.2.0-cp313-cp313-manylinux_2_28_x86_64.whl (5.3 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.28+ x86-64

meds_reader-0.2.0-cp313-cp313-macosx_12_0_arm64.whl (3.5 MB view details)

Uploaded CPython 3.13macOS 12.0+ ARM64

meds_reader-0.2.0-cp312-cp312-win_amd64.whl (5.1 MB view details)

Uploaded CPython 3.12Windows x86-64

meds_reader-0.2.0-cp312-cp312-manylinux_2_28_x86_64.whl (5.3 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.28+ x86-64

meds_reader-0.2.0-cp312-cp312-macosx_12_0_arm64.whl (3.5 MB view details)

Uploaded CPython 3.12macOS 12.0+ ARM64

meds_reader-0.2.0-cp311-cp311-win_amd64.whl (5.1 MB view details)

Uploaded CPython 3.11Windows x86-64

meds_reader-0.2.0-cp311-cp311-manylinux_2_28_x86_64.whl (5.3 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.28+ x86-64

meds_reader-0.2.0-cp311-cp311-macosx_12_0_arm64.whl (3.5 MB view details)

Uploaded CPython 3.11macOS 12.0+ ARM64

meds_reader-0.2.0-cp310-cp310-win_amd64.whl (5.1 MB view details)

Uploaded CPython 3.10Windows x86-64

meds_reader-0.2.0-cp310-cp310-manylinux_2_28_x86_64.whl (5.3 MB view details)

Uploaded CPython 3.10manylinux: glibc 2.28+ x86-64

meds_reader-0.2.0-cp310-cp310-macosx_12_0_arm64.whl (3.5 MB view details)

Uploaded CPython 3.10macOS 12.0+ ARM64

File details

Details for the file meds_reader-0.2.0.tar.gz.

File metadata

  • Download URL: meds_reader-0.2.0.tar.gz
  • Upload date:
  • Size: 82.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for meds_reader-0.2.0.tar.gz
Algorithm Hash digest
SHA256 60c79a4b72a28332dfcf9a4cacd90a768c36ebc3e6824caf770dfae460401554
MD5 9905c2c57771d57aafa84e4de1ea9bb4
BLAKE2b-256 50d8b5e2a7dc4f0c795196fd4e4748840af408becbff7511f1a19064d6f3e0f0

See more details on using hashes here.

Provenance

The following attestation bundles were made for meds_reader-0.2.0.tar.gz:

Publisher: python-build.yml on som-shahlab/meds_reader

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

File details

Details for the file meds_reader-0.2.0-cp313-cp313-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for meds_reader-0.2.0-cp313-cp313-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 3213a781581af5d5a0bf8c6599948241d8141c179fd1d91ef80f77295681a4d5
MD5 91711bb254e515d52429337ceeeb7ffd
BLAKE2b-256 74fc61c1c45a88e888928fa51b74c085b2f24a9c46bbdebbe79214dd1daf2037

See more details on using hashes here.

Provenance

The following attestation bundles were made for meds_reader-0.2.0-cp313-cp313-manylinux_2_28_x86_64.whl:

Publisher: python-build.yml on som-shahlab/meds_reader

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

File details

Details for the file meds_reader-0.2.0-cp313-cp313-macosx_12_0_arm64.whl.

File metadata

File hashes

Hashes for meds_reader-0.2.0-cp313-cp313-macosx_12_0_arm64.whl
Algorithm Hash digest
SHA256 7846cee73caa9fcd6db2dae1a7b345d0c6e7e1ba7c1f6dea2eead00d76f9a796
MD5 0f1521e7125a0855e44fc4a503970f8b
BLAKE2b-256 894747dc298e0e3269ca829758f614d7cde00e57e999031a6f138cf910f4f071

See more details on using hashes here.

Provenance

The following attestation bundles were made for meds_reader-0.2.0-cp313-cp313-macosx_12_0_arm64.whl:

Publisher: python-build.yml on som-shahlab/meds_reader

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

File details

Details for the file meds_reader-0.2.0-cp312-cp312-win_amd64.whl.

File metadata

File hashes

Hashes for meds_reader-0.2.0-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 e7bf3b4c6dca68e99abefcef5c2244d8ef5fb874ab8111b45aaf825754cc4cdb
MD5 ee3cc6d9b25e8cf6f7e625d0c284b32b
BLAKE2b-256 f75a79649444c3711383afc591d1b1fe379c7302a78708dee59aa45c80fd093f

See more details on using hashes here.

Provenance

The following attestation bundles were made for meds_reader-0.2.0-cp312-cp312-win_amd64.whl:

Publisher: python-build.yml on som-shahlab/meds_reader

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

File details

Details for the file meds_reader-0.2.0-cp312-cp312-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for meds_reader-0.2.0-cp312-cp312-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 4edeb6a4f1b0a2992b17d4c360a89a2c314690ee78db057028b81454cc06c11b
MD5 8f47659f8e01ddafedaaef4bdce5618a
BLAKE2b-256 18eab0bf682c44d275ca610ebfc196a0b52e449dc28f1d1101e23ee4768dd6a9

See more details on using hashes here.

Provenance

The following attestation bundles were made for meds_reader-0.2.0-cp312-cp312-manylinux_2_28_x86_64.whl:

Publisher: python-build.yml on som-shahlab/meds_reader

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

File details

Details for the file meds_reader-0.2.0-cp312-cp312-macosx_12_0_arm64.whl.

File metadata

File hashes

Hashes for meds_reader-0.2.0-cp312-cp312-macosx_12_0_arm64.whl
Algorithm Hash digest
SHA256 5cf0c382bf0530fd21910de9e2d08590e49e0d4908fce7b636789b977cb52306
MD5 f5f0b4dfd2a0691365a09e65a95e7696
BLAKE2b-256 2ff8099b818e1b57af9cc735356b41275cc073e87ff2d57c12a1268eda9330af

See more details on using hashes here.

Provenance

The following attestation bundles were made for meds_reader-0.2.0-cp312-cp312-macosx_12_0_arm64.whl:

Publisher: python-build.yml on som-shahlab/meds_reader

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

File details

Details for the file meds_reader-0.2.0-cp311-cp311-win_amd64.whl.

File metadata

File hashes

Hashes for meds_reader-0.2.0-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 35807ff7b54966b14e7b0673a745dca2ebdc160183ae38ab482aeb86e2457bec
MD5 6f0b87ca941c26e4ead09c0564914354
BLAKE2b-256 10e1b124a72726ae044835c6666564506af61c07cb436dcbe895700789850b0c

See more details on using hashes here.

Provenance

The following attestation bundles were made for meds_reader-0.2.0-cp311-cp311-win_amd64.whl:

Publisher: python-build.yml on som-shahlab/meds_reader

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

File details

Details for the file meds_reader-0.2.0-cp311-cp311-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for meds_reader-0.2.0-cp311-cp311-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 58002130dc6d8f59173d4783ba464c95745388bf1bad3c5d42af9430fedb5998
MD5 0fc61cca11f9952191dc4fb6d188e7d4
BLAKE2b-256 02d7dd0f609684f5b03bd71caf76699794e7bf8e9fb01a06620753b75d535925

See more details on using hashes here.

Provenance

The following attestation bundles were made for meds_reader-0.2.0-cp311-cp311-manylinux_2_28_x86_64.whl:

Publisher: python-build.yml on som-shahlab/meds_reader

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

File details

Details for the file meds_reader-0.2.0-cp311-cp311-macosx_12_0_arm64.whl.

File metadata

File hashes

Hashes for meds_reader-0.2.0-cp311-cp311-macosx_12_0_arm64.whl
Algorithm Hash digest
SHA256 22575847e971f3f6e0f36076b433316ac927053040f2aab2b60bddbf99a246f6
MD5 16f4cabfbee298ecf06a8b716eadc2f9
BLAKE2b-256 09571b11658ec3c3b415233d9fd0c57e8f98d1768e339ceaee57f3b50c5df1cc

See more details on using hashes here.

Provenance

The following attestation bundles were made for meds_reader-0.2.0-cp311-cp311-macosx_12_0_arm64.whl:

Publisher: python-build.yml on som-shahlab/meds_reader

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

File details

Details for the file meds_reader-0.2.0-cp310-cp310-win_amd64.whl.

File metadata

File hashes

Hashes for meds_reader-0.2.0-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 aa06f1f199dcca0b477599d563e4b55ed12a3b574edc847a22b886393f41a78e
MD5 770af2fb7854f7b74072a33069dc3f6c
BLAKE2b-256 b44c07acc2a4e86f087e503a27c38b3f784344a50b19148027fe25dae63d7703

See more details on using hashes here.

Provenance

The following attestation bundles were made for meds_reader-0.2.0-cp310-cp310-win_amd64.whl:

Publisher: python-build.yml on som-shahlab/meds_reader

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

File details

Details for the file meds_reader-0.2.0-cp310-cp310-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for meds_reader-0.2.0-cp310-cp310-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 96520d6c194162e4713aebac10905189478b14cab55fd57917346404dca1659f
MD5 864f34b0b3d4c60fa4bbd323c9939433
BLAKE2b-256 9059a4cf194a23b0f1268ccaefdffd4f18fd527bef349dbe98a1f85a72af7fb7

See more details on using hashes here.

Provenance

The following attestation bundles were made for meds_reader-0.2.0-cp310-cp310-manylinux_2_28_x86_64.whl:

Publisher: python-build.yml on som-shahlab/meds_reader

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

File details

Details for the file meds_reader-0.2.0-cp310-cp310-macosx_12_0_arm64.whl.

File metadata

File hashes

Hashes for meds_reader-0.2.0-cp310-cp310-macosx_12_0_arm64.whl
Algorithm Hash digest
SHA256 f7a0cd8d19723c61a75596d9962b7c36cbf59389677bd6fbe668486f9851c042
MD5 64629a047d570f91a23740b769ed7785
BLAKE2b-256 56c6e387390da28ad5c06f738c8be7d98604a542caae71c6374dca9ee87c269d

See more details on using hashes here.

Provenance

The following attestation bundles were made for meds_reader-0.2.0-cp310-cp310-macosx_12_0_arm64.whl:

Publisher: python-build.yml on som-shahlab/meds_reader

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

Release history Release notifications | RSS feed

This release

0.2.0 This release

12 files

0.1.16

20 files

0.1.15

4 files

0.1.14

20 files

0.1.13

20 files

0.1.12

16 files

0.1.11

16 files

0.1.10

7 files

0.1.9

13 files

0.1.8

13 files

0.1.7

13 files

0.1.6

13 files

0.1.5

13 files

0.1.4

3 files

0.1.3

13 files

0.1.1

13 files

0.1.0

13 files

0.0.6

13 files

0.0.5

13 files

0.0.4

13 files

0.0.3

13 files

0.0.2

13 files

0.0.1

13 files

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