livingpark-utils 0.7

\n# LivingPark utils

A collection of utility functions to write LivingPark notebooks.

Usage examples:

import livingpark_utils
from livingpark_utils.dataset import ppmi
from livingpark_utils.clinical import moca2mmse

utils = livingpark_utils.LivingParkUtils()
utils.notebook_init()
utils.get_study_files(["Demographics.csv"])
utils.get_T1_nifti_files(cohort)  # `cohort` is of type: pd.DataFrame

ppmi.find_nifti_file_in_cache(x["PATNO"], x["EVENT_ID"], x["Description"])
ppmi.disease_duration()

moca2mmse(2)

Usage to execute utility notebooks:

from livingpark_utils.scripts import run

run.mri_metadata()
run.pd_status()

Note: Optionally use the %%capture cell magic to further hide notebook outputs.

Troubleshooting

Permission issues on Windows

We use symbolic links when creating the folder for cached data. Unfortunately, by default, Windows does not authorize users to create symbolic links. To fix this issue on your machine, please follow the guide from this blog post.

Contributing guidelines

We welcome contributions of any kind in the form of Pull-Request to this repository. See also LivingPark contributing guidelines.

Make sure to:

• Use Python type annotations
• Include Python docstrings using numpydoc format for all functions
• Format docstrings
• Run psf/black on the files you modify
• Run pre-commit run --all before committing, this will be checked in your PR