Template:TableMapping

From DBpedia Mappings
Jump to: navigation, search

Table mappings should be added to the Mapping namespace, using the Table prefix.

If a table mapping is defined, all rows of the table are mapped to instances of an ontology class, all of its columns are be mapped to ontology properties. A table mapping applies to a table if a set of keywords occurs in the table header.

Usage

{{TableMapping
| mapToClass 		=
| correspondingClass	=
| correspondingProperty =
| header                =
| keywords 		=
| mappings              =
}}

Meanings

  • mapToClass: Table rows are mapped to ontology classes. The template parameter mapToClass allows one DBpedia ontology class as a value.
  • correspondingClass, correspondingProperty: If an instance of type correspondingClass is found in the same section as the table, it will be connected to the instances extracted from the table rows by correspondingProperty.
  • keywords: Keywords define mandatory table column headers or parts of them. Keywords can be separated by semicolons meaning they have to occur in different column headers. Alternatives of keywords can be separated by colons.
  • header: Lists all mapped table column headers, separated by semicolons. Each column definition can contain alternative definitions, separated by colons. If the column is defined by several keywords, the keywords have to be separated by & in the order of their appearance.
  • mappings: Mappings map table columns to ontology properties, they have to be defined by using the same templates as in mappings on Template:TemplateMapping. A separate mapping for each alternative column header definition has to be specified.

Example

All rows of a table shall be mapped to instances of an ontology class, all of its columns shall be mapped to ontology properties.

The rows of tables with the columns Engine Name, Type, Engine code, and Top speed are mapped to instances of the ontology class Automobile Engine, while the columns are mapped to the corresponding ontology properties. If an infobox that is mapped to the ontology class Automobile is in the same section as the table, the instances generated for the table rows are connected to the instance generated from the infobox by the ontology property MeanOfTransportation/engine.

{{TableMapping 
| mapToClass            = AutomobileEngine
| correspondingClass    = Automobile
| correspondingProperty = MeanOfTransportation/engine
| keywords              = engine; speed
| header                = speed; code; name, engine ; type
| mappings              = 
{{PropertyMapping | templateProperty = engine | ontologyProperty = AutomobileEngine/name }}
{{PropertyMapping | templateProperty = type | ontologyProperty = AutomobileEngine/type }}
{{PropertyMapping | templateProperty = code | ontologyProperty = AutomobileEngine/code }}
{{PropertyMapping | templateProperty = speed | ontologyProperty = AutomobileEngine/speed | unit = kilometerPerHour }}
}}

TODO: improve the description of commas and semicolons and ampersands used in TableMapping. Apparently it takes two PhDs to understand it.

Unfortunately this powerful feature is not used much: just 1 mapping as of Feb 2015: