Introduction

Last updated on 2025-04-17 | Edit this page

Overview

Questions

  • How do I package data in a FAIR way?
  • How can I list the authors of individual files?
  • Can I use multiple licenses in the same data package?
  • How can I visualize JSON-LD metadata?

Objectives

  • Construct an RO-Crate by hand using JSON
  • Describe each part of the Research Object
  • Learn basic JSON-LD to create FAIR metadata
  • Connect different parts of the Research Object using identifiers

Introduction


This tutorial assumes you have already completed An overview of the RO-Crate concept and its implementations:

Video: An overview of the RO-Crate concept and its implementations (see also slides and transcript)

Tutorial walk-through


In this tutorial, meant to be read along with the RO-Crate specification, we’ll walk through the initial steps for creating a basic RO-Crate. You are invited to replicate the below steps on your local computer.

Abbreviations

  • FAIR: Findable, Accessible, Interoperable, Reusable; a set of principles for publishing research data and metadata
  • JSON: JavaScript Object Notation, a generic structured text-based data format
  • JSON-LD: JSON Linked Data, a way to express Linked Data (RDF) using regular JSON
  • RO-Crate: Research Object Crate; a way to package research data with structured FAIR metadata

Key Points

  • RO-Crate provides a structure to make FAIR data packages
  • schema.org in JSON-LD provides a controlled vocabulary for FAIR metadata
  • Each entity of the crate is described separately
  • Cross-references between entities create a graph
  • The RO-Crate specification recommends which types and keys to use