Clickermatic Client GUI

1
Clickermatic Client GUI

• Startup Screen
• Question Screens
• Statistic Screens

2
Clickermatic
To log in, enter the requested information and
click Connect below.
3
Question 1 What question is this? A) 1 B) 2 C)
3 D) 4
100
B
Submit
View Question History
0 out of 0 questions answered correctly
4
Question 1 What question is this? A) 1 B) 2 C)
3 D) 4
005
B
Submit
View Question History
0 out of 0 questions answered correctly
5
Question 1 What question is this? Your
answer B) 2 Correct answer A) 1
000
B
Submit
View Question History
0 out of 1 questions answered correctly
6
Question 2 True or false A C array is an
object.
FALSE
Submit
View Question History
0 out of 1 questions answered correctly
7
Question 3 What is the airspeed, in m/s, of an
unladen swallow?
100
2.71828182
Submit
View Question History
1 out of 2 questions answered correctly
8
Question 1 What question is this? Your
answer B) 2 Correct answer A) 1
Previous
Next
Return to Current Question
2 out of 3 questions answered correctly
9
Question 4 Swallows come from Europe and what
other continent?
100
Submit
View Question History
2 out of 3 questions answered correctly
10
Questions over
Statistics Total Questions 10 Answered
correctly 5
View Question History
11
Clickermatic Server GUI

• Startup Screen
• Question Screens
• Live Poll Screens
• Statistic Screens

12
Clickermatic Server
Server IP 1.3.3.7
Port 4012
Port Override
Question Editor
Begin Questions
Number of Clients 27
13
Question 1 What question is this? A) 1 B) 2 C)
3 D) 4
100
Repeat Previous
Next Question
Jump to Question
Answers Received 32 Number of Clients 47
14
Question 2 What question is this?
100
Repeat Previous
Next Question
Jump to Question
Answers Received 34 Number of Clients 47
15
Question 3 Is this a poll?
004
Repeat Previous
Next Question
Jump to Question
Answers Received 42 Number of Clients 47
16
Question 3 Is this a poll?
004
Answers given Count Yes 40 No 3 iD
ontCare 2 DefineThis 2
Repeat Previous
Next Question
Jump to Question
Answers Received 47 Number of Clients 47
17
Question 1 What question is this? A) 1 B) 2 C)
3 D) 4
Question Results
of
of Answer Answers
Answers Correct Answer A 49 98 Most
Common Wrong Answer B 1 2 Other
Answer C 0 0 Other Answer D 0
0
Repeat Previous
Next Question
Jump to Question
Answers Received 50 Number of Clients 50
18
What question is the square root of 4?
Question Results
of
of Answer Answers
Answers Correct Answer 2 40 80 Most
Common Wrong Answer 16 5 10 Minimum
Answer 0 Maximum Answer 1337 Average
Answer 30.02
Repeat Previous
Next Question
Jump to Question
Answers Received 50 Number of Clients 50
19
Question Set Results
Question of of
Average Time Reference Number Answers
Answers to Answer 3 50 100 5
seconds n/a 2 49 98 6 seconds n/a
1 45 90 8 seconds n/a 4 40 80 7
seconds n/a 5 5 10 40 seconds pg
40 Average 37.8 75.6
New Question Set
Export Statistics
Number of Clients 50
20
Clickermatic File I/O

• Question Set Input Files
• Statistics CSV Output Files

21
Question Set Input File

• The question set input file uses an XML format
  with the following tags and attributes
  (attributes in square brackets are optional)
• ltQuestionSetgt
• mode mode quiz tally none
• time time ltIntegergt
• ltQuestiongt
• type type multiple-choice true-false
  number string
• time time ltIntegergt
• ltQuestionTextgt
• ltImagegt
• ltReferencegt
• ltOptiongt
• correct correct correct incorrect

22
Question Set Input File

• The following is the formal definition in a BNF
  style of the Input File syntax
• QUESTION_SET 'ltQuestionSet' MODE TIME'gt'
  QUESTION QUESTION 'lt/QuestionSetgt'
• MODE 'mode"tally"' 'mode"none"'
• QUESTION 'ltQuestion' TYPE TIME 'gt'
  QUESTION_TEXT REFERENCE OPTION OPTION
  'lt/Questiongt'
• TYPE 'type"multiple-choice"'
  'typetrue-false"' 'type"number"
  typestring
• TIME 'time"' INTEGER '"'
• QUESTION_TEXT 'ltQuestionTextgt' STRING
  'lt/QuestionTextgt'
• REFERENCE 'ltReferencegt' STRING
  'lt/Referencegt'
• OPTION 'ltOption' RESULT 'gt' STRING
  'lt/Optiongt'
• RESULT 'result"correct"'
  'result"incorrect"'
• INTEGER 0 1 ...
• STRING abc...

23
Some QuestionText Notations

• Within a ltQuestionTextgt, the following delimiters
  will be used on either side of text to be
  displayed in styles
• / to be italicized
• to be displayed as bold
• __ (double underscore) to underline
• Example
• This /text will/ be __underlined__.
• This text will be underlined.

24
Sample QuestionSet Document
ltQuestionSet modetallygt ltQuestion
typemultiplegt ltQuestionTextgtWhat is the Who
was the first president of the United
States?lt/QuestionTextgt ltReferencegtp.270 of
textlt/Referencegt ltOptiongtBarrack
Obamalt/Optiongt ltOption correctcorrectgtGeorge
Washingtonlt/Optiongt ltOptiongtAbraham
Lincolnlt/Optiongt ltOptiongtRegislt/Optiongt lt/Quest
iongt ltQuestion typestring time5gt ltQuestio
nTextgtType a wordlt/QuestionTextgt lt/Questiongt
25
Sample QuestionSet Document
ltQuestion typeblankgt ltReferencegthttp//www.l
etu.edu/opencms/opencms/ _Academics/Arts-Science/c
omputer-science/faculty.htmllt/Referencegt ltQuesti
onTextgtGive the last name of a LeTourneau CS
professor. lt/QuestionTextgt ltOption
correctcorrectgtTevislt/Optiongt ltOption
correctcorrectgtBaaslt/Optiongt ltOption
correctcorrectgtRouselt/Optiongt lt/Questiongt ltQu
estion typemultiple-choicegt ltQuestionTextgtPic
k a number (Poll Question)lt/QuestionTextgt ltOptio
ngt1lt/Optiongt ltOptiongt6lt/Optiongt ltOptiongt42lt/Op
tiongt ltOptiongt17,239,625lt/Optiongt ltOptiongtSchf
ifty-Fivelt/Optiongt lt/Questiongt lt/QuestionSetgt
26
Statistics Output Files
27
Output Files - General

• The statistics output files from the server will
  meet the following
• They will be formatted as CSV files.
• Each row of a table will be indicated by a new
  line
• Each cell (column) will be separated by commas
• Values within a cell will be surrounded with
  quotes (Quotes within a cell will be escaped as
  \)
• For the question summary file, there will be a
  section for multiple choice questions and one for
  text response questions, separated by two blank
  lines.
• For the student summary file, the file will
  contain names and IP addresses with the number of
  correct answers and percentage correct.

28
Question Summary File

• Multiple Choice Section
• First column Question Number
• Second column Correct Option (-- for poll
  questions)
• Third-Eighth column Number of Option Selected
  (Left blank if option does not exist)
• Last column number depends on the maximum number
  of allowed options, as defined by Requirement
  S-2.
• Ninth column Number with No Answer
• Tenth column Number Correct
• Eleventh column Percent Correct
• Twelfth column Average time to answer

29
Question Summary File

• Text Response Section
• First column Question Number
• Second column Correct Answer (-- for poll
  questions)
• Third column Most common incorrect answer (Most
  common answer for poll)
• Fourth column Number of no answer
• Fifth column Average time to answer
• Sixth column Number correct
• Seventh column Percent correct

30
Question Summary File
Question Correct Option No. A No. B No. C No. D No. E No. F No Answer Avg. Time Correct Percent Correct
1 B 2 15 2 0 1 23.18 15 75
4 -- 1 6 5 5 2 1 5.2 19 95
Question Correct Answer Most Common Incorrect No Answer Avg. Time Correct Percent Correct
2 -- Purple 1 4.2 19 95
3 Tevis Varnell 0 10.4 17 85
31
Question Summary CSV

• Question, Correct Option, No. A, No. B,
  No. C, No. D, No. E, No. F, No Answer,
  Avg. Time, Correct, Percent Correct
• 1, B, 2, 12, 2, 0, , , 1, 23.18,
  15, 75
• 4, --, 1, 6, 5, 5, 2, , 5.2,
  19, 95
• Question, Correct Answer, Most Common
  Incorrect, No Answer, Avg. Time, Correct,
  Percent Correct
• 2, --, Purple, 1, 4.2, 19, 95
• 3, Tevis, Varnell, 0, 10.4, 17, 85

32
Student Summary File

• Student Summary Table
• First column Alias
• Second column IP Address
• Third column Number of correct answers
• Fourth column Number of incorrect answers
• Fifth column Number of No Answers
• Sixth column Percentage of correct answers

33
Student Summary File
Alias IP Address Number Correct Number Incorrect No Answer Percent Correct
Raduns 10.31.162.41 8 1 1 80
Reinking 10.31.162.53 9 1 0 90
Moore 10.31.163.20 7 3 0 70
34
Student Summary CSV

• Alias, IP Address, Number Correct, Number
  Incorrect, Percent Correct
• Raduns, 10.31.162.41, 8, 1, 1, 80
• Reinking, 10.31.162.52, 9, 1, 0, 90
• Moore, 10.31.163.20, 7, 3, 0, 70

35
Clickermatic Network Protocol
36
Server
Client
100 HELLO
200 QUESTION
300 SUBMITTED_ANSWER
400 GRADED_QUESTION
500 END_OF_SET
900 TERMINATE_ME
999 GOODBYE
37
100 Connection Initiation HELLO (C-gtS)
MsgTypeID
DesiredAlias
Record Name Type Length Description
MsgTypeID Int 4 Denotes the type of packet (100)
DesiredAlias String 32 Clients desired alias to the server or instructor
38
200 Question Data QUESTION (S-gtC)
MsgTypeID
QuestionNo
QuestionType
TimeLimit
TallyMode
QuestionText
AnswerOptions
Record Name Type Length Description
MsgTypeID Int 4 Denotes the type of packet (200)
QuestionNo Int 4 The number of the incoming question
QuestionType int 4 The type of question (NBR MC TF STRING)
TimeLimit Int 4 The max allotted time given to the student to answer the question in seconds
TallyMode Bool 1 Determines whether the server is forcing the client to be in tally mode for the question
QuestionText String 256 The actual question
OptionCount Int 4 The number of answer options
AnswerOptions String 256 If QuestionType is MC, this specifies all of the answer options delimited by ASCII char 4
39
300 Final Answer FINAL_ANSWER (C-gtS)
MsgTypeID
QuestionNo
DidAnswer
TimeTaken
FinalAnswer
Record Name Type Length Description
MsgTypeID Int 4 Denotes the type of packet (300)
QuestionNo Int 4 The number of the question associated with the answer
DidAnswer Bool 1 Whether or not the client submitted an answer within the time limit
TimeTaken Int 4 If an answer was submitted, how many seconds elapsed off of the clock before the submission
SubmittedAnswer String 32 Returns the letter association of the selected answer choice for a multiple choice. Returns the single word or number answer for the free-form input questions.
40
400 Question Results GRADED_QUESTION (S-gtC)
MsgTypeID
SubmittedAnswer
CorrectAnswer
IsRightAnswer
TimeTaken
Record Name Type Length Description
MsgTypeID Int 4 Denotes the type of packet (400)
SubmittedAnswer String 16 Echo of FinalAnswer field in 300 packet
CorrectAnswer String 16 The correct letter choice if a multiple choice question. The one-word string if a free-form question
IsRightAnswer Bool 1 Whether or not the student submitted the correct answer
TimeTaken Int 4 Echo of TimeTaken field in 300 packet
41
500 End of Question Set END_OF_SET (S-gtC)
MsgTypeID
Record Name Type Length Description
MsgTypeID Int 4 Denotes the type of packet (500)
900 Connection Termination Request TERMINATE_ME
(C-gtS)
MsgTypeID
ClientAlias
Record Name Type Length Description
MsgTypeID Int 4 Denotes the type of packet (900)
999 Connection Termination GOODBYE (S-gtC)
MsgTypeID
ClientAlias
Record Name Type Length Description
MsgTypeID Int 4 Denotes the type of packet (999)