openaire-graph-docs/docs/data-model/relationships.md

147 lines
4.9 KiB
Markdown
Raw Permalink Normal View History

2022-09-01 13:35:24 +02:00
---
sidebar_position: 2
---
2022-09-09 17:38:08 +02:00
# Relationships
A relationship in the graph is represented by the following data type, which aims to model a directed edge between two nodes, providing information about the semantic of the relation, its provenance and validation.
---
## The `Relationship` object
### source
_Type: [Node](#the-node-object) • Cardinality: ONE_
Represents the source node in the relation.
```json
"source": {
"id": "20|openorgs____::1cb75a3ad756e4c83e455e3e7347643b",
"type": "organization"
}
```
2022-09-09 17:38:08 +02:00
### target
_Type: [Node](#the-node-object) • Cardinality: ONE_
Represents the target node in the relation.
```json
"target": {
"id": "10|doajarticles::022409068174087a003647ff46070f7f",
"type": "datasource"
}
```
2022-09-09 17:38:08 +02:00
### reltype
_Type: [RelType](#the-reltype-object) • Cardinality: ONE_
Represent the semantics of the relation between two nodes of the graph.
```json
"reltype": {
"name": "provides",
"type": "provision"
}
```
2022-09-09 17:38:08 +02:00
### provenance
_Type: [Provenance](entities/other#provenance-1) • Cardinality: ONE_
Indicates the process that produced (or provided) the information.
```json
"provenance": {
"provenance": "Harvested",
"trust":"0.900"
}
```
2022-09-09 17:38:08 +02:00
### validated
_Type: Boolean • Cardinality: ONE_
Indicates weather or not the relation was validated.
```json
"validated": true
```
2022-09-09 17:38:08 +02:00
### validationDate
_Type: String • Cardinality: ONE_
Indicates the validation date of the relation - applies only when the validated flag is set to true.
```json
"validationDate": "2022-09-02"
```
2022-09-09 17:38:08 +02:00
---
## The `Node` object
The Node data type contains the minimum information needed to identify a graph node, its identifier and entity type.
### id
_Type: String • Cardinality: ONE_
OpenAIRE identifier of the node in the graph.
```json
"id": "10|doajarticles::022409068174087a003647ff46070f7f"
```
2022-09-09 17:38:08 +02:00
### type
_Type: String • Cardinality: ONE_
Graph node type.
```json
"type": "datasource"
```
2022-09-09 17:38:08 +02:00
## The `RelType` object
The RelType data type models the semantic of the relationship among two nodes.
### type
_Type: String • Cardinality: ONE_
Relation category, e.g. affiliation, citation, see table Relation typologies.
```json
"name": "provides"
```
2022-09-09 17:38:08 +02:00
### name
_Type: String • Cardinality: ONE_
Further specifies the relation semantic, indicating the relation direction, e.g. Cites, isCitedBy.
```json
"type": "provision"
```
2022-09-09 17:38:08 +02:00
---
## Relationship types
The following table lists all the possible relation semantics found in the graph dump.
| # | Source entity type | Target entity type | Relation type | Relation name | Inverse relation name |
2022-09-09 17:38:08 +02:00
|:--:|:------------------:|:-------------------:|:-------------:|:---------------------------:|:----------------------------:|
| 1 | [Project](entities/project) | [Result](entities/result) | outcome | produces | isProducedBy |
| 2 | [Result](entities/result) | [Organization](entities/organization) | affiliation | hasAuthorInstitution | isAuthorInstitutionOf |
| 3 | [Result](entities/result) | [Result](entities/result) | similarity | isAmongTopNSimilarDocuments | HasAmongTopNSimilarDocuments |
| 4 | [Project](entities/project) | [Organization](entities/organization) | participation | isParticipant | hasParticipant |
| 5 | [Result](entities/result) | [Result](entities/result) | supplement | isSupplementTo | isSupplementedBy |
| 6 | [Result](entities/result) | [Result](entities/result) | relationship | isRelatedTo | isRelatedTo |
| 7 | [Data source](entities/data-source) | [Organization](entities/organization) | provision | provides | isProvidedBy |
| 8 | [Result](entities/result) | [Data source](entities/data-source) | provision | isHostedBy | hosts |
| 9 | [Result](entities/result) | [Data source](entities/data-source) | provision | isProvidedBy | provides |
| 10 | [Result](entities/result) | [Community](entities/community) | relationship | isRelatedTo | isRelatedTo |
| 11 | [Organization](entities/organization) | [Community](entities/community) | relationship | isRelatedTo | isRelatedTo |
| 12 | [Data source](entities/data-source) | [Community](entities/community) | relationship | isRelatedTo | isRelatedTo |
| 13 | [Project](entities/project) | [Community](entities/community) | relationship | isRelatedTo | isRelatedTo |
2022-09-09 17:38:08 +02:00