Sugar Labs - User contributions [en]

Teacher Reporting

2009-05-18T19:12:17Z

Jrgreen118: /* Booting the XO from the SD */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

=====Un-compress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*Un-compress the file
**In Windows, [http://www.rarlab.com/download.htm WinRAR] worked well.
**In Linux, this command works just as well<pre>gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz</pre>

=====Setting Up the Environment=====
With the SD card connected to the Linux PC:
*Using a tool of your choice format the SD card to ext2 or ext3 (Linux 83).
**Gparted was excellent for formating the SD card to ext3, but fdisk would also work.
*Mark the partition with the boot flag
**This can be done using gparted, but in several instances errors were experienced. In lieu fdisk works great.
**To enter fdisk, use
<pre>
fdisk /dev/sd*1
or
fdisk /dev/mmcblk*p1
</pre>
*where * is the letter associated with the SD device and the 1 is the partition. Once in fdisk, use the help to determine the specific command to mark the boot flag. In most instances it will be "a".
*Next ensure the .img file, uncompressed previously, is accessible by the Linux machines.
*Use the command,
<pre>
dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/sd*1
or
dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/mmcblk*p1
</pre>
**This will take some time depending on the system performance.
*Use resize2fs to re-size the partition
<pre>
resize2fs -p /dev/sd*1
or
resize2fs -p /dev/mmcblk*p1
</pre>

=====Getting a Developer Key=====
*First the XO must have a [http://wiki.laptop.org/go/Activation_and_Developer_Keys developer's key!!!]
*The easiest way to go about obtaining this is to boot into the XO's Sugar OS. Open the browse application. Near the bottom right of the home page, there will be a link for "Get a Developer Key".
**Click this link and on the next page click the "Submit Query." Go through this process again after 24 hours and the key should be available.
**Upon return follow the directions displayed to download the key.
*Reboot the XO and tap the "Esc" key to interrupt the booting procedure. At the ok prompt type: <pre>ok disable-security</pre>
**The machine will probably reboot. If so, tap the "Esc" key and type the above command again. It may reboot one final time.
**Upon this reboot tap the "Esc" key again and type the above command a final time. It should print out:
<pre>
ok disable-security
No wp tag
</pre>

=====Booting the XO from the SD=====
More than likely, this will not work right away, most implementations require some tweaking prior to properly booting.
*With the SD card inserted in the XO, turn the machine on and press the "Esc" key to interrupt start-up.
*At the prompt type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>
*It should attempt the boot sequence, but more than likely will fail with a Kernel Panic!!!....error
*This is almost expected, but it's actually an important step. If you look further up on the screen, you should see an error in regards to mounting the file system.
*Around this area, you should also see a list of strange numbers (i.e. b102:) followed by devices (i.e. ramdisk...)
*Find the row for your SD card, it should be labeled something like:
<pre>
b301: mmcblk0p1
</pre>
*Remember the b301 number.
*Connect the SD card back to the Linux PC.
*Open the file /boot/olpc.fth
**Here's a quick resource on what this is [http://wiki.laptop.org/go/SD_Boot_olpc.fth SD Booting].
*You'll see a line like this:
<pre>
" ro root=mmcblk0p1 rootdelay=1 console=ttyS0,115200 console=tty0
rootfstype=ext2 fbcon=font:SUN12x22" to boot-file
</pre>
*Change the "root=******" to be the variable recorded earlier.
*Save the changes and put the SD card back in the XO. Reboot the machine and at the prompt again type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>

=====Post XS School Server Installation Configuration:=====
The following are commands that were run after installing XS on a Virtual Machine. Idealy, the newly configured SD card can now act as the operating system for the Virtual Machine allowing further versatility.

<pre>
yum groupinstall "GNOME Desktop Environment"

edit /etc/inittab and change runlevel from 3 to 5 to startup in Gnome

yum install mysql-server php php-mysql php-mbstring php-gd php-xmlrpc php-imap cvs

service mysqld start
mysqladmin -u root password 'mySecurePassword'
mysql -u root -p
mysql> CREATE DATABASE moodle CHARSET 'utf8';
mysql> exit;
chkconfig mysqld on
--starts sql server; adds root admin user; logs into server and creates DB;
--turns the service on on boot.

cd /var/www
cvs -z3 -d:pserver:anonymous@eu.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle
--download and install/update with the latest version of moodle

mkdir moodledata
chown -R apache:apache moodle
chown -R apache:apache moodledata
--make directory in /var/www/ and change permissions.

edit the file /etc/httpd/conf/httpd.conf
change DocumentRoot "/var/www/html" to DocumentRoot "/var/www/moodle"
change <Directory "/var/www/html"> to <Directory "/var/www/moodle">
then you must restart the apache server by issuing the command:
service httpd restart

</pre>

==Documentation & Resources==

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

== Code ==

Code (parser.awk) can be downloaded [http://www.filedropper.com/parser here] 
Date file (students.dat) can be downloaded [http://www.filedropper.com/students here]
 
 

With data in the same directory and with your PWD also as the same directory.
Issue the command @ the command line:
<pre>awk -f parser.awk students.dat</pre>

 
'''Parser.awk:'''
<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.
# or if they get less than 70% on compounds, because getting a 51% on compounds and 70% on non compounds doesnt satisfy
# understaning of OoO

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

==After Class Plans==

===Wesley Dillingham===
will continue this project into the summer as part of RIT's cooperative education program.

I am becoming more interested in a literal interpretation of the Massachusetts curriculum requirements and integrating them into moodle. I would like to shoot for coming up with a modified quiz module which, reads from the api which in turn reads from multiple games in order to suffice the curriculum standards, As no one game has the format to test for all of the requirements. I will be developing using php, and my immediate goal, is to provide the raw capabilities in php to understand and interpret information from the games to test understanding of guidelines. Bonus work includes, graphs, and other heuristics which the teacher may find valuable. I would like to work on helping the mathblaster game provide information relevant to my teacher reporting application via the API.

====Tenative summer shedule====
*Week 1: Begin learning and understanding of PHP.
*Week 2: Complete conversion of "Operations awk script" into PHP.
*Week 3: "Order of operations awk script" into PHP.
*Week 4: Gain understanding of PHP's querying of MySQL, convert above PHP scripts to gain information via MySQL rather than input file
*Week 6: Integrate above PHP scripts into Pre-existing quiz module.
*Week 7 & 8: Identify, 2 or 3 additional curriculum standards find games which can be used, to satisfy requirements, create php logic, to interpret information gained through MySQl
*Week 9: Work tangentially with mathblaster team and facilitate Mathblaster <> api and api <> teacher-reporter data exchange.
*Week 10: Begin work on teacher interface. Wrap up project, plan for adanonment or continuation.,

===Jeremiah Green===
will continue working on this project when time is available to devote.

*Get networking running on the XO.
*Have Moodle running on the XO.
*Have Database running on the XO.

Teacher Reporting

2009-05-18T19:11:25Z

Jrgreen118: /* Jeremiah Green */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

=====Un-compress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*Un-compress the file
**In Windows, [http://www.rarlab.com/download.htm WinRAR] worked well.
**In Linux, this command works just as well<pre>gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz</pre>

=====Setting Up the Environment=====
With the SD card connected to the Linux PC:
*Using a tool of your choice format the SD card to ext2 or ext3 (Linux 83).
**Gparted was excellent for formating the SD card to ext3, but fdisk would also work.
*Mark the partition with the boot flag
**This can be done using gparted, but in several instances errors were experienced. In lieu fdisk works great.
**To enter fdisk, use
<pre>
fdisk /dev/sd*1
or
fdisk /dev/mmcblk*p1
</pre>
*where * is the letter associated with the SD device and the 1 is the partition. Once in fdisk, use the help to determine the specific command to mark the boot flag. In most instances it will be "a".
*Next ensure the .img file, uncompressed previously, is accessible by the Linux machines.
*Use the command,
<pre>
dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/sd*1
or
dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/mmcblk*p1
</pre>
**This will take some time depending on the system performance.
*Use resize2fs to re-size the partition
<pre>
resize2fs -p /dev/sd*1
or
resize2fs -p /dev/mmcblk*p1
</pre>

=====Getting a Developer Key=====
*First the XO must have a [http://wiki.laptop.org/go/Activation_and_Developer_Keys developer's key!!!]
*The easiest way to go about obtaining this is to boot into the XO's Sugar OS. Open the browse application. Near the bottom right of the home page, there will be a link for "Get a Developer Key".
**Click this link and on the next page click the "Submit Query." Go through this process again after 24 hours and the key should be available.
**Upon return follow the directions displayed to download the key.
*Reboot the XO and tap the "Esc" key to interrupt the booting procedure. At the ok prompt type: <pre>ok disable-security</pre>
**The machine will probably reboot. If so, tap the "Esc" key and type the above command again. It may reboot one final time.
**Upon this reboot tap the "Esc" key again and type the above command a final time. It should print out:
<pre>
ok disable-security
No wp tag
</pre>

====Booting the XO from the SD====
More than likely, this will not work right away, most implementations require some tweaking prior to properly booting.
*With the SD card inserted in the XO, turn the machine on and press the "Esc" key to interrupt start-up.
*At the prompt type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>
*It should attempt the boot sequence, but more than likely will fail with a Kernel Panic!!!....error
*This is almost expected, but it's actually an important step. If you look further up on the screen, you should see an error in regards to mounting the file system.
*Around this area, you should also see a list of strange numbers (i.e. b102:) followed by devices (i.e. ramdisk...)
*Find the row for your SD card, it should be labeled something like:
<pre>
b301: mmcblk0p1
</pre>
*Remember the b301 number.
*Connect the SD card back to the Linux PC.
*Open the file /boot/olpc.fth
**Here's a quick resource on what this is [http://wiki.laptop.org/go/SD_Boot_olpc.fth SD Booting].
*You'll see a line like this:
<pre>
" ro root=mmcblk0p1 rootdelay=1 console=ttyS0,115200 console=tty0
rootfstype=ext2 fbcon=font:SUN12x22" to boot-file
</pre>
*Change the "root=******" to be the variable recorded earlier.
*Save the changes and put the SD card back in the XO. Reboot the machine and at the prompt again type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>

=====Post XS School Server Installation Configuration:=====
The following are commands that were run after installing XS on a Virtual Machine. Idealy, the newly configured SD card can now act as the operating system for the Virtual Machine allowing further versatility.

<pre>
yum groupinstall "GNOME Desktop Environment"

edit /etc/inittab and change runlevel from 3 to 5 to startup in Gnome

yum install mysql-server php php-mysql php-mbstring php-gd php-xmlrpc php-imap cvs

service mysqld start
mysqladmin -u root password 'mySecurePassword'
mysql -u root -p
mysql> CREATE DATABASE moodle CHARSET 'utf8';
mysql> exit;
chkconfig mysqld on
--starts sql server; adds root admin user; logs into server and creates DB;
--turns the service on on boot.

cd /var/www
cvs -z3 -d:pserver:anonymous@eu.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle
--download and install/update with the latest version of moodle

mkdir moodledata
chown -R apache:apache moodle
chown -R apache:apache moodledata
--make directory in /var/www/ and change permissions.

edit the file /etc/httpd/conf/httpd.conf
change DocumentRoot "/var/www/html" to DocumentRoot "/var/www/moodle"
change <Directory "/var/www/html"> to <Directory "/var/www/moodle">
then you must restart the apache server by issuing the command:
service httpd restart

</pre>

==Documentation & Resources==

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

== Code ==

Code (parser.awk) can be downloaded [http://www.filedropper.com/parser here] 
Date file (students.dat) can be downloaded [http://www.filedropper.com/students here]
 
 

With data in the same directory and with your PWD also as the same directory.
Issue the command @ the command line:
<pre>awk -f parser.awk students.dat</pre>

 
'''Parser.awk:'''
<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.
# or if they get less than 70% on compounds, because getting a 51% on compounds and 70% on non compounds doesnt satisfy
# understaning of OoO

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

==After Class Plans==

===Wesley Dillingham===
will continue this project into the summer as part of RIT's cooperative education program.

I am becoming more interested in a literal interpretation of the Massachusetts curriculum requirements and integrating them into moodle. I would like to shoot for coming up with a modified quiz module which, reads from the api which in turn reads from multiple games in order to suffice the curriculum standards, As no one game has the format to test for all of the requirements. I will be developing using php, and my immediate goal, is to provide the raw capabilities in php to understand and interpret information from the games to test understanding of guidelines. Bonus work includes, graphs, and other heuristics which the teacher may find valuable. I would like to work on helping the mathblaster game provide information relevant to my teacher reporting application via the API.

====Tenative summer shedule====
*Week 1: Begin learning and understanding of PHP.
*Week 2: Complete conversion of "Operations awk script" into PHP.
*Week 3: "Order of operations awk script" into PHP.
*Week 4: Gain understanding of PHP's querying of MySQL, convert above PHP scripts to gain information via MySQL rather than input file
*Week 6: Integrate above PHP scripts into Pre-existing quiz module.
*Week 7 & 8: Identify, 2 or 3 additional curriculum standards find games which can be used, to satisfy requirements, create php logic, to interpret information gained through MySQl
*Week 9: Work tangentially with mathblaster team and facilitate Mathblaster <> api and api <> teacher-reporter data exchange.
*Week 10: Begin work on teacher interface. Wrap up project, plan for adanonment or continuation.,

===Jeremiah Green===
will continue working on this project when time is available to devote.

*Get networking running on the XO.
*Have Moodle running on the XO.
*Have Database running on the XO.

Teacher Reporting

2009-05-18T19:03:04Z

Jrgreen118: /* Setting Up the Environment */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

=====Un-compress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*Un-compress the file
**In Windows, [http://www.rarlab.com/download.htm WinRAR] worked well.
**In Linux, this command works just as well<pre>gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz</pre>

=====Setting Up the Environment=====
With the SD card connected to the Linux PC:
*Using a tool of your choice format the SD card to ext2 or ext3 (Linux 83).
**Gparted was excellent for formating the SD card to ext3, but fdisk would also work.
*Mark the partition with the boot flag
**This can be done using gparted, but in several instances errors were experienced. In lieu fdisk works great.
**To enter fdisk, use
<pre>
fdisk /dev/sd*1
or
fdisk /dev/mmcblk*p1
</pre>
*where * is the letter associated with the SD device and the 1 is the partition. Once in fdisk, use the help to determine the specific command to mark the boot flag. In most instances it will be "a".
*Next ensure the .img file, uncompressed previously, is accessible by the Linux machines.
*Use the command,
<pre>
dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/sd*1
or
dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/mmcblk*p1
</pre>
**This will take some time depending on the system performance.
*Use resize2fs to re-size the partition
<pre>
resize2fs -p /dev/sd*1
or
resize2fs -p /dev/mmcblk*p1
</pre>

=====Getting a Developer Key=====
*First the XO must have a [http://wiki.laptop.org/go/Activation_and_Developer_Keys developer's key!!!]
*The easiest way to go about obtaining this is to boot into the XO's Sugar OS. Open the browse application. Near the bottom right of the home page, there will be a link for "Get a Developer Key".
**Click this link and on the next page click the "Submit Query." Go through this process again after 24 hours and the key should be available.
**Upon return follow the directions displayed to download the key.
*Reboot the XO and tap the "Esc" key to interrupt the booting procedure. At the ok prompt type: <pre>ok disable-security</pre>
**The machine will probably reboot. If so, tap the "Esc" key and type the above command again. It may reboot one final time.
**Upon this reboot tap the "Esc" key again and type the above command a final time. It should print out:
<pre>
ok disable-security
No wp tag
</pre>

====Booting the XO from the SD====
More than likely, this will not work right away, most implementations require some tweaking prior to properly booting.
*With the SD card inserted in the XO, turn the machine on and press the "Esc" key to interrupt start-up.
*At the prompt type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>
*It should attempt the boot sequence, but more than likely will fail with a Kernel Panic!!!....error
*This is almost expected, but it's actually an important step. If you look further up on the screen, you should see an error in regards to mounting the file system.
*Around this area, you should also see a list of strange numbers (i.e. b102:) followed by devices (i.e. ramdisk...)
*Find the row for your SD card, it should be labeled something like:
<pre>
b301: mmcblk0p1
</pre>
*Remember the b301 number.
*Connect the SD card back to the Linux PC.
*Open the file /boot/olpc.fth
**Here's a quick resource on what this is [http://wiki.laptop.org/go/SD_Boot_olpc.fth SD Booting].
*You'll see a line like this:
<pre>
" ro root=mmcblk0p1 rootdelay=1 console=ttyS0,115200 console=tty0
rootfstype=ext2 fbcon=font:SUN12x22" to boot-file
</pre>
*Change the "root=******" to be the variable recorded earlier.
*Save the changes and put the SD card back in the XO. Reboot the machine and at the prompt again type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>

=====Post XS School Server Installation Configuration:=====
The following are commands that were run after installing XS on a Virtual Machine. Idealy, the newly configured SD card can now act as the operating system for the Virtual Machine allowing further versatility.

<pre>
yum groupinstall "GNOME Desktop Environment"

edit /etc/inittab and change runlevel from 3 to 5 to startup in Gnome

yum install mysql-server php php-mysql php-mbstring php-gd php-xmlrpc php-imap cvs

service mysqld start
mysqladmin -u root password 'mySecurePassword'
mysql -u root -p
mysql> CREATE DATABASE moodle CHARSET 'utf8';
mysql> exit;
chkconfig mysqld on
--starts sql server; adds root admin user; logs into server and creates DB;
--turns the service on on boot.

cd /var/www
cvs -z3 -d:pserver:anonymous@eu.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle
--download and install/update with the latest version of moodle

mkdir moodledata
chown -R apache:apache moodle
chown -R apache:apache moodledata
--make directory in /var/www/ and change permissions.

edit the file /etc/httpd/conf/httpd.conf
change DocumentRoot "/var/www/html" to DocumentRoot "/var/www/moodle"
change <Directory "/var/www/html"> to <Directory "/var/www/moodle">
then you must restart the apache server by issuing the command:
service httpd restart

</pre>

==Documentation & Resources==

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

== Code ==

Code (parser.awk) can be downloaded [http://www.filedropper.com/parser here] 
Date file (students.dat) can be downloaded [http://www.filedropper.com/students here]
 
 

With data in the same directory and with your PWD also as the same directory.
Issue the command @ the command line:
<pre>awk -f parser.awk students.dat</pre>

 
'''Parser.awk:'''
<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.
# or if they get less than 70% on compounds, because getting a 51% on compounds and 70% on non compounds doesnt satisfy
# understaning of OoO

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

==After Class Plans==

===Wesley Dillingham===
will continue this project into the summer as part of RIT's cooperative education program.

I am becoming more interested in a literal interpretation of the Massachusetts curriculum requirements and integrating them into moodle. I would like to shoot for coming up with a modified quiz module which, reads from the api which in turn reads from multiple games in order to suffice the curriculum standards, As no one game has the format to test for all of the requirements. I will be developing using php, and my immediate goal, is to provide the raw capabilities in php to understand and interpret information from the games to test understanding of guidelines. Bonus work includes, graphs, and other heuristics which the teacher may find valuable. I would like to work on helping the mathblaster game provide information relevant to my teacher reporting application via the API.

====Tenative summer shedule====
*Week 1: Begin learning and understanding of PHP.
*Week 2: Complete conversion of "Operations awk script" into PHP.
*Week 3: "Order of operations awk script" into PHP.
*Week 4: Gain understanding of PHP's querying of MySQL, convert above PHP scripts to gain information via MySQL rather than input file
*Week 6: Integrate above PHP scripts into Pre-existing quiz module.
*Week 7 & 8: Identify, 2 or 3 additional curriculum standards find games which can be used, to satisfy requirements, create php logic, to interpret information gained through MySQl
*Week 9: Work tangentially with mathblaster team and facilitate Mathblaster <> api and api <> teacher-reporter data exchange.
*Week 10: Begin work on teacher interface. Wrap up project, plan for adanonment or continuation.,

===Jeremiah Green===
will continue working on this project when time is available to devote.

Teacher Reporting

2009-05-18T17:17:52Z

Jrgreen118: /* Post XS School Server Installation Configuration: */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

=====Un-compress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*Un-compress the file
**In Windows, [http://www.rarlab.com/download.htm WinRAR] worked well.
**In Linux, this command works just as well<pre>gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz</pre>

=====Setting Up the Environment=====
With the SD card connected to the Linux PC:
*Using a tool of your choice format the SD card to ext2 or ext3 (Linux 83).
**Gparted was excellent for formating the SD card to ext3, but fdisk would also work.
*Mark the partition with the boot flag
**This can be done using gparted, but in several instances errors were experienced. In lieu fdisk works great.
**To enter fdisk, use
<pre>
fdisk /dev/sd*1
or
fdisk /dev/mmcblk*p1
</pre>
*where * is the letter associated with the SD device and the 1 is the partition. Once in fdisk, use the help to determine the specific command to mark the boot flag. In most instances it will be "a".
*Next ensure the .img file, uncompressed previously, is accessible by the Linux machines.
*Use the command, <pre>dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/sd*1</pre>
**This will take some time depending on the system performance.
*Use resize2fs to re-size the partition <pre>resize2fs -p /dev/sd*1</pre>

=====Getting a Developer Key=====
*First the XO must have a [http://wiki.laptop.org/go/Activation_and_Developer_Keys developer's key!!!]
*The easiest way to go about obtaining this is to boot into the XO's Sugar OS. Open the browse application. Near the bottom right of the home page, there will be a link for "Get a Developer Key".
**Click this link and on the next page click the "Submit Query." Go through this process again after 24 hours and the key should be available.
**Upon return follow the directions displayed to download the key.
*Reboot the XO and tap the "Esc" key to interrupt the booting procedure. At the ok prompt type: <pre>ok disable-security</pre>
**The machine will probably reboot. If so, tap the "Esc" key and type the above command again. It may reboot one final time.
**Upon this reboot tap the "Esc" key again and type the above command a final time. It should print out:
<pre>
ok disable-security
No wp tag
</pre>

====Booting the XO from the SD====
More than likely, this will not work right away, most implementations require some tweaking prior to properly booting.
*With the SD card inserted in the XO, turn the machine on and press the "Esc" key to interrupt start-up.
*At the prompt type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>
*It should attempt the boot sequence, but more than likely will fail with a Kernel Panic!!!....error
*This is almost expected, but it's actually an important step. If you look further up on the screen, you should see an error in regards to mounting the file system.
*Around this area, you should also see a list of strange numbers (i.e. b102:) followed by devices (i.e. ramdisk...)
*Find the row for your SD card, it should be labeled something like:
<pre>
b301: mmcblk0p1
</pre>
*Remember the b301 number.
*Connect the SD card back to the Linux PC.
*Open the file /boot/olpc.fth
**Here's a quick resource on what this is [http://wiki.laptop.org/go/SD_Boot_olpc.fth SD Booting].
*You'll see a line like this:
<pre>
" ro root=mmcblk0p1 rootdelay=1 console=ttyS0,115200 console=tty0
rootfstype=ext2 fbcon=font:SUN12x22" to boot-file
</pre>
*Change the "root=******" to be the variable recorded earlier.
*Save the changes and put the SD card back in the XO. Reboot the machine and at the prompt again type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>

=====Post XS School Server Installation Configuration:=====
The following are commands that were run after installing XS on a Virtual Machine. Idealy, the newly configured SD card can now act as the operating system for the Virtual Machine allowing further versatility.

<pre>
yum groupinstall "GNOME Desktop Environment"

edit /etc/inittab and change runlevel from 3 to 5 to startup in Gnome

yum install mysql-server php php-mysql php-mbstring php-gd php-xmlrpc php-imap cvs

service mysqld start
mysqladmin -u root password 'mySecurePassword'
mysql -u root -p
mysql> CREATE DATABASE moodle CHARSET 'utf8';
mysql> exit;
chkconfig mysqld on
--starts sql server; adds root admin user; logs into server and creates DB;
--turns the service on on boot.

cd /var/www
cvs -z3 -d:pserver:anonymous@eu.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle
--download and install/update with the latest version of moodle

mkdir moodledata
chown -R apache:apache moodle
chown -R apache:apache moodledata
--make directory in /var/www/ and change permissions.

edit the file /etc/httpd/conf/httpd.conf
change DocumentRoot "/var/www/html" to DocumentRoot "/var/www/moodle"
change <Directory "/var/www/html"> to <Directory "/var/www/moodle">
then you must restart the apache server by issuing the command:
service httpd restart

</pre>

==Documentation & Resources==

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

== Code ==

Code (parser.awk) can be downloaded [http://www.filedropper.com/parser here] 
Date file (students.dat) can be downloaded [http://www.filedropper.com/students here]

<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.
# or if they get less than 70% on compounds, because getting a 51% on compounds and 70% on non compounds doesnt satisfy
# understaning of OoO

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

==After Class Plans==

Wesley Dillingham will continue this project into the summer as part of RIT's cooperative education program.

Jeremiah Green will continue working on this project when time is available to devote.

Teacher Reporting

2009-05-18T17:16:21Z

Jrgreen118: /* Booting the XO from the SD */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

=====Un-compress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*Un-compress the file
**In Windows, [http://www.rarlab.com/download.htm WinRAR] worked well.
**In Linux, this command works just as well<pre>gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz</pre>

=====Setting Up the Environment=====
With the SD card connected to the Linux PC:
*Using a tool of your choice format the SD card to ext2 or ext3 (Linux 83).
**Gparted was excellent for formating the SD card to ext3, but fdisk would also work.
*Mark the partition with the boot flag
**This can be done using gparted, but in several instances errors were experienced. In lieu fdisk works great.
**To enter fdisk, use
<pre>
fdisk /dev/sd*1
or
fdisk /dev/mmcblk*p1
</pre>
*where * is the letter associated with the SD device and the 1 is the partition. Once in fdisk, use the help to determine the specific command to mark the boot flag. In most instances it will be "a".
*Next ensure the .img file, uncompressed previously, is accessible by the Linux machines.
*Use the command, <pre>dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/sd*1</pre>
**This will take some time depending on the system performance.
*Use resize2fs to re-size the partition <pre>resize2fs -p /dev/sd*1</pre>

=====Getting a Developer Key=====
*First the XO must have a [http://wiki.laptop.org/go/Activation_and_Developer_Keys developer's key!!!]
*The easiest way to go about obtaining this is to boot into the XO's Sugar OS. Open the browse application. Near the bottom right of the home page, there will be a link for "Get a Developer Key".
**Click this link and on the next page click the "Submit Query." Go through this process again after 24 hours and the key should be available.
**Upon return follow the directions displayed to download the key.
*Reboot the XO and tap the "Esc" key to interrupt the booting procedure. At the ok prompt type: <pre>ok disable-security</pre>
**The machine will probably reboot. If so, tap the "Esc" key and type the above command again. It may reboot one final time.
**Upon this reboot tap the "Esc" key again and type the above command a final time. It should print out:
<pre>
ok disable-security
No wp tag
</pre>

====Booting the XO from the SD====
More than likely, this will not work right away, most implementations require some tweaking prior to properly booting.
*With the SD card inserted in the XO, turn the machine on and press the "Esc" key to interrupt start-up.
*At the prompt type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>
*It should attempt the boot sequence, but more than likely will fail with a Kernel Panic!!!....error
*This is almost expected, but it's actually an important step. If you look further up on the screen, you should see an error in regards to mounting the file system.
*Around this area, you should also see a list of strange numbers (i.e. b102:) followed by devices (i.e. ramdisk...)
*Find the row for your SD card, it should be labeled something like:
<pre>
b301: mmcblk0p1
</pre>
*Remember the b301 number.
*Connect the SD card back to the Linux PC.
*Open the file /boot/olpc.fth
**Here's a quick resource on what this is [http://wiki.laptop.org/go/SD_Boot_olpc.fth SD Booting].
*You'll see a line like this:
<pre>
" ro root=mmcblk0p1 rootdelay=1 console=ttyS0,115200 console=tty0
rootfstype=ext2 fbcon=font:SUN12x22" to boot-file
</pre>
*Change the "root=******" to be the variable recorded earlier.
*Save the changes and put the SD card back in the XO. Reboot the machine and at the prompt again type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>

=====Post XS School Server Installation Configuration:=====
<pre>
yum groupinstall "GNOME Desktop Environment"

edit /etc/inittab and change runlevel from 3 to 5 to startup in Gnome

yum install mysql-server php php-mysql php-mbstring php-gd php-xmlrpc php-imap cvs

service mysqld start
mysqladmin -u root password 'mySecurePassword'
mysql -u root -p
mysql> CREATE DATABASE moodle CHARSET 'utf8';
mysql> exit;
chkconfig mysqld on
--starts sql server; adds root admin user; logs into server and creates DB;
--turns the service on on boot.

cd /var/www
cvs -z3 -d:pserver:anonymous@eu.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle
--download and install/update with the latest version of moodle

mkdir moodledata
chown -R apache:apache moodle
chown -R apache:apache moodledata
--make directory in /var/www/ and change permissions.

edit the file /etc/httpd/conf/httpd.conf
change DocumentRoot "/var/www/html" to DocumentRoot "/var/www/moodle"
change <Directory "/var/www/html"> to <Directory "/var/www/moodle">
then you must restart the apache server by issuing the command:
service httpd restart

</pre>

==Documentation & Resources==

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

== Code ==

Code can be downloaded [http://www.filedropper.com/parser here]

<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.
# or if they get less than 70% on compounds, because getting a 51% on compounds and 70% on non compounds doesnt satisfy
# understaning of OoO

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

==After Class Plans==

Wesley Dillingham will continue this project into the summer as part of RIT's cooperative education program.

Jeremiah Green will continue working on this project when time is available to devote.

Teacher Reporting

2009-05-18T17:15:48Z

Jrgreen118: /* Documentation & Resources */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

=====Un-compress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*Un-compress the file
**In Windows, [http://www.rarlab.com/download.htm WinRAR] worked well.
**In Linux, this command works just as well<pre>gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz</pre>

=====Setting Up the Environment=====
With the SD card connected to the Linux PC:
*Using a tool of your choice format the SD card to ext2 or ext3 (Linux 83).
**Gparted was excellent for formating the SD card to ext3, but fdisk would also work.
*Mark the partition with the boot flag
**This can be done using gparted, but in several instances errors were experienced. In lieu fdisk works great.
**To enter fdisk, use
<pre>
fdisk /dev/sd*1
or
fdisk /dev/mmcblk*p1
</pre>
*where * is the letter associated with the SD device and the 1 is the partition. Once in fdisk, use the help to determine the specific command to mark the boot flag. In most instances it will be "a".
*Next ensure the .img file, uncompressed previously, is accessible by the Linux machines.
*Use the command, <pre>dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/sd*1</pre>
**This will take some time depending on the system performance.
*Use resize2fs to re-size the partition <pre>resize2fs -p /dev/sd*1</pre>

=====Getting a Developer Key=====
*First the XO must have a [http://wiki.laptop.org/go/Activation_and_Developer_Keys developer's key!!!]
*The easiest way to go about obtaining this is to boot into the XO's Sugar OS. Open the browse application. Near the bottom right of the home page, there will be a link for "Get a Developer Key".
**Click this link and on the next page click the "Submit Query." Go through this process again after 24 hours and the key should be available.
**Upon return follow the directions displayed to download the key.
*Reboot the XO and tap the "Esc" key to interrupt the booting procedure. At the ok prompt type: <pre>ok disable-security</pre>
**The machine will probably reboot. If so, tap the "Esc" key and type the above command again. It may reboot one final time.
**Upon this reboot tap the "Esc" key again and type the above command a final time. It should print out:
<pre>
ok disable-security
No wp tag
</pre>

====Booting the XO from the SD====
More than likely, this will not work right away, most implementations require some tweaking prior to properly booting.
*With the SD card inserted in the XO, turn the machine on and press the "Esc" key to interrupt start-up.
*At the prompt type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>
*It should attempt the boot sequence, but more than likely will fail with a Kernel Panic!!!....error
*This is almost expected, but it's actually an important step. If you look further up on the screen, you should see an error in regards to mounting the file system.
*Around this area, you should also see a list of strange numbers (i.e. b102:) followed by devices (i.e. ramdisk...)
*Find the row for your SD card, it should be labeled something like:
<pre>
b301: mmcblk0p1
</pre>
*Remember the b301 number.
*Connect the SD card back to the Linux PC.
*Open the file /boot/olpc.fth
**Here's a quick resource on what this is [http://wiki.laptop.org/go/SD_Boot_olpc.fth SD Booting].
*You'll see a line like this:
<pre>
" ro root=mmcblk0p1 rootdelay=1 console=ttyS0,115200 console=tty0
rootfstype=ext2 fbcon=font:SUN12x22" to boot-file
</pre>
*Change the "root=******" to be the variable recorded earlier.
*Save the changes and put the SD card back in the XO. Reboot the machine and at the prompt again type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>

==Documentation & Resources==

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

== Code ==

Code can be downloaded [http://www.filedropper.com/parser here]

<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.
# or if they get less than 70% on compounds, because getting a 51% on compounds and 70% on non compounds doesnt satisfy
# understaning of OoO

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

==After Class Plans==

Wesley Dillingham will continue this project into the summer as part of RIT's cooperative education program.

Jeremiah Green will continue working on this project when time is available to devote.

Teacher Reporting

2009-05-18T17:05:13Z

Jrgreen118: /* Booting the XO from the SD */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

=====Un-compress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*Un-compress the file
**In Windows, [http://www.rarlab.com/download.htm WinRAR] worked well.
**In Linux, this command works just as well<pre>gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz</pre>

=====Setting Up the Environment=====
With the SD card connected to the Linux PC:
*Using a tool of your choice format the SD card to ext2 or ext3 (Linux 83).
**Gparted was excellent for formating the SD card to ext3, but fdisk would also work.
*Mark the partition with the boot flag
**This can be done using gparted, but in several instances errors were experienced. In lieu fdisk works great.
**To enter fdisk, use
<pre>
fdisk /dev/sd*1
or
fdisk /dev/mmcblk*p1
</pre>
*where * is the letter associated with the SD device and the 1 is the partition. Once in fdisk, use the help to determine the specific command to mark the boot flag. In most instances it will be "a".
*Next ensure the .img file, uncompressed previously, is accessible by the Linux machines.
*Use the command, <pre>dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/sd*1</pre>
**This will take some time depending on the system performance.
*Use resize2fs to re-size the partition <pre>resize2fs -p /dev/sd*1</pre>

=====Getting a Developer Key=====
*First the XO must have a [http://wiki.laptop.org/go/Activation_and_Developer_Keys developer's key!!!]
*The easiest way to go about obtaining this is to boot into the XO's Sugar OS. Open the browse application. Near the bottom right of the home page, there will be a link for "Get a Developer Key".
**Click this link and on the next page click the "Submit Query." Go through this process again after 24 hours and the key should be available.
**Upon return follow the directions displayed to download the key.
*Reboot the XO and tap the "Esc" key to interrupt the booting procedure. At the ok prompt type: <pre>ok disable-security</pre>
**The machine will probably reboot. If so, tap the "Esc" key and type the above command again. It may reboot one final time.
**Upon this reboot tap the "Esc" key again and type the above command a final time. It should print out:
<pre>
ok disable-security
No wp tag
</pre>

====Booting the XO from the SD====
More than likely, this will not work right away, most implementations require some tweaking prior to properly booting.
*With the SD card inserted in the XO, turn the machine on and press the "Esc" key to interrupt start-up.
*At the prompt type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>
*It should attempt the boot sequence, but more than likely will fail with a Kernel Panic!!!....error
*This is almost expected, but it's actually an important step. If you look further up on the screen, you should see an error in regards to mounting the file system.
*Around this area, you should also see a list of strange numbers (i.e. b102:) followed by devices (i.e. ramdisk...)
*Find the row for your SD card, it should be labeled something like:
<pre>
b301: mmcblk0p1
</pre>
*Remember the b301 number.
*Connect the SD card back to the Linux PC.
*Open the file /boot/olpc.fth
**Here's a quick resource on what this is [http://wiki.laptop.org/go/SD_Boot_olpc.fth SD Booting].
*You'll see a line like this:
<pre>
" ro root=mmcblk0p1 rootdelay=1 console=ttyS0,115200 console=tty0
rootfstype=ext2 fbcon=font:SUN12x22" to boot-file
</pre>
*Change the "root=******" to be the variable recorded earlier.
*Save the changes and put the SD card back in the XO. Reboot the machine and at the prompt again type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>

==Documentation & Resources==

'''Post XS School Server Installation Configuration:'''
<pre>
yum groupinstall "GNOME Desktop Environment"

edit /etc/inittab and change runlevel from 3 to 5 to startup in Gnome

yum install mysql-server php php-mysql php-mbstring php-gd php-xmlrpc php-imap cvs

service mysqld start
mysqladmin -u root password 'mySecurePassword'
mysql -u root -p
mysql> CREATE DATABASE moodle CHARSET 'utf8';
mysql> exit;
chkconfig mysqld on
--starts sql server; adds root admin user; logs into server and creates DB;
--turns the service on on boot.

cd /var/www
cvs -z3 -d:pserver:anonymous@eu.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle
--download and install/update with the latest version of moodle

mkdir moodledata
chown -R apache:apache moodle
chown -R apache:apache moodledata
--make directory in /var/www/ and change permissions.

edit the file /etc/httpd/conf/httpd.conf
change DocumentRoot "/var/www/html" to DocumentRoot "/var/www/moodle"
change <Directory "/var/www/html"> to <Directory "/var/www/moodle">
then you must restart the apache server by issuing the command:
service httpd restart

</pre>

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

'''Starting MySQL Database:''' 
[[image:ScreenStartingMysql.png]]

'''Logging in to MySQL Database:''' 
[[image:ScreenLoginSqlServ.png]]

'''Creating Database:''' 
[[image:ScreenCreateDB.png]]

== Code ==

Code can be downloaded [http://www.filedropper.com/parser here]

<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

==After Class Plans==

Wesley Dillingham will continue this project into the summer as part of RIT's cooperative education program.

Jeremiah Green will continue working on this project when time is available to devote.

Teacher Reporting

2009-05-18T17:02:42Z

Jrgreen118: /* Getting a Developer Key */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

=====Un-compress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*Un-compress the file
**In Windows, [http://www.rarlab.com/download.htm WinRAR] worked well.
**In Linux, this command works just as well<pre>gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz</pre>

=====Setting Up the Environment=====
With the SD card connected to the Linux PC:
*Using a tool of your choice format the SD card to ext2 or ext3 (Linux 83).
**Gparted was excellent for formating the SD card to ext3, but fdisk would also work.
*Mark the partition with the boot flag
**This can be done using gparted, but in several instances errors were experienced. In lieu fdisk works great.
**To enter fdisk, use
<pre>
fdisk /dev/sd*1
or
fdisk /dev/mmcblk*p1
</pre>
*where * is the letter associated with the SD device and the 1 is the partition. Once in fdisk, use the help to determine the specific command to mark the boot flag. In most instances it will be "a".
*Next ensure the .img file, uncompressed previously, is accessible by the Linux machines.
*Use the command, <pre>dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/sd*1</pre>
**This will take some time depending on the system performance.
*Use resize2fs to re-size the partition <pre>resize2fs -p /dev/sd*1</pre>

=====Getting a Developer Key=====
*First the XO must have a [http://wiki.laptop.org/go/Activation_and_Developer_Keys developer's key!!!]
*The easiest way to go about obtaining this is to boot into the XO's Sugar OS. Open the browse application. Near the bottom right of the home page, there will be a link for "Get a Developer Key".
**Click this link and on the next page click the "Submit Query." Go through this process again after 24 hours and the key should be available.
**Upon return follow the directions displayed to download the key.
*Reboot the XO and tap the "Esc" key to interrupt the booting procedure. At the ok prompt type: <pre>ok disable-security</pre>
**The machine will probably reboot. If so, tap the "Esc" key and type the above command again. It may reboot one final time.
**Upon this reboot tap the "Esc" key again and type the above command a final time. It should print out:
<pre>
ok disable-security
No wp tag
</pre>

====Booting the XO from the SD====
More than likely, this will not work right away, my implementation required some tweaking prior to fully booting.
*With the SD card inserted in the XO, turn the machine on and press the "Esc" key to interrupt start-up.
*At the prompt type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>
*It should attempt the boot sequence, but more than likely will fail with a Kernel Panic!!!....error
*This is almost expected, but it's actually an important step. If you look further up on the screen, you should see an error in regards to mounting the file system.
*Around this area, you should also see a list of strange numbers (i.e. b102:) followed by devices (i.e. ramdisk...)
*Find the row for your SD card, it should be labeled something like:
<pre>
b301: mmcblk0p1
</pre>
*Remember the b301 number.
*Connect the SD card back to the Linux PC.
*Open the file /boot/olpc.fth
**Here's a quick resource on what this is [http://wiki.laptop.org/go/SD_Boot_olpc.fth SD Booting].
*You'll see a line like this:
<pre>
" ro root=mmcblk0p1 rootdelay=1 console=ttyS0,115200 console=tty0
rootfstype=ext2 fbcon=font:SUN12x22" to boot-file
</pre>
*Change the "root=******" to be the variable recorded earlier.
*Save the changes and put the SD card back in the XO. Reboot the machine and at the prompt again type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>

==Documentation & Resources==

'''Post XS School Server Installation Configuration:'''
<pre>
yum groupinstall "GNOME Desktop Environment"

edit /etc/inittab and change runlevel from 3 to 5 to startup in Gnome

yum install mysql-server php php-mysql php-mbstring php-gd php-xmlrpc php-imap cvs

service mysqld start
mysqladmin -u root password 'mySecurePassword'
mysql -u root -p
mysql> CREATE DATABASE moodle CHARSET 'utf8';
mysql> exit;
chkconfig mysqld on
--starts sql server; adds root admin user; logs into server and creates DB;
--turns the service on on boot.

cd /var/www
cvs -z3 -d:pserver:anonymous@eu.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle
--download and install/update with the latest version of moodle

mkdir moodledata
chown -R apache:apache moodle
chown -R apache:apache moodledata
--make directory in /var/www/ and change permissions.

edit the file /etc/httpd/conf/httpd.conf
change DocumentRoot "/var/www/html" to DocumentRoot "/var/www/moodle"
change <Directory "/var/www/html"> to <Directory "/var/www/moodle">
then you must restart the apache server by issuing the command:
service httpd restart

</pre>

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

'''Starting MySQL Database:''' 
[[image:ScreenStartingMysql.png]]

'''Logging in to MySQL Database:''' 
[[image:ScreenLoginSqlServ.png]]

'''Creating Database:''' 
[[image:ScreenCreateDB.png]]

== Code ==

Code can be downloaded [http://www.filedropper.com/parser here]

<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

==After Class Plans==

Wesley Dillingham will continue this project into the summer as part of RIT's cooperative education program.

Jeremiah Green will continue working on this project when time is available to devote.

Teacher Reporting

2009-05-18T17:01:46Z

Jrgreen118: /* Setting Up the Environment */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

=====Un-compress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*Un-compress the file
**In Windows, [http://www.rarlab.com/download.htm WinRAR] worked well.
**In Linux, this command works just as well<pre>gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz</pre>

=====Setting Up the Environment=====
With the SD card connected to the Linux PC:
*Using a tool of your choice format the SD card to ext2 or ext3 (Linux 83).
**Gparted was excellent for formating the SD card to ext3, but fdisk would also work.
*Mark the partition with the boot flag
**This can be done using gparted, but in several instances errors were experienced. In lieu fdisk works great.
**To enter fdisk, use
<pre>
fdisk /dev/sd*1
or
fdisk /dev/mmcblk*p1
</pre>
*where * is the letter associated with the SD device and the 1 is the partition. Once in fdisk, use the help to determine the specific command to mark the boot flag. In most instances it will be "a".
*Next ensure the .img file, uncompressed previously, is accessible by the Linux machines.
*Use the command, <pre>dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/sd*1</pre>
**This will take some time depending on the system performance.
*Use resize2fs to re-size the partition <pre>resize2fs -p /dev/sd*1</pre>

=====Getting a Developer Key=====
*First the XO must have a [http://wiki.laptop.org/go/Activation_and_Developer_Keys developer's key!!!]
*The easiest way to go about obtaining this is to boot into the XO's Sugar OS. Open the browse application. Near the bottom right of the home page, there will be a like for "Get a Developer Key".
**Click this link and on the next page click the "Submit Query." Go through this process again after 24 hours and the key should be available.
**Upon return follow the directions displayed to download the key.
*Reboot the XO and tap the "Esc" key to interrupt the booting procedure. At the ok prompt type: <pre>ok disable-security</pre>
**The machine will probably reboot. If so, tap the "Esc" key and type the above command again. It may reboot one final time.
**Upon this reboot tap the "Esc" key again and type the above command a final time. It should print out:
<pre>
ok disable-security
No wp tag
</pre>

====Booting the XO from the SD====
More than likely, this will not work right away, my implementation required some tweaking prior to fully booting.
*With the SD card inserted in the XO, turn the machine on and press the "Esc" key to interrupt start-up.
*At the prompt type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>
*It should attempt the boot sequence, but more than likely will fail with a Kernel Panic!!!....error
*This is almost expected, but it's actually an important step. If you look further up on the screen, you should see an error in regards to mounting the file system.
*Around this area, you should also see a list of strange numbers (i.e. b102:) followed by devices (i.e. ramdisk...)
*Find the row for your SD card, it should be labeled something like:
<pre>
b301: mmcblk0p1
</pre>
*Remember the b301 number.
*Connect the SD card back to the Linux PC.
*Open the file /boot/olpc.fth
**Here's a quick resource on what this is [http://wiki.laptop.org/go/SD_Boot_olpc.fth SD Booting].
*You'll see a line like this:
<pre>
" ro root=mmcblk0p1 rootdelay=1 console=ttyS0,115200 console=tty0
rootfstype=ext2 fbcon=font:SUN12x22" to boot-file
</pre>
*Change the "root=******" to be the variable recorded earlier.
*Save the changes and put the SD card back in the XO. Reboot the machine and at the prompt again type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>

==Documentation & Resources==

'''Post XS School Server Installation Configuration:'''
<pre>
yum groupinstall "GNOME Desktop Environment"

edit /etc/inittab and change runlevel from 3 to 5 to startup in Gnome

yum install mysql-server php php-mysql php-mbstring php-gd php-xmlrpc php-imap cvs

service mysqld start
mysqladmin -u root password 'mySecurePassword'
mysql -u root -p
mysql> CREATE DATABASE moodle CHARSET 'utf8';
mysql> exit;
chkconfig mysqld on
--starts sql server; adds root admin user; logs into server and creates DB;
--turns the service on on boot.

cd /var/www
cvs -z3 -d:pserver:anonymous@eu.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle
--download and install/update with the latest version of moodle

mkdir moodledata
chown -R apache:apache moodle
chown -R apache:apache moodledata
--make directory in /var/www/ and change permissions.

edit the file /etc/httpd/conf/httpd.conf
change DocumentRoot "/var/www/html" to DocumentRoot "/var/www/moodle"
change <Directory "/var/www/html"> to <Directory "/var/www/moodle">
then you must restart the apache server by issuing the command:
service httpd restart

</pre>

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

'''Starting MySQL Database:''' 
[[image:ScreenStartingMysql.png]]

'''Logging in to MySQL Database:''' 
[[image:ScreenLoginSqlServ.png]]

'''Creating Database:''' 
[[image:ScreenCreateDB.png]]

== Code ==

Code can be downloaded [http://www.filedropper.com/parser here]

<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

==After Class Plans==

Wesley Dillingham will continue this project into the summer as part of RIT's cooperative education program.

Jeremiah Green will continue working on this project when time is available to devote.

Teacher Reporting

2009-05-18T16:59:42Z

Jrgreen118: /* Setting Up the Environment */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

=====Un-compress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*Un-compress the file
**In Windows, [http://www.rarlab.com/download.htm WinRAR] worked well.
**In Linux, this command works just as well<pre>gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz</pre>

=====Setting Up the Environment=====
With the SD card connected to the Linux PC:
*Using a tool of your choice format the SD card to ext2 or ext3 (Linux 83).
**Gparted was excellent for formating the SD card to ext3, but fdisk would also work.
*Mark the partition with the boot flag
**This can be done using gparted, but in several instances errors were experienced. In lieu fdisk works great.
**To enter fdisk, use
<pre>
fdisk /dev/sd*1
or
fdisk /dev/mmcblk*p1
</pre>
*where * is the letter associated with the SD device and the 1 is the partition. Once in fdisk, use the help to determine the specific command to mark the boot flag. In most instances it will be "a".
*Next ensure the .img file uncompressed previously is accessible by the Linux machines. I used another flash drive.
*Use the command <pre>dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/sd*1</pre>
**This will take some time depending on the system performance.
*Use resize2fs to re-size the partition <pre>resize2fs -p /dev/sd*1</pre>

=====Getting a Developer Key=====
*First the XO must have a [http://wiki.laptop.org/go/Activation_and_Developer_Keys developer's key!!!]
*The easiest way to go about obtaining this is to boot into the XO's Sugar OS. Open the browse application. Near the bottom right of the home page, there will be a like for "Get a Developer Key".
**Click this link and on the next page click the "Submit Query." Go through this process again after 24 hours and the key should be available.
**Upon return follow the directions displayed to download the key.
*Reboot the XO and tap the "Esc" key to interrupt the booting procedure. At the ok prompt type: <pre>ok disable-security</pre>
**The machine will probably reboot. If so, tap the "Esc" key and type the above command again. It may reboot one final time.
**Upon this reboot tap the "Esc" key again and type the above command a final time. It should print out:
<pre>
ok disable-security
No wp tag
</pre>

====Booting the XO from the SD====
More than likely, this will not work right away, my implementation required some tweaking prior to fully booting.
*With the SD card inserted in the XO, turn the machine on and press the "Esc" key to interrupt start-up.
*At the prompt type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>
*It should attempt the boot sequence, but more than likely will fail with a Kernel Panic!!!....error
*This is almost expected, but it's actually an important step. If you look further up on the screen, you should see an error in regards to mounting the file system.
*Around this area, you should also see a list of strange numbers (i.e. b102:) followed by devices (i.e. ramdisk...)
*Find the row for your SD card, it should be labeled something like:
<pre>
b301: mmcblk0p1
</pre>
*Remember the b301 number.
*Connect the SD card back to the Linux PC.
*Open the file /boot/olpc.fth
**Here's a quick resource on what this is [http://wiki.laptop.org/go/SD_Boot_olpc.fth SD Booting].
*You'll see a line like this:
<pre>
" ro root=mmcblk0p1 rootdelay=1 console=ttyS0,115200 console=tty0
rootfstype=ext2 fbcon=font:SUN12x22" to boot-file
</pre>
*Change the "root=******" to be the variable recorded earlier.
*Save the changes and put the SD card back in the XO. Reboot the machine and at the prompt again type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>

==Documentation & Resources==

'''Post XS School Server Installation Configuration:'''
<pre>
yum groupinstall "GNOME Desktop Environment"

edit /etc/inittab and change runlevel from 3 to 5 to startup in Gnome

yum install mysql-server php php-mysql php-mbstring php-gd php-xmlrpc php-imap cvs

service mysqld start
mysqladmin -u root password 'mySecurePassword'
mysql -u root -p
mysql> CREATE DATABASE moodle CHARSET 'utf8';
mysql> exit;
chkconfig mysqld on
--starts sql server; adds root admin user; logs into server and creates DB;
--turns the service on on boot.

cd /var/www
cvs -z3 -d:pserver:anonymous@eu.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle
--download and install/update with the latest version of moodle

mkdir moodledata
chown -R apache:apache moodle
chown -R apache:apache moodledata
--make directory in /var/www/ and change permissions.

edit the file /etc/httpd/conf/httpd.conf
change DocumentRoot "/var/www/html" to DocumentRoot "/var/www/moodle"
change <Directory "/var/www/html"> to <Directory "/var/www/moodle">
then you must restart the apache server by issuing the command:
service httpd restart

</pre>

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

'''Starting MySQL Database:''' 
[[image:ScreenStartingMysql.png]]

'''Logging in to MySQL Database:''' 
[[image:ScreenLoginSqlServ.png]]

'''Creating Database:''' 
[[image:ScreenCreateDB.png]]

== Code ==

Code can be downloaded [http://www.filedropper.com/parser here]

<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

==After Class Plans==

Wesley Dillingham will continue this project into the summer as part of RIT's cooperative education program.

Jeremiah Green will continue working on this project when time is available to devote.

Teacher Reporting

2009-05-18T16:58:45Z

Jrgreen118: /* Setting Up the Environment */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

=====Un-compress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*Un-compress the file
**In Windows, [http://www.rarlab.com/download.htm WinRAR] worked well.
**In Linux, this command works just as well<pre>gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz</pre>

=====Setting Up the Environment=====
With the SD card connected to the Linux PC:
*Using a tool of your choice format the SD card to ext2 or ext3 (Linux 83).
**Gparted was excellent for formating the SD card to ext3, but fdisk would also work.
*Mark the partition with the boot flag
**This can be done using gparted, but in several instances errors were experienced. In lieu fdisk works great.
**To enter fdisk, use
<pre>
fdisk /dev/sd*1
or
fdisk /dev/mmcblk*p1
</pre>
***where * is the letter associated with the SD device and the 1 is the partition. Once in fdisk, use the help to determine the specific command to mark the boot flag. In most instances it will be "a".
*Next ensure the .img file uncompressed previously is accessible by the Linux machines. I used another flash drive.
*Use the command <pre>dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/sd*1</pre>
**This will take some time depending on the system performance.
*Use resize2fs to re-size the partition <pre>resize2fs -p /dev/sd*1</pre>

=====Getting a Developer Key=====
*First the XO must have a [http://wiki.laptop.org/go/Activation_and_Developer_Keys developer's key!!!]
*The easiest way to go about obtaining this is to boot into the XO's Sugar OS. Open the browse application. Near the bottom right of the home page, there will be a like for "Get a Developer Key".
**Click this link and on the next page click the "Submit Query." Go through this process again after 24 hours and the key should be available.
**Upon return follow the directions displayed to download the key.
*Reboot the XO and tap the "Esc" key to interrupt the booting procedure. At the ok prompt type: <pre>ok disable-security</pre>
**The machine will probably reboot. If so, tap the "Esc" key and type the above command again. It may reboot one final time.
**Upon this reboot tap the "Esc" key again and type the above command a final time. It should print out:
<pre>
ok disable-security
No wp tag
</pre>

====Booting the XO from the SD====
More than likely, this will not work right away, my implementation required some tweaking prior to fully booting.
*With the SD card inserted in the XO, turn the machine on and press the "Esc" key to interrupt start-up.
*At the prompt type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>
*It should attempt the boot sequence, but more than likely will fail with a Kernel Panic!!!....error
*This is almost expected, but it's actually an important step. If you look further up on the screen, you should see an error in regards to mounting the file system.
*Around this area, you should also see a list of strange numbers (i.e. b102:) followed by devices (i.e. ramdisk...)
*Find the row for your SD card, it should be labeled something like:
<pre>
b301: mmcblk0p1
</pre>
*Remember the b301 number.
*Connect the SD card back to the Linux PC.
*Open the file /boot/olpc.fth
**Here's a quick resource on what this is [http://wiki.laptop.org/go/SD_Boot_olpc.fth SD Booting].
*You'll see a line like this:
<pre>
" ro root=mmcblk0p1 rootdelay=1 console=ttyS0,115200 console=tty0
rootfstype=ext2 fbcon=font:SUN12x22" to boot-file
</pre>
*Change the "root=******" to be the variable recorded earlier.
*Save the changes and put the SD card back in the XO. Reboot the machine and at the prompt again type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>

==Documentation & Resources==

'''Post XS School Server Installation Configuration:'''
<pre>
yum groupinstall "GNOME Desktop Environment"

edit /etc/inittab and change runlevel from 3 to 5 to startup in Gnome

yum install mysql-server php php-mysql php-mbstring php-gd php-xmlrpc php-imap cvs

service mysqld start
mysqladmin -u root password 'mySecurePassword'
mysql -u root -p
mysql> CREATE DATABASE moodle CHARSET 'utf8';
mysql> exit;
chkconfig mysqld on
--starts sql server; adds root admin user; logs into server and creates DB;
--turns the service on on boot.

cd /var/www
cvs -z3 -d:pserver:anonymous@eu.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle
--download and install/update with the latest version of moodle

mkdir moodledata
chown -R apache:apache moodle
chown -R apache:apache moodledata
--make directory in /var/www/ and change permissions.

edit the file /etc/httpd/conf/httpd.conf
change DocumentRoot "/var/www/html" to DocumentRoot "/var/www/moodle"
change <Directory "/var/www/html"> to <Directory "/var/www/moodle">
then you must restart the apache server by issuing the command:
service httpd restart

</pre>

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

'''Starting MySQL Database:''' 
[[image:ScreenStartingMysql.png]]

'''Logging in to MySQL Database:''' 
[[image:ScreenLoginSqlServ.png]]

'''Creating Database:''' 
[[image:ScreenCreateDB.png]]

== Code ==

Code can be downloaded [http://www.filedropper.com/parser here]

<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

==After Class Plans==

Wesley Dillingham will continue this project into the summer as part of RIT's cooperative education program.

Jeremiah Green will continue working on this project when time is available to devote.

Teacher Reporting

2009-05-18T16:55:59Z

Jrgreen118: /* Un-compress the image: */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

=====Un-compress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*Un-compress the file
**In Windows, [http://www.rarlab.com/download.htm WinRAR] worked well.
**In Linux, this command works just as well<pre>gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz</pre>

=====Setting Up the Environment=====
With the SD card connected to the Linux PC:
*Using a tool of your choice format the SD card to ext2 or ext3 (Linux 83).
**I used gparted and formated the SD card to ext3, but fdisk would also work.
*Mark the partition with the boot flag
**This can be done using gparted, but mine had issues applying the changes. I used fdisk.
**To enter fdisk, use <pre>fdisk /dev/sd*1</pre>
***where * is the letter associated with the SD device and the 1 is the partition. Once in fdisk, use the help to determine the specific command to mark the boot flag. For me it was "a".
*Next ensure the .img file uncompressed previously is accessible by the Linux machines. I used another flash drive.
*Use the command <pre>dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/sd*1</pre>
**This will take some time depending on the system performance.
*Use resize2fs to re-size the partition <pre>resize2fs -p /dev/sd*1</pre>

=====Getting a Developer Key=====
*First the XO must have a [http://wiki.laptop.org/go/Activation_and_Developer_Keys developer's key!!!]
*The easiest way to go about obtaining this is to boot into the XO's Sugar OS. Open the browse application. Near the bottom right of the home page, there will be a like for "Get a Developer Key".
**Click this link and on the next page click the "Submit Query." Go through this process again after 24 hours and the key should be available.
**Upon return follow the directions displayed to download the key.
*Reboot the XO and tap the "Esc" key to interrupt the booting procedure. At the ok prompt type: <pre>ok disable-security</pre>
**The machine will probably reboot. If so, tap the "Esc" key and type the above command again. It may reboot one final time.
**Upon this reboot tap the "Esc" key again and type the above command a final time. It should print out:
<pre>
ok disable-security
No wp tag
</pre>

====Booting the XO from the SD====
More than likely, this will not work right away, my implementation required some tweaking prior to fully booting.
*With the SD card inserted in the XO, turn the machine on and press the "Esc" key to interrupt start-up.
*At the prompt type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>
*It should attempt the boot sequence, but more than likely will fail with a Kernel Panic!!!....error
*This is almost expected, but it's actually an important step. If you look further up on the screen, you should see an error in regards to mounting the file system.
*Around this area, you should also see a list of strange numbers (i.e. b102:) followed by devices (i.e. ramdisk...)
*Find the row for your SD card, it should be labeled something like:
<pre>
b301: mmcblk0p1
</pre>
*Remember the b301 number.
*Connect the SD card back to the Linux PC.
*Open the file /boot/olpc.fth
**Here's a quick resource on what this is [http://wiki.laptop.org/go/SD_Boot_olpc.fth SD Booting].
*You'll see a line like this:
<pre>
" ro root=mmcblk0p1 rootdelay=1 console=ttyS0,115200 console=tty0
rootfstype=ext2 fbcon=font:SUN12x22" to boot-file
</pre>
*Change the "root=******" to be the variable recorded earlier.
*Save the changes and put the SD card back in the XO. Reboot the machine and at the prompt again type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>

==Documentation & Resources==

'''Post XS School Server Installation Configuration:'''
<pre>
yum groupinstall "GNOME Desktop Environment"

edit /etc/inittab and change runlevel from 3 to 5 to startup in Gnome

yum install mysql-server php php-mysql php-mbstring php-gd php-xmlrpc php-imap cvs

service mysqld start
mysqladmin -u root password 'mySecurePassword'
mysql -u root -p
mysql> CREATE DATABASE moodle CHARSET 'utf8';
mysql> exit;
chkconfig mysqld on
--starts sql server; adds root admin user; logs into server and creates DB;
--turns the service on on boot.

cd /var/www
cvs -z3 -d:pserver:anonymous@eu.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle
--download and install/update with the latest version of moodle

mkdir moodledata
chown -R apache:apache moodle
chown -R apache:apache moodledata
--make directory in /var/www/ and change permissions.

edit the file /etc/httpd/conf/httpd.conf
change DocumentRoot "/var/www/html" to DocumentRoot "/var/www/moodle"
change <Directory "/var/www/html"> to <Directory "/var/www/moodle">
then you must restart the apache server by issuing the command:
service httpd restart

</pre>

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

'''Starting MySQL Database:''' 
[[image:ScreenStartingMysql.png]]

'''Logging in to MySQL Database:''' 
[[image:ScreenLoginSqlServ.png]]

'''Creating Database:''' 
[[image:ScreenCreateDB.png]]

== Code ==

Code can be downloaded [http://www.filedropper.com/parser here]

<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

==After Class Plans==

Wesley Dillingham will continue this project into the summer as part of RIT's cooperative education program.

Jeremiah Green will continue working on this project when time is available to devote.

Teacher Reporting

2009-05-18T16:55:38Z

Jrgreen118: /* Un-compress the image: */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

=====Un-compress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*Un-compress the file
**In Windows, [http://www.rarlab.com/download.htm WinRAR] worked well.
**In Linux, this command works just as well<pre>gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz"</pre>

=====Setting Up the Environment=====
With the SD card connected to the Linux PC:
*Using a tool of your choice format the SD card to ext2 or ext3 (Linux 83).
**I used gparted and formated the SD card to ext3, but fdisk would also work.
*Mark the partition with the boot flag
**This can be done using gparted, but mine had issues applying the changes. I used fdisk.
**To enter fdisk, use <pre>fdisk /dev/sd*1</pre>
***where * is the letter associated with the SD device and the 1 is the partition. Once in fdisk, use the help to determine the specific command to mark the boot flag. For me it was "a".
*Next ensure the .img file uncompressed previously is accessible by the Linux machines. I used another flash drive.
*Use the command <pre>dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/sd*1</pre>
**This will take some time depending on the system performance.
*Use resize2fs to re-size the partition <pre>resize2fs -p /dev/sd*1</pre>

=====Getting a Developer Key=====
*First the XO must have a [http://wiki.laptop.org/go/Activation_and_Developer_Keys developer's key!!!]
*The easiest way to go about obtaining this is to boot into the XO's Sugar OS. Open the browse application. Near the bottom right of the home page, there will be a like for "Get a Developer Key".
**Click this link and on the next page click the "Submit Query." Go through this process again after 24 hours and the key should be available.
**Upon return follow the directions displayed to download the key.
*Reboot the XO and tap the "Esc" key to interrupt the booting procedure. At the ok prompt type: <pre>ok disable-security</pre>
**The machine will probably reboot. If so, tap the "Esc" key and type the above command again. It may reboot one final time.
**Upon this reboot tap the "Esc" key again and type the above command a final time. It should print out:
<pre>
ok disable-security
No wp tag
</pre>

====Booting the XO from the SD====
More than likely, this will not work right away, my implementation required some tweaking prior to fully booting.
*With the SD card inserted in the XO, turn the machine on and press the "Esc" key to interrupt start-up.
*At the prompt type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>
*It should attempt the boot sequence, but more than likely will fail with a Kernel Panic!!!....error
*This is almost expected, but it's actually an important step. If you look further up on the screen, you should see an error in regards to mounting the file system.
*Around this area, you should also see a list of strange numbers (i.e. b102:) followed by devices (i.e. ramdisk...)
*Find the row for your SD card, it should be labeled something like:
<pre>
b301: mmcblk0p1
</pre>
*Remember the b301 number.
*Connect the SD card back to the Linux PC.
*Open the file /boot/olpc.fth
**Here's a quick resource on what this is [http://wiki.laptop.org/go/SD_Boot_olpc.fth SD Booting].
*You'll see a line like this:
<pre>
" ro root=mmcblk0p1 rootdelay=1 console=ttyS0,115200 console=tty0
rootfstype=ext2 fbcon=font:SUN12x22" to boot-file
</pre>
*Change the "root=******" to be the variable recorded earlier.
*Save the changes and put the SD card back in the XO. Reboot the machine and at the prompt again type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>

==Documentation & Resources==

'''Post XS School Server Installation Configuration:'''
<pre>
yum groupinstall "GNOME Desktop Environment"

edit /etc/inittab and change runlevel from 3 to 5 to startup in Gnome

yum install mysql-server php php-mysql php-mbstring php-gd php-xmlrpc php-imap cvs

service mysqld start
mysqladmin -u root password 'mySecurePassword'
mysql -u root -p
mysql> CREATE DATABASE moodle CHARSET 'utf8';
mysql> exit;
chkconfig mysqld on
--starts sql server; adds root admin user; logs into server and creates DB;
--turns the service on on boot.

cd /var/www
cvs -z3 -d:pserver:anonymous@eu.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle
--download and install/update with the latest version of moodle

mkdir moodledata
chown -R apache:apache moodle
chown -R apache:apache moodledata
--make directory in /var/www/ and change permissions.

edit the file /etc/httpd/conf/httpd.conf
change DocumentRoot "/var/www/html" to DocumentRoot "/var/www/moodle"
change <Directory "/var/www/html"> to <Directory "/var/www/moodle">
then you must restart the apache server by issuing the command:
service httpd restart

</pre>

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

'''Starting MySQL Database:''' 
[[image:ScreenStartingMysql.png]]

'''Logging in to MySQL Database:''' 
[[image:ScreenLoginSqlServ.png]]

'''Creating Database:''' 
[[image:ScreenCreateDB.png]]

== Code ==

Code can be downloaded [http://www.filedropper.com/parser here]

<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

==After Class Plans==

Wesley Dillingham will continue this project into the summer as part of RIT's cooperative education program.

Jeremiah Green will continue working on this project when time is available to devote.

Teacher Reporting

2009-05-18T16:51:31Z

Jrgreen118: /* Booting the XO from the SD */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

=====Un-compress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*Un-compress the file
**In Windows, [http://www.rarlab.com/download.htm WinRAR] worked for me.
**In Linux, this command works just as well<pre>gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz"</pre>

=====Setting Up the Environment=====
With the SD card connected to the Linux PC:
*Using a tool of your choice format the SD card to ext2 or ext3 (Linux 83).
**I used gparted and formated the SD card to ext3, but fdisk would also work.
*Mark the partition with the boot flag
**This can be done using gparted, but mine had issues applying the changes. I used fdisk.
**To enter fdisk, use <pre>fdisk /dev/sd*1</pre>
***where * is the letter associated with the SD device and the 1 is the partition. Once in fdisk, use the help to determine the specific command to mark the boot flag. For me it was "a".
*Next ensure the .img file uncompressed previously is accessible by the Linux machines. I used another flash drive.
*Use the command <pre>dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/sd*1</pre>
**This will take some time depending on the system performance.
*Use resize2fs to re-size the partition <pre>resize2fs -p /dev/sd*1</pre>

=====Getting a Developer Key=====
*First the XO must have a [http://wiki.laptop.org/go/Activation_and_Developer_Keys developer's key!!!]
*The easiest way to go about obtaining this is to boot into the XO's Sugar OS. Open the browse application. Near the bottom right of the home page, there will be a like for "Get a Developer Key".
**Click this link and on the next page click the "Submit Query." Go through this process again after 24 hours and the key should be available.
**Upon return follow the directions displayed to download the key.
*Reboot the XO and tap the "Esc" key to interrupt the booting procedure. At the ok prompt type: <pre>ok disable-security</pre>
**The machine will probably reboot. If so, tap the "Esc" key and type the above command again. It may reboot one final time.
**Upon this reboot tap the "Esc" key again and type the above command a final time. It should print out:
<pre>
ok disable-security
No wp tag
</pre>

====Booting the XO from the SD====
More than likely, this will not work right away, my implementation required some tweaking prior to fully booting.
*With the SD card inserted in the XO, turn the machine on and press the "Esc" key to interrupt start-up.
*At the prompt type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>
*It should attempt the boot sequence, but more than likely will fail with a Kernel Panic!!!....error
*This is almost expected, but it's actually an important step. If you look further up on the screen, you should see an error in regards to mounting the file system.
*Around this area, you should also see a list of strange numbers (i.e. b102:) followed by devices (i.e. ramdisk...)
*Find the row for your SD card, it should be labeled something like:
<pre>
b301: mmcblk0p1
</pre>
*Remember the b301 number.
*Connect the SD card back to the Linux PC.
*Open the file /boot/olpc.fth
**Here's a quick resource on what this is [http://wiki.laptop.org/go/SD_Boot_olpc.fth SD Booting].
*You'll see a line like this:
<pre>
" ro root=mmcblk0p1 rootdelay=1 console=ttyS0,115200 console=tty0
rootfstype=ext2 fbcon=font:SUN12x22" to boot-file
</pre>
*Change the "root=******" to be the variable recorded earlier.
*Save the changes and put the SD card back in the XO. Reboot the machine and at the prompt again type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>

==Documentation & Resources==

'''Post XS School Server Installation Configuration:'''
<pre>
yum groupinstall "GNOME Desktop Environment"

edit /etc/inittab and change runlevel from 3 to 5 to startup in Gnome

yum install mysql-server php php-mysql php-mbstring php-gd php-xmlrpc php-imap cvs

service mysqld start
mysqladmin -u root password 'mySecurePassword'
mysql -u root -p
mysql> CREATE DATABASE moodle CHARSET 'utf8';
mysql> exit;
chkconfig mysqld on
--starts sql server; adds root admin user; logs into server and creates DB;
--turns the service on on boot.

cd /var/www
cvs -z3 -d:pserver:anonymous@eu.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle
--download and install/update with the latest version of moodle

mkdir moodledata
chown -R apache:apache moodle
chown -R apache:apache moodledata
--make directory in /var/www/ and change permissions.

edit the file /etc/httpd/conf/httpd.conf
change DocumentRoot "/var/www/html" to DocumentRoot "/var/www/moodle"
change <Directory "/var/www/html"> to <Directory "/var/www/moodle">
then you must restart the apache server by issuing the command:
service httpd restart

</pre>

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

'''Starting MySQL Database:''' 
[[image:ScreenStartingMysql.png]]

'''Logging in to MySQL Database:''' 
[[image:ScreenLoginSqlServ.png]]

'''Creating Database:''' 
[[image:ScreenCreateDB.png]]

== Code ==

Code can be downloaded [http://www.filedropper.com/parser here]

<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

==After Class Plans==

Wesley Dillingham will continue this project into the summer as part of RIT's cooperative education program.

Jeremiah Green will continue working on this project when time is available to devote.

Teacher Reporting

2009-05-18T16:49:15Z

Jrgreen118: /* Booting the XO from the SD */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

=====Un-compress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*Un-compress the file
**In Windows, [http://www.rarlab.com/download.htm WinRAR] worked for me.
**In Linux, this command works just as well<pre>gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz"</pre>

=====Setting Up the Environment=====
With the SD card connected to the Linux PC:
*Using a tool of your choice format the SD card to ext2 or ext3 (Linux 83).
**I used gparted and formated the SD card to ext3, but fdisk would also work.
*Mark the partition with the boot flag
**This can be done using gparted, but mine had issues applying the changes. I used fdisk.
**To enter fdisk, use <pre>fdisk /dev/sd*1</pre>
***where * is the letter associated with the SD device and the 1 is the partition. Once in fdisk, use the help to determine the specific command to mark the boot flag. For me it was "a".
*Next ensure the .img file uncompressed previously is accessible by the Linux machines. I used another flash drive.
*Use the command <pre>dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/sd*1</pre>
**This will take some time depending on the system performance.
*Use resize2fs to re-size the partition <pre>resize2fs -p /dev/sd*1</pre>

=====Getting a Developer Key=====
*First the XO must have a [http://wiki.laptop.org/go/Activation_and_Developer_Keys developer's key!!!]
*The easiest way to go about obtaining this is to boot into the XO's Sugar OS. Open the browse application. Near the bottom right of the home page, there will be a like for "Get a Developer Key".
**Click this link and on the next page click the "Submit Query." Go through this process again after 24 hours and the key should be available.
**Upon return follow the directions displayed to download the key.
*Reboot the XO and tap the "Esc" key to interrupt the booting procedure. At the ok prompt type: <pre>ok disable-security</pre>
**The machine will probably reboot. If so, tap the "Esc" key and type the above command again. It may reboot one final time.
**Upon this reboot tap the "Esc" key again and type the above command a final time. It should print out:
<pre>
ok disable-security
No wp tag
</pre>

====Booting the XO from the SD====
More than likely, this will not work right away, my implementation required some tweaking prior to fully booting.
*With the SD card inserted in the XO, turn the machine on and press the "Esc" key to interrupt start-up.
*At the prompt type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>
*It should attempt the boot sequence, but more than likely will fail with a Kernel Panic!!!....error
*This is almost expected, but it's actually an important step. If you look further up on the screen, you should see an error in regards to mounting the file system.
*Around this area, you should also see a list of strange numbers (i.e. b102:) followed by devices (i.e. ramdisk...)
*Find the row for your SD card, it should be labeled something like:
<pre>
b301: mmcblk0p1
</pre>
*Remember the b301 number.
*Connect the SD card back to the Linux PC.
*Open the file /boot/olpc.fth
*You'll see a line like this:
<pre>
" ro root=mmcblk0p1 rootdelay=1 console=ttyS0,115200 console=tty0
rootfstype=ext2 fbcon=font:SUN12x22" to boot-file
</pre>
*Change the "root=******" to be the variable recorded earlier.
*Save the changes and put the SD card back in the XO. Reboot the machine and at the prompt again type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>

==Documentation & Resources==

'''Post XS School Server Installation Configuration:'''
<pre>
yum groupinstall "GNOME Desktop Environment"

edit /etc/inittab and change runlevel from 3 to 5 to startup in Gnome

yum install mysql-server php php-mysql php-mbstring php-gd php-xmlrpc php-imap cvs

service mysqld start
mysqladmin -u root password 'mySecurePassword'
mysql -u root -p
mysql> CREATE DATABASE moodle CHARSET 'utf8';
mysql> exit;
chkconfig mysqld on
--starts sql server; adds root admin user; logs into server and creates DB;
--turns the service on on boot.

cd /var/www
cvs -z3 -d:pserver:anonymous@eu.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle
--download and install/update with the latest version of moodle

mkdir moodledata
chown -R apache:apache moodle
chown -R apache:apache moodledata
--make directory in /var/www/ and change permissions.

edit the file /etc/httpd/conf/httpd.conf
change DocumentRoot "/var/www/html" to DocumentRoot "/var/www/moodle"
change <Directory "/var/www/html"> to <Directory "/var/www/moodle">
then you must restart the apache server by issuing the command:
service httpd restart

</pre>

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

'''Starting MySQL Database:''' 
[[image:ScreenStartingMysql.png]]

'''Logging in to MySQL Database:''' 
[[image:ScreenLoginSqlServ.png]]

'''Creating Database:''' 
[[image:ScreenCreateDB.png]]

== Code ==

Code can be downloaded [http://www.filedropper.com/parser here]

<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

==After Class Plans==

Wesley Dillingham will continue this project into the summer as part of RIT's cooperative education program.

Jeremiah Green will continue working on this project when time is available to devote.

Teacher Reporting

2009-05-18T16:47:24Z

Jrgreen118: /* Booting the XO from the SD */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

=====Un-compress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*Un-compress the file
**In Windows, [http://www.rarlab.com/download.htm WinRAR] worked for me.
**In Linux, this command works just as well<pre>gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz"</pre>

=====Setting Up the Environment=====
With the SD card connected to the Linux PC:
*Using a tool of your choice format the SD card to ext2 or ext3 (Linux 83).
**I used gparted and formated the SD card to ext3, but fdisk would also work.
*Mark the partition with the boot flag
**This can be done using gparted, but mine had issues applying the changes. I used fdisk.
**To enter fdisk, use <pre>fdisk /dev/sd*1</pre>
***where * is the letter associated with the SD device and the 1 is the partition. Once in fdisk, use the help to determine the specific command to mark the boot flag. For me it was "a".
*Next ensure the .img file uncompressed previously is accessible by the Linux machines. I used another flash drive.
*Use the command <pre>dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/sd*1</pre>
**This will take some time depending on the system performance.
*Use resize2fs to re-size the partition <pre>resize2fs -p /dev/sd*1</pre>

=====Getting a Developer Key=====
*First the XO must have a [http://wiki.laptop.org/go/Activation_and_Developer_Keys developer's key!!!]
*The easiest way to go about obtaining this is to boot into the XO's Sugar OS. Open the browse application. Near the bottom right of the home page, there will be a like for "Get a Developer Key".
**Click this link and on the next page click the "Submit Query." Go through this process again after 24 hours and the key should be available.
**Upon return follow the directions displayed to download the key.
*Reboot the XO and tap the "Esc" key to interrupt the booting procedure. At the ok prompt type: <pre>ok disable-security</pre>
**The machine will probably reboot. If so, tap the "Esc" key and type the above command again. It may reboot one final time.
**Upon this reboot tap the "Esc" key again and type the above command a final time. It should print out:
<pre>
ok disable-security
No wp tag
</pre>

====Booting the XO from the SD====
More than likely, this will not work right away, my implementation required some tweaking prior to fully booting.
*With the SD card inserted in the XO, turn the machine on and press the "Esc" key to interrupt start-up.
*At the prompt type:
<pre>
ok boot sd:\boot\olpc.fth
</pre>
*It should attempt the boot sequence, but more than likely will fail with a Kernel Panic!!!....error
*This is almost expected, but it's actually an important step. If you look further up on the screen, you should see an error in regards to mounting the file system.
*Around this area, you should also see a list of strange numbers (i.e. b102:) followed by devices (i.e. ramdisk...)
*Find the row for your SD card, it should be labeled something like:
<pre>
b301: mmcblk0p1
</pre>
*Remember the b301 number.
*Connect the SD card back to the Linux PC.
*Open the file /boot/olpc.fth
*You'll see a line like this:
<pre>
" ro root=mmcblk0p1 rootdelay=1 console=ttyS0,115200 console=tty0
rootfstype=ext2 fbcon=font:SUN12x22" to boot-file
</pre>
*Change the "root=******" to be the variable recorded earlier.

==Documentation & Resources==

'''Post XS School Server Installation Configuration:'''
<pre>
yum groupinstall "GNOME Desktop Environment"

edit /etc/inittab and change runlevel from 3 to 5 to startup in Gnome

yum install mysql-server php php-mysql php-mbstring php-gd php-xmlrpc php-imap cvs

service mysqld start
mysqladmin -u root password 'mySecurePassword'
mysql -u root -p
mysql> CREATE DATABASE moodle CHARSET 'utf8';
mysql> exit;
chkconfig mysqld on
--starts sql server; adds root admin user; logs into server and creates DB;
--turns the service on on boot.

cd /var/www
cvs -z3 -d:pserver:anonymous@eu.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle
--download and install/update with the latest version of moodle

mkdir moodledata
chown -R apache:apache moodle
chown -R apache:apache moodledata
--make directory in /var/www/ and change permissions.

edit the file /etc/httpd/conf/httpd.conf
change DocumentRoot "/var/www/html" to DocumentRoot "/var/www/moodle"
change <Directory "/var/www/html"> to <Directory "/var/www/moodle">
then you must restart the apache server by issuing the command:
service httpd restart

</pre>

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

'''Starting MySQL Database:''' 
[[image:ScreenStartingMysql.png]]

'''Logging in to MySQL Database:''' 
[[image:ScreenLoginSqlServ.png]]

'''Creating Database:''' 
[[image:ScreenCreateDB.png]]

== Code ==

Code can be downloaded [http://www.filedropper.com/parser here]

<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

==After Class Plans==

Wesley Dillingham will continue this project into the summer as part of RIT's cooperative education program.

Jeremiah Green will continue working on this project when time is available to devote.

Teacher Reporting

2009-05-18T16:26:03Z

Jrgreen118: /* XS SchoolServer on the XO */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

=====Un-compress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*Un-compress the file
**In Windows, [http://www.rarlab.com/download.htm WinRAR] worked for me.
**In Linux, this command works just as well<pre>gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz"</pre>

=====Setting Up the Environment=====
With the SD card connected to the Linux PC:
*Using a tool of your choice format the SD card to ext2 or ext3 (Linux 83).
**I used gparted and formated the SD card to ext3, but fdisk would also work.
*Mark the partition with the boot flag
**This can be done using gparted, but mine had issues applying the changes. I used fdisk.
**To enter fdisk, use <pre>fdisk /dev/sd*1</pre>
***where * is the letter associated with the SD device and the 1 is the partition. Once in fdisk, use the help to determine the specific command to mark the boot flag. For me it was "a".
*Next ensure the .img file uncompressed previously is accessible by the Linux machines. I used another flash drive.
*Use the command <pre>dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/sd*1</pre>
**This will take some time depending on the system performance.
*Use resize2fs to re-size the partition <pre>resize2fs -p /dev/sd*1</pre>

=====Getting a Developer Key=====
*First the XO must have a [http://wiki.laptop.org/go/Activation_and_Developer_Keys developer's key!!!]
*The easiest way to go about obtaining this is to boot into the XO's Sugar OS. Open the browse application. Near the bottom right of the home page, there will be a like for "Get a Developer Key".
**Click this link and on the next page click the "Submit Query." Go through this process again after 24 hours and the key should be available.
**Upon return follow the directions displayed to download the key.
*Reboot the XO and tap the "Esc" key to interrupt the booting procedure. At the ok prompt type: <pre>ok disable-security</pre>
**The machine will probably reboot. If so, tap the "Esc" key and type the above command again. It may reboot one final time.
**Upon this reboot tap the "Esc" key again and type the above command a final time. It should print out:
<pre>
ok disable-security
No wp tag
</pre>

====Booting the XO from the SD====
More than likely, this will not work right away, my implementation required some tweaking prior to fully booting.

==Documentation & Resources==

'''Post XS School Server Installation Configuration:'''
<pre>
yum groupinstall "GNOME Desktop Environment"

edit /etc/inittab and change runlevel from 3 to 5 to startup in Gnome

yum install mysql-server php php-mysql php-mbstring php-gd php-xmlrpc php-imap cvs

service mysqld start
mysqladmin -u root password 'mySecurePassword'
mysql -u root -p
mysql> CREATE DATABASE moodle CHARSET 'utf8';
mysql> exit;
chkconfig mysqld on
--starts sql server; adds root admin user; logs into server and creates DB;
--turns the service on on boot.

cd /var/www
cvs -z3 -d:pserver:anonymous@eu.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle
--download and install/update with the latest version of moodle

mkdir moodledata
chown -R apache:apache moodle
chown -R apache:apache moodledata
--make directory in /var/www/ and change permissions.

edit the file /etc/httpd/conf/httpd.conf
change DocumentRoot "/var/www/html" to DocumentRoot "/var/www/moodle"
change <Directory "/var/www/html"> to <Directory "/var/www/moodle">
then you must restart the apache server by issuing the command:
service httpd restart

</pre>

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

'''Starting MySQL Database:''' 
[[image:ScreenStartingMysql.png]]

'''Logging in to MySQL Database:''' 
[[image:ScreenLoginSqlServ.png]]

'''Creating Database:''' 
[[image:ScreenCreateDB.png]]

== Code ==

Code can be downloaded [http://www.filedropper.com/parser here]

<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

==After Class Plans==

Wesley Dillingham will continue this project into the summer as part of RIT's cooperative education program.

Jeremiah Green will continue working on this project when time is available to devote.

Teacher Reporting

2009-05-18T16:24:31Z

Jrgreen118: /* Booting the XO from the SD */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==After Class Plans==

Wesley Dillingham will continue this project into the summer as part of RIT's cooperative education program.

Jeremiah Green will continue working on this project when time is available to devote.

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

=====Un-compress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*Un-compress the file
**In Windows, [http://www.rarlab.com/download.htm WinRAR] worked for me.
**In Linux, this command works just as well<pre>gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz"</pre>

=====Setting Up the Environment=====
With the SD card connected to the Linux PC:
*Using a tool of your choice format the SD card to ext2 or ext3 (Linux 83).
**I used gparted and formated the SD card to ext3, but fdisk would also work.
*Mark the partition with the boot flag
**This can be done using gparted, but mine had issues applying the changes. I used fdisk.
**To enter fdisk, use <pre>fdisk /dev/sd*1</pre>
***where * is the letter associated with the SD device and the 1 is the partition. Once in fdisk, use the help to determine the specific command to mark the boot flag. For me it was "a".
*Next ensure the .img file uncompressed previously is accessible by the Linux machines. I used another flash drive.
*Use the command <pre>dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/sd*1</pre>
**This will take some time depending on the system performance.
*Use resize2fs to re-size the partition <pre>resize2fs -p /dev/sd*1</pre>

=====Getting a Developer Key=====
More than likely, this will not work right away, my implementation required some tweaking prior to fully booting.
*First the XO must have a [http://wiki.laptop.org/go/Activation_and_Developer_Keys developer's key!!!]
*The easiest way to go about obtaining this is to boot into the XO's Sugar OS. Open the browse application. Near the bottom right of the home page, there will be a like for "Get a Developer Key".
**Click this link and on the next page click the "Submit Query." Go through this process again after 24 hours and the key should be available.
**Upon return follow the directions displayed to download the key.
*Reboot the XO and tap the "Esc" key to interrupt the booting procedure. At the ok prompt type: <pre>ok disable-security</pre>
**The machine will probably reboot. If so, tap the "Esc" key and type the above command again. It may reboot one final time.
**Upon this reboot tap the "Esc" key again and type the above command a final time. It should print out:
<pre>
ok disable-security
No wp tag
</pre>

==Documentation & Resources==

'''Post XS School Server Installation Configuration:'''
<pre>
yum groupinstall "GNOME Desktop Environment"

edit /etc/inittab and change runlevel from 3 to 5 to startup in Gnome

yum install mysql-server php php-mysql php-mbstring php-gd php-xmlrpc php-imap cvs

service mysqld start
mysqladmin -u root password 'mySecurePassword'
mysql -u root -p
mysql> CREATE DATABASE moodle CHARSET 'utf8';
mysql> exit;
chkconfig mysqld on
--starts sql server; adds root admin user; logs into server and creates DB;
--turns the service on on boot.

cd /var/www
cvs -z3 -d:pserver:anonymous@eu.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle
--download and install/update with the latest version of moodle

mkdir moodledata
chown -R apache:apache moodle
chown -R apache:apache moodledata
--make directory in /var/www/ and change permissions.

edit the file /etc/httpd/conf/httpd.conf
change DocumentRoot "/var/www/html" to DocumentRoot "/var/www/moodle"
change <Directory "/var/www/html"> to <Directory "/var/www/moodle">
then you must restart the apache server by issuing the command:
service httpd restart

</pre>

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

'''Starting MySQL Database:''' 
[[image:ScreenStartingMysql.png]]

'''Logging in to MySQL Database:''' 
[[image:ScreenLoginSqlServ.png]]

'''Creating Database:''' 
[[image:ScreenCreateDB.png]]

== Code ==

Code can be downloaded [http://www.filedropper.com/parser here]

<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

Teacher Reporting

2009-05-18T16:06:23Z

Jrgreen118: /* How To: */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==After Class Plans==

Wesley Dillingham will continue this project into the summer as part of RIT's cooperative education program.

Jeremiah Green will continue working on this project when time is available to devote.

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

=====Un-compress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*Un-compress the file
**In Windows, [http://www.rarlab.com/download.htm WinRAR] worked for me.
**In Linux, this command works just as well<pre>gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz"</pre>

=====Setting Up the Environment=====
With the SD card connected to the Linux PC:
*Using a tool of your choice format the SD card to ext2 or ext3 (Linux 83).
**I used gparted and formated the SD card to ext3, but fdisk would also work.
*Mark the partition with the boot flag
**This can be done using gparted, but mine had issues applying the changes. I used fdisk.
**To enter fdisk, use <pre>fdisk /dev/sd*1</pre>
***where * is the letter associated with the SD device and the 1 is the partition. Once in fdisk, use the help to determine the specific command to mark the boot flag. For me it was "a".
*Next ensure the .img file uncompressed previously is accessible by the Linux machines. I used another flash drive.
*Use the command <pre>dd if=OLPC-School-Server-0.5.2-dev01-i386.img of=/dev/sd*1</pre>
**This will take some time depending on the system performance.
*Use resize2fs to re-size the partition <pre>resize2fs -p /dev/sd*1</pre>

=====Booting the XO from the SD=====
More than likely, this will not work right away, my implementation required some tweaking prior to fully booting.
*First the XO must have a [http://wiki.laptop.org/go/Activation_and_Developer_Keys developer's key!!!]

==Documentation & Resources==

'''Post XS School Server Installation Configuration:'''
<pre>
yum groupinstall "GNOME Desktop Environment"

edit /etc/inittab and change runlevel from 3 to 5 to startup in Gnome

yum install mysql-server php php-mysql php-mbstring php-gd php-xmlrpc php-imap cvs

service mysqld start
mysqladmin -u root password 'mySecurePassword'
mysql -u root -p
mysql> CREATE DATABASE moodle CHARSET 'utf8';
mysql> exit;
chkconfig mysqld on
--starts sql server; adds root admin user; logs into server and creates DB;
--turns the service on on boot.

cd /var/www
cvs -z3 -d:pserver:anonymous@eu.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle
--download and install/update with the latest version of moodle

mkdir moodledata
chown -R apache:apache moodle
chown -R apache:apache moodledata
--make directory in /var/www/ and change permissions.

edit the file /etc/httpd/conf/httpd.conf
change DocumentRoot "/var/www/html" to DocumentRoot "/var/www/moodle"
change <Directory "/var/www/html"> to <Directory "/var/www/moodle">
then you must restart the apache server by issuing the command:
service httpd restart

</pre>

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

'''Starting MySQL Database:''' 
[[image:ScreenStartingMysql.png]]

'''Logging in to MySQL Database:''' 
[[image:ScreenLoginSqlServ.png]]

'''Creating Database:''' 
[[image:ScreenCreateDB.png]]

== Code ==

Code can be downloaded [http://www.filedropper.com/parser here]

<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

Teacher Reporting

2009-05-18T16:00:52Z

Jrgreen118: /* Uncompress the image: */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==After Class Plans==

Wesley Dillingham will continue this project into the summer as part of RIT's cooperative education program.

Jeremiah Green will continue working on this project when time is available to devote.

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

=====Un-compress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*Un-compress the file
**In Windows, [http://www.rarlab.com/download.htm WinRAR] worked for me.
**In Linux, this command works just as well<pre>gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz"</pre>

=====Setting Up the Environment=====
With the SD card connected to the Linux PC:
*Using a tool of your choice format the SD card to ext2 or ext3 (Linux 83).
**I used gparted and formated the SD card to ext3, but fdisk would also work.
*Mark the partition with the boot flag
**This can be done using gparted, but mine had issues applying the changes. I used fdisk.
**To enter fdisk, use <pre>fdisk /dev/sd*1</pre> where * is the letter associated with the SD device and the 1 is the partition. Once in fdisk, use the help to determine the specific command to mark the boot flag. For me it was "a".
*Next ensure the .img file uncompressed previously is accessible by the Linux machines. I used another flash drive.
*Use the command <pre>dd if=OLPC-School-Server-0.5.2-dev01-i386.img.gz of=/dev/sd*1</pre>
**This will take some time depending on the system performance.
*Use resize2fs to re-size the partition <pre>resize2fs -p /dev/sd*1</pre>

==Documentation & Resources==

'''Post XS School Server Installation Configuration:'''
<pre>
yum groupinstall "GNOME Desktop Environment"

edit /etc/inittab and change runlevel from 3 to 5 to startup in Gnome

yum install mysql-server php php-mysql php-mbstring php-gd php-xmlrpc php-imap cvs

service mysqld start
mysqladmin -u root password 'mySecurePassword'
mysql -u root -p
mysql> CREATE DATABASE moodle CHARSET 'utf8';
mysql> exit;
chkconfig mysqld on
--starts sql server; adds root admin user; logs into server and creates DB;
--turns the service on on boot.

cd /var/www
cvs -z3 -d:pserver:anonymous@eu.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle
--download and install/update with the latest version of moodle

mkdir moodledata
chown -R apache:apache moodle
chown -R apache:apache moodledata
--make directory in /var/www/ and change permissions.

edit the file /etc/httpd/conf/httpd.conf
change DocumentRoot "/var/www/html" to DocumentRoot "/var/www/moodle"
change <Directory "/var/www/html"> to <Directory "/var/www/moodle">
then you must restart the apache server by issuing the command:
service httpd restart

</pre>

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

'''Starting MySQL Database:''' 
[[image:ScreenStartingMysql.png]]

'''Logging in to MySQL Database:''' 
[[image:ScreenLoginSqlServ.png]]

'''Creating Database:''' 
[[image:ScreenCreateDB.png]]

== Code ==

Code can be downloaded [http://www.filedropper.com/parser here]

<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

Teacher Reporting

2009-05-18T15:58:42Z

Jrgreen118: /* How To: */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==After Class Plans==

Wesley Dillingham will continue this project into the summer as part of RIT's cooperative education program.

Jeremiah Green will continue working on this project when time is available to devote.

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

=====Uncompress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*In Windows, [http://www.rarlab.com/download.htm WinRAR] worked for me.
*In Linux, the command "gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz" works just as well.

=====Setting Up the Environment=====
With the SD card connected to the Linux PC:
*Using a tool of your choice format the SD card to ext2 or ext3 (Linux 83).
**I used gparted and formated the SD card to ext3, but fdisk would also work.
*Mark the partition with the boot flag
**This can be done using gparted, but mine had issues applying the changes. I used fdisk.
**To enter fdisk, use <pre>fdisk /dev/sd*1</pre> where * is the letter associated with the SD device and the 1 is the partition. Once in fdisk, use the help to determine the specific command to mark the boot flag. For me it was "a".
*Next ensure the .img file uncompressed previously is accessible by the Linux machines. I used another flash drive.
*Use the command <pre>dd if=OLPC-School-Server-0.5.2-dev01-i386.img.gz of=/dev/sd*1</pre>
**This will take some time depending on the system performance.
*Use resize2fs to re-size the partition <pre>resize2fs -p /dev/sd*1</pre>

==Documentation & Resources==

'''Post XS School Server Installation Configuration:'''
<pre>
yum groupinstall "GNOME Desktop Environment"

edit /etc/inittab and change runlevel from 3 to 5 to startup in Gnome

yum install mysql-server php php-mysql php-mbstring php-gd php-xmlrpc php-imap cvs

service mysqld start
mysqladmin -u root password 'mySecurePassword'
mysql -u root -p
mysql> CREATE DATABASE moodle CHARSET 'utf8';
mysql> exit;
chkconfig mysqld on
--starts sql server; adds root admin user; logs into server and creates DB;
--turns the service on on boot.

cd /var/www
cvs -z3 -d:pserver:anonymous@eu.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle
--download and install/update with the latest version of moodle

mkdir moodledata
chown -R apache:apache moodle
chown -R apache:apache moodledata
--make directory in /var/www/ and change permissions.

edit the file /etc/httpd/conf/httpd.conf
change DocumentRoot "/var/www/html" to DocumentRoot "/var/www/moodle"
change <Directory "/var/www/html"> to <Directory "/var/www/moodle">
then you must restart the apache server by issuing the command:
service httpd restart

</pre>

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

'''Starting MySQL Database:''' 
[[image:ScreenStartingMysql.png]]

'''Logging in to MySQL Database:''' 
[[image:ScreenLoginSqlServ.png]]

'''Creating Database:''' 
[[image:ScreenCreateDB.png]]

== Code ==

Code can be downloaded [http://www.filedropper.com/parser here]

<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

Teacher Reporting

2009-05-18T15:42:42Z

Jrgreen118: /* How To: */

{{TOCright}}
==Description==
A custom [http://moodle.org/ Moodle] [http://docs.moodle.org/en/Quiz_module quiz module] which, in addition to the standard Moodle quiz features, analyzes the questions posed to the student for various qualities, such as compliance with [[User:Gdk/4th_Grade_Maths | Curriculum Standards]].

The modified Moodle modules will run on a customized XS School Server operating system. Our goal is to allow results and / or grades, from student activities to be readily available to teachers. Based on their wants and needs, the teachers can then generate custom reports on a class or student and have the ability to determine what types of problems students are finding most difficult. In the end we imagine the XS environment running on an XO itself, allowing the teachers the same portability as the students.

==Group Members==
* '''Project Manager:''' [[User:Wwdillingham | Wesley Dillingham]]
* '''Additional Group Members:''' [[User:jrgreen118 | Jeremiah Green]]
 

==Data Flow Diagram==
[[image:Teacher_Reporting_Diagram.jpg|800px|]]
 

==Goals==
*Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the [http://www.doe.mass.edu/frameworks/current.html Massachusetts Curriculum Framework for Mathematics.]
*Parse mathematical-operation-based and tally percentage of success with each individual operation (+,-,/,* etc).

*Run Moodle with the modified quiz module on an XO running [[olpc:School_server | XS]], The '''X'''O school '''S'''erver.
*Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
*Have [http://download.moodle.org/ Moodle's latest stable release] functioning in an XS School Server [[olpc:XS-on-XO | VirtualBox]] OSE Virtual Machine
*Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined [[olpc:XS-on-XO | here]].
*Have PHP calls successfully querying mock student results from Moodle's MySQL database running on XS.

=="How to Play/Use" for end user==

Our project is not intended for a direct use by students. Components (not yet developed) under the scope of our project exist on students computer's in so far as facilitating the data movement from the XO to the XS. Therefore, there are no directions for students on how to use our application, it will be entirely transparent to them. When a student begins an activity which is compatible with our application, it will automatically report information to the API. Our application will then read this information from the API and produce reports to the teacher. We envision this interface to be web based, allowing the teacher to select particular games, and as a subcategory, the particular curriculum requirements in which that game uses.

At this moment (5/18/2009) we only have a script which analyzes performance on particular mathematical operations and the students ability to understand order of operations.

In order to run this script (parser.awk) issue the command, <pre>awk -f parser.awk students.dat</pre>

== Teachers guide ==

Student.dat file fields:<pre>
MAC-ADDRESS STUDENT_NAME OPERATION CORRECT
</pre>

Example:<pre>
0C7B6G0023BC Wesley 9/3+7 1
0C7B6G04DBBA Jeremiah 4+10/7 0
0C7B6GBA5D7D Billy 88-28*2 0
0C7B6G07E9HB Bob 4*5 1
</pre>

Ouput Example: <pre>Student Only + Contains + Only - Contains - Only * Contains * Only / Contains / Understands OoO?
wes 25 28 12 100 80 83 71 53 no
bob 80 77 0 66 100 100 33 60 yes
jeremiah 0 0 16 33 40 50 14 33 no
billy 66 70 33 53 50 37 100 80 yes
</pre>
''note: This output is not reflective of the student.dat example data above''

==After Class Plans==

Wesley Dillingham will continue this project into the summer as part of RIT's cooperative education program.

Jeremiah Green will continue working on this project when time is available to devote.

==XS SchoolServer on the XO==

A major barrier to achieving our goals is the idea that the School Server needs the ability to be versatile and portable. While some may have resources to dedicate substantial hardware to such a server, others may find themselves with nothing more than the XO laptops. From this stems the idea of running this server on one of the XO laptops via either a USB flash drive, SD card, or the internal NAND hard drive.

When fully installed on an SD card, the base operating system takes up about 1.6GB. There is a small amount of documentation available which is excellent and extremely helpful, but it can be difficult to use at times. Below is a quick break down of what we did and how to replicate it.

====How To:====

The most helpful website to read before beginning can be found here: [http://wiki.laptop.org/go/XS-on-XO Laptop.org's XS-on-XO.]

=====Necessary hardware to replicate our setup includes:=====
*XO Laptop
*Linux Computer with SD Card Reader
**Can be physical machine or virtual. Also, some things can be done in Windows.
*SD card which is at least 4GB (We used an 8GB A-DATA SDHC)

Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]

=====Uncompress the image:=====
*Download the image file: [http://xs-dev.laptop.org/xs/other/OLPC-School-Server-0.5.2-dev01-i386.img.gz OLPC-School-Server-0.5.2-dev01-i386.img.gz]
*In Windows, [http://www.rarlab.com/download.htm WinRAR] worked for me.
*In Linux, the command "gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz" works just as well.

==Documentation & Resources==

'''Post XS School Server Installation Configuration:'''
<pre>
yum groupinstall "GNOME Desktop Environment"

edit /etc/inittab and change runlevel from 3 to 5 to startup in Gnome

yum install mysql-server php php-mysql php-mbstring php-gd php-xmlrpc php-imap cvs

service mysqld start
mysqladmin -u root password 'mySecurePassword'
mysql -u root -p
mysql> CREATE DATABASE moodle CHARSET 'utf8';
mysql> exit;
chkconfig mysqld on
--starts sql server; adds root admin user; logs into server and creates DB;
--turns the service on on boot.

cd /var/www
cvs -z3 -d:pserver:anonymous@eu.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle
--download and install/update with the latest version of moodle

mkdir moodledata
chown -R apache:apache moodle
chown -R apache:apache moodledata
--make directory in /var/www/ and change permissions.

edit the file /etc/httpd/conf/httpd.conf
change DocumentRoot "/var/www/html" to DocumentRoot "/var/www/moodle"
change <Directory "/var/www/html"> to <Directory "/var/www/moodle">
then you must restart the apache server by issuing the command:
service httpd restart

</pre>

'''Installing MySQL:''' 
[[image:ScreenInstalling.png]]

'''Starting MySQL Database:''' 
[[image:ScreenStartingMysql.png]]

'''Logging in to MySQL Database:''' 
[[image:ScreenLoginSqlServ.png]]

'''Creating Database:''' 
[[image:ScreenCreateDB.png]]

== Code ==

Code can be downloaded [http://www.filedropper.com/parser here]

<pre>
#Wesley Dillingham
#Filename parser.awk
#Last updated May 17th 2009

BEGIN{
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", "Student", "Only +", "Contains +", "Only -", "Contains -", "Only
*", "Contains *", "Only /", "Contains /", "Understands OoO?")
}

{
#*****Field Reference *************

#MAC=$1
#NAME=$2
#OPERATION=$3
#SUCCESS=$4

#************************************

#Because in the end statement we will have to loop through one of the arrays, which will be localized according
#to specific aritmetic operations (- + / *). We need to account for the fact that some students may not answer a
#question with one of these operations, and if we looped through that particular operation, we would not represent
#that student in any of the logic containted within that loop in the END{} statment. Therefore an associative array
#which absolutely, accounts for any student, contained in the .dat, the CLASS[] array.
CLASS[$2]

#any line that has division, but not necessarily just.
if ( match($3, /\//) )
{
#How many division problem student $2 encounters = divison[$2]
division[$2]++

if ( $4 == "1" )
{
division_correct[$2]++
}
}

#any line with multiplication but not neccearily just multiplication
if ( match($3, /\*/) )
{
#How many multiplication problem student $2 encounters = multiplication[$2]
multiplication[$2]++

if ( $4 == "1" )
{
multiplication_correct[$2]++
}

}

#any line with addition but not necessarily just addition
if ( match($3, /\+/) )
{
#How many addition problem student $2 encounters = addition[$2]
addition[$2]++

if ( $4 == "1" )
{
addition_correct[$2]++
}
}

#contains subtractions, excludes negative numbers, as it only matches expressions with a "-" sandwiched b/w two digits
if ( match($3, /[0-9]\-[0-9]/) )
{
#How many subtraction problem student $2 encounters = subtraction[$2]
subtraction[$2]++

if ( $4 == "1" )
{
subtraction_correct[$2]++
}
}

# Matches operations with ONLY DIVISION
if ( match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{

#How many ONLY division problem student $2 encounters = 0_divison[$2]
o_division[$2]++

if ( $4 == "1" )
{
o_division_correct[$2]++
}

}

# Matches operations with ONLY SUBTRACTION
if ( !match($3, /\//) && match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY subtraction problem student $2 encounters = o_subtraction[$2]
o_subtraction[$2]++

if ( $4 == "1" )
{
o_subtraction_correct[$2]++
}

}

# Matches operations with ONLY ADDITION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && match($3, /\+/) && !match($3, /\*/) )
{
#How many ONLY Addition problem student $2 encounters = o_addition[$2]
o_addition[$2]++

if ( $4 == "1" )
{
o_addition_correct[$2]++
}

}

# Matches operations with ONLY MULTIPLICATION
if ( !match($3, /\//) && !match($3, /[0-9]\-[0-9]/) && !match($3, /\+/) && match($3, /\*/) )
{
#How many ONLY MULTIPLICATION problem student $2 encounters = o_multiplication[$2]
o_multiplication[$2]++

if ( $4 == "1" )
{
o_multiplication_correct[$2]++
}

}

#How many problems an individual student faced: for classwide statistics we simply use the built-in var NR
numproblems[$2]++

#Determine if it is a compound operation if so increment by one, this requires 4 if's as we have to check if each of them exists in
# conjuntion with another.
#Keep track of total compounds and compounds correct.
#Else-if structure required because if stringed If's were used each compound match would register twice.

if ( match($3, /\//) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /[0-9]\-[0-9]/) && (match($3, /\//) || match($3, /\+/) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else if ( match($3, /\+/) && ( match($3, /[0-9]\-[0-9]/) || match($3, /\//) || match($3, /\*/) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}
}
else if ( match($3, /\*/) && ( match($3, /\+/) || match($3, /[0-9]\-[0-9]/) || match($3, /\//) ) )
{
compound[$2]++

if ($4 == "1") #if correct
{
compound_correct[$2]++
}

}
else # This allows for easy way to harness non compound statements, instead of going through a whole new slew of logic statements.
{

non_compound[$2]++

if ($4 == "1") #if correct
{
non_compound_correct[$2]++
}

}

if ( $4 == "1" )
{totalcorrect[$2]++}

}#end of AWK_MAIN
END{

#loops through all of the elements in the array CLASS[]
#Here We will print out the students

for (student in CLASS)
{

# A student doesnt understand order of operations if their is a greater than 20% difference in between compound
# operations and single operation instructions, but only if lower on the compound instruction side.

if ( ( (non_compound_correct[student] / non_compound[student]) - (compound_correct[student] / compound[student]) > .2 ) ||
( (non_compound_correct[student] / non_compound[student]) ) < .7)
{
understands= "no"
}
else
{
understands= "yes"
}

#need to address divide by 0 issue
printf("%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-8s%-11s%-11s\n", student,
int(o_addition_correct[student]*100/o_addition[student]), int(addition_correct[student]*100/addition[student]),
int(o_subtraction_correct[student]*100/o_addition[student]), int(subtraction_correct[student]*100/subtraction[student]),
int(o_multiplication_correct[student]*100/o_multiplication[student]),
int(multiplication_correct[student]*100/multiplication[student]), int(o_division_correct[student]*100/o_division[student]),
int(division_correct[student]*100/division[student]), understands)

}

} #end of AWK_END

</pre>

Teacher Reporting

2009-05-18T15:42:04Z

Jrgreen118: /* How To: */

Teacher Reporting

2009-05-18T15:41:15Z

Jrgreen118: /* XS SchoolServer on the XO */

Teacher Reporting

2009-05-18T15:29:18Z

Jrgreen118: /* XS SchoolServer on the XO */

Teacher Reporting

2009-05-18T15:13:56Z

Jrgreen118: /* XS SchoolServer on the XO */

Teacher Reporting

2009-05-18T15:06:52Z

Jrgreen118: /* After Class Plans */

Teacher Reporting

2009-05-18T15:06:16Z

Jrgreen118: /* After Class Plans */

Teacher Reporting

2009-05-18T15:04:44Z

Jrgreen118: /* After Class Plans */

Teacher Reporting

2009-05-18T14:31:10Z

Jrgreen118: /* Teachers guide */

Teacher Reporting

2009-05-18T14:30:26Z

Jrgreen118: /* "How to Play/Use" for end user */

Teacher Reporting

2009-05-18T14:29:30Z

Jrgreen118: /* Jeremiah to add for his component - put xs on xo directions here, or in subsection. */

Teacher Reporting

2009-05-18T14:26:32Z

Jrgreen118: /* Teachers guide */

Teacher Reporting

2009-05-18T14:26:06Z

Jrgreen118: /* Jeremiah to add for his component - put xs on xo directions here, or in subsection. */

Teacher Reporting

2009-05-18T14:25:42Z

Jrgreen118: /* "How to Play/Use" for end user */

Teacher Reporting

2009-05-01T19:42:15Z

Jrgreen118: /* Documentation & Resources */

Math4Team/RIT/Alumni/Spring-2009

2009-04-29T18:33:03Z

Jrgreen118: /* Jeremiah Green */

{{TOCright}}
==Computer Engineering Technology==
===[[User:Nikeunltd|Kennedy Kong]]===
2nd Year

==Computer Science==
===[[User:Mdd8919 | Mitchell DeMarco]]===
xl

3rd Year

===[[User:Enimihil|Gregory Stevens]]===
5th Year (Graduating after this class)

Shirt size: Large

===[[User:Jck1089|James Kolb]]===
4th Year (Double majoring in Math)

Medium

===[[User:Qalthos|Nathaniel Case]]===
3rd Year 
Large shirt size

===[[User:EricMallon|Eric Mallon]]===
3rd Year

===[[User:Eldrac|G. Tyler Bragdon]]===
3rd Year (Minoring in Math)

==Information Technology==
===[[User:bjr9081|Brendan Reen]]===
4th Year

===[[User:bbl5660|Brian Long]]===
4th Year
Medium T-Shirt Size

===[[User:Echo35|Anthony Lubrani]]===
2nd Year

===[[User:jrgreen118|Jeremiah Green]]===
5th year 
Shirt Size: Extra Large

===[[User:wwdillingham|Wesley Dillingham]]===
5th year

==Photo Journalism==
===[[User:Jsang1|Jonathan Sanger]]===
1st year 
L

==Networking==
===[[User:Classclownfish | Abbi Honeycutt]]===
1st year

Small?

===[[User:Epsilon748 | Anthony King -XL]]===
2nd year

===[[User:Sss1406 | Steven Schoenfeld]]===
4th Year NSSA Student

Shirt Size: Large

===[[User:Jfinney | Jameson Finney]]===
3rd year
===[[User:dbj4366 | Dennis Jalbert]]===
5th year (Graduating after this quarter) 
Medium

==Software Engineering==
===[[User:Cdaniels29 | Chris Daniels]]===
5th Year
Medium

===[[User:Dpk3062 | Doug Krofcheck]]===
5th Year

Math4Team/RIT/Alumni/Spring-2009

2009-04-29T18:32:41Z

Jrgreen118: /* Jeremiah Green */

{{TOCright}}
==Computer Engineering Technology==
===[[User:Nikeunltd|Kennedy Kong]]===
2nd Year

==Computer Science==
===[[User:Mdd8919 | Mitchell DeMarco]]===
xl

3rd Year

===[[User:Enimihil|Gregory Stevens]]===
5th Year (Graduating after this class)

Shirt size: Large

===[[User:Jck1089|James Kolb]]===
4th Year (Double majoring in Math)

Medium

===[[User:Qalthos|Nathaniel Case]]===
3rd Year 
Large shirt size

===[[User:EricMallon|Eric Mallon]]===
3rd Year

===[[User:Eldrac|G. Tyler Bragdon]]===
3rd Year (Minoring in Math)

==Information Technology==
===[[User:bjr9081|Brendan Reen]]===
4th Year

===[[User:bbl5660|Brian Long]]===
4th Year
Medium T-Shirt Size

===[[User:Echo35|Anthony Lubrani]]===
2nd Year

===[[User:jrgreen118|Jeremiah Green]]===
5th year
Shirt Size: Extra Large

===[[User:wwdillingham|Wesley Dillingham]]===
5th year

==Photo Journalism==
===[[User:Jsang1|Jonathan Sanger]]===
1st year 
L

==Networking==
===[[User:Classclownfish | Abbi Honeycutt]]===
1st year

Small?

===[[User:Epsilon748 | Anthony King -XL]]===
2nd year

===[[User:Sss1406 | Steven Schoenfeld]]===
4th Year NSSA Student

Shirt Size: Large

===[[User:Jfinney | Jameson Finney]]===
3rd year
===[[User:dbj4366 | Dennis Jalbert]]===
5th year (Graduating after this quarter) 
Medium

==Software Engineering==
===[[User:Cdaniels29 | Chris Daniels]]===
5th Year
Medium

===[[User:Dpk3062 | Doug Krofcheck]]===
5th Year

Teacher Reporting

2009-04-24T21:04:44Z

Jrgreen118: /* "Required Accomplishment" */

==Description==
Ideally we envision this project to evolve into a collection of scripts or methods. These methods,specific to an individual game will be modified to parse and report relevant information to a central host program which keeps track of progress from multiple activities. This host program will live on the instructors machine for monitoring purposes and on the students machine only so far as to coordinate the correct implementation of the proper scripts.

==Group Members==
*[http://wiki.sugarlabs.org/go/User:Wwdillingham Wesley Dillingham] will be in charge of the scripts involved with student and class performance, Parsing the mathematical expression. Additionally, he will be responsible for the integration with Kuku.

*[http://wiki.sugarlabs.org/go/User:jrgreen118 Jeremiah Green] will be responsible for automating the collective delivery of each student's game data (Student ID ,Problem, Correctness) to the Teachers XO. and format their results to allow for Wes's methods to compute the relevant class-wide statistics.

==Goals==
Using a combination of shell scripts, AWK, and Python we will be developing a system which reads in from a file, students identifiable information, the question itself (a mathematical operation), and the students correctness. From this studentinfo.dat file we will report to the teacher: Number of questions, total percent correct, percent correct for multiplication, division, addition, and subtraction.

==Week by week milestones==
*Week 8: Have both scripts succesfully tabulating relevant information

*Week 9 :Have student to teacher data information transfer succesfully functioning with scripts.

*Week 10: Have integration with kuku, and a gui for teachers data retrieval.

=="Required Accomplishment"==

===Wes===
*Get StudentParser.awk to successfully calculate the accuracy for each mathematical operation, plus other relevant information TBD, one example will be success of division with remainders.
*Get ClassParser.awk to successfully calculate class-wide statistics on the same information
*Provide Grader.awk which grades each student, calculates a class average, tallys students in each grade interval.

===Jeremiah===
* Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
* Install Moodle server and DBMS on a test Virtual Machine.
** Attempt PHP calls to the Moodle DBMS.
** Attempt to create a simple Moodle module extension which can be further built off of to provide further functionality.
* Provide a script to move StudentParser.awk's output to ClassParser.awk's input

=="Wishlist Accomplishments "==

==Links & Resources==
'''''StudentParser.awk''''' Input file format:
<pre>
Field Structure:
"Mathematical Operation" "Correct?"

example:
45/67 y
</pre>

'''''StudentParser.awk''''' Output file format *Incomplete*
<pre>
Field Structure:
line 1: "Student MAC-Address"
line 2+: "Operation type" "correct in decimal"

example:
0:1e:8c:25:a0:c1
+ .86
- .84
x .91
/ .86
</pre>

'''''Grader.awk:'''''
<pre>
#!/usr/bin/awk

# grades -- average student grades and determine
# letter grade as well as class averages
# at the command line run: awk -f grader.awk grades.dat

BEGIN { OFS = "\t"; "date +%H:%M:%S" | getline current_time
close("date +%H:%M:%S")
print "Report printed on " current_time
}

# action applied to all input lines
{
# add up the grades
total = 0
for (i = 3; i <= NF; ++i) # i=3 skips first 2 fields - last name, first name
total+=$i

# calculate average
avg = total / (NF - 2)

# assign student's average to element of array
class_avg[NR] = avg

# determine letter grade
if (avg >= 90) grade="A"
else if (avg >= 80) grade="B"
else if (avg >= 70) grade="C"
else if (avg >= 60) grade="D"
else grade="F"

# increment counter for letter grade array
++class_grade[grade]

# print student first name, last name, average interger value, and letter grade
print $2 " " $1, int(avg), grade#, NF, NF
}

# print out class statistics
END {
# calculate class average
for (x = 1; x <= NR; x++)
class_avg_total += class_avg[x]
class_average = class_avg_total / NR

# determine how many above/below average
for (x = 1; x <= NR; x++)
if (class_avg[x] >= class_average)
++above_average
else
++below_average

# print results
print ""
print "Class Average: ", class_average
print "At or Above Average: ", above_average
print "Below Average: ", below_average

# print number of students per letter grade
for (letter_grade in class_grade)
print letter_grade ":", class_grade[letter_grade]

}
</pre>

==Helpful stuff==

Teacher Reporting

2009-04-24T20:58:56Z

Jrgreen118: /* "Required Accomplishment" */

==Description==
Ideally we envision this project to evolve into a collection of scripts or methods. These methods,specific to an individual game will be modified to parse and report relevant information to a central host program which keeps track of progress from multiple activities. This host program will live on the instructors machine for monitoring purposes and on the students machine only so far as to coordinate the correct implementation of the proper scripts.

==Group Members==
*[http://wiki.sugarlabs.org/go/User:Wwdillingham Wesley Dillingham] will be in charge of the scripts involved with student and class performance, Parsing the mathematical expression. Additionally, he will be responsible for the integration with Kuku.

*[http://wiki.sugarlabs.org/go/User:jrgreen118 Jeremiah Green] will be responsible for automating the collective delivery of each student's game data (Student ID ,Problem, Correctness) to the Teachers XO. and format their results to allow for Wes's methods to compute the relevant class-wide statistics.

==Goals==
Using a combination of shell scripts, AWK, and Python we will be developing a system which reads in from a file, students identifiable information, the question itself (a mathematical operation), and the students correctness. From this studentinfo.dat file we will report to the teacher: Number of questions, total percent correct, percent correct for multiplication, division, addition, and subtraction.

==Week by week milestones==
*Week 8: Have both scripts succesfully tabulating relevant information

*Week 9 :Have student to teacher data information transfer succesfully functioning with scripts.

*Week 10: Have integration with kuku, and a gui for teachers data retrieval.

=="Required Accomplishment"==

*'''Wes'''
**Get StudentParser.awk to successfully calculate the accuracy for each mathematical operation, plus other relevant information TBD, one example will be success of division with remainders.
**Get ClassParser.awk to successfully calculate class-wide statistics on the same information
**Provide Grader.awk which grades each student, calculates a class average, tallys students in each grade interval.

*'''Jeremiah'''
** Create Moodle data flow diagram to give an understanding of how the Moodle Server and corresponding database interact with Student and Teachers machines.
** Install Moodle server and DBMS on a test Virtual Machine.
*** Attempt PHP calls to the Moodle DBMS.
*** Attempt to create a simple Moodle module extension which can be further built off of to provide further functionality.
** Provide a script to move StudentParser.awk's output to ClassParser.awk's input

=="Wishlist Accomplishments "==

==Links & Resources==
'''''StudentParser.awk''''' Input file format:
<pre>
Field Structure:
"Mathematical Operation" "Correct?"

example:
45/67 y
</pre>

'''''StudentParser.awk''''' Output file format *Incomplete*
<pre>
Field Structure:
line 1: "Student MAC-Address"
line 2+: "Operation type" "correct in decimal"

example:
0:1e:8c:25:a0:c1
+ .86
- .84
x .91
/ .86
</pre>

'''''Grader.awk:'''''
<pre>
#!/usr/bin/awk

# grades -- average student grades and determine
# letter grade as well as class averages
# at the command line run: awk -f grader.awk grades.dat

BEGIN { OFS = "\t"; "date +%H:%M:%S" | getline current_time
close("date +%H:%M:%S")
print "Report printed on " current_time
}

# action applied to all input lines
{
# add up the grades
total = 0
for (i = 3; i <= NF; ++i) # i=3 skips first 2 fields - last name, first name
total+=$i

# calculate average
avg = total / (NF - 2)

# assign student's average to element of array
class_avg[NR] = avg

# determine letter grade
if (avg >= 90) grade="A"
else if (avg >= 80) grade="B"
else if (avg >= 70) grade="C"
else if (avg >= 60) grade="D"
else grade="F"

# increment counter for letter grade array
++class_grade[grade]

# print student first name, last name, average interger value, and letter grade
print $2 " " $1, int(avg), grade#, NF, NF
}

# print out class statistics
END {
# calculate class average
for (x = 1; x <= NR; x++)
class_avg_total += class_avg[x]
class_average = class_avg_total / NR

# determine how many above/below average
for (x = 1; x <= NR; x++)
if (class_avg[x] >= class_average)
++above_average
else
++below_average

# print results
print ""
print "Class Average: ", class_average
print "At or Above Average: ", above_average
print "Below Average: ", below_average

# print number of students per letter grade
for (letter_grade in class_grade)
print letter_grade ":", class_grade[letter_grade]

}
</pre>

==Helpful stuff==

User:Jrgreen118

2009-04-10T13:07:59Z

Jrgreen118:

==Personal Info==
Name: Jeremiah Green 
Email: jrgreen118@gmail.com 
Phone: (303) 382-8942

==School Info==
Major: Information Technology 
Year: 5 
Concentration: Networking and Systems Administration

==Project Info==
Multiplication Minute 
Upload of student progress/responses to teacher 
Researched Frotz application.

==Programming Experience==
Java, Actionscript, Javascript, HTML, XHTML, CSS...etc. 
no Python.

==Standards==
4.N.3 
4.N.4 
4.N.9

User:Jrgreen118

2009-04-07T00:27:20Z

Jrgreen118:

Math4Team/RIT/Alumni/Spring-2009

2009-04-07T00:22:18Z

Jrgreen118:

{{TOCright}}
==Computer Engineering Technology==
===Kennedy Kong===
2nd Year
I am interested in having the other side touch pads running and integrate them with some kinda of software.
I am interested in also having a web cam program running, but that seems to be taken by an external team. I might collaborate with the webcam group.

==Computer Science==
===[[User:Mdd8919 | Mitchell DeMarco]]===
3rd Year

===[[User:Enimihil|Gregory Stevens]]===
5th Year (Graduating after this class)

===James Kolb===
4th Year (Double majoring in Math)

===Nathaniel Case===
3rd Year

===[[User:EricMallon|Eric Mallon]]===
3rd Year

===[[User:Eldrac|G. Tyler Bragdon]]===
3rd Year (Minoring in Math)

==Information Technology==
===[[User:bjr9081|Brendan Reen]]===
4th Year

===[[User:bbl5660|Brian Long]]===
4th Year

===[[User:Echo35|Anthony Lubrani]]===
2nd Year

===[[User:jrgreen118|Jeremiah Green]]===
5th year

==Photo Journalism==
===Jonathan Sanger===
1st year

==Networking==
===[[User:Classclownfish | Abbi Honeycutt]]===
1st year

===[[User:Epsilon748 | Anthony King]]===
2nd year
===[[User:Sss1406 | Steven Schoenfeld]]===
4th year

===Jameson Finney===
3rd year
===[[User:dbj4366 | Dennis Jalbert]]===
5th year (Graduating after this quarter)

==Software Engineering==
===[[User:Cdaniels29 | Chris Daniels]]===
5th Year

===Doug Krofcheck===
5th Year

User:Jrgreen118

2009-04-07T00:19:36Z

Jrgreen118: New page: ==Personal Info== Name: Jeremiah Green Email: jrgreen118@gmail.com Phone: (303) 382-8942 ==School Info== Major: Information Technology Year: 5 Concentration: Networking an...

==Personal Info==
Name: Jeremiah Green 
Email: jrgreen118@gmail.com 
Phone: (303) 382-8942

==School Info==
Major: Information Technology 
Year: 5 
Concentration: Networking and Systems Administration

==Programming Experience==
Java, Actionscript, Javascript, HTML, XHTML, CSS...etc. 
no Python.