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