---
title: "Carpet plot panel plugin for Grafana"
description: "Carpet plot panel plugin for grafana. Carpet plot panel plugin for Grafana by Petr Slavotínek. Available in Grafana Cloud and self-managed Grafana."
---

> This is the Markdown version of https://grafana.com/grafana/plugins/petrslavotinek-carpetplot-panel/

# Carpet plot

- Developer: Petr Slavotínek
- Version: 0.1.2

Carpet plot panel plugin for grafana.

![Carpet plot - Screenshot 1 - Panel and options](https://raw.githubusercontent.com/petrslavotinek/grafana-carpetplot/master/dist/src/img/screenshot1.png)

![Carpet plot - Screenshot 2 - Panel](https://raw.githubusercontent.com/petrslavotinek/grafana-carpetplot/master/dist/src/img/screenshot2.png)

## How to use

This panel receives data series and divides all the data into individual buckets. It groups the data first by day and then by a selected fragment of a day (hour / 15 minutes / minute). If there are multiple data points in a bucket (for example there were multiple series) it aggregates the points using a selected function (average, sum, count).

The data are displayed in a grid where each bucket is presented by corresponding color calculated from a selected color scheme.

Tested with InfluxDb data source.

## Available options

### Display tab

- Colors

  - Mode: Mode of color scheme. Possibility to choose from Spectrum and Custom.

  - Spectrum Mode:

    - Scheme: Color scheme to represent data values.
    - Min: Minimum value corresponding to the leftmost color of the sceheme. If not set, is calculated as a minimum value in current visible data set.
    - Max: Maximum value corresponding to the rightmost color of the sceheme. If not set, is calculated as a maximum value in current visible data set.
    - Invert: inverts selected color schemes.

  - Custom Mode:

    - Space: Color space used to calculate transition between colors. (RGB, HSL, HCL, Lab, Cubehelix)
    - Color 1..N: Custom color. User can add and remove it, reorder them and select breakpoint value for each color. Breakpoint values are optional. Values between breakpoints are linearly interpolated.

  - Null Color: Color to represent buckets with null value.

- Data

  - Aggregate: Function used to aggregate values in a single bucket. (Average / Sum / Count / Min / Max / First / Last)
  - Fragment: Fragment of a day. (Hour, 15 minutes, Minute)
  - Decimals: Number of decimals displayed in tooltip and legend.
  - Unit: Unit format used in tooltip and legend.

- Tooltip:
  - Show: If selected, displays tooltip on hover.

- Legend:
  - Show: If selected, displays legend under graph.

### Axes tab

- X Axis:

  - Show weekends: If selected, displays lines marking beggining and end of weekends.
  - Min bucket width: Minimum required width of a bucket in px to enable displaying of weekend lines.
  - Show crosshair: If selected, displays crosshair in x axis on hover.
  - Hide labels: Hides X axis labels.
  - Label format: Changes format of X axis labels.

- Y Axis:

  - Show crosshair: If selected, displays crosshair in y axis on hover. WD = abbreviated weekday. M = month. D = day. Y = year.
  - Hide labels: Hides Y axis labels.

## Changelog

- 0.0.4
  - Chart now takes into account Override relative time settings in Time range tab.

- 0.0.3

  - Possibility to invert color scheme.
  - Possibility to change X axis label format.
  - Possibility to hide X axis labels.
  - Possibility to hide Y axis labels.

- 0.0.2
  - New aggregate functions: Min, Max, First, Last.

- 0.1.0

  - Possibility of custom colors.
  - Fixed compatibility with IE 11.

- 0.1.1
  - Fixed import of D3 library.