Skip to content

Downloading data shared with your project

Madeleine Price Ball edited this page Sep 21, 2016 · 11 revisions

When members join and authorize your project, they authorize ongoing sharing to the list of data sources your project has requested. This access is ongoing: your project will always have access to the current version of data from this source. This means the project receives access to updated data without needing to perform re-authorization.

API documentation

If you're technically proficient, you may want to work with our APIs directly to download data:

Command line tool

We also have a Python package that comes with a command line tool that can be used to download data: open-humans-api

Mac OSX Walkthrough: Download data shared with a project

Here's a walkthrough of how you can use our command line tool to download all data files currently shared with your project.

Note: if you're proficient with Python, you might want to be using brew and virtualenv to "sandbox" the installed software. The instructions below install packages "globally". See this guide for OSX development setup.

  1. Open the "Terminal" app: All of these commands run within "Terminal". You can find the "Terminal" application within your "Utilities" folder.
  2. Install pip: If you don't already have pip installed, you can install it by running this command in Terminal: sudo easy_install pip
    (Unnecessary if using brew.)
  3. Install open-humans-api: You can install our package globally by running this in Terminal: sudo pip install open-humans-api.
    (If using brew and/or virtualenv, you should avoid global installation and just run pip install open-humans-api.)
  4. Navigate to your Desktop: cd ~/Desktop
  5. Create a directory to put your data: mkdir MyProjectData
  6. Find your master access token in Open Humans: Follow our instructions to get your master access token. Copy the token, you'll use it in the next command.
  7. Download all data: Use your master access token to run the following command: ohproj-download -T YOUR_MASTER_ACCESS_TOKEN -d MyProjectData
Clone this wiki locally