Course administration

Course administration

This page is intended to show how to administrate a course and all the options that a course administrator can do.

As a course administrator, you can simply access its management page by clicking on “Course administration” when you access to the course on UNCode.

Course settings

You will see this page at the moment when you enter in the course administration. In this page, you can setup son settings such as: accessibility and visibility, access control, assign administrators or tutors, among others. In case you want to set your course to use LTI, to use it on platforms like Moodle or Edx, see course integration into a LMS documentation.

Students

Here you are able to:

• Add students to the course. This can be either by clicking setting the student's username or uploading a CSV file. The uploaded CSV file must have a specific structure and amount of columns, see the instructions there. This registers the students on UNCode in case that user is not register, and registers them on the course. This is very useful for large courses or with restricted access.
• See some statistics for each student, where you can see the number of tasks tried and done plus the general grade.
• For each student, you can view all their submissions, download the submissions, replay them (this is submit the code again) or unregister the student from the course.
• Download all the submissions, download csv (this file will show the general stats like the grade for each task and student).

Classrooms

Classrooms are useful to administratively separate students registered in the same course. They offer separate statistics to help the teacher identify problems that students may encounter in this particular context.

Submissions groups can be set in classrooms and define a set of users that will submit together. Their submissions will contain as authors all the students that were members of the group at submission time. Note that students cannot collaborate with students from another classroom. In this case, please consider using only teams, as described below.

Creation

In the classroom list view, specify a classroom description, and click on“Create new classroom”. The newly created classroom will appear in the list.

To edit a classroom, click on the quick link “Edit classroom” located on the right side of the table. You’ll be able to change the classroom description,the associated teaching staff (Tutor list), and to specify the (grouped) students. Assigning tutors will help them to retrieve their classroom statistics.

The student list is entirely managed by drag-and-drop. You can create a new group on the same page, set its maximum size, and drag-and-drop ungrouped students or already grouped students in the newly created group.

Course structure upload

You can generate the course classroom or team structure with an external tool and then upload it on INGInious. This is done with a YAML file, which structure for classrooms or teams are similar and described below. The course structure can be upload on the classroom or team list view in the course administration.

-    description: Classroom 1
     tutors:
             - tutor1
             - tutor2
     students:
             - user1
             - user2
     groups:
             - size: 2
               students:
                     - user1
                     - user2
-    description: Classroom 2
     tutors:
             - tutor1
             - tutor2
     students:
             - user3
             - user4

• description: is a string and corresponds to your classroom description
• tutors: is a list of strings representing the usernames of the assigned classroom tutors.
• students: is a list of strings representing the usernames of the classroom students.
• groups: is a list of group structures containing the following elements :
  • size: the maximum group size
  • students: the list of student usernames in this group

Backup course structure

Course structures (classrooms) can be exported for backup or manual edition via the classrooms list page in the course administration pages. Simply click on the “Download structure” button. The downloaded file will have the same format as described above.

Tasks

Here you can create a new task, where you have to add the task id, this id can only have alphanumeric characters plus '-' or '_'. Once you click on Create new task button, it takes you to another page to setup the task. Please go to How to create a task. Additionally, here you can:

• See the number of students who viewed each at least one time, the number of tries, as well as the number of students who succeeded the task.
• Edit every task, see How to create a task
• View the results of each task, this shows the results for this task for each student, its grade, number of submissions and the actual submissions of each students on this task. Also, you can download a csv file with this information and task grades.
• When you click on Change task order button, this is to change the order in the tasks are shown to the user. This is important to, for example, show the last created tasks at the bottom of the tasks list.

View Submissions

In this page you will be able to generate a query selecting among some parameters like the task or student. Then, the result of the query will be showed in a table where you can download that information.

Downloading submissions

Students' submissions can be downloaded from the Download submissions tab or the submission inspection page. You are able to only download the set of evaluation submissions (according to the task parameters) or all the submissions.

Submissions are downloadable as gzip tarball (.tgz) files. You may need some third-party software if your operating system does not support this format natively. The files contain, for each submission, a test file with extension test containing all the submission metadata and the associated archive folder containing all the files that have been exported using the archive API.

Replaying submissions

Student submissions can be replayed either from the Replay submissions and statistics pages or the submission inspection page. Different replay scheme are available:

• As replacement of the current student submission result. This is the default scheme for the Replay submissions page. When replayed, submission input are put back into the grading queue. When the job is completed, the newly computed result will replace the old one. This is useful if you want to change the grading scripts during or after the assignment period and want all students to be graded the same way. You can replay only the evaluation submission or all submissions. However, please note that if replayed, the best submission can be replaced by an older best submission.
• As a personal copy: this mode is only available from the submission inspection page and copy the student input to generate a new personal copy. This is useful for debugging if a problem occur with a specific student submission. Submission copy is also available with SSH debug mode.

All the tables can be downloaded in CSV format to make some further treatment in your favorite spreadsheet editor.

Course Statistics

Page intended to show some plots related to the course, for every statistic, you can download the data as csv file. The found plots are:

• Grade count: Groups the grades of every task and shows you the number of grades, if the number of grades is grater the circle will be bigger.
• Grade distribution: Shows how the grades are distributed for every class.
• Submissions verdict (ALL): chart showing the number of submissions per task, showing the amount of submissions with status ACCEPTED and WRONG_ANSWER. Clicking on Toggle normalize button, changes the chart to see the percentage of submissions instead of just the amount of submissions.
• Submissions verdict (BEST): Shows the number of submissions per task, but this only shows the best submissions. As well as the previous chart, you can Toggle normalize to show the percentage of submissions rather than the number of submissions.

Notes

• When you click on the corresponding shape of a chart, a table is displayed below the chart showing the information related to selected submissions.
• You also can download a csv file summing up the information of the selected statistic.

Problem bank

Problem is a tool that allows course administrators to copy public tasks from other courses. Here you can also add some of your courses to the bank, and that way, other instructors can see your tasks and copy them. In the Tasks you will see all available tasks to copy.

Plagiarism

Here you can create plagiarism checks for all the tasks and in the different languages on UNCode. Just select the task you want to check, the language used for that task and if you have provided a base code for the students (e.g. notebooks submissions), thus the comparison is takes into account the base code. Then click on start to run the plagiarism check and wait until it finishes. Take into account that for large course this might take a long time to finish.

Manual Scoring

This tool allows instructors to add a manual grade and feedback for each of the student's submissions. The way this manual grade is given is using a rubric. UNCode initially provides a default rubric, though you can upload a custom rubric before you start grading the students, that way the rubric is more accurate for the course purposes. To start using this tool, select a task, then select a student and then select a submission from the list to add feedback and a manual grade, then save the feedback. Additionally, the professor will be able to download a CSV with the manual grades for the course.

In the other side, the student will be able to see the given feedback for each submission and task.