eu.slipo.athenarc.triplegeo.utils

Interface Converter

All Known Implementing Classes:

GraphConverter, RMLConverter, StreamConverter

public interface Converter

Conversion Interface for TripleGeo used in transformation of spatial features (including their non-spatial attributes) into RDF triples with various serializations.

Version:

2.0

Author:

Kostas Patroumpas

Method Summary

Modifier and Type	Method and Description
org.apache.jena.rdf.model.Model	getModel() Provides access to the disk-based model consisting of transformed triples.
java.lang.String	getTDBDir() Returns the local directory that holds the disk-based RDF graph for this transformation thread.
java.util.List<org.apache.jena.graph.Triple>	getTriples() Provides triples resulted after applying transformation in STREAM mode.
java.lang.String	getURItemplate4Classification() Provides the URI template used for all subjects in RDF triples concerning the classification hierarchy.
void	parse(org.geotools.feature.FeatureIterator<?> iterator, Classification classific, org.opengis.referencing.operation.MathTransform reproject, int targetSRID, java.lang.String outputFile) Parses each record from a FeatureIterator and creates the resulting triples (including geometric and non-spatial attributes).
void	parse(java.util.Iterator<org.apache.commons.csv.CSVRecord> records, Classification classific, org.opengis.referencing.operation.MathTransform reproject, int targetSRID, java.lang.String outputFile) Parses each record from a collection of CSV records and creates the resulting triples (including geometric and non-spatial attributes).
void	parse(OSMRecord rs, Classification classific, org.opengis.referencing.operation.MathTransform reproject, int targetSRID) Parses a single OSM record and creates the resulting triples (including geometric and non-spatial attributes)
void	parse(java.sql.ResultSet rs, Classification classific, org.opengis.referencing.operation.MathTransform reproject, int targetSRID, java.lang.String outputFile) Parses each record from a ResultSet and creates the resulting triples (including geometric and non-spatial attributes).
void	parse(java.lang.String wkt, java.util.Map<java.lang.String,java.lang.String> attrValues, Classification classific, int targetSRID, org.opengis.referencing.operation.MathTransform reproject, java.lang.String geomType, int partition_index, java.lang.String outputFile) Parses a Map structure of (key, value) pairs and streamlines the resulting triples (including geometric and non-spatial attributes).
void	parse(java.lang.String wkt, java.util.Map<java.lang.String,java.lang.String> attrValues, Classification classific, int targetSRID, java.lang.String geomType) Parses a single GPX waypoint or track and streamlines the resulting triples (including geometric and non-spatial attributes).
void	parseWithRML(java.util.HashMap<java.lang.String,java.lang.String> row, be.ugent.mmlab.rml.model.dataset.RMLDataset dataset) Converts a row (with several attribute values, including geometry) into suitable triples according to the specified RML mappings.
void	setHeader(java.lang.String[] header) Retains the header (column names) of an input CSV file.
void	store(java.lang.String outputFile) Stores resulting tuples into a file.
void	store(java.lang.String outputFile, int partition_index) Finalizes storage of resulting tuples into a file.
int	writeTriples(be.ugent.mmlab.rml.model.dataset.RMLDataset dataset, java.io.BufferedWriter writer, org.openrdf.rio.RDFFormat rdfFormat, java.lang.String encoding) Serializes the given RML dataset as triples written into a file.
int	writeTriples(be.ugent.mmlab.rml.model.dataset.RMLDataset dataset, java.io.OutputStream writer, org.openrdf.rio.RDFFormat rdfFormat) Serializes the given RML dataset as triples written into a file.

Method Detail

parse

void parse(org.geotools.feature.FeatureIterator<?> iterator,
           Classification classific,
           org.opengis.referencing.operation.MathTransform reproject,
           int targetSRID,
           java.lang.String outputFile)

Parses each record from a FeatureIterator and creates the resulting triples (including geometric and non-spatial attributes).

Parameters:

iterator - FeatureIterator over spatial features collected from an ESRI shapefile of a GeoJSON file.

classific - Instantiation of the classification scheme that assigns categories to input features.

reproject - CRS transformation parameters to be used in reprojecting a geometry to a target SRID (EPSG code).

targetSRID - Spatial reference system (EPSG code) of geometries in the output RDF triples.

outputFile - Path to the output file that collects RDF triples.

parse

void parse(java.sql.ResultSet rs,
           Classification classific,
           org.opengis.referencing.operation.MathTransform reproject,
           int targetSRID,
           java.lang.String outputFile)

Parses each record from a ResultSet and creates the resulting triples (including geometric and non-spatial attributes).

Parameters:

rs - ResultSet containing spatial features retrieved from a DBMS.

classific - Instantiation of the classification scheme that assigns categories to input features.

reproject - CRS transformation parameters to be used in reprojecting a geometry to a target SRID (EPSG code).

targetSRID - Spatial reference system (EPSG code) of geometries in the output RDF triples.

outputFile - Path to the output file that collects RDF triples.

parse

void parse(java.util.Iterator<org.apache.commons.csv.CSVRecord> records,
           Classification classific,
           org.opengis.referencing.operation.MathTransform reproject,
           int targetSRID,
           java.lang.String outputFile)

Parses each record from a collection of CSV records and creates the resulting triples (including geometric and non-spatial attributes).

Parameters:

records - Iterator over CSV records collected from a CSV file.

classific - Instantiation of the classification scheme that assigns categories to input features.

reproject - CRS transformation parameters to be used in reprojecting a geometry to a target SRID (EPSG code).

targetSRID - Spatial reference system (EPSG code) of geometries in the output RDF triples.

outputFile - Path to the output file that collects RDF triples.

parse

void parse(OSMRecord rs,
           Classification classific,
           org.opengis.referencing.operation.MathTransform reproject,
           int targetSRID)

Parses a single OSM record and creates the resulting triples (including geometric and non-spatial attributes)

Parameters:

rs - Representation of an OSM record with attributes extracted from an OSM element (node, way, or relation).

classific - Instantiation of the classification scheme that assigns categories to input features.

reproject - CRS transformation parameters to be used in reprojecting a geometry to a target SRID (EPSG code).

targetSRID - Spatial reference system (EPSG code) of geometries in the output RDF triples.

parse

void parse(java.lang.String wkt,
           java.util.Map<java.lang.String,java.lang.String> attrValues,
           Classification classific,
           int targetSRID,
           java.lang.String geomType)

Parses a single GPX waypoint or track and streamlines the resulting triples (including geometric and non-spatial attributes).

Parameters:

wkt - Well-Known Text representation of the geometry

attrValues - Attribute values for each thematic (non-spatial) attribute

classific - Instantiation of the classification scheme that assigns categories to input features.

targetSRID - Spatial reference system (EPSG code) of geometries in the output RDF triples.

geomType - The type of the geometry (e.g., POINT, POLYGON, etc.)

parse

void parse(java.lang.String wkt,
           java.util.Map<java.lang.String,java.lang.String> attrValues,
           Classification classific,
           int targetSRID,
           org.opengis.referencing.operation.MathTransform reproject,
           java.lang.String geomType,
           int partition_index,
           java.lang.String outputFile)

Parses a Map structure of (key, value) pairs and streamlines the resulting triples (including geometric and non-spatial attributes). Applicable in STREAM transformation mode. Input provided as an individual record. This method is used when running over Spark/GeoSpark.

Parameters:

wkt - Well-Known Text representation of the geometry

attrValues - Attribute values for each thematic (non-spatial) attribute

classific - Instantiation of the classification scheme that assigns categories to input features.

targetSRID - Spatial reference system (EPSG code) of geometries in the output RDF triples.

reproject - CRS transformation parameters to be used in reprojecting a geometry to a target SRID (EPSG code).

geomType - The type of the geometry (e.g., POINT, POLYGON, etc.)

partition_index - The index of the partition.

outputFile - Path to the output file that collects RDF triples.

store

void store(java.lang.String outputFile)

Stores resulting tuples into a file.

Parameters:

outputFile - Path to the output file that collects RDF triples.

store

void store(java.lang.String outputFile,
           int partition_index)

Finalizes storage of resulting tuples into a file. This method is used when running over Spark/GeoSpark.

Parameters:

outputFile - Path to the output file that collects RDF triples.

partition_index - The index of the partition.

setHeader

void setHeader(java.lang.String[] header)

Retains the header (column names) of an input CSV file.

Parameters:

header - A array of attribute (column) names.

parseWithRML

void parseWithRML(java.util.HashMap<java.lang.String,java.lang.String> row,
                  be.ugent.mmlab.rml.model.dataset.RMLDataset dataset)

Converts a row (with several attribute values, including geometry) into suitable triples according to the specified RML mappings. Applicable in RML transformation mode.

Parameters:

row - Record with attribute names and their respective values.

dataset - RMLDataset to collect the resulting triples.

getTriples

java.util.List<org.apache.jena.graph.Triple> getTriples()

Provides triples resulted after applying transformation in STREAM mode.

Returns:

A collection of RDF triples.

getModel

org.apache.jena.rdf.model.Model getModel()

Provides access to the disk-based model consisting of transformed triples. Applicable in GRAPH transformation mode.

Returns:

The model created for a dataset (RDF graph) stored on disk.

getTDBDir

java.lang.String getTDBDir()

Returns the local directory that holds the disk-based RDF graph for this transformation thread. Applicable in GRAPH transformation mode.

Returns:

Path to the local directory.

writeTriples

int writeTriples(be.ugent.mmlab.rml.model.dataset.RMLDataset dataset,
                 java.io.BufferedWriter writer,
                 org.openrdf.rio.RDFFormat rdfFormat,
                 java.lang.String encoding)
          throws java.io.IOException

Serializes the given RML dataset as triples written into a file. Applicable in RML transformation mode only.

Parameters:

dataset - RMLDataset that has collected the resulting triples.

writer - BufferedWriter to write triples in the output stream.

rdfFormat - Serialization format of triples to be written to the file.

encoding - Encoding for string literals.

Returns:

The number of triples written to the output file.

Throws:

java.io.IOException

writeTriples

int writeTriples(be.ugent.mmlab.rml.model.dataset.RMLDataset dataset,
                 java.io.OutputStream writer,
                 org.openrdf.rio.RDFFormat rdfFormat)
          throws java.io.IOException

Serializes the given RML dataset as triples written into a file. Applicable in RML transformation mode only.

Parameters:

dataset - RMLDataset that has collected the resulting triples.

writer - BufferedWriter to write triples in the output stream.

rdfFormat - Serialization format of triples to be written to the file.

Returns:

The number of triples written to the output file.

Throws:

java.io.IOException

getURItemplate4Classification

java.lang.String getURItemplate4Classification()

Provides the URI template used for all subjects in RDF triples concerning the classification hierarchy. Applicable in RML transformation mode.

Returns:

A URI to be used as template for triples regarding classification.