# Teacher Reporting

## Description

A custom Moodle 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 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.

## Collaboration

To help in code contribution of this project, please visit us at our Gitorious project page.

## Project Members

**Project Manager:**Wesley Dillingham**Additional Group Members:**Jeremiah Green, Fred Grose

## Goals

- Expand upon the PHP of the Moodle Quiz Module to parse questions involving mathematical operations for characteristics contained in the Massachusetts Curriculum Framework for Mathematics.
- Run Moodle with the modified quiz module on an XO running XS, The
**X**O school**S**erver. - Have Moodle's latest stable release functioning on an XO running XS using the techniques outlined here.
- Have PHP calls successfully querying mock student results from Moodle's PostgreSQL database running on XS.

## Data Flow Diagram

## Curriculum Requirements and Relevant Activities

### Math 4

Students engage in problem solving, communicating, reasoning, connecting, and representing as they:

#### Number sense and Operations

Id | Standard Description | Who's working on The activity? | What Sugar activity satisfies this objective? | What Information does Teacher Reporting App need? |
---|---|---|---|---|

4.N.1 | Exhibit an understanding of the base ten number system by reading, modeling, writing, and interpreting whole numbers to at least 100,000; demonstrating an understanding of the values of the digits; and comparing and ordering the numbers. | Adam Schreiber | Deka | |

4.N.2 | Represent, order, and compare large numbers (to at least 100,000) using various forms, including expanded notation, e.g., 853 = 8 x 100 + 5 x 10 + 3. | UTOS-XO, Adam Schreiber | Deka | |

4.N.3 | Demonstrate an understanding of fractions as parts of unit wholes, as parts of a collection, and as locations on the number line. | None | None | |

4.N.4 | Select, use, and explain models to relate common fractions and mixed numbers (1/2, 1/3, 1/4, 1/5, 1/6, 1/8, 1/10, 1/12, and 11/2), find equivalent fractions, mixed numbers, and decimals, and order fractions. | None | None | |

4.N.5 | Identify and generate equivalent forms of common decimals and fractions less than one whole (halves, quarters, fifths, and tenths). | None | None | |

4.N.6 | Exhibit an understanding of the base ten number system by reading, naming, and writing decimals between 0 and 1 up to the hundredths. | Adam Schreiber | Deci | |

4.N.7 | Recognize classes (in particular, odds, evens; factors or multiples of a given number; and squares) to which a number may belong, and identify the numbers in those classes. Use these in the solution of problems. | Doug Glenn | None | |

4.N.8 | Select, use, and explain various meanings and models of multiplication and division of whole numbers. Understand and use the inverse relationship between the two operations. | None | None | |

4.N.9 | Select, use, and explain the commutative, associative, and identity properties of operations on whole numbers in problem situations, e.g., 37 x 46 = 46 x 37, (5 x 7) x 2 = 5 x (7 x 2). | None | None | |

4.N.10 | Select and use appropriate operations (addition, subtraction, multiplication, and division) to solve problems, including those involving money. | Gcompris | GCompris Money 11 GCompris Money Cents 11 | |

4.N.11 | Know multiplication facts through 12 x 12 and related division facts. Use these facts to solve related multiplication problems and compute related problems, e.g., 3 x 5 is related to 30 x 50, 300 x 5, and 30 x 500. | Gcompris | GCompris Algebra Guesscount 11 | |

4.N.12 | Add and subtract (up to five-digit numbers) and multiply (up to three digits by two digits) accurately and efficiently. | UTOS-XO | None | |

4.N.13 | Divide up to a three-digit whole number with a single-digit divisor (with or without remainders) accurately and efficiently. Interpret any remainders. | UTOS-XO | None | |

4.N.14 | Demonstrate in the classroom an understanding of and the ability to use the conventional algorithms for addition and subtraction (up to five-digit numbers), and multiplication (up to three digits by two digits). | None | None | |

4.N.15 | Demonstrate in the classroom an understanding of and the ability to use the conventional algorithm for division of up to a three-digit whole number with a single-digit divisor (with or without remainders). | None | None | |

4.N.16 | Round whole numbers through 100,000 to the nearest 10, 100, 1000, 10,000, and 100,000. | User:ossfm | Hop-A-Round | |

4.N.17 | Select and use a variety of strategies (e.g., front-end, rounding, and regrouping) to estimate quantities, measures, and the results of whole-number computations up to three-digit whole numbers and amounts of money to $1000, and to judge the reasonableness of the answer. | None | None | |

4.N.18 | Use concrete objects and visual models to add and subtract common fractions. | None | None |

#### Patterns, Relations, and Algebra

Students engage in problem solving, communicating, reasoning, connecting, and representing as they:

Id | Standard Description | Who's working on The activity? | What Sugar activity satisfies this objective? | What Information does Teacher Reporting App need? |
---|---|---|---|---|

4.P.1 | Create, describe, extend, and explain symbolic (geometric) and numeric patterns, including multiplication patterns like 3, 30, 300, 3000, …. | Adam Schreiber, User:Dfu | Deka | |

4.P.2 | Use symbol and letter variables (e.g. v, x) to represent unknowns or quantities that vary in expressions and in equations or inequalities (mathematical sentences that use =, <, >). | None | None | |

4.P.3 | Determine values of variables in simple equations, e.g., 4106 – x = 37, 5 = y + 3, and s – y = 3. | User:Gdk (developer),User:Rholden | https://fedorahosted.org/dungeonsofmongo/ | |

4.P.4 | Use pictures, models, tables, charts, graphs, words, number sentences, and mathematical notations to interpret mathematical relationships. | None | None | |

4.P.5 | Solve problems involving proportional relationships, including unit pricing (e.g., four apples cost 80¢, so one apple costs 20¢) and map interpretation (e.g., one inch represents five miles, so two inches represent ten miles). | None | None | |

4.P.6 | Determine how change in one variable relates to a change in a second variable, e.g., input-output tables. | User:Rholden | None |

#### Geometry

Students engage in problem solving, communicating, reasoning, connecting, and representing as they:

Id | Standard Description | Who's working on The activity? | What Sugar activity satisfies this objective? | What Information does Teacher Reporting App need? |
---|---|---|---|---|

4.G.1 | Compare and analyze attributes and other features (e.g., number of sides, faces, corners, right angles, diagonals, and symmetry) of two- and three-dimensional geometric shapes. | None | None | |

4.G.2 | Describe, model, draw, compare, and classify two- and three-dimensional shapes, e.g., circles, polygons- especially triangles and quadrilaterals—cubes, spheres, and pyramids. | None | None | |

4.G.3 | Recognize similar figures. | None | None | |

4.G.4 | Identify angles as acute, right, or obtuse. | None | None | |

4.G.5 | Describe and draw intersecting, parallel, and perpendicular lines. | None | None | |

4.G.6 | Using ordered pairs of numbers and/or letters, graph, locate, identify points, and describe paths (first quadrant). | Matthew Daniels, Rob Seay | Nevhma (Under construction) | |

4.G.7 | Describe and apply techniques such as reflections (flips), rotations (turns), and translations (slides) for determining if two shapes are congruent. | None | None | |

4.G.8 | Identify and describe line symmetry in two-dimensional shapes. | None | None | |

4.G.9 | Predict and validate the results of partitioning, folding, and combining two- and three-dimensional shapes. | None | None |

#### Measurement

Students engage in problem solving, communicating, reasoning, connecting, and representing as they:

Id | Standard Description | Who's working on The activity? | What Sugar activity satisfies this objective? | What Information does Teacher Reporting App need? |
---|---|---|---|---|

4.M.1 | Demonstrate an understanding of such attributes as length, area, weight, and volume, and select the appropriate type of unit for measuring each attribute. | None | None | |

4.M.2 | Carry out simple unit conversions within a system of measurement, e.g., hours to minutes, cents to dollars, yards to feet or inches, etc. | None | None | |

4.M.3 | Identify time to the minute on analog and digital clocks using a.m. and p.m. Compute elapsed time using a clock (e.g., hours and minutes since…) and using a calendar (e.g., days since…). | None | None | |

4.M.4 | Estimate and find area and perimeter of a rectangle, triangle, or irregular shape using diagrams, models, and grids or by measuring. | None | None | |

4.M.5 | Identify and use appropriate metric and English units and tools (e.g., ruler, angle ruler, graduated cylinder, thermometer) to estimate, measure, and solve problems involving length, area, volume, weight, time, angle size, and temperature. | None | None |

#### Data Analysis, Statistics, and Probability

Students engage in problem solving, communicating, reasoning, connecting, and representing as they:

Id | Standard Description | Who's working on The activity? | What Sugar activity satisfies this objective? | What Information does Teacher Reporting App need? |
---|---|---|---|---|

4.D.1 | Collect and organize data using observations, measurements, surveys, or experiments, and identify appropriate ways to display the data. | None | None | |

4.D.2 | Match a representation of a data set such as lists, tables, or graphs (including circle graphs) with the actual set of data. | None | None | |

4.D.3 | Construct, draw conclusions, and make predictions from various representations of data sets, including tables, bar graphs, pictographs, line graphs, line plots, and tallies. | None | None | |

4.D.4 | Represent the possible outcomes for a simple probability situation, e.g., the probability of drawing a red marble from a bag containing three red marbles and four green marbles. | None | None | |

4.D.5 | List and count the number of possible combinations of objects from three sets, e.g., how many different outfits can one make from a set of three shirts, a set of two skirts, and a set of two hats? | None | None | |

4.D.6 | Classify outcomes as certain, likely, unlikely, or impossible by designing and conducting experiments using concrete objects such as counters, number cubes, spinners, or coins. | None | None |

## "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.

In order to run this script (parser.awk) issue the command,

awk -f parser.awk students.dat

## Teachers guide

Student.dat file fields:

MAC-ADDRESS STUDENT_NAME OPERATION CORRECT

Example:

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

Ouput Example:

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

*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: 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: OLPC-School-Server-0.5.2-dev01-i386.img.gz
- Un-compress the file
- In Windows, WinRAR worked well.
- In Linux, this command works just as well
gzip -d OLPC-School-Server-0.5.2-dev01-i386.img.gz

##### 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

fdisk /dev/sd*1 or fdisk /dev/mmcblk*p1

- 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,

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

- This will take some time depending on the system performance.

- Use resize2fs to re-size the partition

resize2fs -p /dev/sd*1 or resize2fs -p /dev/mmcblk*p1

##### Getting a Developer Key

- First the XO must have a 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:
ok disable-security

- 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:

ok disable-security No wp tag

##### 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:

ok boot sd:\boot\olpc.fth

- 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:

b301: mmcblk0p1

- 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 SD Booting.

- You'll see a line like this:

" ro root=mmcblk0p1 rootdelay=1 console=ttyS0,115200 console=tty0 rootfstype=ext2 fbcon=font:SUN12x22" to boot-file

- 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:

ok boot sd:\boot\olpc.fth

##### 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.

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