adding a schema for platforms / infrastructures

[lzehl]

... to provide informative metadata on the platforms and to group research products that belong to one platform

@olinux @annapaola there is overlap here of what you are planning at the moment.

Currently this connection can be done indirectly through

• FileRepository:hostedBy->Organization
• or through free text in the RPV description or version innovation fields

Platforms or infrastructures are not necessarily though organizations.
E.g. EBRAINS RI is not equal to it's legal entity the EBRAINS AISBL.

@archgogo @MBAbrams this is also connected to the INCF portfolio

[lzehl]

What to consider? Here a first assessment:

DigitalPlatform

• name (1)
• alternateName (0-1)
• acronym (1)
• digitalIdentifier (0-N)
• description (1)
• type (1)
• governance ?
  • legalEntity (1) Organization only ?
  • member (0-N) Organization only ?
  • userRegistration (0-1)
  • memberRegistration (0-1)
  • policy (1-N)
• homepage (0-1)
• jurisdiction (1) ? or is this given through the legal entity?
• supportChannel
• serviceOffer (1-N) (controlled: data deposit, data management, searchable resource, etc)
• target (1-N) (linked category ?: species, experimental approaches, techniques, etc)
• relatedTo (0-1) (other Platform)

RP(V)s can then link to it:

• isPartOf

Note There is of course more but most of it is defined by the connected services (as also the serviceOffer). If no short cut is added here we would need to create all respective service instances for a platform. The strategy should be discussed first before further planning. Things to consider here:

• data type restrictions

  • for data deposit
  • for searchable resource
  • for data retrieval

• data format restrictions

  • for data deposit
  • for searchable resource
  • for data retrieval

• standard restrictions

  • for data deposit
  • for searchable resource
  • for data retrieval
  • for any computational service

• featured standards (if you use standards, you get additional features)

  • for data deposit
  • for searchable resource
  • for data retrieval
  • for any computational service

etc. (basically all of them are defined by the services)

[lzehl]

questions coming up in discussion with @Raphael-Gazzotti: if a legal entity is replaced by another legal entity, to whom do the old products belong to? would all of them need to replace the old legal entity with the new one? what if there is a transition phase where old and new legal entity coexist?

[MBAbrams]

questions coming up in discussion with @Raphael-Gazzotti: if a legal entity is replaced by another legal entity, to whom do the old products belong to? would all of them need to replace the old legal entity with the new one? what if there is a transition phase where old and new legal entity coexist?

This is a difficult one. It depends on the agreement between the entities on how the products should be referenced. Is there a specific use case you have in mind or do you want a general framework?

[lzehl]

@MBAbrams If we can I want to create a general framework that could be modular expanded into something more specific.

Doing more research I think we should not call it DigitalPlatform but DigitalSystem or actually DigitalInfrastructure. I think "platform" has too much overlap with "service" and we cover those differently.

[lzehl]

I'm still struggling getting order into a meaningful model here.

INFRASTRUCTURE

• has resources:
  • human
  • storage
  • compute
  • network
  • data (incl software, research data, computational models, etc)
  • hardware
  • energy
  • other infrastructures
• provides services:
  • human-centered services
  • technology-centered services

TECHNOLOGY-CENTERED SERVICE

• has component:
  • at least one software in a certain installation
  • maybe other services (technology or human centered)
  • maybe other resources than software

HUMAN-CENTERED SERVICE

• has component:
  • human resource
  • maybe other services (technology or human centered)
  • maybe other resources than human

SOFTWARE

• maybe has component:
  • other software

If that would be the overall model connecting the essential components (leaving out now the components of other resources), we still need to figure out which property (e.g. storage types, data types, etc) is captured where in this model (with clear inheritance rules for information consolidation)

[MBAbrams]

I'm still struggling getting order into a meaningful model here.

INFRASTRUCTURE

• has resources:

  • human
  • storage
  • compute
  • network
  • data (incl software, research data, computational models, etc)
  • hardware
  • energy
  • other infrastructures

• provides services:

  • human-centered services
  • technology-centered services

TECHNOLOGY-CENTERED SERVICE

• has component:

  • at least one software in a certain installation
  • maybe other services (technology or human centered)
  • maybe other resources than software

HUMAN-CENTERED SERVICE

• has component:

  • human resource
  • maybe other services (technology or human centered)
  • maybe other resources than human

SOFTWARE

• maybe has component:

  • other software

If that would be the overall model connecting the essential components (leaving out now the components of other resources), we still need to figure out which property (e.g. storage types, data types, etc) is captured where in this model (with clear inheritance rules for information consolidation)

Archana and I will discuss this during our next meeting and get back to you.

[lzehl]

Here a rough sketch (up for discussion) on a potential model/example (with EBRAINS representations in green; blue numbers indicate the allowed linkages; this is not fully openMINDS language... that still needs to be further specified):

RP(V) = research product (version)
SER(V) = service (version) [special RP(V)]
LE = legal entity
INF = infrastructure
CON = consortium

[Raphael-Gazzotti]

I'm unsure where FileRepository should be placed with this new modeling. Should it be a node between RP(V) and INF, with an optional property pointing to INF if the latter is not defined?

[lzehl]

The FileRepository will remain as link for the RP(V).

In addition, the RP(V) will use the INF as host for the data and should point to the LE of the INF (or the INF directly, TBD) as host of the FileRepository.

Important here is, that the FileRepository of a RP(V) could also be stored in a different INF than the RP(V) belongs to (e.g. code publication on Zenodo or GitHub, while software is a product integrated in EBRAINS).

Note: this submodel will definitely have dependencies with other parts of the model and should be validated accordingly (graph validation) at one point (for now we would need to write down what should not cause conflict for curation to take care of)

Another note: LE will not be a new schema. It is the Organization schema. But since we are using the Organization schema also for non-legal entities I needed to specify the condition in the diagram.

[lzehl]

Putting the figure into openMINDS language (with some more adaptations to better fit our model):

A ResearchProductVersion (RPV) is provided by an Organization. This linkage could be defined through contribution/contributor with the role of provider, or with a specified providedBy property (to enforce requirement).

An Organization may be a legal entity or not (should be specified in the type property of this schema). It may have a parent Organization or not. It may also be a member of another Organization or a Consortium or not (isMemberOf; optional). It is located in a Country.

A Consortium may be defined by one or multiple Organizations or Persons or not (isDefinedBy; optional).

A ServiceVersion (SV) is provided by an Organization (see RPV). It is also part of an Infrastructure (isPartOf; required). It implements at least one other ResearchProductVersion or other ServiceVersion or other Infrastructure (as short cut?). This linkage could be defined through hasPart (current property), or maybe renamed to isImplementing or implements.

An Infrastructure is provided by an Organization (cf. RPV for implementation).

NEW to what we have now:

RPV:

• maybe a dedicated isProvidedBy property (value: required, 1-N, linked type Organization|Person|Consortium) parallel to the new contribution/contributor property (value: embedded type Contribution/ Contributor; cf reassessment of actors, their affiliations, and relations to research product (versions) #513)

For SV in addition to other RPV:

• maybe replace hasPart with isImplementing (value: required, 1-N, linked type RPVs|Infrastructure)
• add isPartOf property (value: required, 1(-N?), linked type Infrastructure)

For Organization cf #513

For Consortium

• add isDefinedBy property (value: optional, 0-N, linked type Person|Organization)

Infrastructure would be entirely new schema. property and value constraints/expectations TBD