1. Structure
  2. Life Sciences
  3. Biomedical Imaging
  4. Foundation
  5. Data Model
  • Home
  • What is TileDB?
  • Get Started
  • Explore Content
  • Accounts
    • Individual Accounts
      • Apply for the Free Tier
      • Profile
        • Overview
        • Cloud Credentials
        • Storage Paths
        • REST API Tokens
        • Credits
    • Organization Admins
      • Create an Organization
      • Profile
        • Overview
        • Members
        • Cloud Credentials
        • Storage Paths
        • Billing
      • API Tokens
    • Organization Members
      • Organization Invitations
      • Profile
        • Overview
        • Members
        • Cloud Credentials
        • Storage Paths
        • Billing
      • API Tokens
  • Catalog
    • Introduction
    • Data
      • Arrays
      • Tables
      • Single-Cell (SOMA)
      • Genomics (VCF)
      • Biomedical Imaging
      • Vector Search
      • Files
    • Code
      • Notebooks
      • Dashboards
      • User-Defined Functions
      • Task Graphs
      • ML Models
    • Groups
    • Marketplace
    • Search
  • Collaborate
    • Introduction
    • Organizations
    • Access Control
      • Introduction
      • Share Assets
      • Asset Permissions
      • Public Assets
    • Logging
    • Marketplace
  • Analyze
    • Introduction
    • Slice Data
    • Multi-Region Redirection
    • Notebooks
      • Launch a Notebook
      • Usage
      • Widgets
      • Notebook Image Dependencies
    • Dashboards
      • Dashboards
      • Streamlit
    • Preview
    • User-Defined Functions
    • Task Graphs
    • Serverless SQL
    • Monitor
      • Task Log
      • Task Graph Log
  • Scale
    • Introduction
    • Task Graphs
    • API Usage
  • Structure
    • Why Structure Is Important
    • Arrays
      • Introduction
      • Quickstart
      • Foundation
        • Array Data Model
        • Key Concepts
          • Storage
            • Arrays
            • Dimensions
            • Attributes
            • Cells
            • Domain
            • Tiles
            • Data Layout
            • Compression
            • Encryption
            • Tile Filters
            • Array Schema
            • Schema Evolution
            • Fragments
            • Fragment Metadata
            • Commits
            • Indexing
            • Array Metadata
            • Datetimes
            • Groups
            • Object Stores
          • Compute
            • Writes
            • Deletions
            • Consolidation
            • Vacuuming
            • Time Traveling
            • Reads
            • Query Conditions
            • Aggregates
            • User-Defined Functions
            • Distributed Compute
            • Concurrency
            • Parallelism
        • Storage Format Spec
      • Tutorials
        • Basics
          • Basic Dense Array
          • Basic Sparse Array
          • Array Metadata
          • Compression
          • Encryption
          • Data Layout
          • Tile Filters
          • Datetimes
          • Multiple Attributes
          • Variable-Length Attributes
          • String Dimensions
          • Nullable Attributes
          • Multi-Range Reads
          • Query Conditions
          • Aggregates
          • Deletions
          • Catching Errors
          • Configuration
          • Basic S3 Example
          • Basic TileDB Cloud
          • fromDataFrame
          • Palmer Penguins
        • Advanced
          • Schema Evolution
          • Advanced Writes
            • Write at a Timestamp
            • Get Fragment Info
            • Consolidation
              • Fragments
              • Fragment List
              • Consolidation Plan
              • Commits
              • Fragment Metadata
              • Array Metadata
            • Vacuuming
              • Fragments
              • Commits
              • Fragment Metadata
              • Array Metadata
          • Advanced Reads
            • Get Fragment Info
            • Time Traveling
              • Introduction
              • Fragments
              • Array Metadata
              • Schema Evolution
          • Array Upgrade
          • Backends
            • Amazon S3
            • Azure Blob Storage
            • Google Cloud Storage
            • MinIO
            • Lustre
          • Virtual Filesystem
          • User-Defined Functions
          • Distributed Compute
          • Result Estimation
          • Incomplete Queries
        • Management
          • Array Schema
          • Groups
          • Object Management
        • Performance
          • Summary of Factors
          • Dense vs. Sparse
          • Dimensions vs. Attributes
          • Compression
          • Tiling and Data Layout
          • Tuning Writes
          • Tuning Reads
      • API Reference
    • Tables
      • Introduction
      • Quickstart
      • Foundation
        • Data Model
        • Key Concepts
          • Indexes
          • Columnar Storage
          • Compression
          • Data Manipulation
          • Optimize Tables
          • ACID
          • Serverless SQL
          • SQL Connectors
          • Dataframes
          • CSV Ingestion
      • Tutorials
        • Basics
          • Ingestion with SQL
          • CSV Ingestion
          • Basic S3 Example
          • Running Locally
        • Advanced
          • Scalable Ingestion
          • Scalable Queries
      • API Reference
    • AI & ML
      • Vector Search
        • Introduction
        • Quickstart
        • Foundation
          • Data Model
          • Key Concepts
            • Vector Search
            • Vector Databases
            • Algorithms
            • Distance Metrics
            • Updates
            • Deployment Methods
            • Architecture
            • Distributed Compute
          • Storage Format Spec
        • Tutorials
          • Basics
            • Ingestion & Querying
            • Updates
            • Deletions
            • Basic S3 Example
            • Running Locally
          • Advanced
            • Versioning
            • Time Traveling
            • Consolidation
            • Distributed Compute
            • RAG LLM
            • LLM Memory
            • File Search
            • Image Search
            • Protein Search
          • Performance
        • API Reference
      • ML Models
        • Introduction
        • Quickstart
        • Foundation
          • Basics
          • Storage
          • Cloud Execution
          • Why TileDB for Machine Learning
        • Tutorials
          • Ingestion
            • Data Ingestion
              • Dense Datasets
              • Sparse Datasets
            • ML Model Ingestion
          • Management
            • Array Schema
            • Machine Learning: Groups
            • Time Traveling
    • Life Sciences
      • Single-cell
        • Introduction
        • Quickstart
        • Foundation
          • Data Model
          • Key Concepts
            • Data Structures
            • Use of Apache Arrow
            • Join IDs
            • State Management
            • TileDB Cloud URIs
          • SOMA API Specification
        • Tutorials
          • Data Ingestion
          • Bulk Ingestion Tutorial
          • Data Access
          • Distributed Compute
          • Basic S3 Example
          • Multi-Experiment Queries
          • Appending Data to a SOMA Experiment
          • Add New Measurements
          • SQL Queries
          • Running Locally
          • Shapes in TileDB-SOMA
          • Drug Discovery App
        • Spatial
          • Introduction
          • Foundation
            • Spatial Data Model
            • Data Structures
          • Tutorials
            • Spatial Data Ingestion
            • Access Spatial Data
            • Manage Coordinate Spaces
        • API Reference
      • Population Genomics
        • Introduction
        • Quickstart
        • Foundation
          • Data Model
          • Key Concepts
            • The N+1 Problem
            • Architecture
            • Arrays
            • Ingestion
            • Reads
            • Variant Statistics
            • Annotations
            • User-Defined Functions
            • Tables and SQL
            • Distributed Compute
          • Storage Format Spec
        • Tutorials
          • Basics
            • Basic Ingestion
            • Basic Queries
            • Export to VCF
            • Add New Samples
            • Deleting Samples
            • Basic S3 Example
            • Basic TileDB Cloud
          • Advanced
            • Scalable Ingestion
            • Scalable Queries
            • Query Transforms
            • Handling Large Queries
            • Annotations
              • Finding Annotations
              • Embedded Annotations
              • External Annotations
              • Annotation VCFs
              • Ingesting Annotations
            • Variant Statistics
            • Tables and SQL
            • User-Defined Functions
            • Sample Metadata
            • Split VCF
          • Performance
        • API Reference
          • Command Line Interface
          • Python API
          • Cloud API
      • Biomedical Imaging
        • Introduction
        • Foundation
          • Data Model
          • Key Concepts
            • Arrays
            • Ingestion
            • Reads
            • User Defined Functions
          • Storage Format Spec
        • Quickstart
        • Tutorials
          • Basics
            • Ingestion
            • Read
              • OpenSlide
              • TileDB-Py
          • Advanced
            • Batched Ingestion
            • Chunked Ingestion
            • Machine Learning
              • PyTorch
            • Napari
    • Files
  • API Reference
  • Self-Hosting
    • Installation
    • Upgrades
    • Administrative Tasks
    • Image Customization
      • Customize User-Defined Function Images
      • AWS ECR Container Registry
      • Customize Jupyter Notebook Images
    • Single Sign-On
      • Configure Single Sign-On
      • OpenID Connect
      • Okta SCIM
      • Microsoft Entra
  • Glossary

On this page

  • Data array
  • Data representation
  • Advantages of this model
  • Key features and considerations
  • Benefits for digital pathology
  1. Structure
  2. Life Sciences
  3. Biomedical Imaging
  4. Foundation
  5. Data Model

Biomedical Imaging Data Model

life sciences
biomedical imaging
foundation
data model
The data model used by TileDB-BioImaging for processing biomedical images.

This section describes the data model used to efficiently represent and store whole slide histopathology images within TileDB by using TileDB-BioImaging. The Storage Format Spec section covers TileDB-BioImaging’s format, whereas the Key Concepts section describes important background information in the internal mechanics of TileDB-BioImaging. By leveraging TileDB’s core features and a flexible multidimensional array structure, this model enables high-performance storage, retrieval, and analysis of large image datasets.

Data array

TileDB stores whole slide images as multidimensional ND dense arrays. This structure allows for the representation of image and volumetric data, incorporating spatial dimensions, time, and channels:

  • X (Space): Represents the width of the image in pixels.
  • Y (Space): Represents the height of the image in pixels.
  • Z (Space): Represents depth (for volumetric data like 3D scans).
  • T (Time): Represents a time dimension (for time-series data).
  • C (Channels): Represents color channels (for example, Red, Green, Blue).

Each resolution layer of a whole slide image is represented as a separate ND array. For instance, a standard 2D image with three color channels would be stored as a 3D array (YXC). A time series of 3D volumetric images would be a 5D array (ZYXCT).

Data representation

Each pixel is represented as an int16 value for each color channel. TileDB stores this data within the cells of the dense array. For grayscale images, the C (channels) dimension reduces to 1.

Advantages of this model

  • Multidimensionality: TileDB’s inherent support for multidimensional arrays aligns perfectly with the complex structure of whole slide images, enabling efficient storage and querying of data across all dimensions.
  • Flexibility: The model accommodates different image types, including 2D images, 3D volumes, and time series data.
  • Scalability: TileDB’s architecture allows for efficient storage and processing of extremely large datasets, essential for handling high-resolution, whole slide images.
  • Interoperability: This data model, alongside TileDB’s multidimensionality nature, allows the definition of extra dimensions like Space, Time, and Channels, leading to the adoption of standard formats like Open Microscopy Environment Next Generation File Format (OME-NGFF). OME-NGFF is a modern, cloud-optimized file format designed for storing and sharing large, complex bioimaging datasets. Using this format ensures interoperability with a growing ecosystem of tools and enables collaboration within the scientific community.

Key features and considerations

  • Axes Order Flexibility: Using the API, you can preserve the original axes order from the source image or store the data in a canonical form. This offers flexibility and compatibility with different workflows.
  • Resolution Layers: Whole slide images are often stored in a pyramidal format with multiple resolution levels. Each level is represented as a separate ND array, allowing for efficient access to different levels of detail.
  • Pyramidal Image Grouping: Each pyramidal image with its multiple resolution levels is represented as a group of arrays within TileDB. This allows for organized storage and management of related data.
  • Group Metadata: Metadata about the entire image, such as patient information, staining technique, and overall image dimensions, are stored at the group level.
  • Level Metadata: Each resolution level within the group can have its own associated metadata, such as the downsampling factor and specific image dimensions for that level.
  • Metadata: Thanks to TileDB, you can store rich metadata associated with the image data, including patient information, staining techniques, and acquisition parameters. This metadata is crucial for proper data interpretation and analysis.
  • Compression: TileDB offers a variety of compression filters to reduce storage size and optimize I/O performance.

Benefits for digital pathology

This data model, combined with TileDB’s capabilities, gives a powerful solution for managing and analyzing whole slide histopathology images. This enables:

  • Efficient Storage: Handle massive image datasets with optimal storage use.
  • Fast Access: Quickly retrieve specific regions or resolutions of images for analysis.
  • Advanced Analysis: Perform complex queries and computations on the data, enabling new insights and discoveries.
  • Collaboration: Share data with colleagues and researchers, enabling collaboration and accelerating research progress.

This data model empowers researchers in digital pathology to efficiently manage, analyze, and share whole slide images, ultimately contributing to advancements in disease diagnosis and treatment.

Foundation
Key Concepts