This format is an open format, licensed under the MIT license and specified by the present document.
The file is a ZIP archive, so it MUST follow the standard ZIP specifications and be readable by all zip utilities.
The contents of the archive MAY be encrypted, as with any ZIP archive.
An up to date version of this document can be accessed at: https://github.com/TheELNConsortium/eln-file-format
This archive format is basically a zipped RO-Crate, with a .eln file extension.
Inside a .eln file, there MUST be a folder that will contain the rest of the data. The name of the folder SHOULD be the same as the archive name. This folder at root prevents issues when opening the file as a zip file and getting archived files extracted in the current directory, possibly overwriting other files, and probably polluting the current directory. There MUST be only one folder at the root of the archive.
Inside that root folder, there MUST be a file named ro-crate-metadata.json. This file follows the RO-Crate 1.1+ Specification.
The rest of the archive is composed of 0 or more folders that each describe one experiment or coherent set of data. Thus, the ELN archive can accomodate one or several experimental set of data.
Example for file: some-data.eln
<root>
some-data.eln/
- ro-crate-metadata.json
- experimentA/:
- index.json
- image.tif
- measurements.csv
- paper.pdf
- experimentB/:
- content.txt
- image-overexposed.tif
- results.xlsx
- subfolder-with-data/:
- some-data.bin
- some-data2.binThis is of course described in the RO-Crate Specification but let's go over an example to understand how it works.
At the root of our JSON-LD object, we have a context and a graph. The graph will contain an array of everything we put in our crate. Each node object in the graph represents the properties of a node serialized by the JSON-LD.
{
"@context": "https://w3id.org/ro/crate/1.1/context",
"@graph": [<EVERYTHING IS IN THERE>]
}The first node we describe here is the ro-crate-metadata.json:
{
"@id": "ro-crate-metadata.json",
"@type": "CreativeWork",
"about": {
"@id": "./"
},
"conformsTo": {
"@id": "https://w3id.org/ro/crate/1.1"
},
"dateCreated": "2022-05-30T12:25:36+0200",
"sdPublisher": {
"@id": "https://eln-example.com"
}
}It is a CreativeWork about the current directory where it is, and conforms to the RO-Crate specification. Other fields like dateCreated (added here) or any other property of CreativeWork can be added.
In addition to the properties outlined in the RO-Crate Metadata File Descriptor, this node SHOULD include sdPublisher property, which references the Organization entity containing additional metadata.
The Organization entity SHOULD contain an @id, @type: Organization, name and url properties. Any other properties of Organization MAY also be added.
The second node is basically describing the current directory (./).
{
"@id": "./",
"@type": ["Dataset"],
"hasPart": [
{
"@id": "./2022-05-29 - Some-experiment/"
},
{
"@id": "./2022-05-29 - Id-asperiores-explicabo-quod-mollitia/"
}
]
}Its type is an array of Dataset and hasPart which corresponds to the different @ids of the other nodes. Think of it like a Table of Contents.
Subsequently, all the remaining nodes are assigned a @type of either Dataset for directories or File for individual files. And the @id corresponds to something in the hasPart of ./.
If a Dataset node has additional files, they should be listed in its hasPart property and can be referenced through their @id.
All nodes with @type: Dataset SHOULD include name, author properties. Furthermore, other properties of Dataset, such as identifier, dateCreated, dateModified, text, keywords, comment MAY also be added.
All nodes with @type: File SHOULD include name, encodingFormat, contentSize properties. Furthermore, other properties of File, such as description, sha256, author, identifier, dateCreated, dateModified, text MAY also be added.
All nodes with a @type such as Comment or Person exist at the root node (once), and can be referenced via their @id in other parts.
For instance, a "comment" on an experiment will exist as a @type: Comment node at the root node, and be referenced through its @id in the comment part of the experiment's node. See "Example Dataset with Comment" example below.
{
"@id": "./2022-05-29 - Some-experiment/",
"@type": "Dataset",
"author": {
"@id": "./author/23"
},
"dateCreated": "2022-05-29 16:17:38",
"dateModified": "2022-05-29 16:17:57",
"name": "Some experiment",
"text": "<h1><span style=\"font-size:14pt;\">Goal :</span></h1>\n<p> </p>\n<h1><span style=\"font-size:14pt;\">Procedure :</span></h1>\n<p> </p>\n<h1><span style=\"font-size:14pt;\">Results :<br></span></h1>\n<p> </p>",
"url": "https://elab.example.com/experiments.php?mode=view&id=256",
"hasPart": [
{
"@id": "./2022-05-29 - Some-experiment/2022-05-30-export.elabftw.csv"
},
{
"@id": "./2022-05-29 - Some-experiment/2022-05-29 - Some-experiment.pdf"
}
]
}{
"@id": "./2022-05-29 - Some-experiment/2022-05-30-export.elabftw.csv",
"@type": "File",
"description": "CSV Export",
"name": "2022-05-30-export.elabftw.csv",
"encodingFormat": "text/csv; charset=UTF-8",
"contentSize": "247",
"sha256": "f3278e796c687371cc63a600b6f12ea32167067fed3ef98099d0c1aad2426531"
}Here we show three nodes, the Dataset (main experiment), a Comment and a Person. The Person leaving the Comment is the same as the author of the Dataset.
{
"@id": "./some-unique-id/23",
"@type": "Dataset",
"author": {
"@id": "./some-author-id/44"
},
"dateCreated": "2023-09-23T01:02:26+02:00",
"dateModified": "2023-09-27T23:02:44+02:00",
"comment": [
{
"@id": "./some-comment-id/91"
}
],
},
{
"@id": "./some-comment-id/91",
"@type": "Comment",
"dateCreated": "2023-09-23T01:02:26+02:00",
"text": "This is the content of the comment.",
"author": {
"@id": "./some-author-id/44"
}
},
{
"@id": "./some-author-id/44",
"@type": "Person",
"familyName": "Tapie",
"givenName": "Bernard"
}See the RO-Crate website.
See the examples folder.