Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Browse files

Updating the README

  • Loading branch information...
commit 20c143f70d25e0359017179d0bc72c2266eaa9be 1 parent 112637a
@eedrummer eedrummer authored
Showing with 56 additions and 17 deletions.
  1. +56 −17
@@ -1,29 +1,68 @@
-# Quality::Measure::Engine
+Quality Measure Engine
-TODO: Write a gem description
+This project is a library designed to calculate clinical quality measures over a given population. Quality measures are described via JSON and provide the details on what information is needed from a patient record to calculate a quality measure. The logic of the measure is described in JavaScript using the MapReduce algorithmic framework.
-## Installation
+Calculating Quality Measures
-Add this line to your application's Gemfile:
+Results of quality measures are represented by QME::QualityReport. This class provides ways to determine if a report has been calculated for a population in the database as well as ways to create jobs to run the calculations.
- gem 'quality-measure-engine'
-And then execute:
+This project currently uses Ruby 1.9.3 and is built using [Bundler]( To get all of the dependencies for the project, first install bundler:
- $ bundle
+ gem install bundler
-Or install it yourself as:
+Then run bundler to grab all of the necessary gems:
- $ gem install quality-measure-engine
+ bundle install
-## Usage
+The Quality Measure engine relies on a MongoDB [MongoDB]( running a minimum of version 2.2.* or higher. To get and install Mongo refer to:
-TODO: Write usage instructions here
-## Contributing
+It also relies on [Redis]( for background jobs via [Resque]( To install Redis, please refer to:
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
+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
+QME::QualityReport 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
+This project uses [minitest]( for testing. To run the suite, just enter the following:
+ bundle exec rake test
+The coverage of the test suite is monitored with [cover_me]( You can see the code coverage by looking in the coverage directory after running the test suite
+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.
+Copyright 2012 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,
+See the License for the specific language governing permissions and
+limitations under the License.
Please sign in to comment.
Something went wrong with that request. Please try again.