Merge branch 'main' of https://github.com/nfdi4plants/arc-website

nfdi4plants · Sep 15, 2024 · 46a6c87 · 46a6c87
2 parents 33aa96a + 8d3a877
commit 46a6c87
Show file tree

Hide file tree

Showing 23 changed files with 258 additions and 20 deletions.
diff --git a/public/ARC-isa-cwl-decorations.png b/public/ARC-isa-cwl-decorations.png
diff --git a/public/arc-bag-your-research.png b/public/arc-bag-your-research.png
diff --git a/public/arc-process-graph.png b/public/arc-process-graph.png
diff --git a/public/arc-ro-crate-profiles.png b/public/arc-ro-crate-profiles.png
diff --git a/public/arc-ro-crate.png b/public/arc-ro-crate.png
diff --git a/public/documentation-principle-assay.png b/public/documentation-principle-assay.png
diff --git a/public/documentation-principle-run.png b/public/documentation-principle-run.png
diff --git a/public/documentation-principle-study.png b/public/documentation-principle-study.png
diff --git a/public/documentation-principle-workflow.png b/public/documentation-principle-workflow.png
diff --git a/public/fairness-gradual-process.png b/public/fairness-gradual-process.png
diff --git a/public/fairness-long-tail-data.png b/public/fairness-long-tail-data.png
diff --git a/public/orga-principle-folder2process.png b/public/orga-principle-folder2process.png
diff --git a/public/orga-principle-scaffold.png b/public/orga-principle-scaffold.png
diff --git a/public/research-data-lifecycle.png b/public/research-data-lifecycle.png
diff --git a/src/components/Home/CommunityCards.astro b/src/components/Home/CommunityCards.astro
@@ -14,17 +14,17 @@ import Card from '../Card.astro'
       <Card
         href="https://docs.astro.build/"
         title="Minimal Organization Principal"
-        body="Learn how Astro works and explore the official API docs."
+        body="Get started to organize your research data using the ARC."
       />
       <Card
         href="https://astro.build/integrations/"
         title="Tools and Services"
-        body="Supercharge your project with new frameworks and libraries."
+        body="Find tools and services that assist you creating and managing your research data using ARC."
       />
       <Card
         href="https://astro.build/themes/"
         title="Support"
-        body="Explore a galaxy of community-built starter themes."
+        body="Explore tutorials, videos or find community that can help."
       />
     </ul>
   </div>

diff --git a/src/components/Home/DeveloperCards.astro b/src/components/Home/DeveloperCards.astro
@@ -1,4 +1,5 @@
 ---
+import { URLS } from "../../statics";
 import Card from '../Card.astro'
 ---
 
@@ -12,19 +13,19 @@ import Card from '../Card.astro'
     </div>
     <ul role="list" class="link-card-grid">
       <Card
-        href="https://docs.astro.build/"
-        title="ARC model"
-        body="Learn how Astro works and explore the official API docs."
+        href= "/details/arc-data-model"
+        title="ARC data model"
+        body="Learn how ARC data model is a FAIR Digital Object implementation"
       />
       <Card
         href="https://astro.build/integrations/"
         title="ARC representation"
-        body="Supercharge your project with new frameworks and libraries."
+        body="Understand how the ARC is both a data scaffold and a JSON manifest"
       />
       <Card
         href="https://astro.build/themes/"
         title="ARC (meta)data framework"
-        body="Explore a galaxy of community-built starter themes."
+        body="Supercharge your RDM with an extensive frameworks and libraries."
       />
     </ul>
   </div>

diff --git a/src/components/Home/RDMGraphNavigation.astro b/src/components/Home/RDMGraphNavigation.astro
@@ -4,7 +4,7 @@ import GraphNavigation from "../GraphNavigation.astro";
 import { Color } from "../GraphNavigation.astro";
 
 const circles = [
-  { id: 1, cx: 8, cy: 25, r: 5, href: '#link4', text: 'FAIR Digital Object', angle: 20 },
+  { id: 1, cx: 8, cy: 25, r: 5, href: URLS.Internal_Home + "/details/arc-fdo", text: 'FAIR Digital Object', angle: 20 },
   { id: 2, cx: 30, cy: 40, r: 5, href: '#link4', text: 'validation', angle: 180 },
   { id: 3, cx: 60, cy: 8, r: 5, href: '#link3', text: 'continuous Integration', angle: 80 },
   { id: 4, cx: 90, cy: 40, r: 5, href: '#link2', text: 'versioning', angle: 250 },

diff --git a/src/components/Home/ResearchGraphNavigation.astro b/src/components/Home/ResearchGraphNavigation.astro
@@ -5,10 +5,10 @@ import { Color } from "../GraphNavigation.astro";
 
 const circles = [
   { id: 1, cx: 8, cy: 10, r: 5, href: URLS.Internal_Home + "/details/documentation-principle", text: 'documentation principle', angle: 80 },
-  { id: 2, cx: 30, cy: 40, r: 5, href: '#link2', text: 'organization principle', angle: 200 },
+  { id: 2, cx: 30, cy: 40, r: 5, href: URLS.Internal_Home + "/details/organization-principle", text: 'organization principle', angle: 200 },
   { id: 3, cx: 60, cy: 35, r: 5, href: '#link3', text: 'quality control', angle: 130 },
   { id: 4, cx: 90, cy: 15, r: 5, href: '#link4', text: 'exchange & publication', angle: 10 },
-  { id: 5, cx: 140, cy: 25, r: 5, href: '#link4', text: 'RDM & FAIRness', angle: 210 },
+  { id: 5, cx: 140, cy: 25, r: 5, href: URLS.Internal_Home + "/details/fairness-and-rdm", text: 'RDM & FAIRness', angle: 210 },
 ];
 ---
 

diff --git a/src/pages/details/arc-data-model.md b/src/pages/details/arc-data-model.md
@@ -0,0 +1,26 @@
+---
+layout: ../../layouts/MarkdownLayout.astro
+title: 'ARC data model'
+pubDate: 2024-09-13
+description: 'A short description of the ARC data mode.'
+author: 'Timo Mühlhaus'
+image:
+    url: 'https://docs.astro.build/assets/rose.webp'
+    alt: 'The Astro logo on a dark background with a pink glow.'
+tags: ["RO-Crate", "FAIR digital object","JSON-LD"]
+---
+
+ARC is an implementation of a FAIR Digital Object (FDO), utilizing RO-Crate with Schema.org and Bioschemas objects as its foundation, and further enhancing it with additional metadata and structure. An RO-Crate serves as a research object, composed of a collection of research elements and data, enabling detailed descriptions of these collections. Research elements in this context include samples, measurement data, and other research outputs.
+
+![ARC RO Crate](/arc-website/arc-ro-crate.png)
+
+ARC extends the basic RO-Crate concept by incorporating detailed descriptions of the processes that lead to the generation of data. This enhancement allows the data model to represent a complete process graph, encompassing experimental procedures, simulations, analyses, and the interconnections and provenance among them.
+In this model, research elements are the nodes of the process graph, while the connections between them, defined as lab processes, are represented by edges. Each process can be further specified and annotated with explanatory and descriptive metadata using lists of PropertyValues, enhancing its clarity and traceability.
+
+![ARC RO Crate](/arc-website/ARC-isa-cwl-decorations.png)
+
+To specialize ARC for biological data, the widely recognized ISA model (Investigation, Study, Assay) is employed, alongside the abstract Common Workflow Language (CWL) for workflows. The ISA model and CWL provide additional layers of metadata and structure, allowing for more precise definitions of processes and data. Dataset objects within ARC can implement either ISA or CWL interface object definitions, ensuring compatibility and standardization across various biological datasets and workflows.
+
+![ARC RO Crate](/arc-website/arc-ro-crate-profiles.png)
+
+This approach elevates ARC from merely documenting research objects to providing a full, interconnected representation of the research process, from data generation to analysis, making it a powerful tool for tracing and reproducing scientific investigations.