Numerical Answers with Python

This page is specific to the Python questions (without coding). The objectives are:

  • Use the necessary Python function in the server.py to generate the solutions, and grade the questions
  • Specify the randomized variables in the server.py
  • Specify the specific files (e.g., figure) in the server.py

Overview

The easiest way to create a Python question (without coding) is by copying an existing question (either Python or R), and change certain files. Then you don’t need to create the UUID by yourself.

Note: Each UUID will be assigned to a question only.

Step 1: Copy a question

  • Follow the Step 1 to Step 4 in the Routine work. Then click PrarieLearn logo (next to Admin) in the upper left.
  • Click a course such as CEE 202: Engineering Risk & Uncertainty in the Courses (not Course instances) list.
  • Click the Questions (next to Issues) on the top line.
  • Find a question you want to copy (for example: AS4_Prob5_2020_AngTang).
  • Click Settings between Preview and Statistics.
  • Click Make a copy of this question
  • Click Change QID

Step 2: Modify the questions

Before you modifying the question, I strongly suggest creating a spreadsheet to keep track of the questions (including title, topic, tags) and corresponding UUID.

Note: Each question folder contain the following files

Folder/File Name Usage
info.json The information of the question such as title, topic, tags, and uuid.
question.html The main body of the question
server.py The solution to the question, but it also species
clientFilesQuestion Save the figures for the question.
clientFilesQuestion
/dist.png		 The figure needes to be added to the question

info.json

  • Click Edit under Settings
  • Define the title, topic, tags, and type

server.py

  • Click Files (under PrairieLearn in the upper left) → Edit the server.py, then you need to finish the following tasks:
import rpy2.robjects as robjects
import prairielearn as pl
import numpy as np
from numpy import arange
from numpy.random import choice

def generate(data):
    # start to code your solution
    ## "a" could be 3.8, 3.9, 4.0, 4.1, 4.2
    a = choice(arange(3.8,4.3,0.1),1)
    answer_a = a+1
    # here is the end of your solution
		
    # Setup output 
    data['correct_answers']["answer_a"] = answer_a
    # Setup randomized variables
    data["params"]["a"] = a 
    # define the figure name
    image_name = "dist.png"
    data["params"]["image"] = image_name
  • import the necessary packages at the beginning
  • Change the randomized variable using a=choice(arange(start,end+interval,interval),1)

Note: a corresponds to ${{params.a}}$, answer_a corresponds to answers-name="answer_a" in the question.html

  • Change the image_name (if you have figure(s))

question.html

  • Click Files (under PrairieLearn in the upper left) → Edit the question.html, then you need to finish the following tasks:
<pl-question-panel>
	<p> 
	This is the problem statement.
	</p>
	<pl-figure file-name={{params.image}} directory="clientFilesQuestion"></pl-figure>
</pl-question-panel>

<pl-question-panel><hr></pl-question-panel>
<pl-question-panel>
	<p>
	    (a) Determine the probability that the settlement will exceed ${{params.a}}$ cm.
	</p>
</pl-question-panel>

<div class="card my-2">
  <div class="card-body">
    <pl-question-panel>
      <p>The answer is: (0.XX)</p>
    </pl-question-panel>
    <pl-number-input answers-name="answer_a" weight = "3" comparison="relabs" rtol="0.01" atol="0.01"></pl-number-input>
  </div>
</div>
  • Replace “This is the problem statement.” with your problem statement
  • Replace ${{params.a}}$ with your randomized variable from server.py
  • Replace "answer_a" with your answer from server.py
  • Define the tolerance. Sotiria suggests that:
    • for the answer (0.XX), comparison="relabs" rtol="0.01" atol="0.01"
    • for the answer (0.XXX), comparison="relabs" rtol="0.001" atol="0.001"

Alternatives: Integer

Reference: (link)

If the answer is an integer, you need to replace

<pl-number-input answers-name="answer_a" weight = "3" comparison="relabs" rtol="0.01" atol="0.01"></pl-number-input>

with

<pl-integer-input answers-name="answer_a" weight = 3></pl-integer-input>

Where the answer “answer_a” has to be an integer.

Step 3: Test your questions

  • Click Preview to test
  • Click New variant to have another test

Step 4: Commit and push the changes

  • Using Git to commit and push the changes

Note: You may do this after you finish all the questions

Step 5: Sync and test

  • Log in the website https://prairielearn.engr.illinois.edu/pl/, and select your course
  • Click Sync, then Pull from remote git repository
  • Find your questions by clicking Questions and test them again