> ## 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.

# Export an HTML report

> report = StrategyReport(strategy) report.save("report.html") 

`StrategyReport` bundles a finished strategy's `Stats` grid, the curated chart set (equity, monthly
returns heatmap, trades history, greeks PnL decomposition), and a scrollable trades table into one
self-contained, Allasso-branded HTML document.

## Build and save

```python theme={null}
from pulse.report import StrategyReport

```

`StrategyReport` accepts a finished `Strategy` or an `ExecutionResult` (the wrapper returned by
`run_sequentially`); if you pass an `ExecutionResult` it pulls `.strategy` out for
you:

```python theme={null}
results = run_sequentially(strategies=[strat], initial_equity=1_000_000)
StrategyReport(results[0]).save("report.html")
```

Construction is cheap; rendering is deferred until the first `to_html`, `save`, `show`, or inline
display, then memoised. The methods:

* `to_html() -> str` - the full HTML document as a string.
* `save(path)` - write it to disk; returns the `Path`.
* `show()` - render and open it in a browser tab.

## Inline in Jupyter

`StrategyReport` implements `_repr_html_`, so making it the last expression in a cell renders it
inline:

```python theme={null}
StrategyReport(strategy, plotly_mode="skip")
```

## Choosing a plotly\_mode

`plotly_mode` controls how Plotly.js is delivered into the document. Pass it as a keyword:

| Mode | Size | Use it when |
| - | - | - |
| `"cdn"` (default) | small | The report will be viewed with internet access. Plotly.js loads from the public CDN. |
| `"inline"` | multi-MB | You need a fully self-contained file (offline viewing, emailing, archiving). The full Plotly.js source is embedded. |
| `"skip"` | smallest | The surrounding page already loads Plotly.js, e.g. a Jupyter notebook. No script tag is emitted. |

```python theme={null}
StrategyReport(strategy, plotly_mode="inline").save("report_offline.html")
```

> [!TIP]
>
> **Pick inline for anything you send to someone**
>
> A `"cdn"` report shows blank charts without a network connection. For a file that has to render
> anywhere, use `"inline"`; accept the larger size as the price of portability.

For the numbers in the stats grid and how returns are summarised, see
[Metrics and Stats](https://docs.allasso.ch/dev/pulse/concepts/metrics.md).

**Related:** [Metrics and Stats](https://docs.allasso.ch/dev/pulse/concepts/metrics.md) ·
[Reading results](https://docs.allasso.ch/dev/pulse/notebooks/reading-results.md) · [Charts](https://docs.allasso.ch/dev/pulse/how-to/charts.md)


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