Fair Allocation

Activities ::: mod_ratingallocate
Maintained by WWU logo smallLearnweb – University of Münster, Tobias Reischmann
This Module lets you add an activity to courses, in which users can rate choices. You may then distribute the users fairly to the choices by maximizing overall 'happiness' in terms of ratings. This may be an alternative to the choice activity or first-come-first-served.

Fair Allocation v2.9-r3

Moodle 2.7, 2.8, 2.9
Released: Thursday, 21 January 2016, 7:37 PM

moodle-mod_ratingallocate

Module which lets you add an activity to courses, in which users can rate choices. You may then distribute the users fairly to the choices by maximising overall 'hapiness' in terms of ratings. This may be an alternative to the choice activity or first-come-first-served.

This plugin is based on previous work by Stefan Koegel and Alexander Bias, University of Ulm.

Installation

This is an activity plugin and should go into mod/ratingallocate. Obtain this plugin from https://moodle.org/plugins/view/mod_ratingallocate.

Usage

Add an activity instance. Set mandatory parameters are timespan, in which users can give ratings, choices, which the users will have to rate and the strategy, which form will be presented to the users to rate. After the rating period has finished, you can distribute the users automatically or manually. Upon publishing the results, users will be able to see which choice they have been associated with

Moodle version

Tested with Moodle 2.7.12 (20160111), Moodle 2.8.10 (Build: 20160111) and 2.9.4 (Build: 20160121).

Algorithm

This module uses a modified Edmonds-karp algorithm to solve the minimum-cost flow problem. Augmenting paths are found using Bellman-Ford, but the user ratings are multiplied with -1 first.

Worst-Case complexity is O(m^2n^2) with m,n being number of edges (#users+#choices+#ratings_users_gave) and nodes (2+#users+#choices) in the graph. Distributing 500 users to 21 choices takes around 11sec.

Version information

Version build number
2016012101
Version release name
v2.9-r3
Can be updated from
v2.7-r2 (2014092900), v2.7-r3 (2015021001), v2.8-r1 (2015031801), v2.8-r2 (2015041301), v2.8-r3 (2015041301), v2.9-r1 (2015071301), v2.9-r2 (2015071401)
Can be updated to
v3.0-r1 (2016012701), v3.1-r1 (2016081600), v3.2-r1-not_published, v3.2-r1 (2017022700), v3.3-r1 (2017050800), v3.4-r1 (2017102700), v3.5-r1 (2018051300), v3.5-r2 (2018071000), v3.6-r1 (2018112900), v3.7-r1 (2019052900), v3.8-r1 (2019112100)
Maturity
Stable version
MD5 Sum
f22b229cd38556bee9c16794234de248
Supported software
Moodle 2.7, Moodle 2.8, Moodle 2.9

Version control information

Version control system (VCS)
GIT
VCS repository URL
VCS tag
v2.9-r3

Default installation instructions for plugins of the type Activities

  1. Make sure you have all the required versions.
  2. Download and unpack the module.
  3. Place the folder (eg "assignment") in the "mod" subdirectory.
  4. Visit http://yoursite.com/admin to finish the installation