Author: andy
Date: Sat Aug 2 19:50:58 2014
New Revision: 1615359
URL: http://svn.apache.org/r1615359
Log:
Put back CSV documentation after site publication for Jena 2.12.0
Added:
jena/site/trunk/content/documentation/csv/index.mdtext
Added: jena/site/trunk/content/documentation/csv/index.mdtext
URL:
http://svn.apache.org/viewvc/jena/site/trunk/content/documentation/csv/index.mdtext?rev=1615359&view=auto
==============================================================================
--- jena/site/trunk/content/documentation/csv/index.mdtext (added)
+++ jena/site/trunk/content/documentation/csv/index.mdtext Sat Aug 2 19:50:58
2014
@@ -0,0 +1,55 @@
+Title: CSV PropertyTable
+
+This module is about getting CSVs into a form that is amenable to Jena SPARQL
processing, and doing so in a way that is not specific to CSV files.
+It includes getting the right architecture in place for regular table shaped
data, using the core abstraction of PropertyTable.
+
+*Illustration*
+
+This module involves the basic mapping of CSV to RDF using a fixed algorithm,
including interpreting data as numbers or strings.
+
+Suppose we have a CSV file located in âfile:///c:/town.csvâ, which has one
header row, two data rows:
+
+ Town,Population
+ Southton,123000
+ Northville,654000
+
+As RDF this might be viewable as:
+
+ @prefix : <file:///c:/town.csv#> .
+ @prefix csv: <http://w3c/future-csv-vocab/> .
+ [ csv:row 1 ; :Town "Southton" ; :Population
â123000â^^http://www.w3.org/2001/XMLSchema#int ] .
+ [ csv:row 2 ; :Town "Northville" ; :Population
â654000â^^http://www.w3.org/2001/XMLSchema#int ] .
+
+or without the bnode abbreviation:
+
+ @prefix : <file:///c:/town.csv#> .
+ @prefix csv: <http://w3c/future-csv-vocab/> .
+ _:b0 csv:row 1 ;
+ :Town "Southton" ;
+ :Population â123000â^^http://www.w3.org/2001/XMLSchema#int .
+ _:b1 csv:row 2 ;
+ :Town "Northville" ;
+ :Population â654000â^^http://www.w3.org/2001/XMLSchema#int.
+
+Each row is modeling one "entity" (here, a population observation).
+There is a subject (a blank node) and one predicate-value for each cell of the
row.
+Row numbers are added because it can be important.
+Now the CSV file is viewed as a graph - normal, unmodified SPARQL can be used.
+Multiple CSVs files can be multiple graphs in one dataset to give query across
different data sources.
+
+We can use the following SPARQL query for âTowns over 500,000 peopleâ
mentioned in the CSV file:
+
+ SELECT ?townName ?pop {
+ GRAPH <file:///c:/town.csv> {
+ ?x :Town ?townName ;
+ :Popuation ?pop .
+ FILTER(?pop > 500000)
+ }
+ }
+
+## Get Started
+
+## Design
+
+## Implementation
+
