Skip to main content

Parse Apple Health App dump conveniently and create visualizations.

Project description

Health Tracking

This repository provides some notebooks to analyze the Apple Health App data export dump as well as visualizations.


Add the exported dump (see here for information), usally named, into the directory data/raw/ The AppleHealthParser is able to unzip and parse it.

Install the package as shown in the installation section. Or simply use:

pip install health-tracking


In order to set up the necessary environment:

  1. create an environment health-tracking with the help of conda,
    conda env create -f environment.yaml
  2. activate the new environment with
    conda activate health-tracking
  3. install health-tracking with:
    python install # or `develop`

Optional and needed only once after git clone:

  1. install several pre-commit git hooks with:

    pre-commit install

    and checkout the configuration under .pre-commit-config.yaml. The -n, --no-verify flag of git commit can be used to deactivate pre-commit hooks temporarily.

  2. install nbstripout git hooks to remove the output cells of committed notebooks with:

    nbstripout --install --attributes notebooks/.gitattributes

    This is useful to avoid large diffs due to plots in your notebooks. A simple nbstripout --uninstall will revert these changes.

Then take a look into the scripts and notebooks folders.

Dependency Management & Reproducibility

  1. Always keep your abstract (unpinned) dependencies updated in environment.yaml and eventually in setup.cfg if you want to ship and install your package via pip later on.
  2. Create concrete dependencies as environment.lock.yaml for the exact reproduction of your environment with:
    conda env export -n health-tracking -f environment.lock.yaml
    For multi-OS development, consider using --no-builds during the export.
  3. Update your current environment with respect to a new environment.lock.yaml using:
    conda env update -f environment.lock.yaml --prune


This project has been set up using PyScaffold 3.2.3. For details and usage information on PyScaffold see

Project details

Download files

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

Files for health-tracking, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size health_tracking-0.1.1-py2.py3-none-any.whl (12.3 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size health-tracking-0.1.1.tar.gz (23.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page