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

# Performance Test

> Run built-in browser performance diagnostics, benchmark hardware and network speeds, and export diagnostic reports for RedBrick AI.

The **Performance Test** (also referred to as **Performance Diagnostics**) is a built-in benchmarking tool inside the RedBrick AI web application. It evaluates your browser, hardware (CPU, GPU, memory), and network connection against realistic medical imaging workloads.

Running a performance test helps verify that your machine meets recommended performance thresholds for handling complex 2D slices, 3D volume rendering, large multi-frame DICOM files, and computationally heavy segmentation algorithms.

***

## When to Run a Performance Test

* **Experiencing Slowdowns**: If viewing, slicing, or 3D volume rendering feels sluggish or drops frames.
* **Troubleshooting Issues**: When working with the RedBrick AI support team to identify client-side bottlenecks (e.g., hardware acceleration or network latency).
* **Evaluating Workstations**: Benchmarking annotator or radiologist hardware before onboarding them onto large annotation projects.
* **Hardware/Browser Comparison**: Comparing performance across different browsers (e.g., Chrome vs. Edge) or hardware setups.

***

## How to Access and Run the Test

**1. Open the Help Menu**

In the bottom-right corner of the RedBrick AI web app, click the **Help** (`?`) icon to open the help menu.

**2. Select Performance Test**

Click **Performance Test** from the menu options.

![Performance Test menu](https://mintcdn.com/redbrickai-c2e4bc62/cstZHsBFobULR0NV/assets/images/troubleshooting/performance-test/menu.png?fit=max\&auto=format\&n=cstZHsBFobULR0NV\&q=85\&s=4612da9e36f77563dd279efe3fb6a30e)

> [!NOTE]
>
> You can also open diagnostics directly in your browser by navigating to `/<your-org-id>/performance-test` (e.g., `https://app.redbrickai.com/my-org/performance-test`).

**3. Start Diagnostics**

Click **Start Diagnostics** in the top toolbar of the modal. The suite runs through 5 test
categories sequentially while displaying real-time progress.

![Performance Test action](https://mintcdn.com/redbrickai-c2e4bc62/cstZHsBFobULR0NV/assets/images/troubleshooting/performance-test/action.png?fit=max\&auto=format\&n=cstZHsBFobULR0NV\&q=85\&s=32eb213acc1542eb287e0bfe97649b5a)

**4. Review the Results**

Once all tests complete, you will see an overall **Local Score** (0–100%), category breakdown, execution duration, and pass/fail indicators.

***

## Test Categories

The performance suite executes realistic imaging tasks divided into five core categories:

> [accordion] 1. Network Throughput
>
> Measures download speed, transfer rates, and browser caching efficiency when fetching medical image files:
>
> * **Single File Download**: Tests latency and retrieval speed for an individual DICOM object.
> * **Concurrent Downloads**: Measures parallel download throughput when fetching multiple files simultaneously.
> * **Large File Download**: Benchmarks cold download performance for large volumetric files (such as NIfTI volumes).
> * **Cached Download**: Verifies warm-cache retrieval speeds from local storage.

> [accordion] 2. Image Parsing
>
> Evaluates how quickly your browser decodes DICOM datasets: - **Single Image Decompression**:
> Measures single-threaded JPEG 2000 decompression latency. - **Parallel Decompression**: Measures
> throughput when decompressing multiple image frames concurrently across Web Workers. - **Header
> Parsing Batch**: Measures raw DICOM metadata parsing performance independent of image
> decompression.

> [accordion] 3. Image Reconstruction
>
> Measures the speed of building viewable 2D slices and 3D volumes in memory: - **2D Single Slice
> Reconstruction**: Time required to build an individual diagnostic slice from a DICOM series. -
> **2D Batch Reconstruction**: Sustained multi-slice reconstruction throughput. - **3D DICOM Volume
> Reconstruction**: Construction speed for full volumetric arrays used in MPR and 3D views.

> [accordion] 4. Interactive Rendering
>
> Measures graphical rendering performance and framerate stability in frames per second (FPS): -
> **2D Slice Rendering**: Steady-state framerate when viewing diagnostic 2D slices (Target: \~60
> FPS). - **3D Volume Rendering**: Framerate under volumetric 3D view rendering (Target: \~45 FPS). -
> **Interactive Rendering**: Framerate under continuous viewport manipulation, camera panning, and
> 3D rotation (Target: \~40 FPS).

> [accordion] 5. Compute Algorithms
>
> Benchmarks WebAssembly and CPU-intensive computation used in semi-automated segmentation workflows:
>
> * **Connected Threshold 2D**: Region-growing threshold calculations on a 2D slice.
> * **Fill Holes (2D & 3D)**: Morphological hole-filling operations on binary segmentation masks.
> * **Level Set (2D & 3D)**: Active contour and level-set segmentation refinements.
> * **Mask Dilate 3D**: 3D morphological dilation passes commonly applied during volume brush edits.

***

## Baselines & Scoring

* **Overall Local Score**: A weighted composite score (0–100%) synthesized across all five categories. Rendering, reconstruction, and compute algorithms carry higher weighting due to their direct impact on viewer interactivity.
* **Default Benchmarks**: By default, each test is measured against pre-defined performance benchmarks (e.g. 60 FPS for 2D rendering, sub-second execution for parsing and reconstruction tasks).
* **Set Current Run as 100%**: Saves the current machine's benchmark to your browser's local storage. This calibrates future runs against your specific hardware environment, making it easy to identify performance regressions or improvements over time.
* **Clear Baseline**: Resets your local calibration and restores the default global benchmarks.

***

## Exporting & Sharing Diagnostics

After running diagnostics, you can easily share your results with the RedBrick AI team:

| Action | Description |
| :- | :- |
| **Copy Summary** | Copies a concise text summary to your clipboard, including overall score, key bottlenecks, and category stats. |
| **Download Report** | Exports a detailed JSON file (`redbrick-performance-report-<timestamp>.json`) containing full hardware profiling, WebGL/WebGPU specs, heap memory deltas, and subtest metrics. |
| **Run Again** | Re-executes the test suite to verify consistency or re-evaluate after changing browser settings/extensions. |

> [!TIP]
>
> When contacting [support@redbrickai.com](mailto:support@redbrickai.com) regarding rendering lag or
> viewport issues, attach the exported JSON report to help our engineers quickly diagnose device- or
> browser-specific bottlenecks.
