Metadata-Version: 2.1
Name: meds_reader
Version: 0.1.8
Summary: A Pythonic interface for MEDS datasets
License: Apache-2.0
Project-URL: Homepage, https://github.com/som-shahlab/meds_reader
Project-URL: Documentation, https://meds-reader.readthedocs.io/en/latest/
Project-URL: Repository, https://github.com/som-shahlab/meds_reader
Project-URL: Tracker, https://github.com/som-shahlab/meds_reader/issues
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyarrow >=9
Requires-Dist: meds ==0.3.3
Requires-Dist: numpy <2,>=1.16
Requires-Dist: pandas >=2.2

## meds_reader: A Pythonic interface for MEDS datasets

[![pypy](https://img.shields.io/pypi/v/meds_reader.svg)](https://pypi.org/project/meds_reader/) [![docs](https://readthedocs.org/projects/meds_reader/badge/?version=latest)](https://meds-reader.readthedocs.io/en/latest/) [![Build wheels](https://github.com/som-shahlab/meds_reader/actions/workflows/python-build.yml/badge.svg?branch=main)](https://github.com/som-shahlab/meds_reader/actions/workflows/python-build.yml?query=branch%3Amain) [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

meds_reader is a fast and easy-to-use library for reading and processing subject data stored in [MEDS (Medical Event Data Standard)](https://github.com/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

```bash
# 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
```

```python
# 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)
```

<!-- Start OnlyGithub -->

To learn more, see our [full documentation](https://meds-reader.readthedocs.io/en/latest/).

<!-- End OnlyGithub -->

### Installation

meds_reader can be installed using pip.

```bash
pip install meds_reader
```

### Interactive Demo

An interactive demo can be found at [Google Colab](https://colab.research.google.com/drive/1R1LrDIzhQyWldQWM0lyfjeF_n9I_iZT3?usp=sharing).
