Other component objects
Here, we describe other component objects that are used as part of the main graph entities.
AccessRight
Subclass of BestAccessRight, indicates information about rights held in and over the resource and the open Access Route.
openAccessRoute
Type: One of { gold, green, hybrid, bronze }
• Cardinality: ONE
Indicates the OpenAccess status. Values are set according to the Unpaywall methodology.
"openAccessRoute": "gold"
AlternateIdentifier
Type used to represent the information associated to persistent identifiers associated to the result that have not been forged by an authority for that pid type. For example we collect metadata from an institutional repository that provides as identifier for the result also the doi.
scheme
Type: String • Cardinality: ONE
Vocabulary reference.
"scheme": "doi"
value
Type: String • Cardinality: ONE
Value from the given scheme/vocabulary.
"value": "10.1016/j.respol.2021.104226"
APC
Indicates the money spent to make a book or article available in Open Access. Sources for this information includes the OpenAPC initiative.
currency
Type: String • Cardinality: ONE
The system of money in which the amount is expressed (Euro, USD, etc).
"currency": "EU"
amount
Type: String • Cardinality: ONE
The quantity of money.
"amount": "1000"
Author
Represents the result author.
fullname
Type: String • Cardinality: ONE
Author's full name.
"fullname": "Turunen, Heidi"
name
Type: String • Cardinality: ONE
Author's given name.
"name": "Heidi"
surname
Type: String • Cardinality: ONE
Author's family name.
"surname": "Turunen"
rank
Type: String • Cardinality: ONE
Author's order in the list of authors for the given result.
"rank": 1
pid
Type: AuthorPid • Cardinality: ONE
Persistent identifier associated with this author.
"pid": {
"id": {
"scheme": "orcid",
"value": "0000-0001-7169-1177"
},
"provenance": {
"provenance": "Harvested",
"trust": "0.9"
}
}
AuthorPid
The author's persistent identifier.
id
Type: AuthorPidSchemaValue • Cardinality: ONE
"id": {
"scheme": "orcid",
"value": "0000-0001-7169-1177"
}
provenance
Type: Provenance • Cardinality: ONE
The reason why the pid was associated to the author.
"provenance": {
"provenance": "Inferred by OpenAIRE",
"trust": "0.85"
}
AuthorPidSchemaValue
Type used to represent the scheme and value for the author's pid.
schema
Type: String • Cardinality: ONE
The author's pid scheme. OpenAIRE currently supports ORCID.
"scheme": "orcid"
value
Type: String • Cardinality: ONE
The author's pid value in that scheme.
"value": "0000-1111-2222-3333"
BestAccessRight
Indicates the most open access rights *available among the result Instances.
* where the openness is defined by the ordering of the access right terms in the following.
OPEN SOURCE > OPEN > EMBARGO (6MONTHS) > EMBARGO (12MONTHS) > RESTRICTED > CLOSED > UNKNOWN
code
Type: String • Cardinality: ONE
COAR access mode code: http://vocabularies.coar-repositories.org/documentation/access_rights/.
"code": "c_16ec"
label
Type: String • Cardinality: ONE
Label for the access mode.
"label": "RESTRICTED"
scheme
Type: String • Cardinality: ONE
Scheme of reference for access right code. Currently, always set to COAR access rights vocabulary: http://vocabularies.coar-repositories.org/documentation/access_rights/.
"scheme": "http://vocabularies.coar-repositories.org/documentation/access_rights/"
Container
This field has information about the conference or journal where the result has been presented or published.
name
Type: String • Cardinality: ONE
Name of the journal or conference.
"name": "Research Policy"
issnPrinted
Type: String • Cardinality: ONE
The journal printed issn.
"issnPrinted": "0048-7333"
issnOnline
Type: String • Cardinality: ONE
The journal online issn.
"issnOnline": "1873-7625"
issnLinking
Type: String • Cardinality: ONE
The journal linking issn.
iss
Type: String • Cardinality: ONE
The journal issue.
"iss": "5"
sp
Type: String • Cardinality: ONE
The start page.
"sp": "12"
ep
Type: String • Cardinality: ONE
The end page.
"ep": "22"
vol
Type: String • Cardinality: ONE
The journal volume.
"vol": "50"
edition
Type: String • Cardinality: ONE
The edition of the journal or conference.
conferenceplace
Type: String • Cardinality: ONE
The place of the conference.
"conferenceplace": "Padua, Italy"
conferencedate
Type: String • Cardinality: ONE
The date of the conference.
"conferencedate": "2022-09-22"
ControlledField
Generic type used to represent the information described by a scheme and a value in that scheme (i.e. pid).
scheme
Type: String • Cardinality: ONE
Vocabulary reference.
"scheme": "DOI"
value
Type: String • Cardinality: ONE
Value from the given scheme/vocabulary.
"value": "10.5281/zenodo.4707307"
Country
To represent the generic country code and label.
code
Type: String • Cardinality: ONE
ISO 3166-1 alpha-2 country code.
"code" : "IT"
label
Type: String • Cardinality: ONE
The country label.
"label": "Italy"
Funding
Funding information for a project.
funding_stream
Type: FundingStream • Cardinality: ONE
Funding information for the project.
"funding_stream": {
"description": "Horizon 2020 Framework Programme - Research and Innovation action",
"id": "EC::H2020::RIA"
}
jurisdiction
Type: String • Cardinality: ONE
Geographical jurisdiction (e.g. for European Commission is EU, for Croatian Science Foundation is HR).
"jurisdiction": "EU"
name
Type: String • Cardinality: ONE
The name of the funder.
"name": "European Commission"
shortName
Type: String • Cardinality: ONE
The short name of the funder.
"shortName": "EC"
FundingStream
Description of a funding stream.
id
Type: String • Cardinality: ONE
The identifier of the funding stream.
"id": "EC::H2020::RIA"
description
Type: String • Cardinality: ONE
Short description of the funding stream.
"description": "Horizon 2020 Framework Programme - Research and Innovation action"
GeoLocation
Represents the geolocation information.
point
Type: String • Cardinality: ONE
A point with Latitude and Longitude.
"point": "7.72486 50.1084"
box
Type: String • Cardinality: ONE
A specified bounding box defined by two longitudes (min and max) and two latitudes (min and max).
"box": "18.569386 54.468973 18.066832 54.83707"
place
Type: String • Cardinality: ONE
The name of a specific place.
"place": "Tübingen, Baden-Württemberg, Southern Germany"
Grant
The money granted to a project.
currency
Type: String • Cardinality: ONE
The currency of the granted amount (e.g. EUR).
"currency": "EUR"
fundedamount
Type: Number • Cardinality: ONE
The funded amount.
"fundedamount": 1.0E7
totalcost
Type: Number • Cardinality: ONE
The total cost of the project.
"totalcost": 1.0E7
H2020Programme
The H2020 programme funding a project.
code
Type: String • Cardinality: ONE
The code of the programme.
"code": "H2020-EU.1.4.1.3."
description
Type: String • Cardinality: ONE
The description of the programme.
"description": "Development, deployment and operation of ICT-based e-infrastructures"
Instance
An instance is one specific materialization or version of the result. For example, you can have one result with three instances as result of deduplication:
- one is the pre-print
- one is the post-print
- one is the published version
Each instance is characterized by the properties that follow.
accessright
Type: AccessRight • Cardinality: ONE
Maps dc:rights, describes the access rights of the web resources relative to this instance.
"accessright": {
"code": "c_abf2",
"label": "OPEN",
"openAccessRoute": "gold",
"scheme": "http://vocabularies.coar-repositories.org/documentation/access_rights/"
}
alternateIdentifier
Type: AlternateIdentifier • Cardinality: MANY
All the identifiers associated to the result other than the authoritative ones.
"alternateIdentifier": [
{
"scheme": "doi",
"value": "10.1016/j.respol.2021.104226"
},
...
]
articleprocessingcharge
Type: APC • Cardinality: ONE
The money spent to make this book or article available in Open Access. Source for this information is the OpenAPC initiative.
"articleprocessingcharge": {
"currency": "EUR",
"amount": "1000"
}
license
Type: String • Cardinality: ONE
The license URL.
"license": "http://creativecommons.org/licenses/by-nc/4.0"
pid
Type: ResultPid • Cardinality: MANY
The set of persistent identifiers associated to this instance that have been collected from an authority for the pid type (i.e. Crossref/Datacite for doi). See the OpenAIRE entity identifier and PID mapping policy for more information.
"pid": [
{
"scheme": "pmc",
"value": "PMC8024784"
},
...
]
publicationdate
Type: String • Cardinality: ONE
The publication date of the research product.
"publicationdate": "2009-02-12"
refereed
Type: String • Cardinality: ONE
Describes if this instance has been peer-reviewed or not. Allowed values are peerReviewed, nonPeerReviewed, UNKNOWN (as defined in https://api.openaire.eu/vocabularies/dnet:review_levels). For example:
- peerReviewed: https://api.openaire.eu/vocabularies/dnet:review_levels/0001
- nonPeerReviewed: https://api.openaire.eu/vocabularies/dnet:review_levels/0002
based on guidelines covers the vocabularies
- DRIVE guidelines 2.0 - info:eu-repo/semantic (OpenAIRE v1.0 till v3.0 - Literature)
- COAR Vocabulary v2.0 and v3.0 (OpenAIRE v4 - Inst.+Them.)
"refereed": "UNKNOWN"
type
Type: String • Cardinality: ONE
The specific sub-type of this instance (see https://api.openaire.eu/vocabularies/dnet:result_typologies following the links)
"type": "Article"
url
Type: String • Cardinality: MANY
URLs to the instance. They may link to the actual full-text or to the landing page at the hosting source.
"url": [
"https://periodicos2.uesb.br/index.php/folio/article/view/4296",
...
]
Indicator
These are indicators computed for a specific OpenAIRE result.
Each Indicator object is composed of the following properties:
impactMeasures
Type: ImpactMeasures • Cardinality: ONE
These impact-based indicators, provided by BIP!, estimate the impact of a result.
For details about their calculation, please refer here.
"impactMeasures": {
"influence": {
"score": "123",
"class": "C2"
},
"influence_alt" : {
"score": "456",
"class": "C3"
},
"popularity": {
"score": "234",
"class": "C1"
},
"popularity_alt": {
"score": "345",
"class": "C5"
},
"impulse": {
"score": "987",
"class": "C3"
}
}
usageCounts
Type: UsageCounts • Cardinality: ONE
These measures, computed by the UsageCounts Service, are based on usage statistics.
"usageCounts":{
"downloads": "10",
"views": "20"
}
Language
Represents information for the language of the result
code
Type: String • Cardinality: ONE
Alpha-3/ISO 639-2 code of the language. Values controlled by the dnet:languages vocabulary.
"code": "eng"
label
Type: String • Cardinality: ONE
Language label in English.
"label": "English"
ImpactMeasures
The different impact-based indicators as computed by BIP!.
influence
Type: Score • Cardinality: ONE
This indicator reflects the overall/total impact of an article in the research community at large, based on the underlying citation network (diachronically). For more details please refer here.
"influence": {
"score": "123",
"class": "C2"
}
influence_alt
Type: Score • Cardinality: ONE
This is an alternative to the "Influence" indicator, which also reflects the overall/total impact of an article in the research community at large, based on the underlying citation network (diachronically). For more details please refer here.
"influence_alt" :{
"score": "456",
"class": "C3"
}
popularity
Type: Score • Cardinality: ONE
This indicator reflects the "current" impact/attention (the "hype") of an article in the research community at large, based on the underlying citation network. For more details please refer here.
"popularity":{
"score": "234",
"class": "C1"
}
popularity_alt
Type: Score • Cardinality: ONE
This is an alternative to the "Popularity" indicator, which also reflects the "current" impact/attention (the "hype") of an article in the research community at large, based on the underlying citation network. For more details please refer here.
"popularity_alt":{
"score": "345",
"class": "C5"
}
impulse
Type: Score • Cardinality: ONE
This indicator reflects the initial momentum of an article directly after its publication, based on the underlying citation network. For more details please refer here.
"impulse":{
"score": "987",
"class": "C3"
}
OrganizationPid
The schema and value for identifiers of the organization.
scheme
Type: String • Cardinality: ONE
Vocabulary reference (i.e. isni).
"scheme" : "GRID"
value
Type: String • Cardinality: ONE
Value from the given scheme/vocabulary (i.e. 0000000090326370).
"value" : "grid.7119.e"
Provenance
Indicates the process that produced (or provided) the information, and the trust associated to the information.
provenance
Type: String • Cardinality: ONE
Provenance term from the vocabulary dnet:provenanceActions.
"provenance": "Harvested"
trust
Type: String • Cardinality: ONE
Trust, expressed as a number in the range [0-1].
"trust": "0.9"
ResultCountry
It is for the country associated to the result. It is a subclass of Country and extends it with provenance information.
provenance
Type: Provenance • Cardinality: ONE
Indicates the reason why this country is associated to this result.
"provenance": {
"provenance": "inferred by OpenAIRE",
"trust": "0.85"
}
ResultPid
Type used to represent the information associated to persistent identifiers for the result that have been forged by an authority for that pid type.
scheme
Type: String • Cardinality: ONE
The scheme of the persistent identifier for the result (i.e. doi). If the pid is here it means the information for the pid has been collected from an authority for that pid type (i.e. Crossref/Datacite for doi). The set of authoritative pid is: doi
when collected from Crossref or Datacite, pmid
when collected from EuroPubmed, arxiv
when collected from arXiv, handle
from the repositories.
"scheme": "doi"
value
Type: String • Cardinality: ONE
The value expressed in the scheme (i.e. 10.1000/182).
"value": "10.21511/bbs.13(3).2018.13"
Score
The specific score object for each calculated impact measure calculated by BIP!.
score
Type: String • Cardinality: ONE
The actual indicator score.
"score": "1234"
class
Type: String • Cardinality: ONE
The impact class assigned based on the indicator score.
To facilitate comprehension, BIP! also offers impact classes for articles, to group together those that have similar impact. The following 5 classes are provided:
C1
: Top 0.01%C2
: Top 0.1%C3
: Top 1%C4
: Top 10%C5
: Bottom 90%
"class": "C2"
Subject
Represents keywords associated to the result.
subject
Type: SubjectSchemeValue • Cardinality: ONE
Contains the subject term: subject type (keyword, MeSH, etc) and the subject term (medicine, chemistry, etc.).
"subject": {
"scheme": "keyword",
"value": "SVOC"
}
provenance
Type: Provenance • Cardinality: ONE
Contains provenance information for the subject term.
"provenance": {
"provenance": "Harvested",
"trust": "0.9"
}
SubjectSchemeValue
Subject classification against a vocabulary
scheme
Type: String • Cardinality: ONE
OpenAIRE subject classification scheme (https://api.openaire.eu/vocabularies/dnet:subject_classification_typologies).
"scheme" : "keyword"
value
Type: String • Cardinality: ONE
The value for the subject in the selected scheme. When the scheme is 'keyword', it means that the subject is free-text (i.e. not a term from a controlled vocabulary).
"value" : "pyrolysis-oil"
UsageCounts
The usage counts indicator computed for this result.
views
Type: String • Cardinality: ONE
The number of views for this result.
"views": "10"
downloads
Type: String • Cardinality: ONE
The number of downloads for this result.
"downloads": "5"