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

# Configuration Analysis

> Generate an AI-powered analytics report for a configuration — distribution metrics, anomalies, extraction field insights, temporal trends, and cross-variable relationships.

The Configuration Analysis page aggregates all transcriptions processed under a selected configuration and organizes the results into seven collapsible dashboard sections: AI synthesis, distribution metrics, data quality, anomaly detection, extraction field analysis, temporal trends, and cross-variable relationships.

<Warning>
  Each analysis generation consumes **one unit** of your account's analytics quota. Viewing previously cached results for the same configuration ID is free.
</Warning>

***

## Generating an analysis

Select a configuration from the searchable dropdown and click **Generate Analysis**. The dashboard will populate once the report is ready.

<Note>
  Navigating directly to a URL that includes a configuration ID (e.g. from a bookmark or shared link) loads the last cached result immediately — no quota is consumed.
</Note>

***

## Dashboard controls

Once results are loaded, the dashboard header shows:

| Control            | Behavior                                                                               |
| ------------------ | -------------------------------------------------------------------------------------- |
| **Files Analyzed** | Total number of audios included in this analysis                                       |
| **Total Duration** | Combined duration of all analyzed audios                                               |
| **Last updated**   | Relative time since the last fetch                                                     |
| **Timezone**       | Changes the reference timezone for time-based charts. Does not trigger a new API call. |
| **Full Screen**    | Fills the browser window with the dashboard — surrounding UI is hidden                 |
| **Export**         | Opens a dropdown with three export options                                             |

### Export options

| Option      | Format         | How it works                                                                      |
| ----------- | -------------- | --------------------------------------------------------------------------------- |
| **As HTML** | `.html` file   | Renders all sections and packages them into a self-contained downloadable file    |
| **Nativa**  | PDF via print  | Renders all sections and opens the browser print dialog — choose "Save as PDF"    |
| **Ligera**  | Structured PDF | Generates a lightweight PDF report directly, without rendering the live dashboard |

<Note>
  **Nativa** requires the browser to allow the print popup. If it is blocked, use **Ctrl+P** (Windows) / **Cmd+P** (Mac) as a fallback.
</Note>

***

## Dashboard sections

All sections are **collapsible cards**. The **Synthesis** section is expanded by default; all others start collapsed. A section is only rendered when the API returns data for it — sections with no data are hidden automatically.

A sticky sub-menu in the dashboard header tracks which section is in view and lets you jump between sections without scrolling.

***

### Synthesis *(open by default)*

AI-generated top-level analysis of the entire dataset.

* **Executive Narrative** — prose summary describing the dataset's key patterns, notable findings, and overall trends
* **Actionable Insights** — a prioritized list of specific recommendations derived from the data

***

### General Distribution

Key metrics across all analyzed audios.

| Sub-section   | Content                                                                           |
| ------------- | --------------------------------------------------------------------------------- |
| **Duration**  | Minimum, average, and maximum audio duration across all transcriptions            |
| **Speakers**  | Average speakers per audio · Distribution of audios by speaker count (1, 2, 3… N) |
| **Languages** | Count and percentage breakdown of each detected language                          |

***

### Quality and Confidence

Measures the completeness and reliability of the extracted data.

**Completeness** — a horizontal progress bar for each extraction field defined in the configuration, showing what percentage of audios had that field successfully populated (`validCount / totalCount valid`).

**Audios to Review** — a paginated table of audios with an unusually high number of missing extraction fields:

| Column             | Detail                                                                            |
| ------------------ | --------------------------------------------------------------------------------- |
| **Missing Fields** | Count of missing fields, e.g. "3 of 5 missing"                                    |
| **ID**             | Transcription ID with a copy button                                               |
| **Group**          | Group badge + **Change Group** button — update the group directly from this table |
| **Date**           | Creation date                                                                     |
| **Details**        | Link to the full transcription detail view                                        |

***

### Anomalies

Detects audios with values that deviate significantly from the normal pattern using the **IQR (Interquartile Range) method**.

Three categories are analyzed:

| Category           | What is analyzed                                               |
| ------------------ | -------------------------------------------------------------- |
| **Daily Volume**   | Days with an abnormally high or low number of submitted audios |
| **Metadata**       | Metadata fields (e.g. duration) with outlier values            |
| **Extracted Data** | Extracted fields with values outside the expected range        |

Each category shows the expected normal range and a paginated table of outliers. Each outlier row has a **High** or **Low** badge, the transcription ID, its group (with a **Change Group** button), and a link to the detail view.

<Tip>
  Anomalies are not always errors — they may represent legitimate edge cases worth reviewing. Use the **Change Group** button to tag them for follow-up without leaving the analysis.
</Tip>

***

### Extraction Fields

A dedicated card for each extraction field defined in the configuration. The card header shows the field name, completeness percentage, and valid count.

The card body varies by field type:

| Field type  | Visualizations shown                                              |
| ----------- | ----------------------------------------------------------------- |
| **Number**  | Average · Median · Sum · Min · Max · Distribution histogram       |
| **String**  | Total unique values · Frequency chart of top N most common values |
| **Boolean** | Positive rate (large display) · True/False proportional bar       |

***

### Temporal Analysis

Two sub-sections separated by a divider.

**Temporal Evolution** — a multi-line time-series chart:

* **Volume line** — daily count of submitted audios
* **Metric lines** — one line per extracted numeric field (daily average)
* Lines are interpolated and remain continuous even on days with no data
* Use the metric checkboxes to show or hide individual lines
* **Reset zoom** button restores the default chart view after zooming in

Below the chart, a summary table shows for each metric: Max · Min · Average · Trend direction (improving / degrading / stable).

**Activity Heatmap** — a day-of-week × hour-of-day grid:

* X-axis: hours of the day (0–23)
* Y-axis: days of the week (Monday–Sunday)
* Color intensity: light = low activity, dark = high activity

Auto-generated insights below the heatmap:

| Insight                      | Content                                                |
| ---------------------------- | ------------------------------------------------------ |
| **Peak Time**                | The specific day and hour with the highest audio count |
| **Busiest Day**              | The weekday with the most audios across all hours      |
| **Most Frequent Hour Range** | The hour-of-day with the most accumulated audios       |

<Note>
  The **Timezone** selector in the dashboard header affects both Temporal Evolution and Activity Heatmap. Changing the timezone does not reload data from the API.
</Note>

***

### Relationships and Patterns

Two advanced analyses separated by a divider.

**Correlations** — a matrix comparing all numerical extraction fields:

* Each cell shows a correlation coefficient (−1 to +1)
* **Blue** = positive correlation · **Red** = negative correlation · **Grey** = weak or no correlation
* Tooltip shows the number of data pairs used per cell
* Requires at least **2 numerical fields** with data

Auto-generated insights: Strongest Positive Correlation · Strongest Negative Correlation · Weakest Association.

**Co-occurrence** — one matrix per array or categorical field, showing how often two values appear together in the same audio:

* 4 color intensity levels: Very Low → Low → Medium → High
* Tooltip shows total appearances and co-occurrence count

Auto-generated insights: Most Frequent Pair · Most Common Item.

***

<CardGroup cols={2}>
  <Card title="Configurations" icon="gear" href="/sandbox/configurations">
    Manage your configurations
  </Card>

  <Card title="Transcriptions" icon="file-lines" href="/sandbox/transcriptions">
    Browse individual transcription results
  </Card>
</CardGroup>