Histogram view
Ta treść nie jest jeszcze dostępna w Twoim języku.
A Histogram view shows the average profile of numeric parameters over a repeating cycle, such as the 24 hours of a day or the 7 days of a week. Each bar is the average of all completed occurrences of that slot in the report window, for example the average power at 14:00 over the last month. The bars show average values, not how often values occur. To show intervals one after another instead, use time bars. Authors add it with Add histogram under Setup → Reports; viewers open it on the report page.
Settings
Section titled “Settings”| Setting | Field | Values | Default |
|---|---|---|---|
| Height | height | Plot height in pixels, 40–4000 | 280 |
| Legend | legend | None (none), Non-interactive (non-interactive), Interactive (interactive) | Interactive |
| Show tooltips | showTooltips | On or off | On |
| Time interval | cadence | Half-hours of the day (30m-of-day), Hours of the day (1h-of-day), Days of the week (1d-of-week), Hours of the week (1h-of-week), Days of the month (1d-of-month) | Hours of the day |
| Display as | displayAs | Grouped bars (neighbour-bars), Stacked bars (stacked-bars), Stacked fills (stacked-fills) | Grouped bars |
Grouped bars stand side by side in parameter order, left to right. Stacked bars and fills stack in parameter order, bottom to top. The histogram has no navigation, no comment markers, and no live updates.
Parameters
Section titled “Parameters”Under Parameters, Add numeric parameters lists numeric report parameters that are not already on this histogram; each can appear once. Move up and Move down reorder them.
| Setting | Field | Values | Default |
|---|---|---|---|
| Value per interval | perCadenceValue | First (first), Latest (latest), Average (average), Delta (delta), Sum (sum), Min (min), Max (max) | Delta |
| Decimal places | decimalPlaces | 0–12 | 2 |
| Scale multiplier | scaleMultiplier | Any number | 1 |
| Scale shift | scaleShift | Any number | 0 |
Value per interval is taken for each underlying interval (half hour, hour, or day) before the slots are averaged. Delta is the latest value in an interval minus the latest value in the previous interval of the same length; when the previous interval has no readings, the first value of the interval is used instead.
Removing a report parameter used here asks for confirmation and removes it from the view; an empty view stays.
On the report page
Section titled “On the report page”| Slots | Count |
|---|---|
| Half-hours of the day | 48 |
| Hours of the day | 24 |
| Days of the week | 7, Monday to Sunday |
| Hours of the week | 168 |
| Days of the month | 31 |
Each slot is the average of the completed occurrences of that slot in the window, in the report timezone. When the clock goes back for daylight saving time, both occurrences of the repeated hour count. A slot without completed occurrences is a gap. Partial days at the edges of the window still contribute their completed intervals.
The histogram appears once the whole window has loaded; the previous bars stay on screen while a new window loads. The Y axis always includes zero, and stacked segments sit on the previous segment.
Bars use the parameter’s Default color; zone colors are not used. The legend sits below the plot and shows a swatch, label, and units; with Interactive, clicking a parameter hides or shows it in every view of the report. Tooltips show the slot and each visible value in its own units with its Decimal places, without scale multiplier or shift. Scale multiplier and Scale shift change only the drawing; CSV export keeps the original values.
Clicking a slot does not change the time window. Errors are shown inside the view.
Related
Section titled “Related”- Report settings
- Report page
- Chart, table, time bars, calendar, hourly matrix, state duration, Sankey
- Readings API:
readings.cadenceat30m,1h, or1d(readings procedures)