Links
Comment on page

Product Tour

In this tutorial you will learn how to navigate and use the main components of the TileDB Cloud, namely:
  1. 3.
    Overview
  2. 7.
    Assets
    1. 1.
      Overview
    2. 2.
      Preview
    3. 3.
      Schema
    4. 4.
      Metadata
    5. 5.
      Sharing
    6. 6.
      Settings
    7. 7.
      Actions
  3. 8.
    Activity
  4. 9.
    Profile
Almost everything you can do on TileDB Cloud, you can also do programmatically using the TileDB Cloud client (see Installation).

Namespace selector

TileDB Cloud has a versatile namespace selector designed to enhance your experience in managing data and collaborations.
TileDB - Namespace selector
Quickly switch between private and organizational namespaces.
Upon signing up, each user is allocated a dedicated, private primary namespace. This namespace serves as your personal workspace, ensuring your data remains isolated and organized (until explicitly shared with other users or orgs).
In addition to your private namespace, TileDB offers the capability to create or join multiple organization namespaces. These spaces fosters seamless teamwork by allowing users to collaborate on projects, share resources, and collectively manage data.
The namespace selector enables effortless movement between these private and organizational spaces, facilitating a smooth transition as you navigate between different projects and contexts.

Notifications

You can receive notifications for various actions happening in TileDB Cloud. For instance, you can be notified when you're invited to join an organization or when someone shares an asset with you.
TileDB - Notifications
A notification received for a shared notebook

Overview

When you log in, the first page you see is Overview. Here you can see a summary of your assets, your current bill and your recent activity.
TileDB - Overview page
Overview - Recently accessed UDFs

Launch server

You can easily launch Jupyter notebook server instances within TileDB Cloud.
TileDB - Jupyter notebook server launch
Launch a Jupyter notebook instance, straight from TileDB Cloud
Launching a Notebook server instance from TileDB Cloud, while boasting a wide range of advantages, might exhibit slightly extended launch times around 30-40 seconds. This is due to the careful allocation of resources that underpin its performance and dependability.

Assets sidebar

You can catalogue and access a wide-range of asset types in TileDB Cloud. From generic, fundamental assets like arrays, files, notebooks and UDFs to more sophisticated assets used across broader applications verticals, including geospatial analysis, genomics research and machine learning.
This holistic approach ensures that whether you're working with traditional data types or delving into specialized domains, TileDB Cloud is your one-stop solution for streamlined asset management across diverse fields.
TileDB - Asset Sidebar
The asset sidebar

Asset browsers

Each asset category has it's dedicated browser where you can also filter and search for specific assets. In the asset browser you can navigate between:
  • My tab : Your registered assets
  • Shared tab : Assets that are shared with you
  • Public tab : Publicly available assets
  • Favorites tab : Assets that are marked as favorite
TileDB - Notebook asset browser (Public tab)
The notebook asset browser, with the public (explore) tab selected
You can use keywords in the search field to search by name, tag or phrases included in the description of the public data and code.

Assets

Assets constitutes data, code and data products that belong to you or an organization you are a member of, as well as data and code shared with you by other users and organizations.

Asset types

The asset categories currently supported by TileDB Cloud are listed in the table below. These assets can be registered and accessed in TileDB Cloud with various methods, described later in an another section.
Asset type
Category
Description
Arrays
Generic
Multi-dimensional arrays adapt to efficiently capture all data modalities, at any scale
Files
Generic
Securely manage and share any file, grouped and organized within your dataset
Notebooks
Generic
Collaborate on Jupyter notebooks, without having to move large datasets, for complete reproducibility
Dashboards
Generic
The same notebooks that power analysis can publish data visualizations for low-code analytics
UDFs
Generic
Move computations closer to your data, with cloud user-defined functions in Python, R and SQL
Task Graphs
Generic
Blend basic tasks, like slicing, and UDFs to build any distributed algorithm, plus options for GPUs
VCF
Life Sciences
Scale genomic analyses. Ingest data in parallel and append new samples to solve the N + 1 problem
SOMA
Life Sciences
Access and analyze large collections of single-cell experiments on object stores
Biomedical Imaging
Life Sciences
Efficiently store and share multi-resolution microscopy images for Cloud-based visualization and analysis
ML Models
Machine Learning
Store ML models alongside direct access to multi-modal datasets for training and prediction
Vector Search
Machine Learning
Efficient similarity search for vector embeddings
Point Cloud
Geospatial
Combine millions of points, such as those from LiDAR and SONAR, in complex 3D space for analysis-ready cloud access.
Geometry
Geospatial
Spatial entities with precise shapes, such as point, line and polygon, for analysis in GIS and mapping applications.
Raster
Geospatial
Geospatial gridded data for advanced analysis in geospatial.


Overview

You can preview various information from the overview tab of an asset. Rich descriptions, tags, URIs, permissions, versioning information along with some asset specific information.
TileDB - Notebook overview
Overview tab of a Notebook asset. Some information like Image and Server profile are available only to notebook asset types

Preview

The preview tab displays important information relative to the asset contents.
TileDB - Notebook Preview
A preview of the dataframe_basics public notebook
TileDB - File preview
A preview of a private .png file
Previews are not supported for every asset type yet, but we continue to expand the feature gradually.

Schema

Explicitly on array assets you can view detailed information regarding the schema of the array.
TileDB - Schema info
Schema information of an array

Metadata

Most of the asset types come with metadata, either inherited by the asset type itself, or defined by the user.
TileDB Cloud - File Metadata
File metadata

Sharing

Any asset can be shared with explicit permissions via username or email. If the email invited is not a TileDB account already, it will prompt the user for a signup first.
Sharing dialogue - Invite via username or email

Settings

From the settings tab you can update your asset description and license, assign tags, rename or remove your asset, change the cloud credentials and make your asset publicly accessible.
TileDB - Asset Settings
Setting of a file asset

Actions

Some assets have specific actions associated with them (highlighted by the blue buttons) such as the ability to download the asset, copy it to another namespace, launch a notebook or quickly add a description to the asset.
TileDB - Asset Actions
Asset actions available for a notebook

Adding assets

Adding assets to TileDB Cloud usually consists of two actions:
  1. 1.
    The creation or transformation of an existing or new asset to a multi-dimensional array. This can be done programmatically, via ingestion or straight from TileDB Cloud.
  2. 2.
    The registration of the asset from it's original storage location (usually S3, Azure or other cloud storage provider) to TileDB Cloud. Again this can happen either programmatically, via ingestion or from TileDB Cloud.
It's pretty common for the creation and registration of an asset to happen simultaneously.
For example when uploading a file from your computer at TileDB Cloud, it gets automatically transformed into an array, registered at your preferred namespace and saved to your selected cloud storage provider. Voila! 🔮
The most common way to register assets, is from popular cloud storage providers. You will first need to set up your cloud credentials in your profile settings at TileDB Cloud in order to do that.
TileDB doesn't host any of your assets in it's own servers. Instead it utilises cloud-native practices to connect with all popular cloud storage providers such as S3, Azure and more.

Activity

You can view all the logged activity of assets you have access to.
TileDB - Activity Screen
Task activity screen

Profile

You can view and edit your primary and organization profile, add cloud credentials, default storage paths, API tokens, and manage your billing.
TileDB - Billing
Profile settings, billing information
On organizations you can also manage your team members.
Organization profile by a read + write user (no billing available)
That was a quick product tour of TileDB Cloud. You can signup for free and start using it today with $10 free credits.