Released version 1.5

README.md

@@ -31,7 +31,7 @@ mvn install:install-file -Dfile=/<*YOUR_LOCAL_DIR*>/RML-Mapper.jar -DgroupId=be.
 <li>
 Building the application with maven:<br/>
 <code>mvn clean package</code><br/>
-results into a <code>triplegeo-1.4-SNAPSHOT.jar</code> under directory <code>target</code> according to what has been specified in the <code>pom.xml</code> file.
+results into a <code>triplegeo-1.5-SNAPSHOT.jar</code> under directory <code>target</code> according to what has been specified in the <code>pom.xml</code> file.
 </li>
 </ul>
 
@@ -45,13 +45,13 @@ TripleGeo supports <i>two-way</i> transformation of geospatial features:
 <li><i>Reverse Transformation</i> of RDF data into de facto geospatial formats (currently, .CSV and ESRI shapefiles). TripleGeo retrieves data from a graph constructed on-the-fly from the RDF data and creates records with a geometry attribute and thematic attributes reflecting the underlying ontology of the input RDF data.</li>
 </ul>
 
-<p>Explanation and usage tips for both transformation modules are given next. The current distribution (ver. 1.4) comes with dummy configuration templates <code>file_options.conf</code> for geographical files (ESRI shapefiles, CSV, GPX, KML, etc.) and <code>dbms_options.conf</code> for database contents (from PostGIS, Oracle Spatial, etc.). These files contain indicative values for the most important properties when accessing data from geographical files or a spatial DBMS. This release also includes a template <code>reverse_options.conf</code> for reconverting RDF data back into geospatial file formats. Self-contained brief instructions can guide you into the extraction and reverse transformation processes.</p>
+<p>Explanation and usage tips for both transformation modules are given next. The current distribution (ver. 1.5) comes with dummy configuration templates <code>file_options.conf</code> for geographical files (ESRI shapefiles, CSV, GPX, KML, etc.) and <code>dbms_options.conf</code> for database contents (from PostGIS, Oracle Spatial, etc.). These files contain indicative values for the most important properties when accessing data from geographical files or a spatial DBMS. This release also includes a template <code>reverse_options.conf</code> for reconverting RDF data back into geospatial file formats. Self-contained brief instructions can guide you into the extraction and reverse transformation processes.</p>
 
 <p>Indicative configuration files and mappings for several cases are available <a href="https://github.com/SLIPO-EU/TripleGeo/tree/master/test/conf/">here</a> in order to assist you when preparing your own.</p>
 
 <p>In addition, custom classification schemes for OpenStreetMap data are available <a href="https://github.com/SLIPO-EU/TripleGeo/tree/master/test/classification/">here</a> and can be readily used with the provided mappings against the <a href="https://github.com/SLIPO-EU/TripleGeo/tree/master/test/data/">sample datasets</a>. </p>
 
-<p><b> NOTE: </b> All execution commands and configurations refer to the current version (TripleGeo ver. 1.4).</p>
+<p><b> NOTE: </b> All execution commands and configurations refer to the current version (TripleGeo ver. 1.5).</p>
 
 
 <h4>
@@ -60,12 +60,12 @@ TripleGeo supports <i>two-way</i> transformation of geospatial features:
 How to use TripleGeo in order to transform geospatial data into RDF triples:
 
 <ul>
-<li>In case that triples will be extracted from a <i>geographical file</i> (e.g., ESRI shapefiles) as specified in the user-defined configuration file in <code>./test/conf/shp_options.conf</code>, and assuming that binaries are bundled together in <code>/target/triplegeo-1.4-SNAPSHOT.jar</code>, give a command like this:</br>
-<code>java -cp ./target/triplegeo-1.4-SNAPSHOT.jar eu.slipo.athenarc.triplegeo.Extractor ./test/conf/shp_options.conf</code></li>
+<li>In case that triples will be extracted from a <i>geographical file</i> (e.g., ESRI shapefiles) as specified in the user-defined configuration file in <code>./test/conf/shp_options.conf</code>, and assuming that binaries are bundled together in <code>/target/triplegeo-1.5-SNAPSHOT.jar</code>, give a command like this:</br>
+<code>java -cp ./target/triplegeo-1.5-SNAPSHOT.jar eu.slipo.athenarc.triplegeo.Extractor ./test/conf/shp_options.conf</code></li>
 <li>If triples will be extracted from a <i>geospatially-enabled DBMS</i> (e.g., PostGIS), the command is essentially the same, but it specifies a suitable configuration file <code>./test/conf/PostGIS_options.conf</code> with all information required to connect and extract data from the DBMS, as well as runtime linking to the JDBC driver for enabling connections to PostgreSQL (assuming that this JDBC driver is located at <code>./lib/postgresql-9.4-1206-jdbc4.jar</code>):</br>
-<code>java -cp ./lib/postgresql-9.4-1206-jdbc4.jar;./target/triplegeo-1.4-SNAPSHOT.jar eu.slipo.athenarc.triplegeo.Extractor ./test/conf/PostGIS_options.conf</code></li>
+<code>java -cp ./lib/postgresql-9.4-1206-jdbc4.jar;./target/triplegeo-1.5-SNAPSHOT.jar eu.slipo.athenarc.triplegeo.Extractor ./test/conf/PostGIS_options.conf</code></li>
 <li>TripleGeo supports data in GML (Geography Markup Language) and KML (Keyhole Markup Language). It can also handle INSPIRE-aligned GML data for seven Data Themes (<a href="https://inspire.ec.europa.eu/Themes/Data-Specifications/2892">Annex I</a>), as well as <a href="https://inspire.ec.europa.eu/metadata/6541">INSPIRE-aligned geospatial metadata</a>. Any such transformation is performed via XSLT, as specified in the respective configuration settings (e.g., <code>./test/conf/KML_options.conf</code>) as follows:</br>
-<code>java -cp ./target/triplegeo-1.4-SNAPSHOT.jar eu.slipo.athenarc.triplegeo.Extractor ./test/conf/KML_options.conf</code></li>
+<code>java -cp ./target/triplegeo-1.5-SNAPSHOT.jar eu.slipo.athenarc.triplegeo.Extractor ./test/conf/KML_options.conf</code></li>
 </ul>
 
 <p>Wait until the process gets finished, and verify that the resulting output files are according to your specifications.</p>
@@ -78,10 +78,10 @@ How to use TripleGeo in order to transform RDF triples into a geospatial data fi
 <ul>
 <li>In the configuration file, specify one or multiple files that contain the RDF triples that will be given as input to the reverse transformation process. </li>
 <li>You must specify a valid SPARQL SELECT query that will be applied against the RDF graph and will fetch the resulting records. The path to the file containing this SPARQL command must be specified in the configuration. It is assumed that the user is aware of the underlying ontology of the RDF graph. If the SPARQL query is not valid, then no or partial results may be retrieved. By default, the names of the variables in the SELECT clause will be used as attribute names in the output file. </li>
-<li>The current release of TripleGeo (ver. 1.4) supports .CSV delimited files and ESRI shapefiles as output formats for reverse transformation.</li>
+<li>The current release of TripleGeo (ver. 1.5) supports .CSV delimited files and ESRI shapefiles as output formats for reverse transformation.</li>
 <li>In case of ESRI shapefile as output format, make sure that all input RDF geometries are of the same type (i.e., either points or lines or polygons), because shapefiles can only support a single geometry type in a given file. </li>
 <li>Once parameters have been specified in a suitable configuration file (e.g., like <code>./test/conf/shp_reverse.conf</code>), execute the following command to launch the reverse transformation process:</br>
-<code>java -cp ./target/triplegeo-1.4-SNAPSHOT.jar eu.slipo.athenarc.triplegeo.ReverseExtractor ./test/conf/shp_reverse.conf</code></li>
+<code>java -cp ./target/triplegeo-1.5-SNAPSHOT.jar eu.slipo.athenarc.triplegeo.ReverseExtractor ./test/conf/shp_reverse.conf</code></li>
 </ul>
 
 
@@ -91,7 +91,8 @@ How to use TripleGeo in order to transform RDF triples into a geospatial data fi
 <p>The current version of TripleGeo utility can access geometries from:</p>
 <ul>
 <li>ESRI shapefiles, a widely used file-based format for storing geospatial features.</li>
-<li>Other widely used geographical file formats, including: CSV (comma separated values), GPX (GPS Exchange Format), GeoJSON, and OpenStreetMap (OSM) XML files.</li>
+<li>Other widely used geographical file formats, including: GPX (GPS Exchange Format), GeoJSON, as well as OpenStreetMap (OSM) XML and PBF files.</li>
+<li>De facto data interchange formats with geometries specified as coordinate pairs: CSV (comma separated values), JSON. </li>
 <li>Geographical data stored in GML (Geography Markup Language) and KML (Keyhole Markup Language).</li>
 <li>INSPIRE-aligned datasets for seven Data Themes (Annex I) in GML format: Addresses, Administrative Units, Cadastral Parcels, GeographicalNames, Hydrography, Protected Sites, and Transport Networks (Roads).</li>
 <li>Several geospatially-enabled DBMSs, including: Oracle Spatial and Graph, PostGIS extension for PostgreSQL, MySQL, Microsoft SQL Server, IBM DB2 with Spatial Extender, SpatiaLite, and ESRI Personal Geodatabases in Microsoft Access format.</li>

config/dbms_options.conf.template

@@ -1,5 +1,5 @@
 ##############################
-## Template for configuring TripleGeo ver.1.4 in order to convert spatial features stored in a DBMS into RDF triples.
+## Template for configuring TripleGeo ver.1.5 in order to convert spatial features stored in a DBMS into RDF triples.
 ## Specify parameters according to the examples for your specific dataset.
 ## Examples given below assume an existing PostgreSQL+PostGIS database.
 ##############################

config/file_options.conf.template

@@ -1,5 +1,5 @@
 ##############################
-## Template for configuring TripleGeo ver.1.4 in order to transform data from geographical files into RDF triples.
+## Template for configuring TripleGeo ver.1.5 in order to transform data from geographical files into RDF triples.
 ## Specify parameters according to the examples for your specific input file(s).
 ##############################
 
@@ -14,7 +14,9 @@
 ##     GPX ;
 ##     GEOJSON ;
 ##     XML (for handling XML/GML/KML/INSPIRE-aligned input);
-##     OSM (currently, only supporting OpenStreetMap XML format).
+##     OSM_XML (supporting OpenStreetMap XML format);
+##     OSM_PBF (supporting OpenStreetMap PBF format);
+##     JSON .
 #inputFormat = SHAPEFILE
 inputFormat = ${inputFormat}
 

config/reverse_options.conf.template

@@ -1,5 +1,5 @@
 ##############################
-## Template for configuring TripleGeo ver.1.4 in order to transform data from RDF triples into geographical files (Reverse Transformation).
+## Template for configuring TripleGeo ver.1.5 in order to transform data from RDF triples into geographical files (Reverse Transformation).
 ## Specify parameters according to the examples for your specific output file(s).
 ##############################
 

docs/allclasses-frame.html

@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_60) on Wed Mar 21 22:03:36 EET 2018 -->
+<!-- Generated by javadoc (1.8.0_60) on Tue Jul 31 11:29:08 EEST 2018 -->
 <title>All Classes</title>
-<meta name="date" content="2018-03-21">
+<meta name="date" content="2018-07-31">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
@@ -33,6 +33,7 @@ <h1 class="bar">All&nbsp;Classes</h1>
 <li><a href="eu/slipo/athenarc/triplegeo/tools/GpxToRdf.html" title="class in eu.slipo.athenarc.triplegeo.tools" target="classFrame">GpxToRdf</a></li>
 <li><a href="com/topografix/gpx/GpxType.html" title="class in com.topografix.gpx" target="classFrame">GpxType</a></li>
 <li><a href="eu/slipo/athenarc/triplegeo/utils/GraphConverter.html" title="class in eu.slipo.athenarc.triplegeo.utils" target="classFrame">GraphConverter</a></li>
+<li><a href="eu/slipo/athenarc/triplegeo/tools/JsonToRdf.html" title="class in eu.slipo.athenarc.triplegeo.tools" target="classFrame">JsonToRdf</a></li>
 <li><a href="com/topografix/gpx/LinkType.html" title="class in com.topografix.gpx" target="classFrame">LinkType</a></li>
 <li><a href="eu/slipo/athenarc/triplegeo/utils/Mapping.html" title="class in eu.slipo.athenarc.triplegeo.utils" target="classFrame">Mapping</a></li>
 <li><a href="eu/slipo/athenarc/triplegeo/utils/Mapping.MappingProfile.html" title="enum in eu.slipo.athenarc.triplegeo.utils" target="classFrame">Mapping.MappingProfile</a></li>
@@ -41,13 +42,19 @@ <h1 class="bar">All&nbsp;Classes</h1>
 <li><a href="eu/slipo/athenarc/triplegeo/db/MySqlDbConnector.html" title="class in eu.slipo.athenarc.triplegeo.db" target="classFrame">MySqlDbConnector</a></li>
 <li><a href="com/topografix/gpx/ObjectFactory.html" title="class in com.topografix.gpx" target="classFrame">ObjectFactory</a></li>
 <li><a href="eu/slipo/athenarc/triplegeo/db/OracleDbConnector.html" title="class in eu.slipo.athenarc.triplegeo.db" target="classFrame">OracleDbConnector</a></li>
+<li><a href="eu/slipo/athenarc/triplegeo/osm/OSMClassification.html" title="class in eu.slipo.athenarc.triplegeo.osm" target="classFrame">OSMClassification</a></li>
+<li><a href="eu/slipo/athenarc/triplegeo/osm/OSMDiskIndex.html" title="class in eu.slipo.athenarc.triplegeo.osm" target="classFrame">OSMDiskIndex</a></li>
 <li><a href="eu/slipo/athenarc/triplegeo/osm/OSMFilter.html" title="class in eu.slipo.athenarc.triplegeo.osm" target="classFrame">OSMFilter</a></li>
 <li><a href="eu/slipo/athenarc/triplegeo/osm/OSMFilterFileParser.html" title="class in eu.slipo.athenarc.triplegeo.osm" target="classFrame">OSMFilterFileParser</a></li>
+<li><a href="eu/slipo/athenarc/triplegeo/osm/OSMIndex.html" title="interface in eu.slipo.athenarc.triplegeo.osm" target="classFrame"><span class="interfaceName">OSMIndex</span></a></li>
+<li><a href="eu/slipo/athenarc/triplegeo/osm/OSMMemoryIndex.html" title="class in eu.slipo.athenarc.triplegeo.osm" target="classFrame">OSMMemoryIndex</a></li>
 <li><a href="eu/slipo/athenarc/triplegeo/osm/OSMNode.html" title="class in eu.slipo.athenarc.triplegeo.osm" target="classFrame">OSMNode</a></li>
+<li><a href="eu/slipo/athenarc/triplegeo/tools/OsmPbfToRdf.html" title="class in eu.slipo.athenarc.triplegeo.tools" target="classFrame">OsmPbfToRdf</a></li>
 <li><a href="eu/slipo/athenarc/triplegeo/osm/OSMRecord.html" title="class in eu.slipo.athenarc.triplegeo.osm" target="classFrame">OSMRecord</a></li>
+<li><a href="eu/slipo/athenarc/triplegeo/osm/OSMRecordBuilder.html" title="class in eu.slipo.athenarc.triplegeo.osm" target="classFrame">OSMRecordBuilder</a></li>
 <li><a href="eu/slipo/athenarc/triplegeo/osm/OSMRelation.html" title="class in eu.slipo.athenarc.triplegeo.osm" target="classFrame">OSMRelation</a></li>
-<li><a href="eu/slipo/athenarc/triplegeo/tools/OsmToRdf.html" title="class in eu.slipo.athenarc.triplegeo.tools" target="classFrame">OsmToRdf</a></li>
 <li><a href="eu/slipo/athenarc/triplegeo/osm/OSMWay.html" title="class in eu.slipo.athenarc.triplegeo.osm" target="classFrame">OSMWay</a></li>
+<li><a href="eu/slipo/athenarc/triplegeo/tools/OsmXmlToRdf.html" title="class in eu.slipo.athenarc.triplegeo.tools" target="classFrame">OsmXmlToRdf</a></li>
 <li><a href="com/topografix/gpx/PersonType.html" title="class in com.topografix.gpx" target="classFrame">PersonType</a></li>
 <li><a href="eu/slipo/athenarc/triplegeo/utils/PGDBDecoder.html" title="class in eu.slipo.athenarc.triplegeo.utils" target="classFrame">PGDBDecoder</a></li>
 <li><a href="eu/slipo/athenarc/triplegeo/db/PostgisDbConnector.html" title="class in eu.slipo.athenarc.triplegeo.db" target="classFrame">PostgisDbConnector</a></li>
@@ -69,6 +76,7 @@ <h1 class="bar">All&nbsp;Classes</h1>
 <li><a href="eu/slipo/athenarc/triplegeo/utils/TripleGenerator.html" title="class in eu.slipo.athenarc.triplegeo.utils" target="classFrame">TripleGenerator</a></li>
 <li><a href="com/topografix/gpx/TrksegType.html" title="class in com.topografix.gpx" target="classFrame">TrksegType</a></li>
 <li><a href="com/topografix/gpx/TrkType.html" title="class in com.topografix.gpx" target="classFrame">TrkType</a></li>
+<li><a href="eu/slipo/athenarc/triplegeo/utils/ValueChecker.html" title="class in eu.slipo.athenarc.triplegeo.utils" target="classFrame">ValueChecker</a></li>
 <li><a href="com/topografix/gpx/WptType.html" title="class in com.topografix.gpx" target="classFrame">WptType</a></li>
 </ul>
 </div>