Skip to content

conversion:bundled_by

Jump to bottom
timrdf edited this page Feb 11, 2011 · 53 revisions

See Suggested ordering of predicates on a conversion:Enhancement.

Example

Values can be bundled by an implicit resource (as in Dataset 10025) or an inline resource (as in Dataset 1147). In the case of an implicit resource a URI is created to bundle the values, while in the inline case no URI is created and the values are associated with a resource that was promoted from an existing value.

(TODO: because of the poor quality of 1147, a new example needs to be used. -Tim)

e.g., Dataset 1147

@prefix : <http://logd.tw.rpi.edu/source/data-gov/dataset/1147/params/enhancement/1/> .

:dataset a void:Dataset;
   conversion:base_uri            "http://logd.tw.rpi.edu"^^xsd:anyURI;
   conversion:source_identifier   "data-gov";
   conversion:dataset_identifier  "1147";
   conversion:dataset_version     "2009-Oct-08";
   conversion:conversion_process [
     conversion:enhance [
        ov:csvCol        3;
        ov:csvHeader    "State_Code_Dest";

        conversion:range rdfs:Resource; # Inline bundles must be promoted to resources.

        a conversion:TypedResourcePromotionEnhancement; # This is not required for inline bundling.
        conversion:range_name "state";
     ];
     conv:enhance [
        ov:csvCol     5;
        ov:csvHeader "State_Abbrv";
        conversion:range    rdfs:Literal;

        a conversion:ExistingBundleEnhancement;
        conversion:bundled_by [ ov:csvCol 3 ];
     ];
   ];
.

@prefix ds1147: <http://logd.tw.rpi.edu/source/data-gov/dataset/1147/version/2009-Oct-08/> .
@prefix raw:    <http://logd.tw.rpi.edu/source/data-gov/dataset/1147/vocab/raw/> .
@prefix e1:     <http://logd.tw.rpi.edu/source/

ds1147:thing_6 
   raw:state_code_origin "01";
   raw:state_abbrv       "AL";
.

becomes

ds1147:thing_6
   e1:state_code_origin <http://logd.tw.rpi.edu/source/data-gov/dataset/1147/version/2009-Oct-08/state/01>;
#  e1:state_abbrv does NOT describe ds1146:thing_6 
.

<http://logd.tw.rpi.edu/source/data-gov/dataset/1147/version/2009-Oct-08/state/01>
   e1:state_abbrv "AL";
   rdfs:label     "01";
.

(TODO: one-level vs hierarchical)

Other datasets that benefit from this enhancement include Dataset 1492.

Ontology

conversion:Enhancement

conversion:bundled_by 
    rdfs:domain conversion:Enhancement;
    rdfs:range [ owl:unionOf ( [[conversion:ImplicitBundle]] [[conversion:ExplicitBundle]] ) ] .

conversion:ImplicitBundle is explicitly typed and has conversion:property_name and conversion:type_name. implicit bundle does NOT have a ov:csvCol.

conversion:ImplicitBundle 
    rdfs:subClassOf [ owl:onProperty ov:csvCol;                owl:maxCardinality 0; a owl:Restriction ] ,
                    [ owl:onProperty conversion:property_name; owl:cardinality    1; a owl:Restriction ] ,
                    [ owl:onProperty conversion:type_name;     owl:maxCardinality 1; a owl:Restriction ] .

conversion:ExplicitBundle must have an ov:csvCol .

conversion:ExplicitBundle 
    rdfs:subClassOf [ owl:onProperty ov:csvCol;                owl:minCardinality 1; a owl:Restriction ] ,
                    [ owl:onProperty conversion:property_name; owl:maxCardinality 0; a owl:Restriction ] ,
                    [ owl:onProperty conversion:type_name;     owl:maxCardinality 0; a owl:Restriction ] .

see also conversion:property_name, conversion:type_name .

Currently still being described at Enhancement Parameters Reference; will transition to here.

What datasets use this enhancement?

109 explicit bundles in 9 dataset versions.

PREFIX rdfs:       <http://www.w3.org/2000/01/rdf-schema#>
PREFIX xsd:        <http://www.w3.org/2001/XMLSchema#>
PREFIX ov:         <http://open.vocab.org/terms/>
PREFIX conversion: <http://purl.org/twc/vocab/conversion/>

SELECT distinct ?dataset
WHERE {
  GRAPH <http://purl.org/twc/vocab/conversion/ConversionProcess> {
    ?dataset a void:Dataset;
      conversion:conversion_process [
        conversion:enhance ?enhancement
      ]
    .
    ?enhancement conversion:bundled_by [ ov:csvCol ?explicit_bundle_position ] .
  }
}

17 implicit bundles in 7 dataset versions.

PREFIX rdfs:       <http://www.w3.org/2000/01/rdf-schema#>
PREFIX xsd:        <http://www.w3.org/2001/XMLSchema#>
PREFIX ov:         <http://open.vocab.org/terms/>
PREFIX conversion: <http://purl.org/twc/vocab/conversion/>

SELECT count(distinct ?bundle)
WHERE {
  GRAPH <http://purl.org/twc/vocab/conversion/ConversionProcess> {
    ?dataset a void:Dataset;
      conversion:conversion_process [
        conversion:enhance ?enhancement
      ]
    .
    ?enhancement conversion:bundled_by ?bundle .
    ?bundle a conversion:ImplicitBundle .
  }
}

Clone this wiki locally