[pd-discuss] Flowchart based Public Domain calculator API call

Thu Feb 11 08:53:07 UTC 2010

HI all,

I am happy to announce that a preliminary version of the flowchart based automatic public domain calculator can be tested (a bit) on test.kl.nl/API/?json=

We've pulled some expertise and knowledge together from the OKFN and Kennisland (Knowledgeland) and developed a calculator based on flowcharts.

see: http://wiki.okfn.org/PublicDomainCalculators for flowcharts
see: http://wiki.okfn.org/PublicDomainCalculators/xml for a first version of a translation manual for flowcharts to XML for inclusion in our calculator
see: http://wiki.okfn.org/PublicDomainCalculators/Api for our API discussion and pseudo-code

Now we can call this library by an API call using http using the following steps:

First, our API call will need to have the following bibliographical data:

work:
title
type
date
creation_date
persons

person:
type
name
birth_date
death_date
country

and uses the following variables

#STATIC FINAL VARS
MAXLIFE = 125

person.type
HUMAN = "person"
LEGAL = "organization"
ANONYMOUS = "unknown"

work.type
LITERARY = "text"
SOUND = "recording"
PHOTO = "photograph"
VIDEO = "video"
DATABASE = "database"

NOW = 20100101

So for example a photograph needs to be encoded using "photograph" and a legal work as "organization"

This will be communicated using json, a json structure would look like:

{
"when": "20110101"
jurisdiction:"uk"
"work": 
	{
		"title": "Collected Papers on the Public Domain (ed)", 
		"type": "text",
		"date" : "20030101",
		"creation_date" : "20030101",
		"persons" : 
		{
			[
				"name" : "Boyle, James" : 
				"type" : "person",
				"birth_date" : "19590101",
				"death_date" : "None",
				"country": "uk"
			]
		}
	}
} 

which, in a single line is:
{"when": "20110101","jurisdiction":"uk","work": {"title": "Collected Papers on the Public Domain (ed)", "type": "text","date" : "20030101","creation_date" : "20030101","persons" : [{"name" : "Boyle, James", "type" : "person","birth_date" : "19590101","death_date" : "None","country": "uk"}]}} 

which will then need to be placed at the end of the API call like this: 

http://test.kl.nl/API/?json={"when": "20110101","jurisdiction":"uk","work": {"title": "Collected Papers on the Public Domain (ed)", "type": "text","date" : "20030101","creation_date" : "20030101","persons" : [{"name" : "Boyle, James", "type" : "person","birth_date" : "19590101","death_date" : "None","country": "uk"}]}} 

Which will perform the calculation. Now it will state 'Uncertain, lacking information' this is because is now standardly based on Generic European flowcharts and hits a wall at the "Is at least one of the authors of the jurisdiction"

The programming is now in a test phase but I could really use some help transforming flowcharts into XML structures

If anyone wants to help this cause please contact me! :)

Best,

Maarten Zeinstra

Kennisland | Knowledgeland 
T: +31.20.575.6720 | E: mz at kl.nl
www.kennisland.nl | www.knowledgeland.org

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.okfn.org/pipermail/pd-discuss/attachments/20100211/e2a0efc8/attachment.html>