openaire-graph-docs/docs/data-model/entities/other.md

680 lines
14 KiB
Markdown
Raw Normal View History

---
sidebar_position: 7
---
2022-09-22 20:21:18 +02:00
# Other component objects
2022-09-22 20:21:18 +02:00
Here, we describe other component objects that are used as part of the main graph entities.
## AccessRight
Subclass of [BestAccessRight](#bestaccessright), indicates information about rights held in and over the resource and the open Access Route.
### openAccessRoute
2022-09-22 20:21:18 +02:00
_Type: One of `{ gold, green, hybrid, bronze }` • Cardinality: ONE_
Indicates the OpenAccess status. Values are set according to the [Unpaywall methodology](https://support.unpaywall.org/support/solutions/articles/44001777288-what-do-the-types-of-oa-status-green-gold-hybrid-and-bronze-mean-).
2022-09-22 20:21:18 +02:00
```json
"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.
2022-09-22 20:21:18 +02:00
```json
"scheme": "doi"
```
### value
_Type: String • Cardinality: ONE_
Value from the given scheme/vocabulary.
2022-09-22 20:21:18 +02:00
```json
"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).
2022-09-22 20:21:18 +02:00
```json
"currency": "EU"
```
### amount
_Type: String • Cardinality: ONE_
The quantity of money.
2022-09-22 20:21:18 +02:00
```json
"amount": "1000"
```
## Author
Represents the result author.
### fullname
_Type: String • Cardinality: ONE_
Author's full name.
2022-09-22 20:21:18 +02:00
```json
"fullname": "Turunen, Heidi"
```
### name
_Type: String • Cardinality: ONE_
Author's given name.
2022-09-22 20:21:18 +02:00
```json
"name": "Heidi"
```
### surname
_Type: String • Cardinality: ONE_
Author's family name.
2022-09-22 20:21:18 +02:00
```json
"surname": "Turunen"
```
### rank
_Type: String • Cardinality: ONE_
Author's order in the list of authors for the given result.
2022-09-22 20:21:18 +02:00
```json
"rank": 1
```
### pid
_Type: [AuthorPid](#authorpid) • Cardinality: ONE_
Persistent identifier associated with this author.
2022-09-22 20:21:18 +02:00
```json
"pid": {
"id": {
"scheme": "orcid",
"value": "0000-0001-7169-1177"
},
2022-09-22 20:21:18 +02:00
"provenance" {
"provenance": "Harvested",
"trust": "0.9"
}
}
```
2022-09-22 20:21:18 +02:00
## AuthorPid
The author's persistent identifier.
### id
_Type: [AuthorPidSchemaValue](#authorpidschemavalue) • Cardinality: ONE_
2022-09-22 20:21:18 +02:00
```json
"id": {
"scheme": "orcid",
"value": "0000-0001-7169-1177"
}
```
### provenance
_Type: [Provenance](#provenance-2) • Cardinality: ONE_
2022-09-22 20:21:18 +02:00
The reason why the pid was associated to the author.
2022-09-22 20:21:18 +02:00
```json
"provenance": {
"provenance": "Inferred by OpenAIRE",
"trust": "0.85"
}
```
2022-09-22 20:21:18 +02:00
## 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.
2022-09-22 20:21:18 +02:00
```json
"scheme": "orcid"
```
### value
_Type: String • Cardinality: ONE_
2022-09-22 20:21:18 +02:00
The author's pid value in that scheme.
```json
"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_
2022-09-22 20:21:18 +02:00
COAR access mode code: http://vocabularies.coar-repositories.org/documentation/access_rights/.
```json
"code": "c_16ec"
```
### label
_Type: String • Cardinality: ONE_
2022-09-22 20:21:18 +02:00
Label for the access mode.
```json
"label": "RESTRICTED"
```
### scheme
_Type: String • Cardinality: ONE_
2022-09-22 20:21:18 +02:00
Scheme of reference for access right code. Currently, always set to COAR access rights vocabulary: http://vocabularies.coar-repositories.org/documentation/access_rights/.
```json
"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_
2022-09-22 20:21:18 +02:00
Name of the journal or conference.
2022-09-22 20:21:18 +02:00
```json
"name": "Research Policy"
```
### issnPrinted
_Type: String • Cardinality: ONE_
The journal printed issn.
2022-09-22 20:21:18 +02:00
```json
"issnPrinted": "0048-7333"
```
### issnOnline
_Type: String • Cardinality: ONE_
The journal online issn.
2022-09-22 20:21:18 +02:00
```json
"issnOnline": "1873-7625"
```
### issnLinking
_Type: String • Cardinality: ONE_
The journal linking issn.
### iss
_Type: String • Cardinality: ONE_
The journal issue.
2022-09-22 20:21:18 +02:00
```json
"iss": "5"
```
### sp
_Type: String • Cardinality: ONE_
The start page.
2022-09-22 20:21:18 +02:00
```json
"sp": "12"
```
### ep
_Type: String • Cardinality: ONE_
The end page.
2022-09-22 20:21:18 +02:00
```json
"ep": "22"
```
### vol
_Type: String • Cardinality: ONE_
The journal volume.
2022-09-22 20:21:18 +02:00
```json
"vol": "50"
```
### edition
_Type: String • Cardinality: ONE_
The edition of the journal or conference.
### conferenceplace
_Type: String • Cardinality: ONE_
The place of the conference.
2022-09-22 20:21:18 +02:00
```json
"conferenceplace": "Padua, Italy"
```
### conferencedate
_Type: String • Cardinality: ONE_
The date of the conference.
2022-09-22 20:21:18 +02:00
```json
"conferencedate": "2022-09-22"
```
## ControlledField
2022-09-22 20:21:18 +02:00
<!-- <span className="todo">TODO: similar to AlternateIdentifier and ResultPid?</span> -->
Generic type used to represent the information described by a scheme and a value in that scheme (i.e. pid).
### scheme
_Type: String &bull; Cardinality: ONE_
Vocabulary reference.
2022-09-22 20:21:18 +02:00
```json
"scheme": "DOI"
```
### value
_Type: String &bull; Cardinality: ONE_
Value from the given scheme/vocabulary.
2022-09-22 20:21:18 +02:00
```json
"value": "10.5281/zenodo.4707307"
```
## Country
To represent the generic country code and label.
### code
_Type: String &bull; Cardinality: ONE_
2022-09-22 20:21:18 +02:00
ISO 3166-1 alpha-2 country code.
```json
"code" : "IT"
```
### label
_Type: String &bull; Cardinality: ONE_
2022-09-22 20:21:18 +02:00
The country label.
2022-09-22 20:21:18 +02:00
```json
"label": "Italy"
```
2022-09-09 17:38:08 +02:00
## GeoLocation
Represents the geolocation information.
2022-09-09 17:38:08 +02:00
### point
_Type: String &bull; Cardinality: ONE_
2022-09-22 20:21:18 +02:00
A point with Latitude and Longitude.
```json
"point": "7.72486 50.1084"
```
2022-09-09 17:38:08 +02:00
### box
_Type: String &bull; Cardinality: ONE_
2022-09-22 20:21:18 +02:00
A specified bounding box defined by two longitudes (min and max) and two latitudes (min and max).
```json
"box": "18.569386 54.468973 18.066832 54.83707"
```
2022-09-09 17:38:08 +02:00
### place
_Type: String &bull; Cardinality: ONE_
2022-09-22 20:21:18 +02:00
The name of a specific place.
```json
"place": "Tübingen, Baden-Württemberg, Southern Germany"
```
## 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
2022-09-22 20:21:18 +02:00
Each instance is characterized by the properties that follow.
### accessright
_Type: [AccessRight](#accessright) &bull; Cardinality: ONE_
Maps [dc:rights](https://www.dublincore.org/specifications/dublin-core/dcmi-terms/elements11/rights/), describes the access rights of the web resources relative to this instance.
2022-09-22 20:21:18 +02:00
```json
"accessright": {
"code": "c_abf2",
"label": "OPEN",
"openAccessRoute": "gold",
"scheme": "http://vocabularies.coar-repositories.org/documentation/access_rights/"
}
```
### alternateIdentifier
_Type: [AlternateIdentifier](#alternateidentifier) &bull; Cardinality: MANY_
All the identifiers associated to the result other than the authoritative ones.
2022-09-22 20:21:18 +02:00
```json
"alternateIdentifier": [
{
"scheme": "doi",
"value": "10.1016/j.respol.2021.104226"
},
...
]
```
### articleprocessingcharge
_Type: [APC](#apc) &bull; Cardinality: ONE_
The money spent to make this book or article available in Open Access. Source for this information is the OpenAPC initiative.
2022-09-22 20:21:18 +02:00
```json
"articleprocessingcharge": {
"currency": "EUR",
"amount": "1000"
}
```
### license
_Type: String &bull; Cardinality: ONE_
The license URL.
2022-09-22 20:21:18 +02:00
```json
"license": "http://creativecommons.org/licenses/by-nc/4.0"
```
### measures
_Type: [Measure](#measure) &bull; Cardinality: MANY_
The measures computed for this instance (e.g. those provided by [BIP! Finder](https://bip.imsi.athenarc.gr/)).
```json
"measures": [
{
"key": "influence",
"value": "6.45335454246e-09"
},
...
]
```
### pid
_Type: [ResultPid](#resultpid) &bull; Cardinality: MANY_
2022-09-22 20:21:18 +02:00
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](entity-identifiers) for more information.
```json
"pid": [
{
"scheme": "pmc",
"value": "PMC8024784"
},
...
]
```
### publicationdate
_Type: String &bull; Cardinality: ONE_
The publication date of the research product.
2022-09-22 20:21:18 +02:00
```json
"publicationdate": "2009-02-12"
```
### refereed
_Type: String &bull; 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](https://wiki.surfnet.nl/download/attachments/10851536/DRIVER_Guidelines_v2_Final_2008-11-13.pdf) (OpenAIRE v1.0 till v3.0 - Literature)
* [COAR Vocabulary v2.0 and v3.0](https://vocabularies.coar-repositories.org/resource_types/) (OpenAIRE v4 - Inst.+Them.)
2022-09-22 20:21:18 +02:00
```json
"refereed": "UNKNOWN"
```
### type
_Type: String &bull; Cardinality: ONE_
The specific sub-type of this instance (see https://api.openaire.eu/vocabularies/dnet:result_typologies following the links)
2022-09-22 20:21:18 +02:00
```json
"type": "Article"
```
### url
_Type: String &bull; Cardinality: MANY_
URLs to the instance. They may link to the actual full-text or to the landing page at the hosting source.
2022-09-22 20:21:18 +02:00
```json
"url": [
"https://periodicos2.uesb.br/index.php/folio/article/view/4296",
...
]
```
## Language
Represents information for the language of the result
### code
_Type: String &bull; Cardinality: ONE_
2022-09-22 20:21:18 +02:00
Alpha-3/ISO 639-2 code of the language. Values controlled by the [dnet:languages vocabulary](https://api.openaire.eu/vocabularies/dnet:languages).
```json
"code": "eng"
```
### label
_Type: String &bull; Cardinality: ONE_
2022-09-22 20:21:18 +02:00
Language label in English.
2022-09-22 20:21:18 +02:00
```json
"label": "English"
```
2022-09-09 17:38:08 +02:00
2022-09-22 20:21:18 +02:00
## Measure
A measure computed for this instance (e.g. those provided by [BIP! Finder](https://bip.imsi.athenarc.gr/))
2022-09-09 17:38:08 +02:00
2022-09-22 20:21:18 +02:00
### key
_Type: String &bull; Cardinality: ONE_
2022-09-09 17:38:08 +02:00
2022-09-22 20:21:18 +02:00
The specified measure. Currently supported one of: `{ influence, influence_alt, popularity, popularity_alt, impulse, cc }` (see [the dedicated page](../../data-provision/enrichment/impact-scores) for more details).
```json
"key": "influence"
2022-09-09 17:38:08 +02:00
```
2022-09-22 20:21:18 +02:00
### value
_Type: String &bull; Cardinality: ONE_
```json
"value": "6.45335454246e-09"
```
The value for that measure.
## OrganizationPid
The schema and value for identifiers of the organization.
2022-09-09 17:38:08 +02:00
### scheme
_Type: String &bull; Cardinality: ONE_
Vocabulary reference (i.e. isni).
2022-09-22 20:21:18 +02:00
```json
"scheme" : "GRID"
```
2022-09-09 17:38:08 +02:00
### value
_Type: String &bull; Cardinality: ONE_
Value from the given scheme/vocabulary (i.e. 0000000090326370).
2022-09-22 20:21:18 +02:00
```json
"value" : "grid.7119.e"
```
2022-09-22 20:21:18 +02:00
## Provenance
Indicates the process that produced (or provided) the information, and the trust associated to the information.
### provenance
_Type: String &bull; Cardinality: ONE_
2022-09-09 17:38:08 +02:00
Provenance term from the vocabulary [dnet:provenanceActions](https://api.openaire.eu/vocabularies/dnet:provenanceActions).
2022-09-22 20:21:18 +02:00
```json
"provenance": "Harvested"
```
### trust
_Type: String &bull; Cardinality: ONE_
Trust, expressed as a number in the range [0-1].
2022-09-22 20:21:18 +02:00
```json
"trust": "0.9"
```
2022-09-09 17:38:08 +02:00
## ResultCountry
It is for the country associated to the result.
It is a subclass of [Country](#country) and extends it with provenance information.
### provenance
_Type: [Provenance](#provenance-2) &bull; Cardinality: ONE_
Indicates the reason why this country is associated to this result.
2022-09-22 20:21:18 +02:00
```json
"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.
2022-09-22 20:21:18 +02:00
<!-- <span className="todo">Seems to be similar to the AlternateIdentifier. What is the difference?</span> -->
### scheme
_Type: String &bull; Cardinality: ONE_
2022-09-22 20:21:18 +02:00
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.
```json
"scheme": "doi"
```
### value
_Type: String &bull; Cardinality: ONE_
2022-09-22 20:21:18 +02:00
The value expressed in the scheme (i.e. 10.1000/182).
```json
"value": "10.21511/bbs.13(3).2018.13"
```
## Subject
Represents keywords associated to the result.
### subject
_Type: [SubjectSchemeValue](#subjectschemevalue) &bull; Cardinality: ONE_
Contains the subject term: subject type (keyword, MeSH, etc) and the subject term (medicine, chemistry, etc.).
2022-09-22 20:21:18 +02:00
```json
"subject": {
"scheme":"keyword",
"value":"SVOC"
}
```
### provenance
_Type: [Provenance](#provenance-2) &bull; Cardinality: ONE_
Contains provenance information for the subject term.
2022-09-22 20:21:18 +02:00
```json
"provenance": {
"provenance":"Harvested",
"trust":"0.9"
}
```
## SubjectSchemeValue
Subject classification against a vocabulary
### scheme
_Type: String &bull; Cardinality: ONE_
OpenAIRE subject classification scheme (https://api.openaire.eu/vocabularies/dnet:subject_classification_typologies).
2022-09-22 20:21:18 +02:00
```json
"scheme" : "keyword"
```
### value
_Type: String &bull; 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).
2022-09-22 20:21:18 +02:00
```json
"value" : "pyrolysis-oil"
```