> ## Documentation Index
> Fetch the complete documentation index at: https://docs.redbrickai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started

# Getting Started with AltaDB

AltaDB is RedBrick AI's integrated high-performance medical imaging storage solution, providing a modern alternative to traditional cloud storage systems like AWS S3, Google Cloud Storage, and Orthanc. AltaDB is specifically optimized for DICOM data with medical imaging-specific features and organization.

<Frame>
  <img src="https://mintcdn.com/redbrickai-c2e4bc62/09_FiR9sdsjqKqIA/assets/images/altadb/Frame%2031412.png?fit=max&auto=format&n=09_FiR9sdsjqKqIA&q=85&s=7ed3be9a1f6f551623df92912fb26f54" alt="AltaDB Overview" width="4016" height="2820" data-path="assets/images/altadb/Frame 31412.png" />
</Frame>

## Accessing AltaDB

AltaDB is now fully integrated into the RedBrick AI platform. To access AltaDB features:

1. Log in to your [RedBrick AI account](https://app.redbrickai.com)
2. Navigate to the **AltaDB** section in your dashboard
3. Your AltaDB datasets will be available within your RedBrick AI organization

## Understanding AltaDB Structure

Within your RedBrick AI organization, AltaDB allows you to organize your data into multiple Datasets. A Dataset is a collection of DICOM studies and/or individual series.

<Frame caption="AltaDB dataset structure within RedBrick AI">
  <img src="https://mintcdn.com/redbrickai-c2e4bc62/09_FiR9sdsjqKqIA/assets/images/altadb/Org%20Structure.png?fit=max&auto=format&n=09_FiR9sdsjqKqIA&q=85&s=6d00beaf49816b3ffe8c35e9942a2e42" alt="Organization Structure" width="1380" height="440" data-path="assets/images/altadb/Org Structure.png" />
</Frame>

All DICOM data is **indexed by series using the Series Instance UID DICOM headers** and automatically organized into series within your dataset.

Once indexing is complete, you can view all DICOM headers and search/filter your dataset by Series Instance UID, Study UID, or Patient ID.

<Info>
  AltaDB will not maintain the original folder structure of your uploads. The
  folder structure will be traversed, and individual series will be extracted
  and indexed for optimal performance.
</Info>

<Frame caption="How AltaDB processes folder structures">
  <img src="https://mintcdn.com/redbrickai-c2e4bc62/09_FiR9sdsjqKqIA/assets/images/altadb/Folder%20Structure.png?fit=max&auto=format&n=09_FiR9sdsjqKqIA&q=85&s=e79abad6e9ff6d756f8e5f2c20ee077b" alt="Folder Structure" width="1380" height="776" data-path="assets/images/altadb/Folder Structure.png" />
</Frame>

<Warning>
  If AltaDB encounters an invalid DICOM file in a Series, the entire Series will
  be skipped during import.
</Warning>

## Importing Data

1. Navigate to your AltaDB dataset in RedBrick AI
2. Click **Import Data** to open the data importer
3. Either:
   * Drag & drop your DICOM files into the importer, or
   * Click to browse and select files from your device
4. AltaDB will index the DICOM headers and apply state-of-the-art compression
5. Monitor import progress in the **Imports** tab

<Tip>
  You can specify a top-level directory to recursively upload all valid DICOM
  files in subdirectories when using the drag & drop interface.
</Tip>

AltaDB recognizes the following file extensions as valid DICOM files:

* `*.dicom`
* `*.dcm`
* `*.ima`

## Viewing Data

Within your AltaDB dataset, preview images by clicking on thumbnails. The integrated viewer supports:

1. **Change slice**: Mouse scroll
2. **Windowing**: Right-click+drag
3. **Zoom**: Left-click+drag
4. **Pan**: Middle mouse+drag

<Frame>
  <iframe className="w-full aspect-video" src="https://share.cleanshot.com/y5k3NJ28/embed" />
</Frame>

## Searching & Filtering

Filter your AltaDB dataset by:

1. **Series UID**
2. **Study UID**
3. **Import ID**: Unique identifier for each import batch
4. **Created by**: User who uploaded the series
5. **Imported at**: Upload date and time

## Using AltaDB in RedBrick AI Projects

Since AltaDB is integrated into RedBrick AI, you can directly use your AltaDB datasets in projects.

You can either add it to your project or workspace directly from AltaDB or by downloading a JSON file.

<Frame caption="Selecting AltaDB data for RedBrick AI projects">
  <img src="https://mintcdn.com/redbrickai-c2e4bc62/09_FiR9sdsjqKqIA/assets/images/altadb/CleanShot%202024-08-30%20at%2012.28.03@2x.png?fit=max&auto=format&n=09_FiR9sdsjqKqIA&q=85&s=eaef0faf1aa019a5594ef5856227460f" alt="Export Options" width="890" height="120" data-path="assets/images/altadb/CleanShot 2024-08-30 at 12.28.03@2x.png" />
</Frame>

<Frame caption="Uploading JSON data">
  <img src="https://mintcdn.com/redbrickai-c2e4bc62/09_FiR9sdsjqKqIA/assets/images/altadb/RedBrick%20AI%202024-05-07%20at%2018.15.00@2x.png?fit=max&auto=format&n=09_FiR9sdsjqKqIA&q=85&s=8fd35303bdf1de44b460806f7a3785b1" alt="Uploading data to a project" width="3840" height="1920" data-path="assets/images/altadb/RedBrick AI 2024-05-07 at 18.15.00@2x.png" />
</Frame>

### Task Configuration Options

When creating tasks from AltaDB datasets, you can include:

* [Task and Series metadata](/python-sdk/formats/full-format-reference#items-list-and-tasksjson)
* [Task Priority](/projects/tasks-and-assignment#task-prioritization) for workflow optimization
* [Task pre-assignment](/projects/tasks-and-assignment#programmatically-assigning-tasks) to specific annotators
* [Pre-existing annotations](/python-sdk/formats/full-format-reference#segmentations-and-segmentmap) for review or refinement

<Frame caption="Task grouping options">
  <img src="https://mintcdn.com/redbrickai-c2e4bc62/09_FiR9sdsjqKqIA/assets/images/altadb/CleanShot%202024-08-30%20at%2012.29.08@2x.png?fit=max&auto=format&n=09_FiR9sdsjqKqIA&q=85&s=6944c596c3c98f3670c75079c23f0de4" alt="Group by Study" width="1150" height="366" data-path="assets/images/altadb/CleanShot 2024-08-30 at 12.29.08@2x.png" />
</Frame>

## Performance Demonstrations

Experience the speed improvements with AltaDB:

<Frame>
  <iframe className="w-full aspect-video" src="https://share.cleanshot.com/zTHQr8St/embed" />
</Frame>

<Frame>
  <iframe className="w-full aspect-video" src="https://share.cleanshot.com/KYgyy4JM/embed" />
</Frame>

## Getting Help

For assistance with AltaDB:

* Check the [RedBrick AI documentation](/)
* Contact support through your RedBrick AI dashboard
* Visit our [troubleshooting guide](/troubleshooting/master-guide)
