Skip to content


Subversion checkout URL

You can clone with
Download ZIP
popHealth - An Open Source Population Health Reporting Prototype
JavaScript Ruby CoffeeScript Shell
Pull request Compare This branch is 888 commits behind pophealth:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


popHealth is an open source tool that allows healthcare providers to calculate quality measures. A quality measure is a calculation of the number of individuals in a population that meet a specific standard of care.

popHealth can import patient summaries in either ASTM CCR or HITSP C32 format. popHealth will extract information from the patient summaries and calculate quality reports.

Quality Measures

This web application is agnostic of any specific quality measures. It leverages the Quality Measure Engine library to calculate quality measures. An implementation of the quality measures needed to meet meaningful use requirements is available in the Measures Project.


This project currently uses Ruby 1.9.2 and is built using Bundler. To get all of the dependencies for the project, first install bundler:

gem install bundler

Then run bundler to grab all of the necessary gems:

bundle install

The Quality Measure engine relies on a MongoDB MongoDB running a minimum of version 1.8.* or higher. To get and install Mongo refer to :

It also relies on Redis for background jobs via Resque. To install Redis, please refer to:

You can also find information on Redis at the Resque homepage. Resque is used by this project to calculate quality measures in background jobs. We also use resque-status. Please consult the resque-status instructions for working with the resque-web application if you would like to use it to monitor status.

Running Resque Workers

popHealth will kick off background jobs with Resque. For these jobs to to actually get performed, you need to be running resque workers. This can be done with the following:

QUEUE=* bundle exec rake resque:work

JRuby and CCR Support

This project requires running under JRuby to enable support for importing for ASTM CCR's. CCR Importing is written in Java and the code is available in the ccr-importer project. popHealth has been tested with JRuby 1.5.6.

Additional Information

Please check our wiki for more information.

Previous Version

If you are interested in the initial prototype of popHealth, you can find them in the Legacy Branch


Copyright 2011 The MITRE Corporation

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Project Practices

Please try to follow our Coding Style Guides. Additionally, we will be using git in a pattern similar to Vincent Driessen's workflow. While feature branches are encouraged, they are not required to work on the project.

Something went wrong with that request. Please try again.