-
Notifications
You must be signed in to change notification settings - Fork 3
/
index.html
159 lines (154 loc) · 6.95 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>PsyGlass Experimenter Console</title>
<link rel="shortcut icon" href="resources/favicon.ico">
<link rel="stylesheet" type="text/css" href="resources/style.css">
</head>
<body>
<nav>
<ul class="clearfix">
<li><a id="nav_home" href="index.html">PG</a></li>
<li><a class="nav_item nav_item_selected" href="index.html">Home</a></li>
<li><a class="nav_item" href="experiment.html">Experiment</a></li>
<li><a class="nav_item" href="data.html">Data</a></li>
</ul>
</nav>
<div id="content">
<h1>Instructions</h1>
<div id="content2">
<h2>Welcome to the Home page</h2>
<p>
This is the web browser client for PsyGlass.
This website is meant to be used in conjunction with PsyGlass Glassware installed in one
or more Google Glass devices.
The goal of this website is to allow you to change the color and text on the
display of a user's device during a session, while the device collects data from its sensors.
</p>
<p>
You are currently on the Home page of the website.
Use this page to familiarize yourself with the functions of the website,
such as creating and guiding a session or viewing the data collected during a session.
</p>
<h2>Running a session</h2>
<p>
Clicking on the Experiment tab on the navigation bar will take you to a page where you will
be able to create and manage a session.
</p>
<p>
In addition to the website navigation bar, the Experiment page consists of two main
elements: the card space and the status bar.<br>
The card space shows two cards, which represent the states of two devices.
A card will be attached to a device when it connects and will show you information about
the device, such as its status and ping.
The status bar shows the state of the session and contains the button through which you
will change the state of the session.
</p>
<p>
A session is dependent on four states:
<ul>
<li>Disconnected - The client is not connected to the server</li>
<p>
The session starts at the Disconnected state.<br>
The log will say "Disconnected from server".<br>
The session button will say "Connect to Server".<br>
Clicking the session button will move the session to the Starting state.
</p>
<li>Starting - The server is accepting connections from devices</li>
<p>
The log will say "Waiting for devices...".<br>
The session button will say "Start Session", but will not be clickable.<br>
Once a device connects, the card attached to that device will become active.<br>
The card's status will say "Connected" and the ping will begin to change.<br>
The session button will become clickable.<br>
Clicking the session button will move the session to the Running state.
</p>
<li>Running - The server is pushing device display updates to connected devices</li>
<p>
The log will say "Session is in progress".<br>
The session button will say "End Session".<br>
You can modify the text and background color of a card and click "Send Update" to
push the changes to the attached device.<br>
Sending an update will change the card status to "Sending update..."
and freeze the card.<br>
Once the client receives a response from the device, the card will be unfrozen.<br>
Clicking the session button will move the session to the Finishing state.
</p>
<li>Finishing - The server is awaiting a disconnect instruction</li>
<p>
The log will say "Session has ended".<br>
The session button will say "Disconnect from Server".<br>
Clicking the session button will move the session to the Disconnected state.
</p>
</ul>
</p>
<img src="resources/images/experiment.png" />
<h2>Viewing session data</h2>
<p>
The third tab on the navigation bar is the Data tab. It will take you to a page where you
will be able to view the data collected on a device during the latest session.
</p>
<p>
In addition to the website navigation bar, the Data page consists of two main elements:
the session timestamp field and the file space.<br>
If there is session data stored on the server, the session timestamp field will show the
date and time of when the latest session was conducted.<br>
If there is session data stored on the server, the available data from one or more devices
will be shown in the file space.
</p>
<p>
In order to copy the data to your clipboard, you must manually highlight all rows of data,
right click the highlighted area, and click Copy. You can alternatively highlight and
Ctrl+C.
</p>
<img src="resources/images/data.png" />
<h2>Things to consider</h2>
<p>
PsyGlass is an open-source project. Accordingly, here are a few things to keep in mind
when using and monitoring the experimenter console:
<ul>
<li>
Try not to leave the Experiment page if you're connected to the server
<p>
When you connect to the server, the server creates a new session in memory.
If you leave the page before clicking the disconnect button, the server is
not notified, and therefore will assume the session is still active.
Rejoining the server will clear the previous session and create a new one in its place.
Any devices connected to the previous session will throw an error and disconnect.
</p>
</li>
<li>
The ping on a card is an <i>approximation</i>
<p>
The ping shown on a card is an approximation of how well connected the client
is to the attached device. The general rule of thumb is that a very low ping
represents a good connection while a high ping represents a bad connection.
</p>
</li>
<li>
But the ping can tell you something else
<p>
The client and server cannot determine when a device disconnects mid-session.
However, you can use the ping of the corresponding card to determine this yourself.
If the ping continuously increases, then the device has been disconnected.
</p>
</li>
<li>
The server does not tell the device to automatically upload its data
<p>
After you end a session, make sure you or the device user manually navigates to the
Upload section of the PsyGlass Glassware. Give the device time to upload the data.
Additionally, give the server some time to save the data to memory.
This process may take seconds to minutes depending on the amount of data collected.
</p>
</li>
</ul>
</p>
<h2>Credits</h2>
<p><i>Created by Kevin Rodriguez, Alexandra Paxton, and Rick Dale. For more, see Paxton,
Rodriguez, & Dale (submitted).</i></p>
</div>
</div>
</body>
</html>