This project will provide a library that can ingest HITSP C32's and ASTM CCR's and extract values needed to compute heath quality measures for a population. It will then be able to query over a population to compute how many people within a population conform to the measure.

Environment

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 necessay gems:

bundle install

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

http://www.mongodb.org/display/DOCS/Quickstart

Testing

This project uses RSpec for testing. To run the suite, just enter the following:

bundle exec rake spec

The coverage of the test suite is monitored with cover_me and can be run with:

bundle exec rake coverage

Map Reduce Testing

This project used the MapReduce functionality of MongoDB pretty heavily. Debugging JavaScript that is to be run inside of MongoDB can be a bit of a chore, so there is a testing tool that can be run in your browser to aid in troubleshooting.

The tool is a very small web application based on the Sinatra framework. It can be run by executing the following command:

bundle exec ruby map_test/map_test.rb

After running this command, you can open your browser to http://localhost:4567. This will show you a page of measures to choose from. Once you have selected a measure, it will take you to a page where you can choose the map function you want to test and the effective date you want to run the function with. Once that is selected, you will arrive at the map test page. The map test page provides the ability to load test JSON records from within the project. Once they are loaded, they can be edited in the textarea on the page. Finally, if you click the "run" button, it will execute the map function on the record in the text area and output the results. Since this is executing in a web browser, you can use the JavaScript debugging utilities provided to set breakpoints and inspect variables.

Source Code Analysis

This project uses metric_fu for source code analysis. Reports can be run with:

bundle exec rake metrics:all

The project is currently configured to run Flay, Flog, Churn, Reek and Roodi

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.