1. Experiment Kit for Research In Reward Policies
Software Laboratory
Amnon Ben Hamu
Oded Golan
Project Advisor:
Yaron Ben-Shushan
Lab engineer:
Dr. Ilana David

2. Introduction
A research of motivation according to reward policies is demanded.
The research is based on an experiment which examine the members motivation according to the reward they get.
אירגון כלשהו מעוניין ללמוד ולבחון את מוטיבציית חבריו.
מתבצע מחקר בשיטות תגמול.
המחקר מתבסס על ניסוי בו נבדקת מוטיבציית הנבחנים בהתאם לתגמול שאותו הם מקבלים (הניסוי הוא אמצעי לביצוע המחקר).

3. Solution
It was decided to use a computer system in order to perform the experiment involved with the research.
The system exhibit a task to the examinees while rewarding them according to their performance.
Data is collected and displayed to the supervisor during the experiment.
מערכת המשמשת פלטפורמה לביצוע הניסוי, וכן לאיסוף וניתוח הנתונים.

4. System Structure
RMI

5. Experiment Description
מספר פרקי הניסוי מוגדר בזמן הקונפיגורציה
Experiment Configuration
Game Tutorial (optional)
Session 1
Session 2
Session 3
ניתן להגדיר זמן הפסקה וזמן משחק בנפרד
Play
Break
כל אחד ממרכיבי ההפסקה הינו אופציונלי
Graphs
Messages (mails)
Survey

6. Client/Server Main Duty
Set experiment Configuration.
Control the experiment online.
Store the experiment results for later analysis.
לקבע את תצורת הניסוי.
לפקח על מהלך הניסוי בזמן אמת.
לשמור את תוצאות הניסוי בבסיס נתונים לצורך ניתוח מאוחר יותר.
לקוח:
להתחבר לשרת ולמסור לו ערוץ יחודי לקבלת פקודות ממנו.
לבצע את כל פקודות השרת כגון: מחיקת לקוח, התחלת משחק, הצגת גרף, וכו'.
Client:
Connect to the Server.
Perform all Server requests.

7. Database
On every experiment the Database is required to store the following:
Experiment configuration data.
Results of the games (scores).
The content of all the messages
& the Surveys.
Users names & the number
of their computer.
נתונים על כל ניסוי (מס' פרקים, זמן הפסקה, זמן משחק)
הניקוד שנצבר בכל משחק עבור כל לקוח.
פרטי ההתכתבויות בין הלקוחות במהלך ההפסקות לרבות מען, נמענים, נושא, תוכן וכו'. וכן את התשובות לשאלונים שהוצגו.
שם כל משתמש ומספר התחנה עליה הוא עבד.

8. Server & Client block diagram
Config Control
Users Data
Main Frame
Game Frame
Survey Editor
אמצעי קלט פלט עיקרי בין המערכת לפקח הניסוי.
מהווה סביבה להכלת משחק במערכת הניסוי. מתאם בין ממשק המערכת לממשק המשחק.
מציג לנבדק את השאלון, ומאפשר לו עריכה, תיקון והגשה.
מכיל את כל המידע על הנבדקים ותחנות הלקוח כגון: מס' תחנת לקוח, כתובת לקוח, שם משתמש, ניקוד שצבר משתמש, וכו'.
Game
אחראי על עיצוב תצורת המערכת והניסוי כגון: ממשק להגדרת התצוגה, מבנה נתונים לאחזקת תצוגת המערכת וכו'.
Survey Server
Graph Server
Messages Server
Graph Viewer
משחק בו ישחקו המשתתפים בניסוי. רשום בפורמט JavaBeans
מציג לנבדק גרפים כפי שנשלחו ע"י השרת, והוגדרו בתצורת הניסוי (Config)
מטפל בהתכתבות בין לקוחות כגון: הצגת כלי ההתכתבות, העברת הודעות לביקורת, החזרת הודעה, שליחת הודעה ליעדה, וכו'.
מטפל בכל הקשור לשאלונים המוצגים ללקוחות בהפסקה, משליחת תוכן השאלון ועד לאיסוף הנתונים לאחר מילויו.
מטפל בכל הקשור לגרפים הנשלחים ללקוחות, עיבוד והכנת הנתונים שיוצגו בגרפים, וכן שליחת נתוני הגרפים אל הלקוחות.
DB Server
State Machine
Registration Servant
Login Manager
Message Tool
מבצע את שלבי רישום תחנת הלקוח לשרת ושומר את נתוני ההתחברות
ממשק בעל כתובת קבועה, דרכו מבצעים הלקוחות רישום למערכת.
איסוף ושמירת נתונים שהתבקשו ע"י המפקח כגון: היסטוריית הודעות בין הלקוחות, רשימת משתתפים, תוכן שאלונים שמולאו, וכו'.
מתזמן את סדר האירועים במערכת, ומניע את מכונת המצבים באמצעותם (התחלת וסוף של ניסוי, משחק, הפסקה, וכו').
Manual Commands
Events To Commands
Unblock Client Commands
Client Command Servant
כלי המאפשר לנבדק לקבל ולשלוח הודעות, לנהל מעקב אחרי הודעות ששלח וכן להחזיר תגובה על הודעות שקיבל.
Notification Tool
שירות קריאה לפונקציות בתחנת לקוח. מאפשר גמישות כגון: יצירת תהליך לכל פניה, ביצוע פניות לא חוסמות, וכו'.
מתרגם מאורעות בשרת לפקודות המובנות בתחנת לקוח, ומעבירם באמצעות הממשק התוכנתי ללקוח.
אובייקט נפרד עבור כל לקוח, הנוצר לאחר רישומו למערכת, ומטפל בכל סוגי הפניות של הלקוח אל השרת.
ממשק דרכו יכול המפקח לבצע פעולות על לקוח ספציפי כגון: מחיקתו, שליחת הודעה אליו, וכו'.
מציג לנבדק הודעות שהועברו לו ע"י המערכת ו/או מפקח הניסוי (חד-כיווני).
Serve Client Servant
ממשק דרכו יכול המפקח לבצע פעולות על לקוח ספציפי כגון: מחיקתו, שליחת הודעה אליו, וכו'.

9. Running Scheme The Server initiate its objects.
The Client initiate its objects.
The Client connect to the Server (Registration Servant) on a unique port.
The Server (Users Data) create an instance of ServClientServant, and return a reference of it to the Client.

10. Running Scheme (cont.)
The Client Connect the Server for login via the ServClientServant.
Configuration of current experiment should be set by the Server.
The experiment starts, and the State Machine copy the configuration to its own image, which will serve the current experiment.

11. Configuration Each experiment configuration has at least one session.
ניתן לשים לב לעמודה NoOfSessions בטבלת ה- ConfigTable, שמכילה בעצם את מספר השורות השייכות לניסוי זה בטבלת ה- SessionsTable.

12. Scores & Reward
Each user score & reward of every session game is being stored.
ניתן לראות את הניקוד שצבר כל משתתף בכל משחק, וכן את התגמול עבור אותו משחק.
כן מחושב התגמול הסופי.

13. Messages Every message is being stored in the Server.
Messages can be monitored to the supervisor of the experiment.
The supervisor can reject or approve any message according to its content due to ‘sending messages policy’.

14. Messages & Addressee Relations
א) להודעה אחת יכולים
להיות מספר מכותבים
(הודעות מס' 9,14).
ב) יש להבדיל בין מספר
הודעה אצל השרת,
לבין מספר הודעה
אצל הלקוח.

15. ClientCommandsServant UnblockClientCommands
D.A.G
Client
RegistrationSrvant
MainFrame
Directed Acyclic Graph
LoginManager
GameFrame
MessageTool
SurveyEditor
ServeClientServant
UsersData
GraphViewer
NotificationTool DB
StateMachine
ConfigControl
GraphServer
SurveyServer
MessageServer
ManualCommands
EventsToCommand
ClientCommandsServant
UnblockClientCommands

16. E N D