---
auto_generated: true
created: 2026-05-18
manual_updated_at: 2026-05-18
modified: 2026-05-18
name: User_Manual
status: active
tags:
- client/oliver
- domain/ai
- domain/analytics
- tech/claude
- tech/react
- type/sop
type: sop
---

# OliVAS User Manual

## What This Tool Does
OliVAS (OLIVER Visual Attention Suite) is an open-source web application designed for creative teams, designers, and marketers. It predicts where human eyes will look in an image during the first 3-5 seconds of viewing. 

Instead of using physical eye-tracking hardware, OliVAS uses advanced machine learning models to generate:
- **Saliency Heatmaps**: Visual overlays showing predicted attention intensity.
- **Gaze Sequence Predictions**: Numbered points showing the predicted order of scanning.
- **Hotspot Detection**: Identification of the top 5 attention regions.
- **AI Design Analysis**: Optional insights powered by Claude Sonnet 4.6, referencing specific visual elements to provide actionable recommendations.

## Who Uses It
- **Designers**: To validate layout hierarchy and focal points.
- **Marketers**: To optimize ad creatives for maximum engagement.
- **Creative Directors**: To provide data-driven feedback on visual assets.

## How to Access
1. Navigate to the OliVAS application URL.
2. Click **"Sign in with Microsoft"**.
3. If you do not have an Oliver agency account, access will be denied. Contact your IT administrator if you believe you should have access.

## Main Workflows

### 1. Creating a Project
1. Log in to the Dashboard.
2. Click **"Create Project"** in the top right corner.
3. Enter a **Project Name** and optional **Description**.
4. Click **"Create"**.
5. You will be redirected to the Project Detail page.

### 2. Analyzing an Image
1. From the **Dashboard** or **Project Detail** page, click **"Analyze"** or **"Create New Analysis"**.
2. Upload an image file.
3. Select a **Model**:
   - **DeepGaze I**: Fast, baseline saliency.
   - **DeepGaze IIE**: **Recommended** for best accuracy.
   - **DeepGaze III**: High-resolution detail.
4. Click **"Analyze"**.
5. Wait for the analysis to complete. You will be redirected to the **Analysis View**.

### 3. Interpreting Results (Analysis View)
Once on the Analysis View page, you can explore several tabs:

#### Heatmap Tab
- Toggle **Opacity** to adjust the visibility of the saliency heatmap overlay.
- Select a **Colormap** (Jet, Viridis, Inferno, etc.) to change how intensity is displayed.
- The red/hot areas indicate high predicted attention.

#### Gaze Sequence Tab
- View **numbered fixation points** (1, 2, 3...) showing the predicted order viewers will scan the image.
- Use this to understand the visual path created by your design.

#### Hotspots Tab
- See the **top 5 attention regions** ranked by intensity.
- Bounding boxes highlight these key areas.

#### AOI (Areas of Interest)
- Draw rectangles over specific design elements.
- The tool calculates **Attention %** (how much attention the element gets), **Area %** (size relative to image), and **Attention Density** for the selected area.

#### Insights Tab
- **Rule-Based Insights**: Automatic metrics including:
  - **Attention Score**: 0-100 concentration score.
  - **Focal Dominance**: How much one area dominates the view.
  - **Spatial Balance**: Distribution of attention across the image.
  - **Edge Risk**: Potential for attention drifting off the edges.
- **AI Design Analysis**: If enabled, view text-based insights from Claude Sonnet 4.6. These reference specific visual elements and provide actionable design recommendations.

#### PDF Report
- Click **"Download PDF Report"** to generate a professional document containing:
  - All visualizations (heatmaps, gaze sequences).
  - Metrics (Hotspots, AOI data).
  - Rule-based and AI insights.
  - Montserrat typography for readability.

### 4. Comparing Designs
1. Navigate to two different analyses.
2. Use the **Comparison View** feature.
3. View side-by-side metrics and heatmaps to evaluate performance differences.

## FAQ

**Q: Why is my analysis taking a long time?**
A: Depending on the model selected (DeepGaze IIE/III) and server load, analysis may take several seconds. DeepGaze IIE is recommended for a balance of speed and accuracy.

**Q: Can I use OliVAS for external client work?**
A: Yes, if you have an Oliver agency account. Ensure you comply with your organization's data privacy policies regarding client images.

**Q: What is the "Attention Score"?**
A: It is a 0-100 metric measuring how focused the predicted attention is. A higher score (e.g., >55) indicates a strong focal point, while a lower score suggests a diffuse or scattered gaze pattern.

**Q: How do I get AI Insights?**
A: AI Insights are optional and require an Anthropic API key to be configured in the backend. If available, they will appear in the Insights tab. If not, only rule-based insights will be shown.

**Q: Can I delete an analysis?**
A: Yes, from the Analysis View or Project Detail page, use the **"Delete"** button. This action is usually irreversible.