This is an old revision of the document!
Table of Contents
Graph Exercises Requirements
Feature
- Provide a welcome screen with “Graph Exercises” as title
- Display equation (linear or sin function) and four possible solutions in the form of graphs
- The graph exercises allow users to take quizzes on certain graphs (pick the corresponding graph)
- Graphs and possible solution are generated at random using Python scripts
- To generate different graphs, the program must be able to edit variables
- For linear equations y = mx + b, m and b must be editable
- For sin functions y = A sin(b * theta + phi), A, b, and phi must be editable
- Program must be able to edit any number of variables, not just one or all
- After a session, results are returned to the user to show performance
Prerequisites
- User must have registered and created an account to do graph exercises
- User must be logged into system in order to do graph exercises
- Must have links on home page and other relevant locations on website directing users to the graph exercises
What the User Sees
- Once directed to the graph exercises, user is greeted by a welcome screen titled “Graph Exercises”; there are options to start a session or go elsewhere on the site
- After entering a session, the user will see a page with an equation and four corresponding graphs
- That graphs each have a button to allow the user to select the one they believe to be correct
- After they select an answer they see:
- The correct graph highlighted in green
- If they selected the incorrect answer, their selection highlighted red
- Text telling either telling them “Correct!” or “Incorrect”
- A button titled “Next” to advance to the next graph exercise
- When a user completes a graph exercise session:
- A string that says how many questions our of how many attempts they got correct
- A percentage representation of this number (perhaps incorporating prior results once the data tracking functionality is finalized
- Try again link that takes the user back to the welcome screen for graph exercises
What the User Does
- Register/login to ChemTutor
- Click on a link guiding them to the graph exercises
- Click on “Begin Session” on graph exercises welcome screen
- Click on the graph which they believe to be correct based on the equation
- Click on the “Next” button to advance to the next question or the results page
- They can click “Try another session” when they complete the exercises
Behavior of the Application
- Once a session is begun, the application will generate graphs based off of Python scripts
- When a user clicks on an answer and then clicks “Submit”, the application will verify that the submitted answer is the correct one
- The application will then send feedback, which will be displayed on the page, showing whether the answer was correct or not
- When the user clicks on “Next”, the application must generate another graph for the next question (this could be done at beginning of session and saved for use on each click of “Next”)
- After the final question when “Next” is clicked, a results page is generated
- Shows how many questions the user got correct and
- Displays a table comparing results to historical averages
- The page then gives the user the option to try again or return to the home page
- If the user selects to try another session, they are redirected to the “Graph Exercises Welcome” page