| rev |
line source |
|
charnik@211
|
1 Strabon
|
|
charnik@211
|
2 -----------
|
|
charnik@211
|
3
|
|
charnik@211
|
4 Introduction
|
|
charnik@211
|
5 ============
|
|
charnik@211
|
6 Strabon is a fully implemented semantic geospatial database system that can be
|
|
charnik@211
|
7 used to store linked geospatial data expressed in RDF and query them using an
|
|
charnik@211
|
8 extension of SPARQL. Strabon supports spatial selections, spatial joins, a rich
|
|
charnik@211
|
9 set of spatial functions similar to those offered by geospatial relational
|
|
charnik@211
|
10 database systems, support for multiple Coordinate Reference Systems and widely
|
|
charnik@211
|
11 used serializations for geometric objects such as WKT and GML. Strabon is built
|
|
charnik@211
|
12 on top of the well-known RDF store Sesame and extends Sesame’s components to be
|
|
charnik@211
|
13 able to manage thematic and spatial data that are stored in PostGIS.
|
|
charnik@211
|
14
|
|
charnik@211
|
15 The development of Strabon started in the context of European FP7 project
|
|
charnik@211
|
16 SemsorGrid4Env (Semantic Sensor Grids for Rapid Application Development for
|
|
charnik@211
|
17 Environmental Management) [http://www.semsorgrid4env.eu/]. Starting September
|
|
charnik@211
|
18 2011, Strabon is being utilized and extended with new functionalities in the
|
|
charnik@211
|
19 FP7 project TELEIOS (Virtual Observatory Infrastructure for Earth Observation
|
|
charnik@211
|
20 Data) [http://www.earthobservatory.eu/] which our group leads.
|
|
charnik@211
|
21
|
|
charnik@211
|
22 The query language of Strabon is called stSPARQL. stSPARQL can be used to query
|
|
charnik@211
|
23 data represented in an extension of RDF called stRDF. stRDF and stSPARQL have
|
|
charnik@211
|
24 been designed for representing and querying geospatial data that changes over
|
|
charnik@211
|
25 time (e.g., the growth of a city over the years due to new developments).
|
|
charnik@211
|
26
|
|
kkyzir@639
|
27 Given the very close relationship between stSPARQL and GeoSPARQL which is a
|
|
kkyzir@639
|
28 recent OGC standard for an extension of SPARQL for querying geospatial metadata,
|
|
kkyzir@639
|
29 we recently provided support for the Core, Geometry and Geometry Topology
|
|
kkyzir@639
|
30 extension of GeoSPARQL.
|
|
kkyzir@639
|
31
|
|
charnik@211
|
32
|
|
charnik@1006
|
33 Conformance to GeoSPARQL
|
|
charnik@1006
|
34 ========================
|
|
charnik@1006
|
35 Strabon implements the `Core', the `Topology Vocabulary Extension', the
|
|
charnik@1006
|
36 `Geometry Extension', the `Geometry Topology Extension', and the `RDFS Entailment
|
|
charnik@1006
|
37 Extension' except for Req. 25
|
|
charnik@1006
|
38 (http://www.opengis.net/spec/geosparql/1.0/req/rdfs-entailment-extension/bgp-rdfs-ent).
|
|
charnik@1006
|
39
|
|
charnik@1006
|
40 With respect to GML, Strabon supports the GML Profile corresponding to Simple
|
|
charnik@1009
|
41 Features, that is, GML Simple Features Profile 2.0.
|
|
charnik@1006
|
42
|
|
charnik@1006
|
43
|
|
charnik@212
|
44 Strabon Homepage
|
|
charnik@212
|
45 ================
|
|
charnik@212
|
46 The homepage of Strabon is at http://www.strabon.di.uoa.gr/.
|
|
charnik@212
|
47
|
|
charnik@212
|
48
|
|
charnik@211
|
49 Demo
|
|
charnik@211
|
50 ====
|
|
charnik@211
|
51 You can find a demo of the system Strabon at http://test.strabon.di.uoa.gr/NOA/.
|
|
charnik@211
|
52
|
|
charnik@212
|
53
|
|
charnik@1022
|
54 How to build and run Strabon from command line
|
|
charnik@1022
|
55 ==============================================
|
|
charnik@1022
|
56 Assuming you have already downloaded Strabon and you are in the top-level
|
|
charnik@1022
|
57 directory of Strabon, issue the following command to build it from command line:
|
|
charnik@1022
|
58
|
|
kkyzir@1118
|
59 $ mvn clean package
|
|
charnik@1022
|
60
|
|
psmeros@1205
|
61 In order to run automatically the JUnit tests, pass the option `-DskipTests=false'
|
|
kkyzir@1118
|
62 to the above command. The complete command is the following:
|
|
charnik@1022
|
63
|
|
kkyzir@1118
|
64 $ mvn -DskipTests=false clean package
|
|
charnik@1022
|
65
|
|
charnik@1365
|
66 Alternatively, it is possible to run a specific test. Supposing that the name of
|
|
charnik@1365
|
67 the corresponding class is `TestName', then you can run only this
|
|
charnik@1365
|
68 test using the following command:
|
|
charnik@1365
|
69
|
|
charnik@1365
|
70 $ mvn test -DfailIfNoTests=false -DskipTests=false -Dtest=TestName
|
|
charnik@1365
|
71
|
|
charnik@1022
|
72 In case of an error during building of Strabon and assuming that the error does
|
|
charnik@1022
|
73 not come from the JUnit tests, please have a look at the `Known Issues' section
|
|
charnik@1022
|
74 below. If none of the known issues of that section applies, please contact the
|
|
charnik@1022
|
75 developers through the Strabon mailing-list or submit a corresponding bug
|
|
charnik@1022
|
76 (see `Bugs' section below).
|
|
charnik@1022
|
77
|
|
charnik@1022
|
78 After you have successfully built Strabon, you have access to the following
|
|
charnik@1022
|
79 components:
|
|
charnik@1022
|
80
|
|
charnik@1022
|
81 * Strabon Endpoint
|
|
charnik@1022
|
82
|
|
charnik@1022
|
83 This is a SPARQL endpoint for Strabon. It is distributed as a war file so
|
|
charnik@1022
|
84 you may deploy it in a Tomcat container. You may find the war file under
|
|
charnik@1022
|
85 directory `endpoint/target'.
|
|
charnik@1022
|
86
|
|
charnik@1022
|
87 * Strabon Endpoint (standalone)
|
|
charnik@1022
|
88
|
|
charnik@1022
|
89 This is a SPARQL endpoint for Strabon like the above one, but it differs
|
|
charnik@1022
|
90 only in that it does not require the user to have already set up a Tomcat
|
|
charnik@1022
|
91 container. The standalone Strabon Endpoint may be run by issuing the
|
|
charnik@1022
|
92 following command:
|
|
charnik@1022
|
93
|
|
charnik@1022
|
94 $ java -jar endpoint-exec/target/strabon-endpoint-executable-${version}.jar
|
|
charnik@1022
|
95
|
|
charnik@1022
|
96 After issuing the above command, you may access the Strabon Endpoint at
|
|
charnik@1022
|
97 the following URL: <http://localhost:8080/>.
|
|
charnik@1022
|
98
|
|
charnik@1022
|
99 Please see the page at <http://hg.strabon.di.uoa.gr/Strabon/rev/674f8f91162b>
|
|
charnik@1022
|
100 to find out other options that you may pass to the Tomcat container that
|
|
charnik@1022
|
101 will run by the above command.
|
|
charnik@1022
|
102
|
|
charnik@1022
|
103 SPECIAL NOTE: if you need to configure the connection details to the
|
|
charnik@1022
|
104 underlying database, you may do so in two ways:
|
|
charnik@1022
|
105 1. By modifying file `endpoint/WebContent/WEB-INF/connection.properties'
|
|
charnik@1022
|
106 before building Strabon and executing the above command.
|
|
charnik@1022
|
107 2. After executing the above command, by visiting the following page by a
|
|
charnik@1022
|
108 browser: <http://localhost:8080/ChangeConnection>
|
|
charnik@1022
|
109
|
|
charnik@1022
|
110 * Strabon Endpoint Client
|
|
charnik@1022
|
111
|
|
charnik@1022
|
112 This is a Java client for interacting with Strabon Endpoint or any other
|
|
charnik@1022
|
113 SPARQL endpoint. It is packaged as a jar file and may be found under
|
|
charnik@1022
|
114 directory `endpoint-client/target/' with name
|
|
charnik@1022
|
115 `strabon-endpoint-client-${version}.jar'. This jar contains any dependencies
|
|
charnik@1022
|
116 to other code, so may copy and paste it to your project and start playing
|
|
charnik@1022
|
117 with the code immediately.
|
|
charnik@1022
|
118
|
|
charnik@1022
|
119 * Strabon script
|
|
charnik@1022
|
120
|
|
charnik@1022
|
121 The `strabon' script is located under the `scripts/' directory and it is the
|
|
charnik@1022
|
122 main command-line tool for interacting with Strabon. You may use it to store
|
|
charnik@1022
|
123 RDF data with geospatial information or query/update it using one of
|
|
charnik@1022
|
124 stSPARQL or GeoSPARQL query languages.
|
|
charnik@1022
|
125
|
|
charnik@1022
|
126 * Endpoint script
|
|
charnik@1022
|
127
|
|
charnik@1022
|
128 The `endpoint' script is located under the `scripts' directory and it is the
|
|
charnik@1022
|
129 main command-line tool for interacting with a `Strabon Endpoint'. You may
|
|
charnik@1022
|
130 use it to do any operation you would like to do with the `strabon' script
|
|
charnik@1022
|
131 above, but in contrast to the `strabon' script you need to have access to a
|
|
charnik@1022
|
132 Strabon endpoint. Of course, the `Strabon Endpoint Client' component above
|
|
charnik@1022
|
133 can be used as well as a command-line tool. At the time of writing, the
|
|
charnik@1022
|
134 `Strabon Endpoint Client' component supports only querying of RDF data with
|
|
charnik@1022
|
135 geospatial information.
|
|
charnik@1022
|
136
|
|
charnik@1022
|
137
|
|
charnik@211
|
138 Getting Started
|
|
charnik@211
|
139 ===============
|
|
charnik@211
|
140 To get started with Strabon please have a look at the tutorial for the stRDF
|
|
charnik@211
|
141 data model and stSPARQL query language, the User Guide, and the Developer Guide.
|
|
charnik@211
|
142
|
|
charnik@211
|
143 stRDF and stSPARQL tutorial
|
|
charnik@211
|
144 http://www.strabon.di.uoa.gr/files/stSPARQL_tutorial.pdf
|
|
charnik@211
|
145
|
|
kkyzir@800
|
146
|
|
kkyzir@800
|
147 stSPARQL Reference
|
|
kkyzir@800
|
148 ~~~~~~~~~~~~~~~~~~
|
|
kkyzir@800
|
149 The reference for the spatial and temporal extension functions defined in
|
|
Konstantina@1283
|
150 stSPARQL can be found at http://www.strabon.di.uoa.gr/stSPARQL.
|
|
kkyzir@800
|
151
|
|
kkyzir@800
|
152
|
|
charnik@211
|
153 User Guide
|
|
charnik@211
|
154 ~~~~~~~~~~
|
|
charnik@211
|
155 Assuming that you are familiar with Maven, the following steps need to be
|
|
charnik@211
|
156 followed in order to use Strabon using Eclipse:
|
|
charnik@211
|
157
|
|
charnik@211
|
158 1. Install PostgreSQL from http://www.postgresql.org/download/. At the time of
|
|
charnik@211
|
159 this writing the latest PostgreSQL version is 9.1.
|
|
charnik@211
|
160 2. Install PostGIS from http://postgis.refractions.net/download/. At the time of
|
|
Konstantina@1281
|
161 this writing we have tested Strabon with PostGIS 1.5.3. For the
|
|
Konstantina@1281
|
162 temporal features of stSPARQL download the PostgreSQL temporal extension
|
|
Konstantina@1281
|
163 from here: https://github.com/jeff-davis/PostgreSQL-Temporal and follow
|
|
Konstantina@1281
|
164 the installation guide.
|
|
charnik@211
|
165 3. Install Maven from http://maven.apache.org/download.html. At the time of this
|
|
charnik@211
|
166 writing the latest Maven version is 3.0.4.
|
|
charnik@211
|
167 4. Install Eclipse from http://www.eclipse.org/downloads/. At the time of this
|
|
charnik@211
|
168 writing the latest Eclipse version is 3.7.2.
|
|
charnik@211
|
169 5. Install the m2e plugin for Eclipse from http://www.eclipse.org/m2e/.
|
|
charnik@211
|
170 6. Install the MercurialEclipse plugin for Eclipse from
|
|
charnik@211
|
171 http://javaforge.com/project/HGE .
|
|
charnik@211
|
172 7. From Eclipse, go to File --> Import --> Mercurial --> Clone Existing
|
|
charnik@211
|
173 Mercurial Repository --> Next. In the URL textarea paste the following
|
|
charnik@211
|
174 URL: http://hg.strabon.di.uoa.gr/StrabonUser and then press Next --> Next -->
|
|
charnik@211
|
175 Finish. If you used the default settings, you should have a new project named
|
|
charnik@211
|
176 StrabonMain. Right click on the project and select Configure --> Convert to
|
|
charnik@211
|
177 Maven project. Eclipse will enable Maven dependency management for the
|
|
charnik@211
|
178 project, download any dependencies and build the project.
|
|
charnik@211
|
179
|
|
charnik@211
|
180
|
|
charnik@211
|
181 Storing stRDF graphs and evaluating stSPARQL queries
|
|
charnik@211
|
182 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
charnik@211
|
183 You can see some examples in the classes gr.uoa.di.strabon.example.PostgisExample
|
|
charnik@211
|
184 and gr.uoa.di.strabon.example.PostgisExample2.
|
|
charnik@211
|
185
|
|
kkyzir@954
|
186 Tuning PostgreSQL
|
|
kkyzir@954
|
187 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
kkyzir@954
|
188 The default settings of Postgres are rather conservative. As a result, parameter
|
|
kkyzir@954
|
189 tuning is neccessary for speeding up Postgres, therefore Strabon. If you are
|
|
kkyzir@954
|
190 using Strabon to compare its performance against your implementation of
|
|
kkyzir@954
|
191 stSPARQL/GeoSPARQL, you are *strongly* encouraged to contact us using the Strabon
|
|
kkyzir@954
|
192 Users mailing list for assistance on tuning Postgres.
|
|
kkyzir@954
|
193
|
|
kkyzir@954
|
194 You can follow the instructions below for tuning a Postgres server running on an
|
|
kkyzir@954
|
195 Ubuntu machine that is dedicated to PostgreSQL and Strabon.
|
|
kkyzir@954
|
196
|
|
kkyzir@954
|
197 1. Append the following text at the end of postgresql.conf.
|
|
kkyzir@954
|
198 *Uncomment* the appropriate lines.
|
|
kkyzir@954
|
199
|
|
kkyzir@954
|
200 ### RAM
|
|
kkyzir@954
|
201 ## 4 GB of RAM
|
|
kkyzir@954
|
202 #shared_buffers = 3GB
|
|
kkyzir@954
|
203 #effective_cache_size = 3GB
|
|
kkyzir@954
|
204 #maintenance_work_mem = 1GB
|
|
kkyzir@954
|
205 #work_mem = 2GB
|
|
kkyzir@954
|
206 ## 8 GB of RAM
|
|
kkyzir@954
|
207 #shared_buffers = 5GB
|
|
kkyzir@954
|
208 #effective_cache_size = 6GB
|
|
kkyzir@954
|
209 #maintenance_work_mem = 2GB
|
|
kkyzir@954
|
210 #work_mem = 5GB
|
|
kkyzir@954
|
211 ## 16 GB of RAM
|
|
kkyzir@954
|
212 #shared_buffers = 10GB
|
|
kkyzir@954
|
213 #effective_cache_size = 14GB
|
|
kkyzir@954
|
214 #maintenance_work_mem = 4GB
|
|
kkyzir@954
|
215 #work_mem = 10GB
|
|
kkyzir@954
|
216 ## 24 GB of RAM
|
|
kkyzir@954
|
217 #shared_buffers = 16GB
|
|
kkyzir@954
|
218 #effective_cache_size = 22GB
|
|
kkyzir@954
|
219 #maintenance_work_mem = 6GB
|
|
kkyzir@954
|
220 #work_mem = 15GB
|
|
kkyzir@954
|
221 ## 48 GB of RAM
|
|
kkyzir@954
|
222 #shared_buffers = 32GB
|
|
kkyzir@954
|
223 #effective_cache_size = 46GB
|
|
kkyzir@954
|
224 #maintenance_work_mem = 8GB
|
|
kkyzir@954
|
225 #work_mem = 30GB
|
|
kkyzir@954
|
226 ## 64 GB of RAM
|
|
kkyzir@954
|
227 # contact us to find out!
|
|
kkyzir@954
|
228 ### HD
|
|
kkyzir@954
|
229 ## RAID with ordinary 7.200 disks
|
|
kkyzir@954
|
230 #random_page_cost = 3.5 #3.0-3.5
|
|
kkyzir@954
|
231 ## High-End NAS/SAN
|
|
kkyzir@954
|
232 #random_page_cost = 2 #1.5-2.5
|
|
kkyzir@954
|
233 ## Amazon EBS/Heroku
|
|
kkyzir@954
|
234 #random_page_cost = 1.3 #1.1-2.0
|
|
kkyzir@954
|
235 ## SSD array
|
|
kkyzir@954
|
236 #random_page_cost = 2.0 #1.5-2.5
|
|
kkyzir@1147
|
237 ### Planner options
|
|
kkyzir@1147
|
238 # Increase the following values in order to avoid using the GEQO planner.
|
|
kkyzir@1147
|
239 # Small values (<8) reduce planning time but may produce inferior query plans
|
|
kkyzir@1147
|
240 #
|
|
kkyzir@1147
|
241 geqo_threshold = 15 # keep this value larger that the following two parameters
|
|
kkyzir@1147
|
242 from_collapse_limit = 14
|
|
kkyzir@1147
|
243 join_collapse_limit = 14
|
|
kkyzir@954
|
244 ### Misc
|
|
kkyzir@954
|
245 default_statistics_target = 10000
|
|
kkyzir@954
|
246 constraint_exclusion = on
|
|
kkyzir@954
|
247 checkpoint_completion_target = 0.9
|
|
kkyzir@954
|
248 wal_buffers = 32MB
|
|
kkyzir@954
|
249 checkpoint_segments = 64
|
|
kkyzir@954
|
250 ### Connections
|
|
kkyzir@954
|
251 max_connections = 10
|
|
kkyzir@954
|
252
|
|
kkyzir@954
|
253 2. Append the following lines at the end of /etc/sysctl.conf
|
|
kkyzir@954
|
254 *Uncomment* the appropriate lines.
|
|
kkyzir@954
|
255
|
|
kkyzir@954
|
256 ## 4 GB of RAM
|
|
kkyzir@954
|
257 #kernel.shmmax = 3758096384
|
|
kkyzir@954
|
258 #kernel.shmall = 3758096384
|
|
kkyzir@954
|
259 #kernel.shmmni = 4096
|
|
kkyzir@954
|
260 ## 8 GB of RAM
|
|
kkyzir@954
|
261 #kernel.shmmax = 5905580032
|
|
kkyzir@954
|
262 #kernel.shmall = 5905580032
|
|
kkyzir@954
|
263 #kernel.shmmni = 4096
|
|
kkyzir@954
|
264 ## 16 GB of RAM
|
|
kkyzir@954
|
265 #kernel.shmmax = 11274289152
|
|
kkyzir@954
|
266 #kernel.shmall = 11274289152
|
|
kkyzir@954
|
267 #kernel.shmmni = 4096
|
|
kkyzir@954
|
268 ## 24 GB of RAM
|
|
kkyzir@954
|
269 #kernel.shmmax = 17716740096
|
|
kkyzir@954
|
270 #kernel.shmall = 17716740096
|
|
kkyzir@954
|
271 #kernel.shmmni = 4096
|
|
kkyzir@954
|
272 ## 48 GB of RAM
|
|
kkyzir@954
|
273 #kernel.shmmax = 35433480192
|
|
kkyzir@954
|
274 #kernel.shmall = 35433480192
|
|
kkyzir@954
|
275 #kernel.shmmni = 4224
|
|
kkyzir@954
|
276 ## 64 GB of RAM
|
|
kkyzir@954
|
277 # contact us to find out!
|
|
kkyzir@954
|
278
|
|
charnik@969
|
279 3. Apply all changes by executing
|
|
kkyzir@954
|
280
|
|
kkyzir@954
|
281 $ sudo sysctl -p
|
|
kkyzir@954
|
282 $ sudo /etc/init.d/postgresql restart
|
|
kkyzir@954
|
283
|
|
kkyzir@954
|
284 4. Prepare for the next run by issuing the command
|
|
kkyzir@954
|
285
|
|
kkyzir@954
|
286 $ sudo -u postgres psql -c 'VACUUM ANALYZE;' db
|
|
kkyzir@954
|
287
|
|
kkyzir@954
|
288 or
|
|
kkyzir@954
|
289
|
|
kkyzir@954
|
290 $ psql -c 'VACUUM ANALYZE;' db
|
|
kkyzir@954
|
291
|
|
kkyzir@954
|
292 where db is the name of the Postgres database that Strabon will use.
|
|
kkyzir@954
|
293
|
|
charnik@211
|
294
|
|
charnik@211
|
295 Developer Guide
|
|
charnik@211
|
296 ~~~~~~~~~~~~~~~
|
|
charnik@211
|
297 Assuming that you are familiar with Maven, the following steps need to be
|
|
charnik@211
|
298 followed in order to use Strabon using Eclipse:
|
|
charnik@211
|
299
|
|
charnik@211
|
300 1. Install PostgreSQL from http://www.postgresql.org/download/. At the time of
|
|
charnik@211
|
301 this writing the latest PostgreSQL version is 9.1.
|
|
charnik@211
|
302 2. Install PostGIS from http://postgis.refractions.net/download/. At the time of
|
|
Konstantina@1281
|
303 this writing we have tested Strabon with PostGIS 1.5.3. For the
|
|
Konstantina@1281
|
304 temporal features of stSPARQL download the PostgreSQL temporal extension
|
|
Konstantina@1281
|
305 from here: https://github.com/jeff-davis/PostgreSQL-Temporal and follow
|
|
Konstantina@1281
|
306 the installation guide.
|
|
charnik@211
|
307 3. Install Maven from http://maven.apache.org/download.html. At the time of this
|
|
charnik@211
|
308 writing the latest Maven version is 3.0.4.
|
|
charnik@211
|
309 4. Install Eclipse from http://www.eclipse.org/downloads/. At the time of this
|
|
charnik@211
|
310 writing the latest Eclipse version is 3.7.2.
|
|
charnik@211
|
311 5. Install the m2e plugin for Eclipse from http://www.eclipse.org/m2e/.
|
|
charnik@211
|
312 6. Install the MercurialEclipse plugin for Eclipse from
|
|
charnik@211
|
313 http://javaforge.com/project/HGE.
|
|
charnik@211
|
314 7. From Eclipse, go to File --> Import --> Mercurial --> Clone Existing
|
|
charnik@211
|
315 Mercurial Repository --> Next. In the URL textarea paste the following
|
|
charnik@211
|
316 URL: http://hg.strabon.di.uoa.gr/Strabon and then press Next --> Next -->
|
|
charnik@211
|
317 Finish. If you used the default settings, you should have a new project named
|
|
charnik@211
|
318 StrabonMain. Right click on the project and select Configure --> Convert to
|
|
charnik@211
|
319 Maven project. Eclipse will enable Maven dependency management for the
|
|
charnik@211
|
320 project, download any dependencies and build the project.
|
|
charnik@211
|
321
|
|
charnik@211
|
322
|
|
psmeros@993
|
323 Tester Guide
|
|
psmeros@993
|
324 ~~~~~~~~~~~~
|
|
psmeros@993
|
325 Assuming again that you are familiar with Maven and Junit these are the steps
|
|
psmeros@993
|
326 you need to follow to test the functionality of Strabon:
|
|
psmeros@993
|
327
|
|
psmeros@1031
|
328
|
|
psmeros@993
|
329 * Using Eclipse
|
|
psmeros@993
|
330
|
|
psmeros@993
|
331 If you want to create a new test:
|
|
psmeros@993
|
332
|
|
psmeros@993
|
333 1. Import Strabon into Eclipse as explained in the Developer Guide.
|
|
psmeros@1031
|
334 2. Go to strabon-testsuite project.
|
|
psmeros@1031
|
335 3. Create a new folder (Recommended folder name: <test's name>) and place inside the following files:
|
|
psmeros@1051
|
336 3.1. An ntriples or nquads file with the test dataset (with .nt or .nq extension).
|
|
psmeros@1051
|
337 3.2. Pairs of files with sparql test queries and expected test results in xml format.
|
|
psmeros@1051
|
338 Notice that each pair must have the same name and .rq extension for the queryFile and .srx extension for the resultsFile.
|
|
psmeros@1031
|
339 4. Create a test class that extends TemplateTest class.
|
|
psmeros@1079
|
340 5. If you have followed the recommendations the test is ready. If you have different names or location for your
|
|
psmeros@1079
|
341 files, insert them explicitly in the constructor of the class. WARNING: All prefixes must be placed in file "prefixes" so that
|
|
psmeros@1079
|
342 every time a namespace changes, we have to change it just once.
|
|
psmeros@1031
|
343
|
|
psmeros@1031
|
344 If you want to run a test:
|
|
psmeros@1031
|
345
|
|
psmeros@1031
|
346 1. Right-click on the test class.
|
|
psmeros@1031
|
347 2. Select "Run as JUnit Test".
|
|
psmeros@1031
|
348 3. Database properties are retrieved from database.properties file. If you want, you can change a property
|
|
psmeros@1051
|
349 "on the fly" with an environment variable.
|
|
psmeros@1031
|
350
|
|
psmeros@1031
|
351
|
|
psmeros@1031
|
352 * Command Line
|
|
psmeros@1031
|
353
|
|
psmeros@1031
|
354 If you want to run all the tests:
|
|
psmeros@1031
|
355
|
|
psmeros@1031
|
356 1. Go to Strabon directory (root directory of all the subprojects).
|
|
psmeros@1130
|
357 2. Run "mvn test -DskipTests=false".
|
|
psmeros@1031
|
358 3. Optionally you can pass an environment variable with "-DvariableName=variableValue".
|
|
psmeros@993
|
359
|
|
psmeros@993
|
360
|
|
psmeros@993
|
361 Storing stRDF graphs and evaluating stSPARQL queries
|
|
psmeros@993
|
362 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
charnik@211
|
363 You can see some examples in the classes
|
|
charnik@211
|
364 eu.earthobservatory.runtime.postgis.StoreOp and
|
|
charnik@211
|
365 eu.earthobservatory.runtime.postgis.QueryOp.
|
|
charnik@211
|
366
|
|
charnik@211
|
367
|
|
charnik@211
|
368 Download
|
|
charnik@211
|
369 ========
|
|
charnik@211
|
370 You can download the source code of the latest version of Strabon by accessing
|
|
charnik@211
|
371 our public mercurial repository located at http://hg.strabon.di.uoa.gr/Strabon.
|
|
charnik@211
|
372 You can find more information on how to use and extend Strabon at the Getting
|
|
charnik@211
|
373 Started section.
|
|
charnik@211
|
374
|
|
charnik@211
|
375
|
|
charnik@211
|
376 Publications
|
|
charnik@211
|
377 ============
|
|
charnik@211
|
378 You can learn about stRDF data model and stSPARQL query language employed in
|
|
charnik@211
|
379 Strabon by reading our tutorial under the Getting Started section and/or the
|
|
charnik@211
|
380 publications given on this page.
|
|
charnik@211
|
381
|
|
charnik@211
|
382 The current versions of stRDF and stSPARQL which are based on OGC standards are
|
|
Konstantina@1121
|
383 presented in the following documents:
|
|
charnik@554
|
384 * K. Kyzirakos, M. Karpathiotakis, and M. Koubarakis. Strabon: A Semantic
|
|
charnik@554
|
385 Geospatial DBMS. In Internatioanl Semantic Web Conference (ISWC'12). Boston,
|
|
charnik@554
|
386 USA, November 11-15, 2012.
|
|
charnik@554
|
387 [pdf: http://strabon.di.uoa.gr/files/strabon-iswc.pdf]
|
|
charnik@554
|
388
|
|
charnik@211
|
389 * Manolis Koubarakis, Kostis Kyzirakos, Babis Nikolaou, Michael Sioutis, and
|
|
charnik@211
|
390 Stavros Vassos. A data model and query language for an extension of RDF with
|
|
charnik@211
|
391 time and space. Deliverable D2.1, European ICT project TELEIOS, 2011.
|
|
charnik@211
|
392 [pdf: http://strabon.di.uoa.gr/files/deliv2-1-re-revised.pdf]
|
|
Konstantina@1121
|
393
|
|
Konstantina@1121
|
394 The temporal features of stRDF and stSPARQL are presented in the following
|
|
Konstantina@1121
|
395 document:
|
|
Konstantina@1121
|
396 * K. Bereta, P. Smeros and M. Koubarakis. Representing and Querying the
|
|
Konstantina@1121
|
397 Valid Time of Triples for Linked Geospatial Data. In the 10th Extended
|
|
Konstantina@1121
|
398 Semantic Web Conference (ESWC 2013). Montpellier, France. May 26-30, 2013.
|
|
Konstantina@1121
|
399 [pdf: http://www.strabon.di.uoa.gr/files/eswc2013.pdf]
|
|
charnik@211
|
400
|
|
charnik@211
|
401 The initial versions of stRDF and stSPARQL that are based on constraint
|
|
charnik@211
|
402 databases are presented in the following publications:
|
|
charnik@211
|
403 * Manolis Koubarakis and Kostis Kyzirakos. Modeling and Querying Metadata in
|
|
charnik@211
|
404 the Semantic Sensor Web: the Model stRDF and the Query Language stSPARQL.
|
|
charnik@211
|
405 In 7th Extended Semantic Web Conference (ESWC 2010). Heraklion, Crete,
|
|
charnik@211
|
406 30 May - 03 June, 2010.
|
|
charnik@211
|
407 [pdf: http://strabon.di.uoa.gr/files/stSPARQL.pdf]
|
|
charnik@211
|
408
|
|
charnik@211
|
409 * Kostis Kyzirakos, Manos Karpathiotakis and Manolis Koubarakis. Developing
|
|
charnik@211
|
410 Registries for the Semantic Sensor Web using stRDF and stSPARQL (short
|
|
charnik@211
|
411 paper).
|
|
charnik@211
|
412 In Proceedings of 3rd International workshop on Semantic Sensor Networks
|
|
charnik@211
|
413 2010, in conjunction with ISWC 2010, November 2010, Shanghai, China.
|
|
charnik@211
|
414 [pdf: http://strabon.di.uoa.gr/files/strabon.pdf]
|
|
charnik@211
|
415
|
|
charnik@211
|
416 Applications of stRDF, stSPARQL, and the system Strabon are described here:
|
|
charnik@211
|
417 * Alasdair J. G. Gray, Raúl García-Castro, Kostis Kyzirakos, Manos
|
|
charnik@211
|
418 Karpathiotakis, Jean-Paul Calbimonte, Kevin Page, Jason Sadler, Alex
|
|
charnik@211
|
419 Frazer, Ixent Galpin, Alvaro A. A. Fernandes, Norman W. Paton, Oscar
|
|
charnik@211
|
420 Corcho, Manolis Koubarakis, David De Roure, Kirk Martinez and Asunción
|
|
charnik@211
|
421 Gómez-Pérez. A Semantically Enabled Service Architecture for Mashups over
|
|
charnik@211
|
422 Streaming and Stored Data. In 8th Extended Semantic Web Conference (ESWC
|
|
charnik@211
|
423 2011). Heraklion, Crete, May 20 - June 2, 2011.
|
|
charnik@211
|
424 [pdf: http://strabon.di.uoa.gr/files/Gray2011Architecture.pdf]
|
|
charnik@211
|
425
|
|
charnik@211
|
426 * A.J.G. Gray, J. Sadler, O. Kit, K. Kyzirakos, M. Karpathiotakis, J.-P.
|
|
charnik@211
|
427 Calbimonte, K. Page, R. García-Castro, A. Frazer, I. Galpin, A.A.A.
|
|
charnik@211
|
428 Fernandes, N.W. Paton, O. Corcho, M. Koubarakis, D.D. Roure, K. Martinez,
|
|
charnik@211
|
429 A. Gómez-Pérez. A Semantic Sensor Web for Environmental Decision Support
|
|
charnik@211
|
430 Applications. Sensors. 11, 8855-8887.
|
|
charnik@211
|
431 [pdf: http://strabon.di.uoa.gr/files/sensors-11-08855.pdf]
|
|
charnik@211
|
432
|
|
charnik@211
|
433 Coming up soon:
|
|
charnik@211
|
434 Strabon will soon support an extension of RDF for incomplete geospatial
|
|
charnik@211
|
435 information. The following publication gives a preview of the relevant research
|
|
charnik@211
|
436 problems:
|
|
charnik@211
|
437 * M. Koubarakis, K. Kyzirakos, M. Karpathiotakis, C. Nikolaou, M. Sioutis,
|
|
charnik@211
|
438 S. Vassos, D. Michail, T. Herekakis, C. Kontoes and I. Papoutsis. Challenges
|
|
charnik@211
|
439 for Qualitative Spatial Reasoning in Linked Geospatial Data. In Proceedings
|
|
charnik@211
|
440 of IJCAI 2011 Workshop on Benchmarks and Applications of Spatial Reasoning,
|
|
charnik@211
|
441 Barcelona, Spain.
|
|
charnik@212
|
442 [pdf: http://www.earthobservatory.eu/publications/SciQL_ADASS2011.pdf]
|
|
charnik@211
|
443
|
|
charnik@812
|
444 * C. Nikolaou and M. Koubarakis: "Querying Linked Geospatial Data with
|
|
charnik@812
|
445 Incomplete Information". In 5th International Terra Cognita Workshop -
|
|
charnik@812
|
446 Foundations, Technologies and Applications of the Geospatial Web. In
|
|
charnik@812
|
447 conjunction with the 11th International Semantic Web Conference, Boston,
|
|
charnik@812
|
448 USA, November, 2012.
|
|
charnik@812
|
449 [http://www.earthobservatory.eu/publications/iswc-workshop.pdf]
|
|
charnik@812
|
450
|
|
charnik@211
|
451
|
|
charnik@211
|
452 Contributors
|
|
charnik@211
|
453 ============
|
|
charnik@211
|
454 The system Strabon has been developed by the following members of our team:
|
|
charnik@211
|
455
|
|
charnik@211
|
456 * Manos Karpathiotakis <mk@di.uoa.gr>
|
|
kostis@1319
|
457 * Kostis Kyzirakos <Kostis.Kyzirakos@cwi.nl>
|
|
charnik@211
|
458 * Manolis Koubarakis <koubarak@di.uoa.gr>
|
|
charnik@211
|
459 * Giorgos Garbis <ggarbis@di.uoa.gr>
|
|
charnik@211
|
460 * Konstantina Bereta <konstantina.bereta@di.uoa.gr>
|
|
kkyzir@639
|
461 * Charalampos Nikolaou <charnik@di.uoa.gr>
|
|
kkyzir@639
|
462 * Stella Gianakopoulou <sgian@di.uoa.gr>
|
|
psmeros@1322
|
463 * Panayiotis Smeros <psmeros@di.uoa.gr>
|
|
kallirroi@902
|
464 * Kallirroi Dogani <kallirroi@di.uoa.gr>
|
|
charnik@211
|
465
|
|
charnik@211
|
466
|
|
charnik@211
|
467 Mailing-list
|
|
charnik@211
|
468 ============
|
|
kkyzir@954
|
469 Currently, we maintain the following mailing lists:
|
|
kkyzir@954
|
470
|
|
kkyzir@954
|
471 * Strabon-users, is used as a communication channel for Strabon users.
|
|
kkyzir@954
|
472 To subscribe to the mailing-list, please visit page
|
|
kkyzir@954
|
473 http://cgi.di.uoa.gr/~mailman/listinfo/strabon-users. To post e-mails
|
|
kkyzir@954
|
474 to Strabon-users mailing-list, write to strabon-users@di.uoa.gr.
|
|
kkyzir@954
|
475
|
|
kkyzir@954
|
476 * Strabon-devel, is used as a communication channel with the developers
|
|
kkyzir@954
|
477 of Strabon. To subscribe to the mailing-list, please visit page
|
|
kkyzir@954
|
478 http://cgi.di.uoa.gr/~mailman/listinfo/strabon-devel. To post e-mails
|
|
kkyzir@954
|
479 to Strabon-devel mailing-list, write to strabon-devel@di.uoa.gr.
|
|
charnik@211
|
480
|
|
charnik@211
|
481
|
|
charnik@211
|
482 Bugs
|
|
charnik@211
|
483 ====
|
|
charnik@211
|
484 Please report bugs to http://bug.strabon.di.uoa.gr/report or
|
|
charnik@211
|
485 the Strabon-devel mailing-list Strabon-devel@di.uoa.gr.
|
|
charnik@212
|
486
|
|
charnik@212
|
487
|
|
sgian@627
|
488 Known Issues
|
|
sgian@627
|
489 ============
|
|
charnik@846
|
490 * By default, Tomcat uses ISO-8859-1 character encoding when decoding URLs received
|
|
charnik@846
|
491 from a browser. This can cause problems when encoding is UTF-8, and you are using
|
|
charnik@846
|
492 international characters. In order to fix this, edit conf/server.xml and find the
|
|
charnik@846
|
493 line where the Connector is defined. Add the parameter URIEncoding and set it to
|
|
charnik@846
|
494 UTF-8. For example:
|
|
sgian@627
|
495
|
|
charnik@846
|
496 <Connector port="8080" protocol="HTTP/1.1"
|
|
charnik@846
|
497 connectionTimeout="20000"
|
|
charnik@846
|
498 URIEncoding="UTF-8"
|
|
charnik@846
|
499 redirectPort="8443" />
|
|
charnik@846
|
500
|
|
charnik@846
|
501 * Building and executing any maven goals fails for maven versions <3.0 due to a
|
|
charnik@846
|
502 dependency to the `shade' plugin that is available only for maven version 3.0
|
|
charnik@846
|
503 (http://maven.apache.org/plugins/maven-shade-plugin/). In such systems, you may
|
|
charnik@846
|
504 disable execution of this plugin by setting the environmental variable
|
|
charnik@846
|
505 `shade.skip'. For example, to build Strabon using maven version 2.0 you may
|
|
charnik@846
|
506 execute the following command:
|
|
charnik@846
|
507
|
|
charnik@846
|
508 $ mvn clean package -Dshade.skip
|
|
sgian@627
|
509
|
|
sgian@967
|
510 * When using MonetDB as a backend, the following source code of MonetDB must be
|
|
sgian@967
|
511 used:
|
|
sgian@967
|
512 https://hg.strabon.di.uoa.gr/MonetDB/
|
|
sgian@967
|
513
|
|
sgian@627
|
514
|
|
charnik@212
|
515 License
|
|
charnik@212
|
516 =======
|
|
charnik@553
|
517 This Source Code Form is subject to the terms of the Mozilla Public
|
|
charnik@553
|
518 License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
charnik@553
|
519 file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
charnik@553
|
520
|
|
Konstantina@1121
|
521 Copyright (C) 2010, 2011, 2012, 2013 Pyravlos Team
|
|
charnik@553
|
522
|
|
charnik@553
|
523 http://www.strabon.di.uoa.gr/
|
|
charnik@553
|
524
|
|
charnik@553
|
525
|
|
charnik@553
|
526 How to apply the license
|
|
charnik@553
|
527 ========================
|
|
charnik@866
|
528 * In the beginning of script files (after the shell directive) paste the
|
|
charnik@866
|
529 following statement:
|
|
charnik@553
|
530 #
|
|
charnik@553
|
531 # This Source Code Form is subject to the terms of the Mozilla Public
|
|
charnik@553
|
532 # License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
charnik@553
|
533 # file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
charnik@553
|
534 #
|
|
Konstantina@1121
|
535 # Copyright (C) 2010, 2011, 2012, 2013 Pyravlos Team
|
|
charnik@553
|
536 #
|
|
charnik@553
|
537 # http://www.strabon.di.uoa.gr/
|
|
charnik@553
|
538 #
|
|
charnik@553
|
539
|
|
charnik@866
|
540 * In the beginning of Java source code files paste the following statement:
|
|
charnik@553
|
541 /**
|
|
charnik@553
|
542 * This Source Code Form is subject to the terms of the Mozilla Public
|
|
charnik@553
|
543 * License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
charnik@553
|
544 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
charnik@553
|
545 *
|
|
Konstantina@1121
|
546 * Copyright (C) 2010, 2011, 2012, 2013 Pyravlos Team
|
|
charnik@553
|
547 *
|
|
charnik@553
|
548 * http://www.strabon.di.uoa.gr/
|
|
charnik@553
|
549 */
|
|
charnik@553
|
550
|
|
charnik@866
|
551 * In the beginning of HTML/XML files paste the following statement:
|
|
charnik@553
|
552 <!-- This Source Code Form is subject to the terms of the Mozilla Public
|
|
charnik@553
|
553 - License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
charnik@553
|
554 - file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
charnik@553
|
555 -
|
|
Konstantina@1121
|
556 - Copyright (C) 2010, 2011, 2012, 2013 Pyravlos Team
|
|
charnik@553
|
557 -
|
|
charnik@553
|
558 - http://www.strabon.di.uoa.gr/
|
|
charnik@553
|
559 -->
|
