…
type: Ontology
description: Ontology used to describe interpretations of tabular literals to produce RDF.
comment: This ontology is used by the csv2rdf4lod project.
creator: TimLebo
creator: greg
date: 2011-02-09
preferred namespace prefix: conversion
preferred namespace uri: http://purl.org/twc/vocab/conversion/

Superclass for different conversion processes.
type: Class

A raw conversion process from CSV to RDF
type: Class
subclass of: Superclass for different conversion processes.
subclass of: Restriction
  on property: enhancement_identifier
  max cardinality: 0

An enhancement of an RDF dataset that adds new RDF triples
type: Class
subclass of: Superclass for different conversion processes.
subclass of: Restriction
  on property: enhancement_identifier
  min cardinality: 1
subclass of: Restriction
  on property: enhance
  min cardinality: 1

The state of a document at a point in time.
type: Class

RowEnhancement
subclass of: Restriction
  on property: csvRow
  min cardinality: 1

HeaderRow
type: Class
subclass of: RowEnhancement
userdocs: conversion:HeaderRow

DataStartRow
type: Class
subclass of: RowEnhancement
userdocs: conversion:DataStartRow

DataEndRow
type: Class
subclass of: RowEnhancement
userdocs: conversion:DataEndRow

delimits_cell
type: DatatypeProperty
comment: The delimiter that should be used to separate cells in a row.
domain: Superclass for different conversion processes.
range: Literal
userdocs: conversion:delimits cell

delimits_object
type: DatatypeProperty
comment: A regular expression specifiying how the object literal should be delimited to produce multiple object values.
userdocs: conversion:delimits object

Omitted
type: Class
subclass of: Enhancement
comment: Omit all triples from this column.
userdocs: conversion:Omitted

Only if column
type: Class
subclass of: Enhancement
comment: Omit triple if there is no value in the cell of the given column.

Enhancement
type: Class
label: The superclass of all enhancements. When the enhancement is referring to a particular property, the property's local name or originating column number may be used (using conversion:property_name and ov:csvCol, respectively).
subclass of: Restriction
  on property: csvCol
  min cardinality: 0
subclass of: Restriction
  on property: property_name
  min cardinality: 0
subclass of: Restriction
  on property: predicate identifier
  max cardinality: 1

IncludesLODLinks
type: Class
subclass of: Enhancement
comment: Any enhnacment with a conversion:links_via can also be a conversion:IncludesLODLinks. When so, include the LODLinks graph in the converted output.

CaseInsensitiveLODLink
type: Class
subclass of: Enhancement
comment: Ignore string case when attempting to match identifiers between the input table and the identifiers in the LODLinks graph

SubjectEnhancement
type: Class
comment: An Enhancement that modifies the subject of the resulting triple.
subclass of: Enhancement

PredicateEnhancement
type: Class
comment: An Enhancement that modifies the predicate of the resulting triple.
subclass of: Enhancement

ObjectEnhancement
type: Class
comment: An Enhancement that modifies the object of the resulting triple.
comment: Superclass of enhancements which promote values from a plain literal to more complex terms (resources or typed literals).
subclass of: Enhancement
subclass of: Restriction
  on property: interpret
  min cardinality: 1

Implicit bundle enhancement
type: Class
subclass of: SubjectEnhancement
comment: Reasserts the property-value pair to belong to a new resource specified by the conversion:bundled_by property. An example of this enhancement would be the introduction of a geo:Point instance based on latitude and longitude properties.
subclass of: Restriction
  on property: bundled_by
  cardinality: 1
subclass of: Restriction
  on property: bundled_by
  some values from: Implicit Bundle

Implicit Bundle
type: Class
comment: Represents the structural template for an implicit bundle enhancement. The conversion:property_name specifies the property name by which a bundle is attached to an instance. An optional conversion:type_name may be specified for the bundle to indicate the rdf:type of the new resource.
disjoint with: Implicit bundle enhancement
subclass of: Restriction
  on property: property_name
  cardinality: 1
subclass of: Restriction
  on property: type_name
  max cardinality: 1

Existing bundle enhancement
type: Class
subclass of: SubjectEnhancement
comment: Reasserts the property-value pair to belong to the existing resource specified by the conversion:bundled_by property.
subclass of: Restriction
  on property: bundled_by
  cardinality: 1
subclass of: Restriction
  on property: bundled_by
  all values from: Resource promotion enhancement

bundled_by
type: ObjectProperty
range: Resource
userdocs: conversion:bundled by

domain_template
type: DatatypeProperty
domain: SubjectEnhancement
comment: Template to name the subject of the triple produced.
userdocs: conversion:domain template
comment: TODO, cannot happen: :cp a conversion:EnhancementConversionProcess; conversion:enhance [ ov:csvCol 1; conversion:domain_template 'a' ], [ ov:csvCol 2; conversion:domain_template 'b' ] (col 1 and col 2 make the enhancements distinct, and an EnhancementConversionProcess can only have one domain_templated enhancement.)

Subject type enhancement
type: Class
subclass of: SubjectEnhancement
comment: Asserts that the subject instance is of a specific type, specified by name with conversion:domain_name. Also asserts that the type is a owl:Class.
subclass of: Restriction
  on property: domain_name
  cardinality: 1

domain_name
type: DatatypeProperty
domain: Subject type enhancement
range: Literal
comment: The local type that should be asserted for the subjects of raw triples.
userdocs: conversion:domain name

equivalent_property
type: Class
subclass of: PredicateEnhancement
coment: The URI of a predicate that the current property should be replaced with.

Label Rename Enhancement
type: Class
subclass of: PredicateEnhancement
comment: Renames an existing property in the dataset.

label
type: DatatypeProperty
domain: Label Rename Enhancement
range: Literal
comment: A human-friendly label (like rdfs:label) that will be used to create the property local name when creating the property URI. The exact value of conversion:label will also be used for the rdfs:label of the property created.

Property comment enhancement
type: Class
subclass of: PredicateEnhancement
comment: Uses the object of the conversion:comment property and asserts it as the value of rdfs:comment on the property definition. The value of conversion:comment typically comes from the original csv header (that was too long), or from an ancillary file accompanying the csv file.

comment
type: DatatypeProperty
domain: Property comment enhancement
range: Literal
comment: A comment (like rdfs:comment) that will be applied to the property created during conversion.
userdocs: conversion:comment

Subproperty enhancement
type: Class
subclass of: PredicateEnhancement
comment: Asserts that an existing property in the dataset is a subproperty of an external property specified by conversion:subproperty_of. This enhancement will materialize the subproperty entailments for all instances.
subclass of: Restriction
  on property: property_name
  cardinality: 1
subclass of: Restriction
  on property: subproperty_of
  min cardinality: 1

eg
type: Property
type: AnnotationProperty
domain: ObjectEnhancement
comment: Example value from a cell in the column for this ColumnEnhancement.
userdocs: conversion:eg

Repeat previous if empty column
type: Class
subclass of: Enhancement
comment: Repeat value of last non-empty cell in this column for the current cell.
userdocs: conversion:Repeat previous if empty column

InterpretedAsNullEnhancement
type: Class
subclass of: Enhancement
comment: Prevents triples with objects of a certain value. Prevents values specified by rdf:value.
subclass of: Restriction
  on property: value
  min cardinality: 1

Literal datatype promotion enhancement
type: Class
subclass of: ObjectEnhancement
disjoint with: Resource promotion enhancement
comment: Promotes the raw literal value to a datatyped literal using the datatype specified with the conversion:range property.

DateTime promotion enhancement
type: Class
subclass of: Literal datatype promotion enhancement
comment: Casts raw literal values into W3CDTF values typed as xsd:dateTime based on a strftime pattern specified with the conversion:datetime_pattern. If the property values follow different patterns, multiple conversion:datetime_pattern values may specified. The first matching pattern (of a nondeterministic ordering) will be applied. An optional conversion:datetime_timezone may be specified if no timezone information is present in the datetime pattern.
equivalent class: Restriction
  on property: range
  has value: dateTime
subclass of: Restriction
  on property: datetime timezone
  max cardinality: 1
subclass of: Restriction
  on property: datetime pattern
  min cardinality: 1

Date promotion enhancement
type: Class
subclass of: Literal datatype promotion enhancement
comment: Casts raw literal values into W3CDTF values typed as xsd:date based on a strftime pattern specified with the conversion:date_pattern. If the property values follow different patterns, multiple conversion:date_pattern values may specified.
comment: For each value, all DateTimePromotionEnhancement patterns are attempted before attempting any DatePromotionEnhancement patterns specified for the same property.
equivalent class: Restriction
  on property: range
  has value: date
subclass of: Restriction
  on property: date pattern
  min cardinality: 1

Multiplier enhancement
type: Class
subclass of: Literal datatype promotion enhancement
comment: After datatype promotion to an XSD numeric type, multiplies the value by the multiplicand specified with the conversion:multiplier property.
subclass of: Restriction
  on property: multiplier
  min cardinality: 1

Boolean promotion enhancement
type: Class
subclass of: Literal datatype promotion enhancement
comment: Casts raw literal values into xsd:boolean datatyped values. The default recognized lexical representations are (case insensitive): 'yes', 'no', 'true', 'false', '0', and '1'. The conversion:boolean_true and conversion:boolean_false properties may be used to add additional lexical forms.
equivalent class: Restriction
  on property: range
  has value: boolean

Resource promotion enhancement
type: Class
subclass of: ObjectEnhancement
comment: Superclass of enhancements which promote values from a plain literal to a resource.
equivalent class: Restriction
  on property: range
  has value: Resource

Resource cast enhancement
type: Class
subclass of: Resource promotion enhancement
comment: Casts raw literal values directly into a URI.

Template resource promotion enhancement
type: Class
subclass of: Resource promotion enhancement
comment: Converts raw literal values into URIs by replacing in the template (specified by the conversion:template_pattern property) the substring '[value]'.
subclass of: Restriction
  on property: template pattern
  min cardinality: 1

Property-scoped resource promotion enhancement
type: Class
subclass of: Resource promotion enhancement
comment: Appends raw literal values to the dataset-property-specific value space URI. For example, the value 'AK' for property 'origin_state' would be promoted to </source/SSS/dataset/DDD/value/origin_state/AK>.

Typed resource promotion enhancement
type: Class
subclass of: Resource promotion enhancement
comment: Constructs a URI from the concatenation of a dataset-specific URI, a type token specified with conversion:range_name, and the raw literal value. Additionally asserts an rdf:type for the new resource with the class named with conversion:range_name. The type name will be lowercased for use in the URI and have the first letter uppercased for use as the class name. For example, the value 'AK' with conversion:range_name 'state' would be promoted to </source/SSS/dataset/DDD/type/state/AK> with an rdf:type of </source/SSS/dataset/DDD/vocab/State>.
subclass of: Restriction
  on property: range name
  cardinality: 1

Subclass enhancement
type: Class
subclass of: Enhancement
comment: Asserts that an existing class in the dataset, specified by name with conversion:class_name, is a subclass of an external class specified by conversion:subclass_of. This enhancement will materialize the rdf:type entailments for all instances.
subclass of: Restriction
  on property: class name
  cardinality: 1
subclass of: Restriction
  on property: subclass of
  min cardinality: 1

Superclass for sameAs enahncements
type: Class
subclass of: Enhancement
disjoint union of: Subject sameAs enahncements
disjoint union of: Object sameAs enahncements
disjoint union of: IndirectSameAsEnhancement
subclass of: Restriction
  on property: links_via
  min cardinality: 1

Subject sameAs enahncements
type: Class
subclass of: Superclass for sameAs enahncements
comment: Asserts owl:sameAs relationships between instances and external URIs based on the instances' values of a specific property and their interpretation by a mapping specified by conversion:linksVia. How this mapping is performed based on this value is unspecified, but may be based on aligning with (e.g. SKOS) labels or the edit distance between the property value and instances in a known ontology.

Subject sameAs enahncements via Lookup
type: Class
subclass of: Subject sameAs enahncements
comment: Asserts owl:sameAs relationships based on the values in the mapping of the property specified by conversion:subject_of.
subclass of: Restriction
  on property: subject of
  min cardinality: 1

Object sameAs enahncements
type: Class
subclass of: Superclass for sameAs enahncements
subclass of: Resource promotion enhancement
comment: Asserts owl:sameAs relationships between resources and external URIs based on the instances' values of a specific property and their interpretation by a mapping specified by conversion:linksVia. How this mapping is performed based on this value is unspecified, but may be based on aligning with (e.g. SKOS) labels or the edit distance between the property value and instances in a known ontology.

Object sameAs enahncements via Lookup
type: Class
subclass of: Object sameAs enahncements
comment: Asserts owl:sameAs relationships based on the values in the mapping of the property specified by conversion:subject_of.
subclass of: Restriction
  on property: subject of
  min cardinality: 1

IndirectSameAsEnhancement
type: Class
comment: For any Resource that became owl:sameAs another Resource in an external LOD bubble, use ALL external URIs instead of the local resource.

IndirectSameAsEnhancement
type: Class
comment: Refer to a local URI, which then has a single owl:sameAs triple pointing to external LOD bubbles. Depends on owl:sameAs inference OR extra graph patterns in SPARQL queries.

dataset file
type: ObjectProperty
domain: The state of a document at a point in time.
range: Document
comment: The URL of a dataset document.

encoding
type: DatatypeProperty
domain: The state of a document at a point in time.
comment: The character encoding of a dataset document.

source data
type: ObjectProperty
domain: Superclass for different conversion processes.
range: The state of a document at a point in time.
comment: The source of data for a conversion process.

base_uri
type: Property
domain: Dataset
comment: The base URI used in constructing identifying URIs for instances in the converted dataset.

source_identifier
type: DatatypeProperty
domain: Dataset
range: Literal
comment: The name of the organization to which the dataset being converted belongs.

dataset_identifier
type: DatatypeProperty
domain: Dataset
range: Literal
comment: The identifier of the dataset being converted. Ideally provided by source_identifier.

version_identifier
type: DatatypeProperty
domain: Dataset
range: Literal
comment: The version of conversion being performed per dataset.
comment: The version_identifier should only change during a 'raw' conversion when the underlying dataset has changed.

conversion_identifier
type: DatatypeProperty

enhancement_identifier
type: DatatypeProperty
sub property of: conversion_identifier

dataset_version
term status: archaic
moreinfo: DEPRECATING:-conversion:dataset version

conversion_process
type: ObjectProperty
domain: Layer Dataset
range: Superclass for different conversion processes.
comment: A conversion process that led to the creation or modification of an RDF dataset.

enhance
type: ObjectProperty
domain: An enhancement of an RDF dataset that adds new RDF triples
range: Enhancement

predicate identifier
type: DatatypeProperty
comment: ov:csvCol OR conversion:property_name should be used to refer to the property being enhanced - NOT BOTH.

property_name
type: DatatypeProperty
domain:
  union of: Enhancement
  union of: Implicit Bundle
range: Literal
comment: The property name on which an enhancement takes place.
comment: The local name of a property within this dataset-specific namespace.
sub property of: predicate identifier

csvCol
type: DatatypeProperty
sub property of: predicate identifier
range: positiveInteger
comment: First column is column 1; i.e., human-based indexing.

range name
type: DatatypeProperty
range: Literal
comment: The local name of an internal class.
userdocs: conversion:range name

template pattern
type: Property
domain: Template resource promotion enhancement
range: Literal
comment: String representing a templated URI. Placeholders in the template are replaced by values of the row in the specified columns. Columns are cited by local name or column number. For example, http://some.other.org/instances/[value]. http://some.other.org/instances/[state]-[county], http://some.other.org/instances/[#4]-[#6]

range
type: ObjectProperty
domain: Enhancement
range: Resource
comment: The rdfs:range of the property after enhancement. For raw conversions, it is always rdfs:Literal. More interesting things happen during enhancements.

BooleanSymbolInterpretation
type: Class
subclass of: SymbolInterpretation
comment: Any SymbolInterpretation that interprets to true or false is a BooleanSymbolInterpretation.
union of: Restriction
  on property: interpretation
  has value: true
union of: Restriction
  on property: interpretation
  has value: false

type_name
type: Property
domain: Implicit Bundle
range: Literal
comment: The local name of a class within this dataset-specific namespace.

subproperty_of
type: Property
domain: Subproperty enhancement
comment: The external property that is a super property of the local property named by :property_name
userdocs: conversion:subproperty of

links_via
type: ObjectProperty
range: Resource
userdocs: conversion:links via
range: LODLinks

LODLinks
type: Class
subclass of: Dataset
comment: An RDF Graph of resources with identifiers (dcterms:identifer, etc) that is used to link to resources created during conversion.

CatalogedDataset
type: Class
comment: A CatalogedDataset is any kind of dataset, in the most general sense and regardless of how it is encoded (RDF, Relational, Tabular, XML, SPS, etc.). If someone says to you, 'yea, NASA has a Mars imagery dataset, talk to Joe about it and visit its homepage', you just instantiated a CatalogedDataset. There are MANY CatalogedDatasets that are NOT conversion:Datasets and NOT void:Datasets, since both of these are RDF-based datasets. The purpose of CatalogedDataset is to maintain a list of 'TODO' items that could be explored, converted, and published as RDF. Once a CatalogedDataset IS investigated, named, and converted, it also becomes a conversion:Dataset (and thus a void:Datast).

Dataset
type: Class
comment: Asserted by the converter.
subclass of: Dataset
subclass of: Restriction
  on property: contributor
  min qualified cardinality: 1
  on class: Source

Source
type: Class
comment: A person, organization, or agent from which a dataset is retrieved.
subclass of: Agent
disjoint with: Dataset

Abstract Dataset
type: Class
comment: Dataset with source and dataset identifiers, but not version. Before any version is materialized (captured in time), and the union of all VersionedDatasets.
subclass of: Dataset
subclass of: Restriction
  on property: subset
  min qualified cardinality: 0
  on class: Versioned Dataset
disjoint with: Versioned Dataset
disjoint with: Layer Dataset

Versioned Dataset
type: Class
comment: A materialized (captured in time) dataset -- something is now on disk. Union of all LayerDatasets created by different conversion parameters.
subclass of: Dataset
subclass of: Restriction
  on property: subset
  min qualified cardinality: 0
  on class: Layer Dataset
disjoint with: Abstract Dataset
disjoint with: Layer Dataset

Layer Dataset
type: Class
comment: A conversion of a VersionedDataset using a particular set of conversion parameters.
subclass of: Dataset
subclass of: Restriction
  on property: subset
  min qualified cardinality: 0
  on class: Dataset Sample
disjoint with: Abstract Dataset
disjoint with: Versioned Dataset

Dataset Sample
type: Class
comment: A potentially incomplete subset of a void:Dataset
subclass of: Dataset

Meta Dataset
type: Class
comment: Data about another Dataset. Can contain VoID, PML, OPM, provenance, Dublin Core, etc.
subclass of: AuxiliaryDataset
disjoint with: SameAs Dataset

Dataset Catalog
type: Class
comment: A dataset that lists other datasets as its entries.
subclass of: Meta Dataset

ConversionMetaDataset
type: Class
comment: Metadata for a dataset that is created during the dataset's conversion invocation.
subclass of: Meta Dataset

SameAs Dataset
type: Class
subclass of: AuxiliaryDataset
subclass of: LinkSet
disjoint with: Meta Dataset

VersionControlledDataset
type: Class
subclass of: Dataset
subclass of: Project
comment: A conversion:Dataset whose data skeleton is available from a version control system.
subclass of: Restriction
  on property: repository
  min cardinality: 1

UnitTestedDatset
type: Class
subclass of: Dataset
comment: An RDF dataset tested with SPARQL queries verifying the presense or absence of particular triples.
comment: UnitTestedDatasets should cite locations for their unit tests.
subclass of: Restriction
  on property: testable by
  min cardinality: 1

informationResourceInput
type: ObjectProperty
comment: Information Resource (e.g. a file) used as input for the test case

Curl
type: Class
subclass of: InferenceEngine
comment: Asserted by pcurl.sh

HTTPHeader
type: Class
subclass of: Information
comment: Done by pcurl.sh

Number of invocation logs
type: DatatypeProperty
comment: Number of docs/logs/* captured by convert-aggregate.sh

ExampleResource
type: Class
subclass of: RowEnhancement
comment: Cites a row that contains an exemplary resource or structure; 'highlighting' it for increased attention. e.g., Jim Hendler or Bill O'Reilly in a White House Visitor Record.

Bundle
type: Property

TypedResourcePromotion
type: Property

range template
type: DatatypeProperty

SubjectAnnotation
type: Class
comment: add a predicate-object description to the subject of a triple created.

predicate
type: Property

object
type: Property

interpret
type: ObjectProperty
range: SymbolInterpretation

SymbolInterpretation
type: Class
comment: Pairs a collection of symbols with how they should be interpreted. For example, 'S' should be interpreted as http://dbpedia.org/resource/United_States_Senate.
subclass of: Enhancement
subclass of: Restriction
  on property: symbol
  min cardinality: 1
subclass of: Restriction
  on property: interpretation
  cardinality: 1

symbol
type: DatatypeProperty
domain: SymbolInterpretation

interpretation
type: Property
domain: SymbolInterpretation

TripleStore
type: Class
subclass of: InferenceEngine

ConversionTrigger
type: Class
subclass of: InferenceEngine
comment: In csv2rdf4lod-automation, the conversion trigger is a shell script situated within the conversion cockpit that initiates conversion of source data to RDF.

LargeValue
type: Class
comment: Used to denote that the value of a cell is 'large', where 'large' is loosely defined by the implementing system. For example, javacsv thinks 100,000 characters is Large and requires a setting to permit more than that.

subsetT
type: TransitiveProperty
type: ObjectProperty
comment: A transitive version of void:subset

CSV2RDF4LOD_environment_variables
type: Class
comment: A shell script that sets https://github.com/timrdf/csv2rdf4lod-automation/wiki/CSV2RDF4LOD-environment-variables to control the behavior of csv2rdf4lod-automation.

A measure of conceptual depth using the URI's 'depth' within the source/dataset/version contextualization scheme used by csv2rdf4lod's data aggretation naming scheme.
type: DatatypeProperty
sub property of: conceptual depth

num_triples
type: DatatypeProperty
equivalent property: triples

ServiceEndpoint
type: Class
comment: http://www.w3.org/TR/sparql11-service-description/ does not specify a range, but we want to refer to it

VocabularyMappings
type: Class
comment: Vocabulary mappings to other vocabularies; a mapping file with tag 'mapping/<format>'. Replace <format> with the mapping/rule language used, like R2R or RIF.

enhancement_layer

enhances
type: AnnotationProperty
comment: Used to describe terms from enhanced datasets, to refer to analogous terms from less enhanced datasets

name_template
type: DatatypeProperty

object_search
type: ObjectProperty

pattern
type: DatatypeProperty

regex
type: DatatypeProperty

subject_discriminator

todo

triples_per_minute
type: DatatypeProperty

uses_class
type: AnnotationProperty

uses_predicate
type: AnnotationProperty