Current version: 1.7, released March 10, 2009. Change Log. Download from . Also available through Subversion at Google Code
IMathAS is an Internet Mathematics Assessment System. It is primarily a
web-based math assessment tool for delivery and automatic grading of math homework
and tests. Questions are algorithmically generated and numerical and math expression
answers can be computer graded. Beyond that, IMathAS includes learning management tools,
including posting of announcements, text files, and attachments, as well as discussion
forums and a full gradebook. In postings and assessments, IMathAS allows accurate display
of math and graphs, with simple calculator-style math entry and point-and-click graph
creation. It is most similar to (and inspired by) WebWork
and WIMS, and similar to commercial and publisher-produced systems
like iLrn, MathXL, WebAssign, etc.
IMathAS was written by David Lippman (c) 2006-2009,
with with partial support from the
WA State E-Learning Council, the
Transition Math Project, and
Pierce College. It is distributed under
the GPL. See the license.txt file distributed with IMathAS for more details
and credits for components attributed to others.
IMathAS's second home, running a more up-to-date demo, can be found at www.imathas.com.
A full production installation (also with a demo login available) is at www.wamap.org.
Log in to IMathAS.
Want to try a demo as a student? Click on the link above and log in as "student" with password "student".
Want to try it out as an instructor? Click on the link above, and Sign up as a new user. You will be granted
Limited Course Creator rights. If you want to see your work from a student perspective, log in as "teststudent" with password "password",
and enroll the teststudent in your course
Want to try it out with students? I can't do that on SourceForge, but head over to www.imathas.com and
request an instructor account to try out the system with your students on a short-term basis. Free hosting for Washington State
teachers is available at www.wamap.org.
With permission from the creators of WebWork from the Univ of Rochester, I've begun translating the Univ of Rochester WebWork question
library into IMathAS. So far about 1500 question have been translated from the Algebra, Trig, Differential Calculus, Integral Calculus, and
Sequences and Series sets. Download the WebWork sets. An additional 5000+ questions have been created by
Looking for Help? Support can now be found at www.imathas.com
New Installers: some example questions are included with the distribution. There are some more questions available by contacting me.
Also, since this program is mainly being used in my production server, I would love to know who else is using it and get feedback; please send me an email
IMathAS was built on three primary philosophies:
- Math: The system was designed for Math assessment; no effort was made for the system to be multi-purpose.
- Sharing: The system was setup to encourage sharing of questions within a system and outside. Questions are grouped into
question libraries, and are not tied directly to a specific assessment. Unless marked Private, questions can be used by
anyone on the system, or used as a template for writing new questions. Assessments and course setups can be copied
between users with permission. Export and Import allows the
sharing of question sets between systems. Also, macro libraries allow for the expansion of IMathAS's question language.
Users with expertise in a field can develop macro extensions, and share them with other users.
- Ease of Install: The system uses standard PHP and MySQL. It requires no special compilation options or installation
of external programs.
Core Features include:
- Rich Math and Graph display, using standards-based MathML and SVG, powered
by Peter Jipsen's ASCIIsvg and
ASCIIMathML, or using image fallbacks
- Rich Text Editor with built-in Math and Graph support for text items displayed in a course and forum posts
- Alternate display options for screenreaders and browsers without needed support
- Question types including:
- Functions, with answers like "sin(x)"
- Numbers, compared to a given tolerance
- Calculated Numbers, like 5/3 or 2^5
- Essay (not computer graded)
- Numerical Matrix
- Calculated Matrix
- Calculated Interval
- Drawing / Graphing
- File Upload
- Multiple display options and assessment settings, including an option for practice sets, and
due date exceptions for individual students
- Algorithmically generated questions, with a relatively simple-to-use question language
(loosely based on PHP) with many built-in randomizers and display macros
- Group assessments
- Expandable question language, by installing additional macros
- Other Course Features:
- Post text items, uploaded files, or web links to the classroom
- Discussion Forums, optionally gradable
- Full gradebook with support for online and offline grades and flexible grading schemes
- Flexible administration: IMathAS can be centrally administered,
or teachers can be given rights to create their own courses
- Teachers can be grouped by school or other division, with one or more group administrators
- Courses can have one or more teachers
- Experimental support for SimpleLTI, both as a consumer and producer
- Experimental Google gadget for listing messages and forum posts
For details on how the system works, look over the Help File or view
training and support resources.
Why a new system
You may be wondering why another system, when excellent systems already exist.
For my purposes, WebWork and WIMS were too difficult to install (since I don't have direct
access to my school's webserver). I didn't want to use commercial or publisher produced systems
because I don't want students with used books to incur additional cost.
- Download IMathAS, extract it, and copy the files to your webserver.
- If your web host requires that you create databases through the web panel, create a database
and database user for IMathAS now. If you have a username/password with database
creation priviledges, you can wait and use it later in the install process.
- Open a browser and access install.php. This script will write the config.php file, change directory
permissions, copy distribution files, and set up the database. At the end of the install you
will be given the opportunity to install a small set of example questions.
- Log into IMathAS. If you didn't change the
initial imathas user settings when running install.php, log in as 'root' with password 'root'.
If you did not change the inital imathas user settings, click the "Change Password"
link now to change the password to something substantial. Alternatively, you can
go into the Admin page, create a new user with Admin rights, then delete the 'root'
- Edit loginpage.php and infoheader.php if desired. If you plan to use the new instructor account
request page, edit newinstructor.php
If you are upgrading from IMathAS 1.6 or later, access update.php to install any new database changes
and learn about any other changes necessary. If you are upgrading from a version earlier
than 1.6, you'll need to manually apply changes from the upgrade.txt file.
PHP 5 and MySQL 4+ are recommended. Most of the system will work with PHP 4.2+
and MySQL 3.23, but future compatibility is not guaranteed.
PHP with GD2 and Treetype are recommended for best image-based graph support
An installation serving 2500+ students
with 80+ concurrent users has operated well on a commercial shared web server.
IMathAS uses a standard databased-stored sessions-based system. If a user does
not log out, the session is cleared from database after 24 hours.
Questions (written by teachers) are passed through an interpreter that only allows
authorized functions to be used. Student answers are evaluated client-side using
Macro Libraries (PHP function libraries that can be used in writing questions)
can only be installed by full Admins in IMathAS. The option allowing install can be
disabled in the config.php file
The install.php script automatically handles the following install steps. They're
listed here in case anything goes wrong:
- Change permissions (chmod) of the following directories to allow the webserver process
to write to the directories:
- Rename (in the main directory):
- config.php.dist to config.php
- infoheader.php.dist to infoheader.php
- loginpage.php.dist to loginpage.php
- newinstructor.php.dist to newinstructor.php
- Edit config.php. Change these options to your liking:
- $dbserver: The address of your database server. Probably www.yoursite.edu or localhost
- $dbname: The name of the IMathAS database
- $dbusername: The username of the IMathAS database user.
- $dbpassword: The password for the IMathAS database user. Choose something really complicated
- $installname: The name of your installation, for personalization.
- $longloginprompt: How you want to prompt new students for a username
- $loginprompt: How you want to prompt students for a username
- $loginformat: Enforce a format requirement on the username
- $emailconfirmation: If set to true, new users will have to respond to an email sent by the system
before being able to enroll in any classes
- $sendfrom: An email address to send confirmation and notification emails from.
- $imasroot: The web root of the imathas install (ie, http://yoursite.edu $imasroot)
- $mathimgurl: An absolute path or full url to a Mimetex CGI installation, for math image fallback
- $colorshift: Whether icons should change colors as due date approaches. I thought this was cute,
but others might find it annoying
- $smallheaderlogo: Text or an HTML image tag for a small (120 x 80) logo to display at the top right of
- $allownongrouplibs: Whether non-admins should be allowed to create non-group libraries.
On a single-school install, set to true; for larger installs that plan to
use the Groups features, set to false
- $allowcourseimport: Whether anyone should be able to import/export questions and libraries from the
course page. Intended for easy sharing between systems, but the course page
is cleaner if turned off.
- $allowmacroinstall: Whether admins should be able to install macro files. Macros files hold a large
security risk, and should only be installed from trusted sources. For a single-admin system, it is
recommended that you leave this as false, and change it when you need to install a macro
- $sessionpath: change the session file path different than the default.
This is usually not necessary unless your site is on a server farm, or
you're on a shared server and want more security of session data
- $mathchaturl: a URL to the live chat server. Leave unchanged to use the local install's
server. Comment out to disable the chat server. You can also use a different install to
offload chat on a different server
- $enablesimplelti: Set to true to enable use of IMathAS as a SimpleLTI producer.
- $AWSkey,$AWSsecret,$AWSbucket: To allow students and teachers to upload files through
the text editor, and to enable file upload questions, this specifies an Amazon S3
key, secret, and bucket to use for file storage. Local storage is not yet implemented.
- Run the dbsetup.php script (access http://yoursite.edu $imasroot/dbsetup.php), or send it
to your system administrator and ask them to run it, if you don't have creation access
to the database server. Alternatively, have your system administrator create a database and database user,
and use these names in the config.php file before running dbsetup.php. This script sets up the necessary database user, database, and tables for IMathAS.