.. title: Eyegrade: grading multiple choice exams with a webcam
.. slug: index

.. class:: lead

Eyegrade uses a webcam to grade multiple choice question exams.
Needing just a cheap low-end webcam,
it aims to be a low-cost and portable alternative
to other solutions based on scanners.


.. class:: alert alert-info sidebar

Latest version
---------------

The latest available version is
**Eyegrade 0.9**,
which was released on January 17, 2022.


.. class:: alert alert-info sidebar

News
------------

.. |rssicon| image:: rss-icon.png
             :height: 1em
             :target: blog/rss.xml

|rssicon| `Subscribe <blog/rss.xml>`_
| `Read more news at the blog <blog/index.html>`_


**[Jan 17, 2022]**
Eyegrade 0.9 has been released!
See the `blog post <blog/posts/eyegrade-09-released/>`__
or go to the `downloads page <download/>`__.

**[Mar 29, 2019]**
Eyegrade 0.8.1 has been released!
See the `blog post <blog/posts/eyegrade-08-released/>`__
or go to the `downloads page <download/>`__.

**[Jan 25, 2018]**
A user from Vietnam has contributed with a nice video tutorial.
It's linked from the `documentation page <documentation/>`__.
See the `blog post <blog/posts/new-video-tutorial/>`__.



Main features
--------------------------

The main features of Eyegrade are:

- **Grading the exams:**
  By using a webcam,
  the graphical user interface of Eyegrade
  allows you to grade your exams.
  Eyegrade is able to recognize not only the answers to the questions,
  but also the identity of the student
  by using its hand-written digit recognition module.
  The whole process is supervised by the user
  in order to detect and fix potential detection errors.

- **Exporting grades:**
  Grades can be exported in CSV format,
  compatible with other programs such as spreadsheets.

- **Typesetting the exams:**
  Although you can create your exams with other tools,
  Eyegrade integrates an utility to creating MCQ exams.
  It is able to create your exams in PDF format.
  Eyegrade can automatically build several versions of the exam
  by shuffling questions and the choices within the questions.

Here is a short demonstration video of an early version of Eyegrade.
Please note that the user interface has been greatly improved since then:

.. raw:: html

         <iframe width="360" height="270"
                 src="https://www.youtube.com/embed/ajK9JAhsDH0"
                 frameborder="0" allowfullscreen></iframe>

And here is a more current screenshot:

.. figure:: /galleries/screenshots-05/change-id-preview.png
   :class: thumbnail
   :alt: A screenshot of Eyegrade.




Trying Eyegrade
------------------

Eyegrade has been used in several courses
at `Universidad Carlos III de Madrid <http://www.uc3m.es>`_
since 2010,
as well as in other institutions worldwide.
Follow the `quick start guide <quick-start-guide/>`_
if you want to give it a try.


How can you contribute?
--------------------------

Eyegrade is free software, licensed under the terms of the
`GNU General Public License (GPL) version 3
<http://www.gnu.org/licenses/gpl-3.0.html>`_
or any later version.

The source code of Eyegrade
is hosted at
`Github: jfisteus/eyegrade
<https://github.com/jfisteus/eyegrade>`_.
Bug reports, feature requests and pull requests are welcome there.



How can you cite this work from academic papers?
-----------------------------------------------------

An article describing Eyegrade has been published
by the Journal of Science Education and Technology:

Jesus Arias Fisteus, Abelardo Pardo and Norberto Fernández García,
*Grading Multiple Choice Exams with
Low-Cost and Portable Computer-Vision Techniques*.
Journal of Science Education and Technology.
`doi:10.1007/s10956-012-9414-8 <http://dx.doi.org/10.1007/s10956-012-9414-8>`_

Please, cite the paper if you use Eyegrade for research activities.