Strabon

view README @ 928:389213ce7843

[maven-release-plugin] prepare release v3.2.8
author Babis Nikolaou <charnik@di.uoa.gr>
date Tue Mar 26 13:33:47 2013 +0200 (2013-03-26)
parents c94a157459eb
children 6fac72daf1d3
line source
1 Strabon
2 -----------
4 Introduction
5 ============
6 Strabon is a fully implemented semantic geospatial database system that can be
7 used to store linked geospatial data expressed in RDF and query them using an
8 extension of SPARQL. Strabon supports spatial selections, spatial joins, a rich
9 set of spatial functions similar to those offered by geospatial relational
10 database systems, support for multiple Coordinate Reference Systems and widely
11 used serializations for geometric objects such as WKT and GML. Strabon is built
12 on top of the well-known RDF store Sesame and extends Sesame’s components to be
13 able to manage thematic and spatial data that are stored in PostGIS.
15 The development of Strabon started in the context of European FP7 project
16 SemsorGrid4Env (Semantic Sensor Grids for Rapid Application Development for
17 Environmental Management) [http://www.semsorgrid4env.eu/]. Starting September
18 2011, Strabon is being utilized and extended with new functionalities in the
19 FP7 project TELEIOS (Virtual Observatory Infrastructure for Earth Observation
20 Data) [http://www.earthobservatory.eu/] which our group leads.
22 The query language of Strabon is called stSPARQL. stSPARQL can be used to query
23 data represented in an extension of RDF called stRDF. stRDF and stSPARQL have
24 been designed for representing and querying geospatial data that changes over
25 time (e.g., the growth of a city over the years due to new developments).
27 Currently, only the geospatial features of stSPARQL have been implemented fully.
28 The temporal features are the subject of current work.
30 Given the very close relationship between stSPARQL and GeoSPARQL which is a
31 recent OGC standard for an extension of SPARQL for querying geospatial metadata,
32 we recently provided support for the Core, Geometry and Geometry Topology
33 extension of GeoSPARQL.
36 Strabon Homepage
37 ================
38 The homepage of Strabon is at http://www.strabon.di.uoa.gr/.
41 Demo
42 ====
43 You can find a demo of the system Strabon at http://test.strabon.di.uoa.gr/NOA/.
46 Getting Started
47 ===============
48 To get started with Strabon please have a look at the tutorial for the stRDF
49 data model and stSPARQL query language, the User Guide, and the Developer Guide.
51 stRDF and stSPARQL tutorial
52 http://www.strabon.di.uoa.gr/files/stSPARQL_tutorial.pdf
55 stSPARQL Reference
56 ~~~~~~~~~~~~~~~~~~
57 The reference for the spatial and temporal extension functions defined in
58 stSPARQL can be found at http://www.strabon.di.uoa.gr/stSPARQL#spatial and
59 http://www.strabon.di.uoa.gr/stSPARQL#temporals respectively.
62 User Guide
63 ~~~~~~~~~~
64 Assuming that you are familiar with Maven, the following steps need to be
65 followed in order to use Strabon using Eclipse:
67 1. Install PostgreSQL from http://www.postgresql.org/download/. At the time of
68 this writing the latest PostgreSQL version is 9.1.
69 2. Install PostGIS from http://postgis.refractions.net/download/. At the time of
70 this writing we have tested Strabon with PostGIS 1.5.3.
71 3. Install Maven from http://maven.apache.org/download.html. At the time of this
72 writing the latest Maven version is 3.0.4.
73 4. Install Eclipse from http://www.eclipse.org/downloads/. At the time of this
74 writing the latest Eclipse version is 3.7.2.
75 5. Install the m2e plugin for Eclipse from http://www.eclipse.org/m2e/.
76 6. Install the MercurialEclipse plugin for Eclipse from
77 http://javaforge.com/project/HGE .
78 7. From Eclipse, go to File --> Import --> Mercurial --> Clone Existing
79 Mercurial Repository --> Next. In the URL textarea paste the following
80 URL: http://hg.strabon.di.uoa.gr/StrabonUser and then press Next --> Next -->
81 Finish. If you used the default settings, you should have a new project named
82 StrabonMain. Right click on the project and select Configure --> Convert to
83 Maven project. Eclipse will enable Maven dependency management for the
84 project, download any dependencies and build the project.
87 Storing stRDF graphs and evaluating stSPARQL queries
88 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
89 You can see some examples in the classes gr.uoa.di.strabon.example.PostgisExample
90 and gr.uoa.di.strabon.example.PostgisExample2.
93 Developer Guide
94 ~~~~~~~~~~~~~~~
95 Assuming that you are familiar with Maven, the following steps need to be
96 followed in order to use Strabon using Eclipse:
98 1. Install PostgreSQL from http://www.postgresql.org/download/. At the time of
99 this writing the latest PostgreSQL version is 9.1.
100 2. Install PostGIS from http://postgis.refractions.net/download/. At the time of
101 this writing we have tested Strabon with PostGIS 1.5.3.
102 3. Install Maven from http://maven.apache.org/download.html. At the time of this
103 writing the latest Maven version is 3.0.4.
104 4. Install Eclipse from http://www.eclipse.org/downloads/. At the time of this
105 writing the latest Eclipse version is 3.7.2.
106 5. Install the m2e plugin for Eclipse from http://www.eclipse.org/m2e/.
107 6. Install the MercurialEclipse plugin for Eclipse from
108 http://javaforge.com/project/HGE.
109 7. From Eclipse, go to File --> Import --> Mercurial --> Clone Existing
110 Mercurial Repository --> Next. In the URL textarea paste the following
111 URL: http://hg.strabon.di.uoa.gr/Strabon and then press Next --> Next -->
112 Finish. If you used the default settings, you should have a new project named
113 StrabonMain. Right click on the project and select Configure --> Convert to
114 Maven project. Eclipse will enable Maven dependency management for the
115 project, download any dependencies and build the project.
118 Storing stRDF graphs and evaluating stSPARQL queries
119 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
120 You can see some examples in the classes
121 eu.earthobservatory.runtime.postgis.StoreOp and
122 eu.earthobservatory.runtime.postgis.QueryOp.
125 Download
126 ========
127 You can download the source code of the latest version of Strabon by accessing
128 our public mercurial repository located at http://hg.strabon.di.uoa.gr/Strabon.
129 You can find more information on how to use and extend Strabon at the Getting
130 Started section.
133 Publications
134 ============
135 You can learn about stRDF data model and stSPARQL query language employed in
136 Strabon by reading our tutorial under the Getting Started section and/or the
137 publications given on this page.
139 The current versions of stRDF and stSPARQL which are based on OGC standards are
140 presented in the following document:
141 * K. Kyzirakos, M. Karpathiotakis, and M. Koubarakis. Strabon: A Semantic
142 Geospatial DBMS. In Internatioanl Semantic Web Conference (ISWC'12). Boston,
143 USA, November 11-15, 2012.
144 [pdf: http://strabon.di.uoa.gr/files/strabon-iswc.pdf]
146 * Manolis Koubarakis, Kostis Kyzirakos, Babis Nikolaou, Michael Sioutis, and
147 Stavros Vassos. A data model and query language for an extension of RDF with
148 time and space. Deliverable D2.1, European ICT project TELEIOS, 2011.
149 [pdf: http://strabon.di.uoa.gr/files/deliv2-1-re-revised.pdf]
151 The initial versions of stRDF and stSPARQL that are based on constraint
152 databases are presented in the following publications:
153 * Manolis Koubarakis and Kostis Kyzirakos. Modeling and Querying Metadata in
154 the Semantic Sensor Web: the Model stRDF and the Query Language stSPARQL.
155 In 7th Extended Semantic Web Conference (ESWC 2010). Heraklion, Crete,
156 30 May - 03 June, 2010.
157 [pdf: http://strabon.di.uoa.gr/files/stSPARQL.pdf]
159 * Kostis Kyzirakos, Manos Karpathiotakis and Manolis Koubarakis. Developing
160 Registries for the Semantic Sensor Web using stRDF and stSPARQL (short
161 paper).
162 In Proceedings of 3rd International workshop on Semantic Sensor Networks
163 2010, in conjunction with ISWC 2010, November 2010, Shanghai, China.
164 [pdf: http://strabon.di.uoa.gr/files/strabon.pdf]
166 Applications of stRDF, stSPARQL, and the system Strabon are described here:
167 * Alasdair J. G. Gray, Raúl García-Castro, Kostis Kyzirakos, Manos
168 Karpathiotakis, Jean-Paul Calbimonte, Kevin Page, Jason Sadler, Alex
169 Frazer, Ixent Galpin, Alvaro A. A. Fernandes, Norman W. Paton, Oscar
170 Corcho, Manolis Koubarakis, David De Roure, Kirk Martinez and Asunción
171 Gómez-Pérez. A Semantically Enabled Service Architecture for Mashups over
172 Streaming and Stored Data. In 8th Extended Semantic Web Conference (ESWC
173 2011). Heraklion, Crete, May 20 - June 2, 2011.
174 [pdf: http://strabon.di.uoa.gr/files/Gray2011Architecture.pdf]
176 * A.J.G. Gray, J. Sadler, O. Kit, K. Kyzirakos, M. Karpathiotakis, J.-P.
177 Calbimonte, K. Page, R. García-Castro, A. Frazer, I. Galpin, A.A.A.
178 Fernandes, N.W. Paton, O. Corcho, M. Koubarakis, D.D. Roure, K. Martinez,
179 A. Gómez-Pérez. A Semantic Sensor Web for Environmental Decision Support
180 Applications. Sensors. 11, 8855-8887.
181 [pdf: http://strabon.di.uoa.gr/files/sensors-11-08855.pdf]
183 Coming up soon:
184 Strabon will soon support an extension of RDF for incomplete geospatial
185 information. The following publication gives a preview of the relevant research
186 problems:
187 * M. Koubarakis, K. Kyzirakos, M. Karpathiotakis, C. Nikolaou, M. Sioutis,
188 S. Vassos, D. Michail, T. Herekakis, C. Kontoes and I. Papoutsis. Challenges
189 for Qualitative Spatial Reasoning in Linked Geospatial Data. In Proceedings
190 of IJCAI 2011 Workshop on Benchmarks and Applications of Spatial Reasoning,
191 Barcelona, Spain.
192 [pdf: http://www.earthobservatory.eu/publications/SciQL_ADASS2011.pdf]
194 * C. Nikolaou and M. Koubarakis: "Querying Linked Geospatial Data with
195 Incomplete Information". In 5th International Terra Cognita Workshop -
196 Foundations, Technologies and Applications of the Geospatial Web. In
197 conjunction with the 11th International Semantic Web Conference, Boston,
198 USA, November, 2012.
199 [http://www.earthobservatory.eu/publications/iswc-workshop.pdf]
202 Contributors
203 ============
204 The system Strabon has been developed by the following members of our team:
206 * Manos Karpathiotakis <mk@di.uoa.gr>
207 * Kostis Kyzirakos <kkyzir@di.uoa.gr>
208 * Manolis Koubarakis <koubarak@di.uoa.gr>
209 * Giorgos Garbis <ggarbis@di.uoa.gr>
210 * Konstantina Bereta <konstantina.bereta@di.uoa.gr>
211 * Charalampos Nikolaou <charnik@di.uoa.gr>
212 * Stella Gianakopoulou <sgian@di.uoa.gr>
213 * Panagiotis Smeros <psmeros@di.uoa.gr>
214 * Kallirroi Dogani <kallirroi@di.uoa.gr>
217 Mailing-list
218 ============
219 Currently, there is only a developers mailing-list, Strabon-devel, for support
220 and other questions concerning Strabon. To subscribe to the mailing-list, please
221 visit page http://cgi.di.uoa.gr/~mailman/listinfo/strabon-devel. To post e-mails
222 to Strabon-devel mailing-list, write to Strabon-devel@di.uoa.gr.
225 Bugs
226 ====
227 Please report bugs to http://bug.strabon.di.uoa.gr/report or
228 the Strabon-devel mailing-list Strabon-devel@di.uoa.gr.
231 Known Issues
232 ============
233 * By default, Tomcat uses ISO-8859-1 character encoding when decoding URLs received
234 from a browser. This can cause problems when encoding is UTF-8, and you are using
235 international characters. In order to fix this, edit conf/server.xml and find the
236 line where the Connector is defined. Add the parameter URIEncoding and set it to
237 UTF-8. For example:
239 <Connector port="8080" protocol="HTTP/1.1"
240 connectionTimeout="20000"
241 URIEncoding="UTF-8"
242 redirectPort="8443" />
244 * Building and executing any maven goals fails for maven versions <3.0 due to a
245 dependency to the `shade' plugin that is available only for maven version 3.0
246 (http://maven.apache.org/plugins/maven-shade-plugin/). In such systems, you may
247 disable execution of this plugin by setting the environmental variable
248 `shade.skip'. For example, to build Strabon using maven version 2.0 you may
249 execute the following command:
251 $ mvn clean package -Dshade.skip
254 License
255 =======
256 This Source Code Form is subject to the terms of the Mozilla Public
257 License, v. 2.0. If a copy of the MPL was not distributed with this
258 file, You can obtain one at http://mozilla.org/MPL/2.0/.
260 Copyright (C) 2010, 2011, 2012, Pyravlos Team
262 http://www.strabon.di.uoa.gr/
265 How to apply the license
266 ========================
267 * In the beginning of script files (after the shell directive) paste the
268 following statement:
269 #
270 # This Source Code Form is subject to the terms of the Mozilla Public
271 # License, v. 2.0. If a copy of the MPL was not distributed with this
272 # file, You can obtain one at http://mozilla.org/MPL/2.0/.
273 #
274 # Copyright (C) 2010, 2011, 2012, Pyravlos Team
275 #
276 # http://www.strabon.di.uoa.gr/
277 #
279 * In the beginning of Java source code files paste the following statement:
280 /**
281 * This Source Code Form is subject to the terms of the Mozilla Public
282 * License, v. 2.0. If a copy of the MPL was not distributed with this
283 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
284 *
285 * Copyright (C) 2010, 2011, 2012, Pyravlos Team
286 *
287 * http://www.strabon.di.uoa.gr/
288 */
290 * In the beginning of HTML/XML files paste the following statement:
291 <!-- This Source Code Form is subject to the terms of the Mozilla Public
292 - License, v. 2.0. If a copy of the MPL was not distributed with this
293 - file, You can obtain one at http://mozilla.org/MPL/2.0/.
294 -
295 - Copyright (C) 2010, 2011, 2012, Pyravlos Team
296 -
297 - http://www.strabon.di.uoa.gr/
298 -->