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

4.9 KiB

sidebar_position
2

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 • Cardinality: ONE

Represents the source node in the relation.

"source": {
    "id": "20|openorgs____::1cb75a3ad756e4c83e455e3e7347643b",
    "type": "organization"
}

target

Type: Node • Cardinality: ONE

Represents the target node in the relation.

"target": {
    "id": "10|doajarticles::022409068174087a003647ff46070f7f",
    "type": "datasource"
}

reltype

Type: RelType • Cardinality: ONE

Represent the semantics of the relation between two nodes of the graph.

"reltype": {
    "name": "provides",
    "type": "provision"
}

provenance

Type: Provenance • Cardinality: ONE

Indicates the process that produced (or provided) the information.

"provenance": {
    "provenance": "Harvested",
    "trust":"0.900"
}

validated

Type: Boolean • Cardinality: ONE

Indicates weather or not the relation was validated.

"validated": true

validationDate

Type: String • Cardinality: ONE

Indicates the validation date of the relation - applies only when the validated flag is set to true.

"validationDate": "2022-09-02"

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.

"id": "10|doajarticles::022409068174087a003647ff46070f7f"

type

Type: String • Cardinality: ONE

Graph node type.

"type": "datasource"

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.

"name": "provides"

name

Type: String • Cardinality: ONE

Further specifies the relation semantic, indicating the relation direction, e.g. Cites, isCitedBy.

"type": "provision"

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
1 Project Result outcome produces isProducedBy
2 Result Organization affiliation hasAuthorInstitution isAuthorInstitutionOf
3 Result Result similarity isAmongTopNSimilarDocuments HasAmongTopNSimilarDocuments
4 Project Organization participation isParticipant hasParticipant
5 Result Result supplement isSupplementTo isSupplementedBy
6 Result Result relationship isRelatedTo isRelatedTo
7 Data source Organization provision provides isProvidedBy
8 Result Data source provision isHostedBy hosts
9 Result Data source provision isProvidedBy provides
10 Result Community relationship isRelatedTo isRelatedTo
11 Organization Community relationship isRelatedTo isRelatedTo
12 Data source Community relationship isRelatedTo isRelatedTo
13 Project Community relationship isRelatedTo isRelatedTo