Content of this document
Timeline of an Artemis Online Exam
1. Creation and Configuration
During the exam creation and configuration, you can create your exam and configure it to fit your needs. Add exercises with different variants, register students, generate student exams and conduct test runs. For more information see 1.2 Create and Configure Exam.
1.1 Accessing the Exam Management Page
Log in to Artemis with your account credentials.
Click on .
Click on for your course. It will open the Exam Management Screen.
Here you have access to all the exams of your course. All aspects of the exam are managed from the management screen.
You can create an exam by clicking on .
1.2 Create and Configure Exam
When you click on you are presented with the Create Exam view. Here you can set the basic information such as
examineretc. The timeline of the exam is defined by the dates:
start of working time,
end of working time,
release date of results,
begin of student review,
end of student review.
The first three dates are mandatory when you create an exam. The rest can be set when required.
grace perioddefines the amount of time the students have at their disposal to hand in their exam after the
working timeis over. This is set to 3 minutes by default.
Before the exam’s assessment you can choose the
Number of correction rounds in exam. If you want two tutors to assess a student’s exam subsequently, set the number to two here. This enables the second correction.
You can also define the
number of exercisesin the exam. You can leave this out initially, however it must be set before you can generate the student exams. For more information, see 1.3 Exercise Groups.
Artemis will randomize the order of the exercises for each student if you activate
randomize order of exercise groups.
Finally, you can fill out the exam
end text. Artemis will present these texts to the students during the exam conduction, at the Start- and End page respectively.
1.3 Exercise Groups
Artemis exam mode allows you to define multiple exercise variants so that each student can receive a unique exam. Artemis achieves this through exercise groups. Exercise groups represent an individual exercise slot for each student exam. Within one exercise group you can define different exercises.
Artemis selects one exercise per exercise group randomly, to generate the individual student exams.
You can distinguish between mandatory exercise groups and non-mandatory exercise groups.
Artemis always includes mandatory exercise groups in the individual exam of a student.
Non-mandatory exercise groups can be left out, if there are more exercise groups than the
number of exercisesdefined in the exam configuration.
By default, every exercise group is mandatory. You can set the
mandatoryflag when you add an exercise group initially, or later by clicking on the exercise group.
1.4 Add Exercises
Exercise groups can contain multiple exercises. For every student exam, Artemis will randomly select one exercise per exercise group.
If you want all student to have the same exam, define only one exercise per exercise group.
To add exercises navigate to the Exercise Groups of the exam. On the header of each exercise group you will find the available exercise types. You can choose between
creating a new exerciseor
importing an existing onefrom your courses.
For exercise types
modelingyou can also define example submissions and example assessments to guide your assessor team.
Assessors will review the example submissions and assessments in order to familiarise themselves with the exercise and assessment instructions, before they can assess the real submissions.
1.4.1 Programming Exercises
Programming exercises have multiple special options to adjust their behaviour:
You can check the option to
allow manual assessment.
If you do not set this flag, your assessors will not be able to manually assess the student’s submissions during the assessment process.
You can activate
Run Tests once after Due Date. This will compile and run the test suite on all the student submissions once after the set date.
After you add a programming exercise you can configure the grading via .
In the Configure Grading screen, you can tweak the
weightof the tests, the
bonus multiplierand add
You can hide tests so that they are not executed during the exam conduction. Students can not receive feedback from hidden tests during the exam conduction.
If you hide all tests, the students will only be able to see if their submission compiles during the conduction. Set the
Run Tests once after Due Dateafter the exam end date to achieve this effect.
1.5 Register Students
To register students to the exam, navigate from the exam management to the Students page. Artemis offers two options to register students. You can:
Add students manually by searching via the search bar.
Bulk import students using a
CSVfile. You can do this by pressing the button.
Register every student in the course. You can do this by pressing the button.
Just registering the students to the exam will not allow them to participate in the exam. First, individual student exams must be generated.
You can also remove students from the exam. When you do so, you have the option to also delete their participations and submissions linked to the user’s student exam.
1.6 Manage Student Exams
Student exams represent the exam of a student. It consists of an individual set of exercises based on the configured exercise groups.
Student exams are managed via the Student Exams page.
Here you can have an overview of all student exams. When you press
Viewon a student exam, you can view the
details of the student, the allocated
working time, their
participation status, their
summary, as well as their
scores. Additionally, you will also be able to view which assessor is responsible for each exercise.
You can change the individual working time of students from here. The screenshot Individual Working Time below shows where you can do that.
To generate student exams you must click on . This will trigger Artemis to create a student exam for every registered user.
Artemis determines the number of exercises from the exam configuration and randomly selects one exercise per exercise group.
button will be locked once the exam becomes visible to the students. You cannot perform changes to student exams once the exam conduction has started.
If you have added more students recently, you can choose to .
creates a participation for each exercise for every registered user, based on their assigned exercises. It also creates the individual repositories and build plans for programming exercises. This action can take a while if there are many registered students due to the communication between the version control (VC) and continuous integration (CI) server.
You must trigger before the exam conduction begins.
On the Student Exams page, you can also maintain the repositories of student exams. This functionality only affects programming exercises. You can choose to and all student repositories.
Artemis locks and unlocks the student repositories automatically based on the individual exam start and end date. These buttons are typically not necessary unless something went wrong.
1.7 Conducting Test Runs
Test runs are designed to offer the instructors confidence that the exam conduction will run smoothly. They allow you to experience the exam from the student’s perspective. A test run is distinct from a student exam and is not taken into consideration during the calculation of the exam scores.
You can manage your test runs from the Test Run page.
To create a new test run you can press . This will open a popup where you can select an exercise for each exercise group. You can also set the
working time. A test run will have as many exercises as there are exercise groups. It does consider the
number of exercisesset in the exam configuration.
Exercise groups with no exercises are ignored.
When you start the test run, you conduct the exam similar to how a student would. You can create submissions for the different exercises and end the test run.
An instructor can also assess his test run submissions. To do this, you must have completed at least one test run. To navigate to the assessment screen of the test runs click .
Only the creator of the test run is able to assess his submissions.
You can view the results of the assessment of the test run by clicking on . This page simulates the Student Exam Summary where the students can view their submissions and the results once they are published.
Here instructors can also use the
complaintfeature and respond to it to conclude the full exam timeline.
You should delete test runs before the actual exam conduction takes place.
1.8 Exam Checklist
After you create an exam, the exam checklist appears at the top of the exam’s detail page.
The exam checklist helps you oversee and ensure every step of the exam is executed correctly.
You can track the progress of the steps mentioned in this document and spot missed steps easily.
Each row of the checklist includes the name of the task, description and short summary where it is applicable and the page column which navigates the instructors to the relevant action.
Going through each task from the start until the current task and making sure the description column contains no warnings or errors can help instructors conduct the exam smoothly.
The exam list page displays a more concise overview of the exam steps in the
You can glance over the preparation, conduction and correction status of the exams in the list.
The exam conduction starts when the exam becomes visible to the students and ends when the latest working time is over. When the exam conduction begins, you cannot make any changes anymore to the exam configuration or individual student exams. When the conduction starts, the students can access and start their exam. They can submit their solutions to the exercises within the given individual working time. When a student submits the exam, they cannot make any changes anymore to his exercise submissions. For more information, see participating in the online exam.
The assessment begins as soon as the latest student exam working time is over. During this period, your team can assess the submissions of the students and provide results. Artemis executes the test suites for programming exercises automatically and grades these. You can enhance the automatic grading with a manual review. You can also trigger the automatic grading of the quiz exercises via the Manage Student Exams Screen. If you want you can also enable the second correction feature for the exam.
3.1 Assess Student Exams
Once the exam conduction is over and the latest individual working time has passed, your team can begin the assessment process.
This is done through the Assessment Dashboard.
If the exam conduction is not over, you will not be able to access this page.
The assessment process is anonymized. Artemis omits personal student data from the assessors.
The Assessment Dashboard provides an overview over the current assessment progress per exercise. For each exercise, you can view how many submissions have already been assessed and how many are still left. The status of the student complaints is also displayed here.
Additionally, once the exam conduction ends, you can click on . This action will evaluate all student exam submissions for all quiz exercises and assign an automatic result.
If you do not press this button, the students quiz exercises will not be graded.
After the exam conduction ends, you can click on . This action will automatically evaluate all submissions with 0 points for unsubmitted student exams. Additionally, empty submissions will be automatically graded with 0 points.
If you do not press this button, the unsubmitted student submissions and the empty submissions will appear in the assessment dashboard of the exam, which leads to unnecessary effort during grading.
To assess a submission for an exercise, you can click on .
Your assessors must first complete the example submissions and assessments, if you have attached those to the exercise, see 1.4 Add Exercises.
If there is a submission which has not been assessed yet, you can click . This will fetch a random student submission of this exercise which you can then assess.
Artemis grades programming exercises automatically. However, if the exercise allows a manual assessment, you can review and enhance the automatic results.
You can trigger Artemis to automatically grade quiz exercises via the Manage Student Exams Screen. Therefore, quiz exercises do not appear in the Assessment Dashboard.
3.2 Assessment with Second Correction Round
Set the number of correction rounds of the exam to 2.
When the second correction is enabled, the assessment progress can be observed in the Assessment Dashboard.
There you can see the state of the individual correction rounds, and the state of the complaints.
You can toggle if tutors can assess specific exercises in the second round. Disabling the second correction again, does not affect already created second assessments.
Correction in the second round can be enabled/disabled anytime.
To assess a submission a second time go to the exercise assessment dashboard. When it is enabled, a button will be visible in the second correction round.
The new second assessment will have all the feedback copied from the first assessment. Those can be overridden, and new feedback can be added as well. This does not override the original result, but saves a separate second result.
Within the second correction round review instructors and tutors can highlight which feedback was created for which correction round. This is displayed as a badge at the bottom of every feedback. This view can be enabled or disabled any time during the second correction round review by pressing the button at the top of the page. The feature is currently available for text, modeling and file-upload exercises.
You can access each assessment of both rounds by going to the exam’s ->
3.3 Plagiarism detection
Artemis also allows you to detect plagiarism attempts.
Artemis conducts this by analyzing the similarities between all student submissions and flagging those which exceed a given threshold. You can compare all flagged submissions side by side and confirm plagiarism attempts.
Instructors can download a
CSVreport of accepted and rejected plagiarism attempts for further processing on external systems.
To apply the plagiarism check, you must navigate to the individual exercise. This can be done by navigating to:
-> -> exercise-title
At the bottom of the page you will find the option .
3.4 Grading Key
Optionally, you can create a grading key for your exam by clicking at the top of the exam’s detail page.
Defining a grading key allows the exam score to be converted to a grade automatically by Artemis, students are then able to see their own grades after the specified Release Date of Results.
Using a grading key also enhances the generated statistics so that the instructor is able to view grade distributions.
For an easy out-of-the-box configuration, you can click and then click
By default, grades are defined as percentages of the total obtainable score. You can also display their point equivalent if you specify
Maximum number of points for exam.
If you would like to define custom grade steps, you can use the button and modify the grade step intervals.
Keep an eye out for the warnings at the bottom of the page to ensure that the grading key is valid.
Inclusivityfield allows you to decide which grade should be assigned if the student’s score is exactly equal to a boundary value between two grades.
There are two grade types you can use:
Gradetype allows you to set a final grade for the exam with custom grade step names, while the
Bonustype allows you to assign bonus points to each grade step so they can contribute to the grade of another course or exam.
Grade Type is
Grade you should set
First Passing Grade.
For more fine grained control, you can switch to
Detailedediting mode and set grade step bounds manually.
buttons enable you to save the grading key as a CSV file and re-use it in other courses and exams.
4. Publication of Results
You can specify the moment when Artemis publishes the results of the exam, see 1.2 Create and Configure Exam. This is usually when the exam assessment ends, but you can specify this at any point in time. During the publication of the results, the student can view their results from their summary page. You can also view the exam statistics from the exam Scores page and export the data into external platforms such as TUM Online as a
CSV file, see 4.1 Exam Scores.
4.1 Exam Scores
You can access the exam scores by clicking on . This view aggregates the results of the students and combines them to provide an overview over the students’ performance.
You can view the spread between different achieved scores, the average results per exercise, as well as the individual students’ results.
Additionally, you can choose to modify the dataset by selecting
only include submitted examsor
only include exercises with at least one non-empty submission.
Unsubmitted exams are not eligible for the assessment process.
Review student performance using various metrics such as average, median and standard deviation.
Unsubmitted exams are not eligible for assessment and thereby appear as having no score. It can happen that an exercise is not part of any student exam. This is the case when Artemis selects a different exercise of the same exercise group for every student exam. Similarly to the unsubmitted exams, they can warp the results and statistics of the exam. By eliminating unsubmitted exams and exercises which were not part of the exam conduction, you can gain a more realistic overview of the performance of the students.
Review the students perceived difficulty of every exercise to improve exams in the future.
The exam scores can also be exported via . This is useful to upload the results into university systems like TUM Online as a
CSVfile includes the
registration number, their assigned
exercises, and their
scorefor every exercise.
CSVfile also contains the aggregated statistics of the exam conduction such as the
number of participationsand the
average scoreper exercise.
5. Student Review
During the review period, students have the opportunity to review the assessment of their exam. If they find inconsistencies, they can submit complaints about perceived mistakes made in the assessment. Students can provide their reasoning through a text message to clarify their objections. You can set the student review period in the exam configuration, see 1.2 Create and Configure Exam.
Students can submit complaints about their assessment in the Summary page.
During the student review, a complaint button will appear for every manually assessed exercise.
Students cannot submit complaints for automatically assessed exercises like quiz and programming exercises.
Students will be able to submit a complaint for programming exercises, if the automatic result has been reviewed manually by an assessor. This is only possible if manual assessment is enabled for the programming exercise.
If you have found a mistake in the automatic assessment of quiz and programming exercises, you can edit those and re-trigger the evaluation for all participants.
For more information on how students can participate in the student review and submit complaints, see student summary guide.
6. Complaint Assessment
Artemis collects the complaints submitted by the students during the student review. You can access and review the complaints similar to the submissions from the Assessment Dashboard. Every assessor can evaluate a complaint about the assessment of their peers and either accept or reject the complaint. Artemis will automatically update the results of accepted complaints. You can view the updated scores immediately in the Scores page. There you can also export the updated data in
CSV format, see 4.1 Exam Scores.
The complaints appear below the exercise submissions.
The original assessor of an assessment cannot respond to the complaint. A second assessor must review the complaint and respond to it.
Artemis tracks the progress of the complaint assessment and displays a progress bar in the Assessment Dashboard. This allows you to keep track of the complaint assessment and see how many open complaints are left.