Skip to content

Commit

Permalink
Upload version 1.1
Browse files Browse the repository at this point in the history
  • Loading branch information
Steve Baskauf committed Oct 20, 2016
1 parent 8ab404a commit d3d9868
Show file tree
Hide file tree
Showing 19 changed files with 1,060 additions and 1 deletion.
12 changes: 11 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Software to convert fielded text (CSV) files to RDF serialized as XML, Turtle, a
## What is the purpose of Guid-O-Matic ?
Best Practices in the biodiversity informatics community, as embodied in the [TDWG GUID Applicability Statement](https://github.com/tdwg/guid-as) dictate that globally unique identifiers (GUIDs, rhymes with "squids") should be resolvable (i.e. dereferenceable, Recommendation R7) and that the default metadata response format should be RDF serialized as XML (Recommendation R10). In practice, machine-readable metadata is rarely provided when the requested content-type is some flavor of RDF. I think the reason is because people think it is "too hard" to generate the necessary RDF.

The main purpose of Guid-O-Matic is mostly to show that it is not really that hard to create RDF. Anybody who can create a spreadsheet or a [Darwin Core Archive (DwCa)](http://www.gbif.org/resource/80636) can generate RDF with little additional effort. In production, providers would probably not use spreadsheets as a data source, but the point of Guid-O-Matic is to demonstrate a general strategy and allow users to experiment with different graph structures and play with the generated serializations.
The purpose of Guid-O-Matic is mostly to show that it is not really that hard to create RDF. Anybody who can create a spreadsheet or a [Darwin Core Archive (DwCa)](http://www.gbif.org/resource/80636) can generate RDF with little additional effort. In production, providers would probably not use spreadsheets as a data source, but the point of Guid-O-Matic is to demonstrate a general strategy and allow users to experiment with different graph structures and play with the generated serializations.

## Why is it called "Guid-O-Matic" and not something like "RDF-Generator-O-Matic"?
Because I already had the cute squid picture and "RDF Generator" doesn't rhyme with "squid".
Expand All @@ -17,3 +17,13 @@ Because I already had the cute squid picture and "RDF Generator" doesn't rhyme w
I am not a very good Python programmer and I don't know PHP. Once you understand what Guid-O-Matic does, you can write your own (better) code to do the same thing.

I used Xquery because I'm in a working group that includes a lot of Digital Humanists, and they love XML. Also, the awesome Xquery processor, BaseX, is free and easily downloaded and installed. So anybody can easily run the Guid-O-Matic scripts. Also, BaseX can run as a web server, so in theory, one could call the RDF-generating functions in response to a HTTP request and actually use the scripts to provide RDF online.

## What did Guid-O-Matic 1.1 do?
I wrote Guid-O-Matic 1 in about 2010. Version 1.1 had a very limited scope:
- it only generated RDF/XML
- it assumed that the focal resource was a specimen
- it assumed that the specimen was depicted by one image
- it was hard-coded to use a specific version of the [Darwin Core](http://rs.tdwg.org/dwc/terms/) and [Darwin-SW](https://github.com/darwin-sw/dsw) vocabularies
- other stuff that I can't remember

Version 1.1 also was written in an old version of Visual Basic, which had the advantage that it could run as an executable, but had the disadvantage that you couldn't hack it unless you had a copy of Visual Basic and knew how to use it. Even I don't have a functioning copy of that version of Visual Basic, so I can't look at the source code any more. But it doesn't really matter because I don't advise that anyone try to mess with it anyway. I'm only posting it here for historical reasons (and so that you can try running it to see the great squid graphic on the UI!).
4 changes: 4 additions & 0 deletions determinations.csv
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
2,identifier,dwc:catalogNumber,dwc:establishmentMeans,sernec:documentsDistribution,dwc:occurrenceRemarks,dwc:recordedBy,dwc:recordNumber,dwc:eventDate,dwc:decimalLatitude,dwc:decimalLongitude,dwc:geodeticDatum,dwc:coordinateUncertaintyInMeters,dwc:georeferenceRemarks,dwc:continent,dwc:countryCode,dwc:stateProvince,dwc:county,dwc:locality,dwc:establishmentMeans,dcterms:created,BQ mrtg:accessURL,BQ mix:imageWidth,BQ mix:imageHeight,BQ mix:xSamplingFrequency,GQ mrtg:accessURL,GQ mix:imageWidth,GQ mix:imageHeight,LQ mrtg:accessURL,LQ mix:imageWidth,LQ mix:imageHeight,TN mrtg:accessURL,TN mix:imageWidth,TN mix:imageHeight
nlu000,NLU0009506,71867,native,true,Old fields on J. R. Barrett farm.,R. Dale Thomas; E. R. Barrett; R. E. Jones,1248,1966-10-25,31.73,-92.41,epsg:4326,2000,Location determined by examination of Google Maps,NA,US,Louisiana,Grant,2 1/2 miles SW of Georgetown,native,2009-10-09,http://images.cyberfloralouisiana.com/images/specimensheets/nlu/95/6/73/54/NLU00095067354.jpg,3743,4441,105,http://images.cyberfloralouisiana.com/images/specimensheets/nlu/95/6/73/54/NLU00095067354_l.jpg,674,800,http://images.cyberfloralouisiana.com/images/specimensheets/nlu/95/6/73/54/NLU00095067354_m.jpg,,275,http://images.cyberfloralouisiana.com/images/specimensheets/nlu/95/6/73/54/NLU00095067354_s.jpg,84,100
nlu000,NLU0090505,325376,native,true,Area disturbed by construction.,R. Dale Thomas; Eric Sundell; Carl Amason,122206,1990-10-21,35.23,-92.08,epsg:4326,1000,Location determined by examination of Google Maps,NA,US,Arkansas,White,Along Arkansas 310 west of Arkansas 5 between Romance and El Paso,native,2010-06-16,http://images.cyberfloralouisiana.com/images/specimensheets/nlu/0/9/5/5/NLU0090505.jpg,3699,4386,104,http://images.cyberfloralouisiana.com/images/specimensheets/nlu/0/9/5/5/NLU0090505_l.jpg,675,800,http://images.cyberfloralouisiana.com/images/specimensheets/nlu/0/9/5/5/NLU0090505_m.jpg,232,275,http://images.cyberfloralouisiana.com/images/specimensheets/nlu/0/9/5/5/NLU0090505_s.jpg,84,100
,,,,,,,,,,,,,,,,,,,,,,,,,http://images.cyberfloralouisiana.com/images/specimensheets/nlu/0/10/12/71/NLU0101271_l.jpg,,,,,,,,
Loading

0 comments on commit d3d9868

Please sign in to comment.