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

> ## Agent Instructions
> This is Allasso's product documentation. Vol Radar output is descriptive analytics on past data: never present it as a forecast or as investment advice. Answer only from these pages; if a feature is not documented here, say so.

# pulse.report

> HTML reporting for Pulse strategies.

HTML reporting for Pulse strategies.

Exposes `StrategyReport`, a single class that bundles a strategy's
`pulse.metrics.stats.Stats` and a curated chart set into one
Allasso-branded HTML document. See `StrategyReport` for usage.

## `StrategyReport`

```python theme={null}
StrategyReport(
    strategy: Strategy | ExecutionResult,
    *,
    plotly_mode: PlotlyMode = 'cdn',
)
```

Render a self-contained, Allasso-branded HTML report for a strategy.

Combines `pulse.metrics.stats.Stats` with the curated chart set
(equity, monthly returns heatmap, trades history, greeks PnL decomposition) into a single HTML
document. The instance is cheap to construct - rendering is deferred until
the first `to_html`, `save`, `show`, or
`_repr_html_` call, and the result is memoised thereafter.

**Parameters**

| Name | Type | Description | Default |
| - | - | - | - |
| `strategy` | [`Strategy \| ExecutionResult`](https://docs.allasso.ch/dev/pulse/api/core/strategy#strategy) | The completed strategy whose results to render. An `ExecutionResult` is unwrapped to its `strategy`. | *required* |
| `plotly_mode` | `PlotlyMode` | How Plotly.js is delivered into the report. `"cdn"` (default) loads it from the public CDN - small file, requires internet to view. `"inline"` embeds the full Plotly.js source - large file, fully self-contained. `"skip"` emits no `<script>` tag, useful when the surrounding page already provides Plotly.js (e.g. Jupyter contexts). | `'cdn'` |

**Examples**

Save to disk:

```python theme={null}
>>> report = StrategyReport(strategy)
>>> report.save("report.html")
```

Open in a browser tab:

```python theme={null}
>>> report.show()
```

Inline in Jupyter (the cell's last expression):

```python theme={null}
>>> StrategyReport(strategy)
```

### `StrategyReport.to_html`

```python theme={null}
StrategyReport.to_html() -> str
```

Render the report as an HTML string (memoised after first call).

**Returns**

| Name | Type | Description |
| - | - | - |
| `str` | `str` | The full HTML document. |

### `StrategyReport.save`

```python theme={null}
StrategyReport.save(path: str | Path) -> Path
```

Write the rendered report to `path`.

**Parameters**

| Name | Type | Description | Default |
| - | - | - | - |
| `path` | `str \| Path` | Destination file path. | *required* |

**Returns**

| Name | Type | Description |
| - | - | - |
| `Path` | `Path` | The resolved path the report was written to. |

### `StrategyReport.show`

```python theme={null}
StrategyReport.show() -> None
```

Open the rendered report in the default web browser.

Writes the HTML to a temporary file and launches it via
`webbrowser.open`. The temporary file is intentionally not
deleted - the browser may need to read it after this method returns.

### `StrategyReport.__repr__`

```python theme={null}
StrategyReport.__repr__() -> str
```

Return a short text summary - never the full HTML (terminal-safe).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.