forked from OrganicityEu/organicityeu.github.io
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathset.html
132 lines (104 loc) · 5.5 KB
/
set.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
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<title>Smartphone Experimentation | OrganiCity </title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<!-- Standard Favicon -->
<link rel="shortcut icon" type="image/x-icon" href="favicon.ico">
<!-- For iPhone: -->
<link rel="apple-touch-icon-precomposed" href="apple-touch-icon-precomposed.png">
<link rel="stylesheet" href="stylesheets/stylesheet.css">
</head>
<body>
<header>
<a href="http://organicity.eu/" title="OrganiCity - link to homepage">
<img src="images/organicity_logo.png" alt="OrganiCity">
</a>
</header>
<div class="title">
<h1>Smartphone Experimentation | OrganiCity</h1>
</div>
<div class="content">
<h1>Experimenter Guide</h1>
<h2>Introduction</h2>
<p>This guide will help you understand the functionality provided by the Smartphone Experimentation OrganiCity
CoCreation tool, its capabilities and all the necessary steps to create, configure, monitor and manage your
experiment as well as retrieve the data collected.</p>
<h2>Experimentation as a Service</h2>
<p>The Smartphone Experimentation is offered as an Experimentation As A Service tool that you can easily use over
via its cloud infrastructures and the provided Android Smartphone Application.</p>
<p><strong>Experimenter Portal</strong></p>
<!--General GUIDELINES + concepts UC-->
<p>The Smartphone Experimentation cloud interface is tightly integrated with the OrganiCity Experimenter's portal.
Most of the functionalities for managing the experimentation flow. In order to configure a new Experiment
Experimenters need to follow the steps presented bellow:</p>
<p>
<ul>
<li>Create an Account for OrganiCity and be accepted as an Experimenter.</li>
<li>Register a new Experiment and fill in all the required information.</li>
<li>Draw a number of regions of interest on the Map for the data collection to take place.</li>
<li>Create an Application of type "Smartphone Application".</li>
<li>Now your application is ready to be executed! (not realy :P)</li>
</ul>
</p>
<p>
There are <i>three operations that differentiate</i> the creation of a Smartphone Crowdsensing Experiment from
the rest
of the OrganiCity Experiments.
</p>
<p>
First, when the experimentation areas are defined, the experimenter need to specify more information including:
<ul>
<li>the expected <b>number of samples</b> (minimum and expected) for collection by the experimenters,</li>
<li>the <b>time spans</b> for the experimentation to be executed,</li>
<li>the <b>importance</b> of the area in the whole experiment.</li>
</ul>
</p>
<p>
Secondly, the experimenter needs to select which sensors the experiment will use on the smartphone.
The experimenter can select any of the available sensor plugins without the need for uploading any piece of
code.
In the case that the experimenter needs to upload a new sensor plugin, the upload can be done from this link.
Any new sensor plugin can be either public or private based on the choice of the experimenter.
</p>
<p>
Finally, the experimenter needs to provide the jar file that contains the business logic of the experiment.
This is a specific jar file for the experiment and is responsible for preparing the data for upload to the
Smartphone Experimentation Storage Services.
</p>
<p><strong>Development Environment</strong></p>
<p>
Smartphone Experimentation is based on the Ambient Dynamix project and the execution of OSGi plugins inside a
host Android application. Specific security and privacy checks are performed internally to restrict the usage
to sensors and interfaces on the phones based on the user's preferences. Information about how to install the
Ambient Dynamix development environment in is available on the Ambient Dynamix
<a href="http://ambientdynamix.org/documentation/plug-in-development-guide">Website</a>.
</p>
<p>
In the context of Smartphone Experimentation there are two types of OSGi plugins to be used:
<ul>
<li>Sensors and</li>
<li>Experiments</li>
</ul>
Both operate on an async call for a context update and provide data back to the SET wrapper for this request. (calls
to handleContextRequest )
Experiment Plugins can access data from all Sensor plugins and :
<ul>
<li>either simply aggregate them to a single measurement to upload to the server or</li>
<li>do internal calculations and format the results as the message to upload to the server.</li>
</ul>
Code templates and examples for sensor and experiment plugins are available in the following repositories:
<ul>
<li><a href="https://github.com/OrganicityEu/smartphone-experimentation-plugins">Sensor Plugins</a></li>
<li><a href="https://github.com/OrganicityEu/smartphone-experimentation-experiments">Experiment Plugins</a></li>
</ul>
All of them are available to use without the need for any development. If experimenters need to use any of them,
they simply need to select them during the creation of the experiment.
</p>
</div>
<footer>© OrganiCity 2016</footer>
</body>
</html>