projects
/
s290-pingpong
/ commitdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
| commitdiff |
tree
raw
|
patch
|
inline
| side by side (from parent 1:
7691a9c
)
rewrapped text
master
author
Benjamin Mako Hill
<mako@atdot.cc>
Thu, 18 Jun 2015 21:07:39 +0000
(14:07 -0700)
committer
Benjamin Mako Hill
<mako@atdot.cc>
Thu, 18 Jun 2015 21:07:39 +0000
(14:07 -0700)
README
patch
|
blob
|
history
diff --git
a/README
b/README
index 3f23564b72c577320cbd9fd1cbeb93ddd1b9ac79..1f09db442e2001a3be38cd006c7817f0a8260531 100644
(file)
--- a/
README
+++ b/
README
@@
-1,16
+1,16
@@
-The following R program was designed to (
mostly) randomly select
-students to call for questions in a class room environment. It was
-created in Harvard Graduate School of Graduate Education's S-290 to
-
replace a physical ping-pong
ball jar.
+The following R program was designed to (
somewhat) randomly select students
+to call for questions in a class room environment. It was created in Harvard
+Graduate School of Graduate Education's S-290 to replace a physical ping-pong
+ball jar.
It takes a list of options (e.g., students), selects one at random and
It takes a list of options (e.g., students), selects one at random and
-returns it, and then adjusts the weights so that the selected option
-is relatively less likely to be selected in subsequent draws. Every
-
student can
be called on at any time.
+returns it, and then adjusts the weights so that the selected option
is
+relatively less likely to be selected in subsequent draws. Every student can
+be called on at any time.
-It is particularly well suited to classes in which a reasonably small
-number of students will be called on a small number of times. Over
-
even a small
number of classes, a very balanced list is likely.
+It is particularly well suited to classes in which a reasonably small
number
+of students will be called on a small number of times. Over even a small
+number of classes, a very balanced list is likely.
The software was written by Benjamin Mako Hill <mako@atdot.cc> and is
released into the public domain.
The software was written by Benjamin Mako Hill <mako@atdot.cc> and is
released into the public domain.
@@
-20,9
+20,9
@@
Usage
The first time you the program this you'll need to:
The first time you the program this you'll need to:
- Modify ping_pong_ball_jar.R in a text editor to include the list of
- o
ptions or students that you want. There are comments in the file
-
which should help
provide some direction.
+ Modify ping_pong_ball_jar.R in a text editor to include the list of
options
+ o
r students that you want. There are comments in the file which should help
+ provide some direction.
Save the modified version for later if you'll be doing this again.
Save the modified version for later if you'll be doing this again.
@@
-34,20
+34,20
@@
Every time you want to select an option, you'll need to:
Type "get.ping.pong.ball()" and then <ENTER> within R.
Type "get.ping.pong.ball()" and then <ENTER> within R.
- As a shortcut, you can usually just type <UP> once or twice to see
-
the last
command if you're going to be running it repeatedly.
+ As a shortcut, you can usually just type <UP> once or twice to see
the last
+ command if you're going to be running it repeatedly.
Files
---------
ping_pong_ball_jar.R
Files
---------
ping_pong_ball_jar.R
- Contains the R necessary to run the program. You'll need to at least
-
modify
the list of options.
+ Contains the R necessary to run the program. You'll need to at least
modify
+ the list of options.
ping_pong_ball_jar_simulation.R
simulation_unweighted_random.png
simulation_weighted.png
ping_pong_ball_jar_simulation.R
simulation_unweighted_random.png
simulation_weighted.png
- Code and output from simulations that show the number of questions
-
asked to
each participant in a large number of simulated classes.
+ Code and output from simulations that show the number of questions
asked to
+ each participant in a large number of simulated classes.
Benjamin Mako Hill
||
Want to submit a patch?