Course administration

Course administration

This page is intended to show how is 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” in the main course page.

Course settings

You will see this page at the moment when you enter in the course administration. In this page, you can configure some things like: accessibility, access control, assign administrators or tutors, among others.

Students Submissions

Statistics over students submissions are largely available in INGinious, and all the files related to them are stored and can be downloaded.

General overview

The administration page gives you several global list views :

• All the tasks of a course, with the number of students who viewed they at least one time, who tried and the number of tries, as well as the number of students who succeeded the task. This view can be accessed clicking on "Tasks" tab in the main administration page.
• All the students/classrooms of a course, with the number of tasks tried and done, as well as its global progression for students. This view can be accessed by switching to “Students” / ”Classrooms” in the main administration page.
• All the students/classrooms who tried a given task, if they succeeded it, and the number of submissions they did. You can show these information by clicking on “View results” in the Task page and on the task that you want to view.
• All the tasks tried by a given student/classroom, if (s)he/they succeeded it and the number of submissions (s)he/they did. These information can be displayed by clicking on “View” in the corresponding student/group page.
• All the submissions made by a student/classroom for a given tasks, with date of submission and the global result. Submissions can be displayed by clicking on “View submissions” in the Tasks tab.

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

Downloading submissions

Student 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 submissions, 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 (Under testing)

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.

Classrooms

Classrooms are useful to administratively separate students following the same course. They offer separate statistics to help the teacher identify problems 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.