Skip to content

perllaghu/test

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

What is NBGrader?

NBGrader is a tool for managing homework, or assignments.

Normally, this is in the form of questions to test whether students can write code to solve problems.

Nbgrader views the world in two ways: Instructors can set & mark assignments; students complete assignments & submit for marking.

In Noteable, Instructors are students with more options.

Top level view of assignments

At the very top level, the life-cycle of a notebooks is create, release, fetch, submit, grade, feedback:

  • Instructors create and release
  • Students fetch and submit
  • Instructors grade and feedback

nbgrader for students

When you start a notebook, you have three tabs top-left - the Assignments one is where you interact with assignments released to your course

top tabs

This page has three areas: Released assignments, Downloaed assignment, and Submitted assignments.

Released assignments

New assignments will be listed here

Released assignments

Clicking on [ Fetch ] will download it for you to work on.

Downloaded assignments

Assignments you have downloaded are listed here.

Downloaded assignments

Notice the assignments are listed in alphabetical order, and that each assignment has a right-facing arrow.

If you click on the name of the assignment (or arrow-head) the assignment will open to show you the notebook(s) for you to work on.

Clicking on the notebook name will open the notebook.

Working on assignments

When in a notebook, you will only be able to edit certain cells - the ones where you're providing answers (either code, or free-form text)

Remember to save your notebook before closing it - if you don't, then you'll submit the last auto-saved version.... which is probably missing important work.

Submitting assignments

Having worked on an assignment, and saved it, you can return to the assignments tab and check your work by clicking on the [ validate ] button.

You may edit, save, validate; edit, save, validate as often as you need until you are ready to submit your work.

Click on the [ Submit ] button to return your work to the Instructor.

Note, if you realise you have an error (or just want to change the way you do something), you can edit, save, validate... and re-submit - the instructor will be given your last submitted notebook when then collect notebooks for marking.

Submitted assignments

This is where all your submissions are listed

Submitted assignments

There are two things of note here:

  1. All your submissions are grouped under their assignments, and timestamped - the instructor will see the timestamp for the submission they're marking.
  2. There may be feedback available for submissions, and this is where you fetch it.

Folders you will see in your home folder

All files are stored in your home folder, so you can find them directly:

  • Fetched assignments will be in <couse_code>/<assignment_code>/

    If you delete the <assignment_code>, your system will think you've not fetched the assignments, and allow you to re-fetch it.

  • feedback is stored in <couse_code>/<assignment_code>/feedback/<timestamp> - which means if your instructor marks two different submissions, you may have multiple versions of the feedback.

    The link in the assignments tab should take you to the right one.

nbgrader for instructors

When you start a notebook, you have four tabs top-left:

  • the Formgrader one is whwere you create, and mark, assignments.
  • the Assignments one is where you interact with assignments released to your course (like students do.)

top tabs

The formgrader pane is broken into two sections - The management menu, and The working area.

When you start, the management menu will be set to Manage Assignments, and the working area will have all your assignments [for this course] listed

  • The management menu:

    formgrader assignment menu

  • The Manage Assignments table:

    formgrader assignment table

Creating an assignment

Step one is to create a new assignment in your local gradebook database:

Click on the Formgrader tab to access the management tools

Note - This opens a new tab in your browser

  1. Click on the Add New Assignment link at the bottom of the table:

    New assignment link

  2. Fill in the resultant pop-up form:

    New assignment details

  3. This will create a new entry in the assignments table:

    New assignment in table

    • The Edit pen allows you to change the name of the assignment, or it's Due Date
  4. Click on the Name of the assignment to actually add content.

    Note - This opens a new tab in your browser

    Adding an assignment

    Notice that you are in a sub-folder - assignment names need to be unique, simply because of this folder structure.

    How you add a notebook depends on how you work. Gnerally I make my assignment notebook beforehand, and upload it here.

    These notebooks should be complete - ie include tests, sample code for answers, and everything needed for the notebook to run without errors.

    See How to write an assignment below for details on this.

    assignment notebook

    You may add as many notebooks and/or data files as you wish - but keep everything in the same folder.

    Once finished adding files, you may close the browser tab.

  5. Back at the assignments table, you are now ready to create the version that students will get.

    Click on the hat in the Generate column, and the system should respons with a Success popup:

    successfull generate

    If there are errors, go back and edit the source file (see step 4), save, and re-run Generate

    This will result in a new version, which you Preview before Release-ing

    generated assignment

    • If you click on the spyglass under Preview, you can look at the version that will be [has been?] released

      Notice that you are in a different sub-folder to the source file. This also opens a new tab in your browser. Close it once you've finished previwing

    • If you click on the arrow to cloud symbol in the Release column, this will release the notebook to students.

    Note - Once you have done this, it is impractical (not not advisable) to re-release the notebook: Students may already have downloaded a copy, and will not see an updated version.

    Releaseing the notebook will result in a Success popup:

    Successfull release

  6. Back at the assignments table, you can see your assignment has been released:

    Released Assignment

  7. .. collection ..

  8. .. grading ..

  9. .. feedback ..

Folders you will see in your home folder

All files are stored in your home folder, so you can find them directly:

  • Fetched assignments will be in <couse_code>/<assignment_code>/

    If you delete the <assignment_code>, your system will think you've not fetched the assignments, and allow you to re-fetch it.

  • feedback is stored in <couse_code>/<assignment_code>/feedback/<timestamp> - which means if your instructor marks two different submissions, you may have multiple versions of the feedback.

    The link in the assignments tab should take you to the right one.

How to write an assignment

Releases

No releases published

Packages

No packages published