Elsevier Funding Bodies LOD - 2012-06

Report
Accessing Elsevier Funding Body Vocabulary through
Open Access APIs
Presented to the FundRef Pilot group
June 15, 2012
Sophie Forge
Business Technology Manager
[email protected]
Agenda
1. Elsevier’s Funding Body Data v2.0
2. How to navigate Funding Body Data in RDF
3. Elsevier Open Access APIs
http://data.elsevier.com/documentation/index.html
2
Elsevier SciVal Funding Body Data - v2.0
•SciValFunders v2.0 released in open access on June 13,
2012
•New version contains 4,572 unique Organization IDs (versus
3,397 in v1)
•Covering Australia, Canada, the European
Commission, India, Ireland, New Zealand, Singapore, South
Africa, the United Kingdom, and the United States.
•For more information on Elsevier’s SciVal Funding:
http://www.funding.scival.com/home#b
3
Elsevier SciVal Funding Body Data - v2.0
• Each organization’s record includes:
Property
Description
Concept ID
A unique identifier for the funding body.
Preferred Label
The preferred label to use when referring to the funding body (for example, Massachusetts General Hospital).
Alternate Labels
One or more alternate labels that are used for the funding body (for example, MGH).
Timestamps
Timestamps that indicate when the concept was created and last modified.
Timestamps are in the format:
yyyy-mm-ddThh:mm:ss
For example, 2012-05-04T23:58:30 indicates 4 May 2012 at 11:58:30 PM.
Funding Body
Type
The funding type of the funding body.
Funding types include:
•pri: Private
•gov: Government
Funding Body
Subtype
The funding subtype of the funding body.
Private funding subtypes include:
•Academic, corporate, foundation, international, other non-profit (private), professional associations and
societies
Government funding subtypes include:
•federal (national government). government non-federal (state/provincial government)
Country
The URI on the sws.geonames.org website for the ISO 3166 country code for the home country of the funding body.
For example, the country code 6252001 is for the United States.
State
The URI on the sws.geonames.org website for the ISO 3166 country subdivision code for the home subdivision (for
example, state, province, or territory) of the funding body.
For example, the subdivision code 6093943 is for the Ontario province in Canada.
4
Elsevier SciVal Funding Body Data - v2.0
• Interrelations between funding bodies
–Two relationships: Broader and Affiliated With
–Relationships are optional properties
Property
Description
Broader
Points to the parent concept(s) in the taxonomy (Note: NT relationship is implied)
Affiliated With
Points to related concept(s) in the taxonomy (RT relationship)
SAMPLE “BROADER”
RELATIONSHIPS
National Science
Foundation
Office of Polar
Programs
Office of Polar
Environment,
Health and Safety
Division of Antarctic
Infrastructure and
Logistics
Directorate for
Education and
Human Resources
Division of
Research,
Evaluation, and
Communication
“AFFILIATED WITH”
U.S. Department
of Education
Office of
Postsecondary
Education
Office of Special
Education and
Rehabilitative
Services
5
Elsevier SciVal Funding Body Data - v2.0
Note: FundRef funders OrgIds
–DOE: http://data.elsevier.com/vocabulary/SciValFunders/100000015
–NASA: http://data.elsevier.com/vocabulary/SciValFunders/100000104
–NSF: http://data.elsevier.com/vocabulary/SciValFunders/100000001
–Wellcome Trust: http://data.elsevier.com/vocabulary/SciValFunders/100004440
6
How to read Funding Body Data in RDF (1)
• Each organization record is contained between a <skos:Concept> and the next
</skos:Concept>
• Each organization has a unique ID, represented as a URI in the RDF:about field of the RDF
file
• All its other properties follow
Property
RDF Properties / Sample Values
Concept ID
<skos:Concept rdf:about="http://data.elsevier.com/vocabulary/SciValFunders/100000015">
Preferred Label
<skosxl:prefLabel><skosxl:Label>
<skosxl:literalForm xml:lang="en">U.S. Department of Energy</skosxl:literalForm>
</skosxl:Label> </skosxl:prefLabel>
Alternate Labels
<skosxl:altLabel><skosxl:Label>
<skosxl:literalForm xml:lang="en“>DOE</skosxl:literalForm>
</skosxl:Label></skosxl:altLabel>
Timestamps
<dct:modified>2011-11-07T16:06:07.000000</dct:modified>
<dct:created>2009-07-06T18:53:11.000000</dct:created>
Funding Body Type
<svf:fundingBodyType>gov</svf:fundingBodyType>
Funding Body Subtype
<svf:fundingBodySubType>federal/national government</svf:fundingBodySubType>
Country
<svf:country rdf:resource="http://sws.geonames.org/6252001/"/>
State
<svf:state rdf:resource="http://sws.geonames.org/4138106/"/>
Relationships Property
RDF Properties / Sample Values
Broader
<skos:broader rdf:resource="http://data.elsevier.com/vocabulary/SciValFunders/100000001"/>
Affiliated With
<svf:affilWith rdf:resource="http://data.elsevier.com/vocabulary/SciValFunders/100000104"/>
7
SciVal Funding Body Example Record in RDF with
“Broader“ relationship
<skos:Concept rdf:about="http://data.elsevier.com/vocabulary/SciValFunders/100000087">
<skos:inScheme rdf:resource="http://data.elsevier.com/vocabulary/SciValFunders"/>
<skosxl:prefLabel>
<skosxl:Label>
<skosxl:literalForm xml:lang="en“>Office of Polar Programs</skosxl:literalForm>
</skosxl:Label>
</skosxl:prefLabel>
<skosxl:altLabel>
<skosxl:Label>
<skosxl:literalForm xml:lang="en">OPP</skosxl:literalForm>
</skosxl:Label>
</skosxl:altLabel>
<skos:broader rdf:resource="http://data.elsevier.com/vocabulary/SciValFunders/100000001"/>
<dct:modified>2011-11-07T09:36:09.000000</dct:modified>
<dct:created>2009-07-06T18:53:11.000000</dct:created>
<svf:fundingBodyType>gov</svf:fundingBodyType>
<svf:country rdf:resource="http://sws.geonames.org/6252001/"/>
<svf:state rdf:resource="http://sws.geonames.org/6254928/"/>
<svf:fundingBodySubType>federal</svf:fundingBodySubType>
</skos:Concept>
8
How to read Funding Body Data in RDF (2)
• Related concept(s) unique ids are referred to by their URIs
Property
Sample Values
Concept ID
rdf:about="http://data.elsevier.com/vocabulary/SciValFunders/100000087">
Broader concept
<skos:broader rdf:resource="http://"data.elevier.com/vocabulary/SciValFunders/100000001/”>
<skos:Concept rdf:about="http://data.elsevier.com/vocabulary/SciValFunders/100000001">
<skos:inScheme rdf:resource="http://data.elsevier.com/vocabulary/SciValFunders"/>
<skosxl:prefLabel><skosxl:Label>
<skosxl:literalForm xml:lang="en">National Science Foundation</skosxl:literalForm></skosxl:Label></skosxl:prefLabel>
<skosxl:altLabel> <skosxl:Label> <skosxl:literalForm xml:lang="en">NSF</skosxl:literalForm>
</skosxl:Label></skosxl:altLabel>
<dct:modified>2011-11-07T09:36:09.000000</dct:modified>
<dct:created>2009-07-06T18:53:11.000000</dct:created>
<svf:fundingBodyType>gov</svf:fundingBodyType>
<svf:country rdf:resource="http://sws.geonames.org/6252001/"/>
<svf:state rdf:resource="http://sws.geonames.org/6254928/"/>
<svf:fundingBodySubType>federal</svf:fundingBodySubType> <
/skos:Concept>
 http://data.elsevier.com/vocabulary/SciValFunders/100000001 (National
Science Foundation) is parent of
http://data.elsevier.com/vocabulary/SciValFunders/100000087 (Office of Polar
Programs)
9
SciVal Funding Body Example Record in RDF with
“Affiliated With” relationship
<skos:Concept rdf:about="http://data.elsevier.com/vocabulary/SciValFunders/100005733">
<skos:inScheme rdf:resource="http://data.elsevier.com/vocabulary/SciValFunders"/>
<skosxl:prefLabel>
<skosxl:Label>
<skosxl:literalForm xml:lang="en">California Space Grant Consortium</skosxl:literalForm>
</skosxl:Label>
</skosxl:prefLabel>
<skosxl:altLabel>
<skosxl:Label>
<skosxl:literalForm xml:lang="en">CaSGC</skosxl:literalForm>
</skosxl:Label>
</skosxl:altLabel>
<svf:affilWith rdf:resource="http://data.elsevier.com/vocabulary/SciValFunders/100000104"/>
<dct:created>2010-11-23T14:00:52</dct:created>
<svf:fundingBodyType>pri</svf:fundingBodyType>
<svf:country rdf:resource="http://sws.geonames.org/6252001/"/>
<svf:state rdf:resource="http://sws.geonames.org/5332921/"/>
<svf:fundingBodySubType>other non-profit</svf:fundingBodySubType>
</skos:Concept>
10
How to read Funding Body Data in RDF (3)
• Related concept(s) unique ids are referred to by their URIs
Property
Sample Values
Concept ID
rdf:about="http://data.elsevier.com/vocabulary/SciValFunders/100005733">
Affiliated concept <svf:affilWith rdf:resource="http://"data.elevier.com/vocabulary/SciValFunders/100000104/”>
<skos:Concept rdf:about="http://data.elsevier.com/vocabulary/SciValFunders/100000104">
<skos:inScheme rdf:resource="http://data.elsevier.com/vocabulary/SciValFunders"/>
<skosxl:prefLabel><skosxl:Label><skosxl:literalForm xml:lang="en">
National Aeronautics and Space Administration
</skosxl:literalForm></skosxl:Label></skosxl:prefLabel>
<skosxl:altLabel><skosxl:Label><skosxl:literalForm xml:lang="en“>NASA</skosxl:literalForm></skosxl:Label></skosxl:altLabel>
<dct:modified>2011-11-07T16:06:07.000000</dct:modified>
<dct:created>2009-07-06T18:53:11.000000</dct:created>
<svf:fundingBodyType>gov</svf:fundingBodyType>
<svf:country rdf:resource="http://sws.geonames.org/6252001/"/> <svf:state
rdf:resource="http://sws.geonames.org/4138106/"/>
<svf:fundingBodySubType>federal/national government</svf:fundingBodySubType>
</skos:Concept>
 http://data.elsevier.com/vocabulary/SciValFunders/1000005733 (California Space
Grant Consortium) is affiliated with
http://data.elsevier.com/vocabulary/SciValFunders/100000104 (National Aeronautics
and Space Administration)
11
Elsevier Open Access APIs
• To download the vocabulary and then synchronize your local copy with updates to it, you
would use the following LDR APIs:
–Get Entire Vocabulary: Retrieves the latest version of the entire vocabulary as an RDF file, stored
inside a Zip file.
–Get Last Update Date/Version for Vocabulary: Retrieves the timestamp and version number of the
latest version of the vocabulary, allowing you to see if a newer version than the one that you last
downloaded is now available.
• To query the vocabulary for funding body labels and other information:
–Auto-Complete Concept Label Search: Allows you to retrieve the funding bodies whose preferred or
alternate labels match a specified "starts with" string. Supports auto-completion of funding body name
for authoring tools.
–Get Concept from Vocabulary: Allows you to retrieve all of the information that is stored in the
vocabulary about a funding body.
–Get Preferred Label for Concept URI: Allows you to retrieve the preferred label for a funding body.
12
Elsevier Open Access APIs: Get Entire Vocabulary
• The following call retrieves the RDF for the entire SciValFunders vocabulary:
http://data.elsevier.com/vocabulary/bulk/SciValFunders
• This query returns the vocabulary in RDF format in a zip file
13
Elsevier Open Access APIs: Get Last Update
Date/Version for Vocabulary
• The following call retrieves the timestamp for the last update to the SciValFunders
vocabulary:
http://data.elsevier.com/content/vocabulary/lastUpdate/SciValFunders
• This query returns the following result:
{id: "http://data.elsevier.com/vocabulary/SciValFunders",
lastUploadedDate: "2012-05-29T19:19:26+0000",
lastUploadedVersion: "2.0",
numberOfConcepts: 4572,
vocabularyUploadDetails:
[
{transactionId: "d650574b-93cd-410f-99f4-41db7a1a1617",
uploadedDate: "2012-04-19T21:35:03+0000",
version: "1.0"
}]}
14
Elsevier Open Access APIs: Auto-Complete
Concept Label Search
• The following call retrieves the concepts in the SciValFunders vocabulary whose labels
match the conceptName string nas and the maximum number of results to return set
to 50:
http://data.elsevier.com/content/vocabulary/labels/SciValFunders?conceptName=nas&resu
ltsToReturn=50
• Important: case-insensitive, stop words are ignored (the, a, of, etc)
• This query returns the following result:
[
{"conceptId":"SciValFunders/100002241","prefLabel":"Nasdaq
OMX","matchedLabels":["Nasdaq OMX"]},
{"conceptId":"SciValFunders/100000209","prefLabel":"National Academy of
Sciences","matchedLabels":["NAS"]},
{"conceptId":"SciValFunders/100005965","prefLabel":"National Academy of Social
Insurance","matchedLabels":["NASI"]},
{"conceptId":"SciValFunders/100000104","prefLabel":"National Aeronautics and Space
Administration","matchedLabels":["NASA"]},
{"conceptId":"SciValFunders/100003202","prefLabel":"North American Spine
Society","matchedLabels":["NASS"]},
{"conceptId":"SciValFunders/100005764","prefLabel":"Utah Rocky Mountain NASA Space
Grant Consortium","matchedLabels":["Utah Rocky Mountain NASA Space Grant
Consortium"]}
]
15
Elsevier Open Access APIs: Get Concept from
Vocabulary
• The following calls retrieve the RDF fragment for a funding entity in the SciValFunders
vocabulary whose unique ID is 100004440:
http://data.elsevier.com/content/vocabulary/concept/SciValFunders?conceptURI=http://data.else
vier.com/vocabulary/SciValFunders/100004440
http://data.elsevier.com/vocabulary/SciValFunders/100004440
• The following call retrieves the RDF fragment for a funding entity in the SciValFunders
vocabulary that has the label Wellcome Trust (case-insensitive):
http://data.elsevier.com/content/vocabulary/concept/SciValFunders?conceptName=wellcome%2
0trust
• All three example queries return the following result:
concepts: [{id: "http://data.elsevier.com/vocabulary/SciValFunders/100004440",
inScheme: {value: "“,resource: "http://data.elsevier.com/vocabulary/SciValFunders”},
prefLabel: { label: { literalForm: { value: "Wellcome Trust“, lang: "en“ }}},
modified: ["2012-04-27T18:17:23.000000”],
created: ["2009-07-06T18:53:11.000000”],
fundingBodyType: ["pri”],
country: [{resource: http://sws.geonames.org/2635167/}],
state: [{resource: “”}],
fundingBodySubType: ["international”]}]}
16
Elsevier Open Access APIs: Get Preferred Label for
Concept URI
• The following call retrieves the preferred label for a funding entity in the SciValFunders
vocabulary whose unique ID is 100000001:
http://data.elsevier.com/content/vocabulary/concept/prefLabel/SciValFunders?conceptURI=
http://data.elsevier.com/vocabulary/SciValFunders/100000001
• This query returns the following result:
{"concepts":
[{"id":"http://data.elsevier.com/vocabulary/SciValFunders/100000001",
"prefLabel":{"label":{
"literalForm":{"value":“National Science Foundation","lang":"en"}}}
}]}
17
Questions / Next Steps
• If you have more questions on the APIs, please contact us at
[email protected]
• Please send feedback on the taxonomy and/or APIs by June 25, 2012 to Sharon
and Ed.
–Chris Shillum will provide the taxonomy feedback to his team and assess if and when an
updated version can be released
18
Contact Info:
[email protected]
Sophie Forge
Chris Shillum
+1 215 239 3619
+1 212 462 1987
[email protected]
[email protected]
19

similar documents