eu.slipo.athenarc.triplegeo.tools

Class OsmXmlToRdf

java.lang.Object

org.xml.sax.helpers.DefaultHandler

eu.slipo.athenarc.triplegeo.tools.OsmXmlToRdf

All Implemented Interfaces:

org.xml.sax.ContentHandler, org.xml.sax.DTDHandler, org.xml.sax.EntityResolver, org.xml.sax.ErrorHandler

public class OsmXmlToRdf
extends org.xml.sax.helpers.DefaultHandler

Entry point to convert OpenStreetMap (OSM) XML files into RDF triples using Saxon XSLT. LIMITATIONS: - Depending on system and JVM resources, transformation can handle only a moderate amount of OSM features. - RML transformation mode not currently supported.

Version:

2.0

Author:

Kostas Patroumpas

Field Summary

Fields

Modifier and Type	Field and Description
(package private) Classification	classification
private static org.opengis.referencing.crs.CRSAuthorityFactory	crsFactory
private Configuration	currentConfig
private com.vividsolutions.jts.geom.GeometryFactory	geometryFactory
private boolean	inNode
private java.lang.String	inputFile
private boolean	inRelation
private boolean	inWay
private boolean	keepIndexed
(package private) Assistant	myAssistant
(package private) ValueChecker	myChecker
(package private) Converter	myConverter
private OSMNode	nodeTmp
(package private) long	numNamedEntities
(package private) long	numNodes
(package private) long	numRelations
(package private) long	numWays
private java.lang.String	outputFile
private OSMRecordBuilder	recBuilder
private OSMRelation	relationTmp
private org.opengis.referencing.operation.MathTransform	reproject
private boolean	rescanRelations
private boolean	scanRelations
private boolean	scanWays
(package private) int	sourceSRID
private java.util.Set<java.lang.String>	tags
(package private) int	targetSRID
private java.util.Map<java.lang.String,com.vividsolutions.jts.geom.Geometry>	tmpNodeIndex
private java.util.Map<java.lang.String,com.vividsolutions.jts.geom.Geometry>	tmpRelationIndex
private java.util.Map<java.lang.String,com.vividsolutions.jts.geom.Geometry>	tmpWayIndex
private OSMWay	wayTmp

Constructor Summary

Constructors

Constructor and Description
OsmXmlToRdf(Configuration config, java.lang.String inFile, java.lang.String outFile, int sourceSRID, int targetSRID) Constructor for the transformation process from OpenStreetMap XML file to RDF.

Method Summary

Modifier and Type	Method and Description
void	apply() Applies transformation according to the configuration settings.
void	endElement(java.lang.String s, java.lang.String s1, java.lang.String element) Concludes processing of an OSM element (node, way, or relation) once it has been parsed completely.
void	parseDocument() Calls Saxon transformation to parse the input XML file.
void	startElement(java.lang.String s, java.lang.String s1, java.lang.String elementName, org.xml.sax.Attributes attributes) Starts parsing of a new OSM element (node, way, or relation).

Methods inherited from class org.xml.sax.helpers.DefaultHandler

characters, endDocument, endPrefixMapping, error, fatalError, ignorableWhitespace, notationDecl, processingInstruction, resolveEntity, setDocumentLocator, skippedEntity, startDocument, startPrefixMapping, unparsedEntityDecl, warning

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

myConverter

Converter myConverter

myAssistant

Assistant myAssistant

myChecker

ValueChecker myChecker

reproject

private org.opengis.referencing.operation.MathTransform reproject

sourceSRID

int sourceSRID

targetSRID

int targetSRID

currentConfig

private Configuration currentConfig

inputFile

private java.lang.String inputFile

outputFile

private java.lang.String outputFile

classification

Classification classification

crsFactory

private static final org.opengis.referencing.crs.CRSAuthorityFactory crsFactory

numNodes

long numNodes

numWays

long numWays

numRelations

long numRelations

numNamedEntities

long numNamedEntities

geometryFactory

private com.vividsolutions.jts.geom.GeometryFactory geometryFactory

recBuilder

private OSMRecordBuilder recBuilder

tmpNodeIndex

private java.util.Map<java.lang.String,com.vividsolutions.jts.geom.Geometry> tmpNodeIndex

tmpWayIndex

private java.util.Map<java.lang.String,com.vividsolutions.jts.geom.Geometry> tmpWayIndex

tmpRelationIndex

private java.util.Map<java.lang.String,com.vividsolutions.jts.geom.Geometry> tmpRelationIndex

nodeTmp

private OSMNode nodeTmp

wayTmp

private OSMWay wayTmp

relationTmp

private OSMRelation relationTmp

tags

private java.util.Set<java.lang.String> tags

inWay

private boolean inWay

inNode

private boolean inNode

inRelation

private boolean inRelation

scanWays

private boolean scanWays

scanRelations

private boolean scanRelations

rescanRelations

private boolean rescanRelations

keepIndexed

private boolean keepIndexed

Constructor Detail

OsmXmlToRdf

public OsmXmlToRdf(Configuration config,
                   java.lang.String inFile,
                   java.lang.String outFile,
                   int sourceSRID,
                   int targetSRID)

Constructor for the transformation process from OpenStreetMap XML file to RDF.

Parameters:

config - Parameters to configure the transformation.

inFile - Path to input OSM XML file.

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

sourceSRID - Spatial reference system (EPSG code) of the input OSM XML file.

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

Method Detail

parseDocument

public void parseDocument()

Calls Saxon transformation to parse the input XML file.

startElement

public void startElement(java.lang.String s,
                         java.lang.String s1,
                         java.lang.String elementName,
                         org.xml.sax.Attributes attributes)
                  throws org.xml.sax.SAXException

Starts parsing of a new OSM element (node, way, or relation). Overrides method in parent Saxon class to initialize variables at the start of parsing of each OSM element.

Specified by:

startElement in interface org.xml.sax.ContentHandler

Overrides:

startElement in class org.xml.sax.helpers.DefaultHandler

Parameters:

s - The Namespace URI, or the empty string if the element has no Namespace URI or if Namespace processing is not being performed.

s1 - The local name (without prefix), or the empty string if Namespace processing is not being performed.

elementName - The qualified name (with prefix), or the empty string if qualified names are not available.

attributes - The attributes attached to the element. If there are no attributes, it shall be an empty Attributes object.

Throws:

org.xml.sax.SAXException

endElement

public void endElement(java.lang.String s,
                       java.lang.String s1,
                       java.lang.String element)

Concludes processing of an OSM element (node, way, or relation) once it has been parsed completely. Overrides method in the parent Saxon class to finalize variables and indices at the end of parsing of each OSM element.

Specified by:

endElement in interface org.xml.sax.ContentHandler

Overrides:

endElement in class org.xml.sax.helpers.DefaultHandler

Parameters:

s - The Namespace URI, or the empty string if the element has no Namespace URI or if Namespace processing is not being performed.

sl - The local name (without prefix), or the empty string if Namespace processing is not being performed.

element - The qualified name (with prefix), or the empty string if qualified names are not available.

apply

public void apply()

Applies transformation according to the configuration settings.