Skip to content

nerissa23/G12-MktTeam

Repository files navigation

RajaMark User Manual Documentation

Table of Contents
  1. Introduction
  2. Getting Started
  3. Features
  4. Troubleshooting
  5. Best Practices
  6. Glossary
  7. Appendix

1.0 Introduction

Meet RajaMark, your reliable helper to automate the grading of multiple-choice question (MCQ) answer sheets. By leveraging Tesseract OCR for handwritten text recognition and OpenCV for image preprocessing, RajaMark can swiftly and accurately interpret handwritten answers (A-E) beside question numbers. This automation eliminates the tedious and error-prone manual grading process, making it ideal for educational institutions seeking a more efficient grading solution.

In addition to grading, RajaMark offers tools to compile class results, allowing educators to aggregate individual scores and generate comprehensive reports on class performance in quizzes and tests. This feature helps teachers quickly identify trends and areas for improvement, streamlining the assessment process. Overall, RajaMark is a valuable resource for schools and universities aiming to improve the speed and accuracy of MCQ evaluation while reducing the workload on educators.


2.0 Getting Started

2.1 Operating System Requirements

RajaMark requires (either one):

  • the 64-bit version of Microsoft Windows 10 or later. These versions of Windows should include the required Windows PowerShell 5 or later.
  • ChromeOS.

2.2 Installation Steps

To install RajaMark:

  1. Click here to access our Google Drive.
  2. Download the .exe file.
  3. Click the .exe file and allow it to make changes to your computer for execution.
  4. You are all set.

2.3 Account Setup

2.3.1 Register

  1. Upon first launch into the system, you will be asked to enter your email and password to log into your existing account in the Login page.

  1. If you have not set up an account before, click the “Don’t have an account? Register here” button. If you have already registered an account, go to Login.

  1. You will be asked to give your email and password that you intend to use. Upon completing the registration, you will have to enter your password once again for confirmation.

  1. Click the “Register” button once you have filled in the required information for registration.

  2. You will be redirected to the Login if you have registered successfully.

2.3.2 Login

  1. In the Login page, fill in your email or username and password then click on the “Log in” button.

  1. If you have forgotten your password and wish to create a new one, proceed to Forgot Password.

2.3.3 Forgot Password

  1. Click on the “Forgot Password?” button.

  1. Enter your registered email address to receive a password reset link to change your password.

  1. You will be shown with this message if you have entered a valid email address.

2.3.4 Logout

  1. After successfully logged in, you will now see the Homepage (dashboard page) like the picture below:

  1. If you wish to log out, navigate to the navigation bar located at the leftmost of the screen and click on the “LogOut” button. You will then be redirected to the Login page again.

2.4 Navigation

  1. Exam Page

The Exam Page contains all exams that have been created. The exams can be edited or deleted from this table. The date of creation will also be displayed on this page. It is also possible to create a new exam from this page.

  1. User Manual Page

The User Manual Page contains the documentation of the user manual that provides detailed instructions on how to use this system effectively.

  1. LogOut

Navigate to the navigation bar located at the leftmost of the screen and click on the “LogOut” button if you wish to log out from your account.


3.0 Features

3.1 Exam Creation

  1. Go to the Exam page.
  2. Click on the “Create” button to create a new examination/quiz.

  1. Enter the examination’s details and grading’s criteria.

  1. Scroll down to enter the answer scheme.

  1. Click the “save” button to create the examination record.
  2. The examination record is successfully created.

3.2 Edit Examination

  1. Go to the Exam page.
  2. Click on the “edit” icon for the specific exam to be edited.

  1. Enter the changes required in the Edit Exam page.

  1. Scroll down and click the “save” button to apply the changes.

3.3 View Exam's details

  1. Go to the Exam page.
  2. Click on the “eye” icon for a specific exam to view the exam’s details.

  1. You will be directed to the Exam Details page.

3.4 Manage student's answer

  1. Go to the Exam page.
  2. Click on the “eye” icon to view the exam’s details.

  1. Once redirected into the Exam Details page, navigate to the list of students’ records and click on the “eye” icon to view the student’s details, “note” icon to edit the student's details or “trash” icon to delete the student's information.

  1. On the Student’s Details page, click the “Edit Result” button to make changes to the student's details.

3.5 Upload Sample Answer

  1. Go to the Exam page.
  2. Click on the “eye” icon to view the exam’s details.

  1. Click on the “Upload answer” button to upload the sample answer scheme.

  1. Once redirected into the Answer Scheme page, click the “+” icon to upload the sample answer scheme.

  1. Upload the answer scheme file.

  1. If the image processing fails, try to upload another file with a clearer view of the answer scheme.

  1. Wait for the file to be processed.

  1. Click the “confirm” button to apply the answer scheme.

3.6 Upload Student Answer

  1. Go to the Exam page.
  2. Select the exam you wish to grade.

  1. In the student column, locate and click the "Add" button to input student data.

  1. Enter the student's ID and name into the designated fields.
  2. Click the "Upload" button to update the student's answer sheet.

  1. To add the student's answer sheet, either drag a file or use the "Choose files" option to select the file from your computer.
  2. After selecting a file, refer to Image Preprocessing for more details.

  1. The student's details will be displayed on the page for confirmation.
  2. Repeat steps 2 to 7 to add more students as necessary.
  3. Once you have finished adding all students, click the "Save" button to save the student records.

3.7 Image Preprocessing

  1. Once a file is selected for upload, the system will begin processing the image.

  1. After successful processing, users are required to enter a file name for saving and the author's name. (In case of processing failure, refer to Troubleshooting for more info)
  2. Click on "Extract this file" to initiate OCR processing.

  1. The system will commence extracting text from the image.

  1. Upon successful extraction, the extracted text (answers) will be displayed.
  2. If the extracted data is incorrect, users may request a reupload. Otherwise, proceed to Step 7 of Upload Student Answer if no issues arise.

3.8 Score Calculation and Reporting

  1. Go to the Exam page.
  2. Select the eye icon of the exam you wish to view.
  3. Upon uploading students' answers, the system will automatically calculate the score for each student and calculate the mean and median score of the class. (Refer to Upload Student Answer to know more about uploading student’s answer)
  4. To generate a report, click on the "Generate Report" button.
  5. The report will include statistical measures such as the median, mean, and other relevant statistics.

4.0 Troubleshooting

4.1 Common Issues

NO Issues Issue Description Solution
1 Poor Image Quality OCR accuracy may decrease if the input images are of low resolution or contain artifacts such as blurriness or distortion. Ensure that input images are clear, well-lit, and have sufficient resolution. Avoid using images with excessive noise or compression artifacts.
2 Unsupported Fonts Certain fonts or styles may not be recognized accurately by the OCR system, leading to errors in text extraction. Whenever possible, use standard fonts and avoid decorative or obscure fonts that may not be recognized reliably by the OCR system.
3 Complex Layouts Documents with complex layouts, such as tables, columns, or mixed fonts, can pose challenges for OCR algorithms and result in incorrect text extraction. If possible, preprocess documents to remove complex layouts or convert them into simpler formats before performing OCR. This can help improve accuracy and reduce errors.
4 Handwritten Text Our product is encountering difficulties accurately recognizing handwritten text For handwritten text, please ensure that the handwriting is clear and legible, and that the document is properly scanned or photographed for optimal results.

4.2 Support Contact

If you encounter any issues with the OCR system that cannot be resolved using the provided solutions, please contact our support team for assistance:

Email: [[email protected]]([email protected])


5.0 Best Practices

5.1 Student Answer Guidelines

  1. Student names and student IDs do not need to follow a specific order. Either one can be written first.
  2. The system will recognize student names and IDs after the colon (:) symbol. Avoid using other symbols such as arrows (->) or hyphens (-) before writing the name and ID.
  3. The phrases "Student Name" and "Student ID" are case-insensitive. You can write them as "sTuDeNt nAmE" or "sTUDENT ID", and the system will still recognize them.
  4. Student Name and Student ID must be written in a single line only.
  5. Student answers must be written in vertical format and each answer is separated by a new line.
  6. For best OCR text extraction, use white blank paper only instead of foolscap paper or grid-lined paper.

5.2 Grading Tips

  1. Ensure students format answers consistently and legibly to aid OCR accuracy.

  1. Advise clear separation of answers for each question to minimize ambiguity.

  1. Caution against overlapping answers to enhance OCR interpretation.

  1. Scan answers at high resolution in well-lit conditions for optimal recognition.
  2. Encourage manual review of extracted text for clarity before submission.
  3. Ensure students use dark, bold pens or pencils for writing to improve OCR readability.

  1. Remind students to avoid excessive use of decorative elements or symbols that may interfere with OCR recognition.

  1. Provide guidelines for students to write numbers and symbols clearly, especially those prone to misinterpretation.
  2. Advise against folding or creasing answer sheets, as it can distort text and hinder OCR accuracy.
  3. Recommend students to use a ruler or straight edge for neat alignment of answers to improve OCR alignment.

Accuracy Recommendations

  1. Provide clear handwriting guidelines to optimize OCR recognition; for example, require all multiple-choice answers to be in capital letters.
  2. Conduct regular practice sessions to familiarize students with handwriting recognition and improve their writing.
  3. Offer constructive feedback to students to enhance handwriting quality and OCR accuracy.
  4. Provide comprehensive user training to educators to address accuracy challenges effectively.
  5. Develop a standardized answer sheet template with clear instructions and designated areas for answers to facilitate OCR processing.
  6. Encourage students to practice writing in a consistent style and size to aid OCR recognition.

6.0 Glossary

Term Definition
Optical Character Recognition (OCR) The technology used to convert different types of documents, such as scanned paper documents, PDF files, or images captured by a digital camera, into editable and searchable data.
Resolution The level of detail that an image holds. In the context of scanning, it measures the number of pixels per inch (PPI) or dots per inch (DPI) in a digital image.
Layout The arrangement of text, images, and other elements on a document or webpage.
Handwriting Recognition The process of converting handwritten text into digital text. It involves analyzing and interpreting handwritten characters to recognize and convert them into machine-readable text.
Calibration The process of adjusting and fine-tuning equipment or software to ensure accuracy and consistency in performance. In the context of scanning, calibration may involve adjusting settings such as brightness, contrast, and color balance to optimize image quality.
Standardized Format A predefined layout or structure that follows specific guidelines or conventions. In the context of answer sheets, a standardized format ensures consistency in the presentation of questions and answers, facilitating accurate interpretation and grading.
Alignment The positioning of text or objects relative to a reference point or line. In the context of OCR, alignment ensures that text is accurately detected and interpreted within predefined boundaries or regions.
Noise Random variations or interference in an image that can degrade quality and affect OCR accuracy.
Preprocessing The process of applying various techniques to raw data, such as images or text, to improve quality, enhance features, or prepare it for further analysis.

7.0 Appendix

7.1 Frequently Asked Questions

1. Which platforms are RajaMark compatible with?

A: RajaMark is designed to be compatible with multiple operating systems, which are Windows, macOS, Linux, Android and iOS.

2. How does RajaMark automate answer sheet grading?

A: RajaMark assumes the adherence of the answer sheets uploaded to a standardized format and layout, and conducts recognition of students’ handwriting with OCR technology to compare the answers with the sample provided.

3. What format should the answer sheets uploaded be in?

A: The answer sheets should have the answers consistently written next to the corresponding question numbers in a predetermined manner and written in Capital Letters (e.g., letters A-E)

4. How does RajaMark ensure its accuracy in text recognition to compare uploaded answer sheets with the sample answers?

A: While we try our best to produce the most accurate text recognition results using OCR technology, it is inevitable to face minor inaccuracies in detecting the handwritten answers. Hence, we highly advise users to conduct a thorough checking of the graded answers and make the necessary corrections on the Student Answer Page.

5. Can I modify the grading system for a subject?

A: Yes! After the user has created a subject under the Exam Details page, a default grade will be automatically set for the subject and users can click “Edit” to amend the existing grading system.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 7