projects.mako.cc - s290-pingpong/blob - README

   1 The following R program was designed to (somewhat) randomly select students
   2 to call for questions in a class room environment. It was created in Harvard
   3 Graduate School of Graduate Education's S-290 to replace a physical ping-pong
   4 ball jar.
   5
   6 It takes a list of options (e.g., students), selects one at random and
   7 returns it, and then adjusts the weights so that the selected option is
   8 relatively less likely to be selected in subsequent draws.  Every student can
   9 be called on at any time.
  10
  11 It is particularly well suited to classes in which a reasonably small number
  12 of students will be called on a small number of times. Over even a small
  13 number of classes, a very balanced list is likely.
  14
  15 The software was written by Benjamin Mako Hill <mako@atdot.cc> and is
  16 released into the public domain.
  17
  18 Usage
  19 --------
  20
  21 The first time you the program this you'll need to:
  22
  23   Modify ping_pong_ball_jar.R in a text editor to include the list of options
  24   or students that you want. There are comments in the file which should help
  25   provide some direction.
  26
  27   Save the modified version for later if you'll be doing this again.
  28
  29 Each time you use it, you'll need to:
  30
  31   Paste the contents of ping_pong_ball_jar.R into a running session of R.
  32
  33 Every time you want to select an option, you'll need to:
  34
  35   Type "get.ping.pong.ball()" and then <ENTER> within R.
  36
  37   As a shortcut, you can usually just type <UP> once or twice to see the last
  38   command if you're going to be running it repeatedly.
  39
  40 Files
  41 ---------
  42
  43 ping_pong_ball_jar.R
  44
  45   Contains the R necessary to run the program. You'll need to at least modify
  46   the list of options.
  47
  48 ping_pong_ball_jar_simulation.R
  49 simulation_unweighted_random.png
  50 simulation_weighted.png
  51
  52   Code and output from simulations that show the number of questions asked to
  53   each participant in a large number of simulated classes.