Contents:

DESTINY Climate and Health Repository#

Overview#

The DESTINY Repository is a living and comprehensive database of research data focused on climate and health. It is designed to continually store, enrich, and provide access to research data.

This documentation provides information on how to interact with the DESTINY Repository as an importer, robot or user.

Glossary#

  • Reference: The core data unit in the Repository, representing a piece of research.

  • ExternalIdentifier: Data that identifies a reference. These can be internal DESTINY identifiers or external third-party identifiers.

  • Enhancement: Data that enriches a Reference.

  • Importers: A process that brings References into the Repository from external sources. These references may contain Identifiers and Enhancements.

  • Robots: A process that adds Enhancements to References within the Repository. These are specialised, for instance there is a Robot for fetching abstract Enhancements.

  • Users / UIs: Individuals or interfaces that interact with the Repository to retrieve References.

Flowcharts#

        ---
title: DESTINY Repository
---
flowchart LR
   I([Importers])
   REPO[(Repository)]
   ROBOT([Robots])
   USER([Users / UIs])

   I-- Provide References -->REPO

   REPO-- Provide References -->ROBOT
   ROBOT-- Provide Enhancements -->REPO

   REPO-- Provide References -->USER
    
        ---
title: DESTINY Repository Reference Flow
---
sequenceDiagram
   participant I as Importer
   participant REPO as Repository
   participant ROBOT as Robot
   participant U as Users / UIs

   I->>REPO: Ingest Reference
   loop While Enhancements required
      REPO-->>REPO: Detect missing Enhancements
      REPO->>ROBOT: Provide Reference
      ROBOT->>REPO: Provide Enhancement
   end

   REPO->>U: Provide Reference