Strabon

view README @ 627:a1a5e82e6844

Added "Known Issues" section to README, for setting tomcat's connector encoding to UTF8.
author Stella Giannakopoulou <sgian@di.uoa.gr>
date Mon Oct 08 10:53:10 2012 +0300 (2012-10-08)
parents e3967795041b
children 61c165c2e0b7
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.
31 Strabon Homepage
32 ================
33 The homepage of Strabon is at http://www.strabon.di.uoa.gr/.
36 Demo
37 ====
38 You can find a demo of the system Strabon at http://test.strabon.di.uoa.gr/NOA/.
41 Getting Started
42 ===============
43 To get started with Strabon please have a look at the tutorial for the stRDF
44 data model and stSPARQL query language, the User Guide, and the Developer Guide.
46 stRDF and stSPARQL tutorial
47 http://www.strabon.di.uoa.gr/files/stSPARQL_tutorial.pdf
49 User Guide
50 ~~~~~~~~~~
51 Assuming that you are familiar with Maven, the following steps need to be
52 followed in order to use Strabon using Eclipse:
54 1. Install PostgreSQL from http://www.postgresql.org/download/. At the time of
55 this writing the latest PostgreSQL version is 9.1.
56 2. Install PostGIS from http://postgis.refractions.net/download/. At the time of
57 this writing we have tested Strabon with PostGIS 1.5.3.
58 3. Install Maven from http://maven.apache.org/download.html. At the time of this
59 writing the latest Maven version is 3.0.4.
60 4. Install Eclipse from http://www.eclipse.org/downloads/. At the time of this
61 writing the latest Eclipse version is 3.7.2.
62 5. Install the m2e plugin for Eclipse from http://www.eclipse.org/m2e/.
63 6. Install the MercurialEclipse plugin for Eclipse from
64 http://javaforge.com/project/HGE .
65 7. From Eclipse, go to File --> Import --> Mercurial --> Clone Existing
66 Mercurial Repository --> Next. In the URL textarea paste the following
67 URL: http://hg.strabon.di.uoa.gr/StrabonUser and then press Next --> Next -->
68 Finish. If you used the default settings, you should have a new project named
69 StrabonMain. Right click on the project and select Configure --> Convert to
70 Maven project. Eclipse will enable Maven dependency management for the
71 project, download any dependencies and build the project.
74 Storing stRDF graphs and evaluating stSPARQL queries
75 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
76 You can see some examples in the classes gr.uoa.di.strabon.example.PostgisExample
77 and gr.uoa.di.strabon.example.PostgisExample2.
80 Developer Guide
81 ~~~~~~~~~~~~~~~
82 Assuming that you are familiar with Maven, the following steps need to be
83 followed in order to use Strabon using Eclipse:
85 1. Install PostgreSQL from http://www.postgresql.org/download/. At the time of
86 this writing the latest PostgreSQL version is 9.1.
87 2. Install PostGIS from http://postgis.refractions.net/download/. At the time of
88 this writing we have tested Strabon with PostGIS 1.5.3.
89 3. Install Maven from http://maven.apache.org/download.html. At the time of this
90 writing the latest Maven version is 3.0.4.
91 4. Install Eclipse from http://www.eclipse.org/downloads/. At the time of this
92 writing the latest Eclipse version is 3.7.2.
93 5. Install the m2e plugin for Eclipse from http://www.eclipse.org/m2e/.
94 6. Install the MercurialEclipse plugin for Eclipse from
95 http://javaforge.com/project/HGE.
96 7. From Eclipse, go to File --> Import --> Mercurial --> Clone Existing
97 Mercurial Repository --> Next. In the URL textarea paste the following
98 URL: http://hg.strabon.di.uoa.gr/Strabon and then press Next --> Next -->
99 Finish. If you used the default settings, you should have a new project named
100 StrabonMain. Right click on the project and select Configure --> Convert to
101 Maven project. Eclipse will enable Maven dependency management for the
102 project, download any dependencies and build the project.
105 Storing stRDF graphs and evaluating stSPARQL queries
106 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
107 You can see some examples in the classes
108 eu.earthobservatory.runtime.postgis.StoreOp and
109 eu.earthobservatory.runtime.postgis.QueryOp.
112 Download
113 ========
114 You can download the source code of the latest version of Strabon by accessing
115 our public mercurial repository located at http://hg.strabon.di.uoa.gr/Strabon.
116 You can find more information on how to use and extend Strabon at the Getting
117 Started section.
120 Publications
121 ============
122 You can learn about stRDF data model and stSPARQL query language employed in
123 Strabon by reading our tutorial under the Getting Started section and/or the
124 publications given on this page.
126 The current versions of stRDF and stSPARQL which are based on OGC standards are
127 presented in the following document:
128 * K. Kyzirakos, M. Karpathiotakis, and M. Koubarakis. Strabon: A Semantic
129 Geospatial DBMS. In Internatioanl Semantic Web Conference (ISWC'12). Boston,
130 USA, November 11-15, 2012.
131 [pdf: http://strabon.di.uoa.gr/files/strabon-iswc.pdf]
133 * Manolis Koubarakis, Kostis Kyzirakos, Babis Nikolaou, Michael Sioutis, and
134 Stavros Vassos. A data model and query language for an extension of RDF with
135 time and space. Deliverable D2.1, European ICT project TELEIOS, 2011.
136 [pdf: http://strabon.di.uoa.gr/files/deliv2-1-re-revised.pdf]
138 The initial versions of stRDF and stSPARQL that are based on constraint
139 databases are presented in the following publications:
140 * Manolis Koubarakis and Kostis Kyzirakos. Modeling and Querying Metadata in
141 the Semantic Sensor Web: the Model stRDF and the Query Language stSPARQL.
142 In 7th Extended Semantic Web Conference (ESWC 2010). Heraklion, Crete,
143 30 May - 03 June, 2010.
144 [pdf: http://strabon.di.uoa.gr/files/stSPARQL.pdf]
146 * Kostis Kyzirakos, Manos Karpathiotakis and Manolis Koubarakis. Developing
147 Registries for the Semantic Sensor Web using stRDF and stSPARQL (short
148 paper).
149 In Proceedings of 3rd International workshop on Semantic Sensor Networks
150 2010, in conjunction with ISWC 2010, November 2010, Shanghai, China.
151 [pdf: http://strabon.di.uoa.gr/files/strabon.pdf]
153 Applications of stRDF, stSPARQL, and the system Strabon are described here:
154 * Alasdair J. G. Gray, Raúl García-Castro, Kostis Kyzirakos, Manos
155 Karpathiotakis, Jean-Paul Calbimonte, Kevin Page, Jason Sadler, Alex
156 Frazer, Ixent Galpin, Alvaro A. A. Fernandes, Norman W. Paton, Oscar
157 Corcho, Manolis Koubarakis, David De Roure, Kirk Martinez and Asunción
158 Gómez-Pérez. A Semantically Enabled Service Architecture for Mashups over
159 Streaming and Stored Data. In 8th Extended Semantic Web Conference (ESWC
160 2011). Heraklion, Crete, May 20 - June 2, 2011.
161 [pdf: http://strabon.di.uoa.gr/files/Gray2011Architecture.pdf]
163 * A.J.G. Gray, J. Sadler, O. Kit, K. Kyzirakos, M. Karpathiotakis, J.-P.
164 Calbimonte, K. Page, R. García-Castro, A. Frazer, I. Galpin, A.A.A.
165 Fernandes, N.W. Paton, O. Corcho, M. Koubarakis, D.D. Roure, K. Martinez,
166 A. Gómez-Pérez. A Semantic Sensor Web for Environmental Decision Support
167 Applications. Sensors. 11, 8855-8887.
168 [pdf: http://strabon.di.uoa.gr/files/sensors-11-08855.pdf]
170 Coming up soon:
171 Strabon will soon support an extension of RDF for incomplete geospatial
172 information. The following publication gives a preview of the relevant research
173 problems:
174 * M. Koubarakis, K. Kyzirakos, M. Karpathiotakis, C. Nikolaou, M. Sioutis,
175 S. Vassos, D. Michail, T. Herekakis, C. Kontoes and I. Papoutsis. Challenges
176 for Qualitative Spatial Reasoning in Linked Geospatial Data. In Proceedings
177 of IJCAI 2011 Workshop on Benchmarks and Applications of Spatial Reasoning,
178 Barcelona, Spain.
179 [pdf: http://www.earthobservatory.eu/publications/SciQL_ADASS2011.pdf]
182 Contributors
183 ============
184 The system Strabon has been developed by the following members of our team:
186 * Manos Karpathiotakis <mk@di.uoa.gr>
187 * Kostis Kyzirakos <kkyzir@di.uoa.gr>
188 * Manolis Koubarakis <koubarak@di.uoa.gr>
189 * Giorgos Garbis <ggarbis@di.uoa.gr>
190 * Konstantina Bereta <konstantina.bereta@di.uoa.gr>
193 Mailing-list
194 ============
195 Currently, there is only a developers mailing-list, Strabon-devel, for support
196 and other questions concerning Strabon. To subscribe to the mailing-list, please
197 visit page http://cgi.di.uoa.gr/~mailman/listinfo/strabon-devel. To post e-mails
198 to Strabon-devel mailing-list, write to Strabon-devel@di.uoa.gr.
201 Bugs
202 ====
203 Please report bugs to http://bug.strabon.di.uoa.gr/report or
204 the Strabon-devel mailing-list Strabon-devel@di.uoa.gr.
207 Known Issues
208 ============
209 By default, Tomcat uses ISO-8859-1 character encoding when decoding URLs received
210 from a browser. This can cause problems when encoding is UTF-8, and you are using
211 international characters. In order to fix this, edit conf/server.xml and find the
212 line where the Connector is defined. Add the parameter URIEncoding and set it to
213 UTF-8. For example:
215 <Connector port="8080" protocol="HTTP/1.1"
216 connectionTimeout="20000"
217 URIEncoding="UTF-8"
218 redirectPort="8443" />
221 License
222 =======
223 This Source Code Form is subject to the terms of the Mozilla Public
224 License, v. 2.0. If a copy of the MPL was not distributed with this
225 file, You can obtain one at http://mozilla.org/MPL/2.0/.
227 Copyright (C) 2010, 2011, 2012, Pyravlos Team
229 http://www.strabon.di.uoa.gr/
232 How to apply the license
233 ========================
234 In the beginning of script files (after the ???) paste the following statement:
235 #
236 # This Source Code Form is subject to the terms of the Mozilla Public
237 # License, v. 2.0. If a copy of the MPL was not distributed with this
238 # file, You can obtain one at http://mozilla.org/MPL/2.0/.
239 #
240 # Copyright (C) 2010, 2011, 2012, Pyravlos Team
241 #
242 # http://www.strabon.di.uoa.gr/
243 #
245 In the beginning of Java source code files paste the following statement:
246 /**
247 * This Source Code Form is subject to the terms of the Mozilla Public
248 * License, v. 2.0. If a copy of the MPL was not distributed with this
249 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
250 *
251 * Copyright (C) 2010, 2011, 2012, Pyravlos Team
252 *
253 * http://www.strabon.di.uoa.gr/
254 */
256 In the beginning of HTML/XML files paste the following statement:
257 <!-- This Source Code Form is subject to the terms of the Mozilla Public
258 - License, v. 2.0. If a copy of the MPL was not distributed with this
259 - file, You can obtain one at http://mozilla.org/MPL/2.0/.
260 -
261 - Copyright (C) 2010, 2011, 2012, Pyravlos Team
262 -
263 - http://www.strabon.di.uoa.gr/
264 -->