Strabon

annotate README @ 902:742958932e5a

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