Skip to content

Latest commit

 

History

History
113 lines (86 loc) · 3.91 KB

Overview.md

File metadata and controls

113 lines (86 loc) · 3.91 KB
Raw

Zarrcade Overview

Image Discovery

Zarrcade supports automatic discovery of images through its Agent API. An Agent is a Python class that implements the walk and yield_images methods, which is used to recursively search for images in a storage backend.

Currently, there is only one built-in agent called OmeZarrAgent which discovers OME-Zarr images. It checks for the presence of a .zattrs file, and if found, it attempts to recursively parse the OME-Zarr metadata in the container. If the bioformats2raw.layout attribute is found, the transitional bioformats2raw layout is used to extract images. Otherwise, the groups are checked recursively to find any group with a multiscales attribute.

When transitional Omero metadata is present, it is used to extract channels colors and intensity ranges, for use in e.g. Neuroglancer multichannelconfiguration.

Neuroglancer Multichannel Configuration

Neuroglancer does not currently support automatic loading of multichannel OME-Zarr images. To work around this, Zarrcade generates a Neuroglancer configuration JSON file and exposes it on its internal file server. When opening an image in Neuroglancer, the link will use the internal file server to load the configuration.

Data Model

Zarrcade uses a simple database schema to store the image metadata and annotations. A DBCollection is a named collection of images at a particular URL or filepath. Images found at that data URL are discovered by import.py and added to the DBImage table.

Annotations optionally loaded from the user-provided CSV file are added to the DBImageMetadata table, and each DBImage may be linked to one DBImageMetadata record. Multiple images (e.g. in an image series) may be linked to the same DBImageMetadata record. Columns in the CSV file are added to the DBMetadataColumn table which maps the original column name to the internal database name.

Class diagram

This diagram shows the Python API for the database schema. These classes are mapped to the database tables using SQLAlchemy.

classDiagram

class DBCollection {
    int id
    String name
    String label
    String data_url
}

class DBMetadataColumn {
    int id
    String db_name
    String original_name
}

class DBImageMetadata {
    int id
    String collection
    String path
    String aux_image_path
    String thumbnail_path
    String YOUR_ANNOTATION_NAME_1
    String YOUR_ANNOTATION_NAME_2
    String YOUR_ANNOTATION_NAME_3
}

class DBImage {
    int id
    String collection
    String image_path
    String path
    String group_path
    String image_info
    int image_metadata_id
}

DBImageMetadata "1" --> "0..*" DBImage : contains
DBImage "1" --> "0..1" DBImageMetadata : references
DBCollection "1" --> "0..*" DBImage : contains
Loading

Entity-relationship (ER) diagram

This diagram shows the database schema. You can use something like DB Browser for SQLite to browse your database file directly.

erDiagram
DBCollection {
    id int
    name str
    label str
    data_url str
}

DBMetadataColumn {
    id int
    db_name str
    original_name str
}

DBImageMetadata {
    id int
    collection str
    path str
    aux_image_path str
    thumbnail_path str
    YOUR_ANNOTATION_NAME_1 str
    YOUR_ANNOTATION_NAME_2 str
    YOUR_ANNOTATION_NAME_3 str
}

DBImage {
    id int
    collection str
    image_path str
    path str
    group_path str
    image_info str
    image_metadata_id int
}

DBCollection ||--o{ DBImageMetadata : contains
DBImageMetadata ||--o{ DBImage : contains
DBImage ||--o| DBImageMetadata : references
Loading