Loading documentation...
Build structured engineering reports with block-based editing, viewer capture, cover page branding, and PDF export.
The Report tab provides a personal workspace for documenting your findings about a recording. It is separate from the AI Analysis report — this is your notes, observations, and conclusions.
Reports are built from blocks — modular content pieces that you arrange in any order. Block types range from free-text narrative and headings to live waveform charts, digital signal snapshots, measurement tables, phasor diagrams, event timelines, images, and a table of contents. The result is a structured engineering report that you can preview and export to PDF.
The editor supports a split-pane layout — Edit and Preview panels can be shown side-by-side, giving you a live preview while editing. The split divider is draggable.
When you first open the Report tab for a recording, you see an empty state with two options:
You can switch templates at any time, but this replaces all existing blocks.
The report toolbar is a compact, single-row control bar at the top of the Report tab. It provides quick access to all editor-level actions without taking up vertical space.
Report Tab — Toolbar
The toolbar is organized into logical groups separated by vertical dividers:
The filter searches across block type labels and content (heading text, narrative markdown, cover titles, captions). Non-matching blocks are dimmed with reduced opacity rather than hidden, so you can still see the overall report structure.
Click the Add Block button between any two blocks (or at the bottom) to insert a new block. The available block types are:
| Block Type | Description |
|---|---|
| Cover Page | Title page with report title, subtitle, author, date, organization, and optional custom logo |
| Table of Contents | Auto-generated from heading blocks — updates dynamically as you add/remove headings |
| Heading | Section heading (level 1, 2, or 3) for structuring the report |
| Text / Narrative | Free-text block with full Markdown support — headings, bold, italic, lists, tables, code blocks, and links |
| Waveform Chart | Embedded waveform plot showing selected analog and digital channels over a configurable time range. Opens a channel picker to choose which signals to include |
| Digital Signals | Captured digital signal panel from the waveform viewer, showing binary channel states |
| Measurements | Table of RMS values, phase angles, and instantaneous values for selected channels at a specific time point |
| Event Timeline | Chronological list of detected events — fault inception/clearance, digital signal transitions, and annotation markers |
| Annotations | Summary of all waveform annotations (or a filtered subset by ID) |
| Protection | Assessment summary from distance and/or overcurrent protection analysis |
| Phasor Snapshot | Captured phasor diagram image at a specific time — supports single and dual A/B cursor mode |
| Image / Photo | Upload any image (up to 2 MB) with a caption and adjustable width |
| Custom Table | Free-form table with editable headers and rows |
| Page Break | Forces a page break in the exported PDF |
Each block type has a unique color accent on the left border and a color-coded type badge, making it easy to scan the report structure at a glance.
Each block is displayed as a card with a header row and editable content area. The card anatomy is shown below.
Report Tab — Block Card Anatomy
Block-specific editing controls
Each block type renders its own editor here — text fields, channel pickers, time range inputs, image uploads, toggles, etc.
Every block header provides these actions:
The toolbar also provides a Collapse/Expand All button to toggle all blocks at once.
The Filter input in the toolbar searches across block types and content. When a search term is active:
This is helpful for quickly finding specific sections in long reports.
You can capture live viewer content directly into the report from two tabs:
On the Waveforms tab, click the Add to Report button in the bottom-right corner. A popup appears with two options:
The capture uses the current zoom level, visible channels, and annotations. Scrollbars are automatically hidden during capture for a clean image.
On the Phasors tab, click the Add to Report button. This captures the phasor diagram as it currently appears — including both diagrams if you are in A/B Compare mode. The A/B compare toggle button is automatically hidden from the captured image.
Both capture types create image blocks in the report that fill the full page width. The captured time and a caption field are included with each block.
Capture tips
The Cover Page block includes fields for:
In the preview, the cover page renders as a full-width header with the report metadata centered. The custom logo appears at the top of the cover.
The Table of Contents block is fully dynamic — it scans all heading blocks in the report and renders a hierarchical numbered list. There is nothing to configure; the TOC updates automatically as you add, remove, or reorder headings.
In the editor, the TOC block shows a read-only label ("Auto-generated from headings"). In preview and PDF, it renders a properly indented outline with H1, H2, and H3 levels.
Three built-in templates provide starting points for common report types:
A comprehensive report structure with cover page, table of contents, introduction, recorded waveforms, event chronology, measurements, protection assessment, and conclusions. Best for formal post-fault analysis.
Focused on relay performance evaluation — includes operating times, protection assessment, and measurement sections. Best for relay testing and commissioning reports.
A single-page summary with a waveform chart, measurement table, and event timeline. Best for quick internal documentation.
You can access templates from the Templates dropdown in the toolbar, even after starting a report.
Template replacement
Reports auto-save as part of the recording's display configuration. Every change you make is persisted automatically after a short debounce delay (2 seconds).
Each recording has exactly one user report. There is no separate save button — the auto-save handles everything.
Click the Export PDF button in the toolbar to generate a printable document. The export process:
The PDF includes all rendered content — cover page with logo, table of contents, narrative text, waveform charts, digital signal snapshots, measurement tables, phasor diagrams, uploaded images, and event timelines. Page Break blocks insert explicit breaks in the output.
The exported document title is automatically set to Report-{station name}-{date} based on the recording metadata.
Figures and tables are automatically numbered based on their order in the block list (Figure 1, Table 1, etc.) in both preview and PDF output.
PDF tips