Skip to content

08 Exporting Data

dawndawn edited this page Oct 16, 2025 · 11 revisions

You can export your data models, annotations, and metadata. Click on the Export page in the IMMARKUS Interface and select the data you wish to export.

You can also export filtered subsets of your annotations based on search and filtering criteria in the Knowledge Graph Mode.

Exporting Annotations

Click and download Annotations.

  1. Annotation Data: export all annotations as a flat list in the W3C Web Annotation JSON-LD format (JSON for Linked Data, a specification for encoding contextualized meaning into JSON documents).
  2. Annotations and Images: generates one XLSX file with multiple worksheets. Each worksheet is for each top-level (parent) entity class. Each property is exported as a column followed by the image snippet, the file name, the annotation ID, and the time when the annotation was created.

For image snippets, you can choose to export them as either with bounding boxes or exact shapes.

08_exporting-data_fig1
Figure 1. Exporting Annotations

08_exporting-data_fig2
Figure 2. Comparing Annotation Snippets Exported as Bounding Boxes (Left, Outlined in Blue) and Exact Shapes (Right, Outlined in Yellow)

Exporting Relationships

Click and download Relationships.

  1. Relationship Data: export all relationships created between entity classes as a flat list in the W3C Web Annotation JSON-LD format.

  2. Relationships and Images: export all relationships created between entity classes on all images in your current work folder as a single XLSX file. Each relationship is exported as a column, followed by the start- (source) annotation snippet, its file and folder name, and entity class, as well as the end (target) annotation snippet, its file and folder name, and entity class.

08_exporting-data_fig3
Figure 3. Exporting Relationships Created between Entity Classes

Exporting a Data Model

In Data Model you can select what to export: Entity Classes, Relationship Types, Image Metadata, Folder Metadata, or the entire IMMARKUS Data Model. All the exports are downloaded as a JSON file.

Full IMMARKUS Data Model is the same file you will find in your working folder as _immarkus.model.json.

08_exporting-data_fig4
Figure 4. Exporting a Data Model

Exporting Metadata

Click Metadata and select either Image or Folder Metadata. The metadata will be downloaded as a flat list in a CSV spreadsheet.

08_exporting-data_fig5
Figure 5. Exporting Metadata

A Type column (outlined in Figure 6) is generated in the Metadata export to specify whether the folder or image originates locally or from an IIIF import.

08_exporting-data_fig6
Figure 6. Type Column Indicating Folder and Image Sources in Exported Metadata Files

A Path column (outlined in Figure 7) is generated in Image Metadata export to indicate the location of each image in the folder structure. For IIIF images, the path reflects the subfolder hierarchy of the source manifest.

08_exporting-data_fig7
Figure 7. Path Column Indicating Image Locations in the Exported IIIF Image Metadata File

Currently, the IIIF embedded metadata is only fetched for viewing within IMMARKUS interfaces and is not included in the export file.

Clone this wiki locally