Method Values

widgets/heatmap/heatmap.go:90–124

Values sets the values to be displayed by the HeatMap. Each value in values has a xLabel and a yLabel, which means len(yLabels) == len(values) and len(xLabels) == len(values[i]). But labels could be empty strings. When no labels are provided, labels will be "0", "1", "2"... Each call to Values ove

(xLabels []string, yLabels []string, values [][]float64, opts ...Option)

// Each call to Values overwrites any previously provided values.
// Provided options override values set when New() was called.
func (hp *HeatMap) Values(xLabels []string, yLabels []string, values [][]float64, opts ...Option) error {
	clonedValues, minValue, maxValue, err := cloneValues(values)
	if err != nil {
		return err
	}

	nextOpts := *hp.opts
	for _, opt := range opts {
		opt.set(&nextOpts)
	}
	if err := nextOpts.validate(); err != nil {
		return err
	}

	rows := len(clonedValues)
	cols := len(clonedValues[0])
	xs, err := normalizeLabels(xLabels, cols)
	if err != nil {
		return fmt.Errorf("invalid x labels: %w", err)
	}
	ys, err := normalizeLabels(yLabels, rows)
	if err != nil {
		return fmt.Errorf("invalid y labels: %w", err)
	}

	hp.mu.Lock()
	defer hp.mu.Unlock()
	hp.values = clonedValues
	hp.xLabels = xs
	hp.yLabels = ys
	hp.minValue = minValue
	hp.maxValue = maxValue
	hp.opts = &nextOpts
	return nil
}

// ClearXLabels clear the X labels.
func (hp *HeatMap) ClearXLabels() {