LSPeerNom

This repository contains the several scripts and files to perform Peer Nomination Surveys using LimeSurvey.

• LSRadboud-theme

  • Contains a LimeSurvey theme template
  • Currently not to be used, but eventually this would replace the default Radboud theme on LimeSurvey
  • The theme should implement better colors for active and non-active buttons, which is essential when doing peer nomination. This is currently taken care of in the question scripts (see the LSPeerNom-components directory)

• preprocessing directory

  • Contains the Jupyter notebook to process the list of students from a school into the input csv file for LimeSurvey, this notebook:
    • reads in a csv file with certain expected columns, see the notebook for more specific documentation on the input file
    • generates a new column with for each student a randomized list of classmates (other students)
    • specifies columns names for specific required attributes for doing peer nomination in LimeSurvey
  • Contains an example_data with:
    • an example input file for testing the participant information preprocessing notebook
    • an example output file, which can be uploaded as LimeSurvey participant list for testing Peer Nomination

• LSPeerNom-templates directory

  • Contains .lss templates that can be uploaded into LimeSurvey
    • One template for the student survey
    • One template for the teacher/mentor survey

• LSPeerNom-components directory

  • Contains scripts (Javascript) to enable Peer Nomination and Peer Ranking for specific question types. The scripts should be added to the question body using the LimeSurvey editor. The question needs to be prepared by adding a labelset with plenty of peer placeholders.
  • A labelset with 40 peer placeholders. This file can be uploaded in the LimeSurvey labelset interface and is enough for any peer group smaller than 41 participants.

When setting up a LimeSurvey peer nomination survey, you should have access to an active LimeSurvey server. If you work at Radboud University, you can use the organization's LimeSurvey server. More information on using this server can be found on the Technical Support Group wiki.

Alternatively you can set up your own webserver or local test installation, more information can be found in the installation documentation.

Once you have access to the LimeSurvey admin interface, either start by uploading one of the LSPeerNom templates from the LSPeerNom-templates directory or create a new survey and use the files in the LSPeerNom-components directory.