/Auto-DIG

Repository for current version of Automated Assessment Generation for College Algebra at the University of Florida.

Primary LanguageTeXGNU General Public License v3.0GPL-3.0

Welcome!

This repository is a work-in-progress on automatically generating assessments in a College Algebra course. By automatically, we mean that assessments are generated (via a combination of technology) with little input from the user. This is achieved by front-loading the creation of question structures and associated conceptions/errors that are later called by a shell script to create PDF versions of assessments for instructors to utilize in the classroom. Published and under-review articles on this project are housed here. The related project, an open-source College Algebra online homework system, is housed here.

No coding experience is required to use this work as-is. The GUI is currently written using Zenity and thus works best on Linux. This project will eventually move to a cross-platform application for widespread use.

Steps to create the desktop app for Ubuntu.

  1. Download the necessary open-source programs: Python and LaTeX.

    This code uses Python and LaTeX to create the questions and compile the questions into a PDF assessment. Both are open-source and available on Windows, Mac, and Linux.

  2. Clone the repository.

    We suggest downloading the repository to a folder in your home directory. As we use many git repositories, we have a git-repos folder in the home directory that we put any downloaded repositories (like this one) in. Instructions on how to clone a repository can be found here. If you choose not to do this, remove "git-repos" from the next instructions.

  3. Run the installer shell script install_AutoDIG via terminal.

    1. Navigate to the ShellScripts folder. If you took our suggestion, this can be done with: cd ./git-repos/Auto-DIG/ShellScripts/
    2. Make the installer shell script executable. sudo chmod +x ./git-repos/Auto-DIG/ShellScripts/install_AutoDIG.sh
    3. Run the installer. ./git-repos/Auto-DIG/ShellScripts/./install_AutoDIG.sh

    The first step is necessary just in case you have a different directory structure where you downloaded the Auto-DIG folder.

  4. Right-click desktop app and Trust this executable.

This will bring up the GUI to guide you through the rest of the process. If all goes well, the collection of PDFs are available in the CompleteExam folder! This folder should open immediately after the code has finished.

Contribute to this project!

If you would like to contribute to the creation of the assessments, please contact Darryl Chamberlain Jr. at dchamberlain31@ufl.edu.