// Copyright 2019 Google Inc. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package axes // scale.go calculates the scale of the Y axis. import ( "fmt" "github.com/mum4k/termdash/canvas/braille" "github.com/mum4k/termdash/numbers" ) // YScale is the scale of the Y axis. type YScale struct { // Min is the minimum value on the axis. Min *Value // Max is the maximum value on the axis. Max *Value // Step is the step in the value between pixels. Step *Value // CvsHeight is the height of the canvas the scale was calculated for. CvsHeight int // brailleHeight is the height of the braille canvas based on the CvsHeight. brailleHeight int } // NewYScale calculates the scale of the Y axis, given the boundary values and // the height of the canvas. The nonZeroDecimals dictates rounding of the // calculated scale, see NewValue for details. // Max must be greater or equal to min. The cvsHeight must be a positive // number. func NewYScale(min, max float64, cvsHeight, nonZeroDecimals int) (*YScale, error) { if max < min { return nil, fmt.Errorf("max(%v) cannot be less than min(%v)", max, min) } if min := 1; cvsHeight < min { return nil, fmt.Errorf("cvsHeight cannot be less than %d, got %d", min, cvsHeight) } brailleHeight := cvsHeight * braille.RowMult usablePixels := brailleHeight - 1 // One pixel reserved for value zero. diff := max - min step := NewValue(diff/float64(usablePixels), nonZeroDecimals) return &YScale{ Min: NewValue(min, nonZeroDecimals), Max: NewValue(max, nonZeroDecimals), Step: step, CvsHeight: cvsHeight, brailleHeight: brailleHeight, }, nil } // PixelToValue given a Y coordinate of the pixel, returns its value according // to the scale. The coordinate must be within bounds of the canvas height // provided to NewYScale. Y coordinates grow down. func (ys *YScale) PixelToValue(y int) (float64, error) { pos, err := yToPosition(y, ys.brailleHeight) if err != nil { return 0, err } switch { case pos == 0: return ys.Min.Rounded, nil case pos == ys.brailleHeight-1: return ys.Max.Rounded, nil default: v := float64(pos) * ys.Step.Rounded if ys.Min.Value < 0 { diff := -1 * ys.Min.Rounded v -= diff } return v, nil } } // ValueToPixel given a value, determines the Y coordinate of the pixel that // most closely represents the value on the line chart according to the scale. // The value must be within the bounds provided to NewYScale. Y coordinates // grow down. func (ys *YScale) ValueToPixel(v float64) (int, error) { if min, max := ys.Min.Value, ys.Max.Rounded; v < min || v > max { return 0, fmt.Errorf("invalid value %v, must be in range %v <= v <= %v", v, min, max) } if ys.Step.Rounded == 0 { return 0, nil } if ys.Min.Value < 0 { diff := -1 * ys.Min.Rounded v += diff } pos := int(numbers.Round(v / ys.Step.Rounded)) return positionToY(pos, ys.brailleHeight) } // CellLabel given a Y coordinate of a cell on the canvas, determines value of // the label that should be next to it. The Y coordinate must be within the // cvsHeight provided to NewYScale. Y coordinates grow down. func (ys *YScale) CellLabel(y int) (*Value, error) { pos, err := yToPosition(y, ys.CvsHeight) if err != nil { return nil, err } pixelY, err := positionToY(pos*braille.RowMult, ys.brailleHeight) if err != nil { return nil, err } v, err := ys.PixelToValue(pixelY) if err != nil { return nil, err } return NewValue(v, ys.Min.NonZeroDecimals), nil } // XScale is the scale of the X axis. type XScale struct { // Min is the minimum value on the axis. Min *Value // Max is the maximum value on the axis. Max *Value // Step is the step in the value between pixels. Step *Value // AxisWidth is the width of the canvas that is available to the X axis. AxisWidth int // brailleWidth is the height of the braille canvas based on the AxisWidth. brailleWidth int } // NewXScale calculates the scale of the X axis, given the number of data // points in the series and the width on the canvas that is available to the X // axis. The nonZeroDecimals dictates rounding of the calculated scale, see // NewValue for details. // The numPoints must be zero or positive number. The axisWidth must be a // positive number. func NewXScale(numPoints int, axisWidth, nonZeroDecimals int) (*XScale, error) { if numPoints < 0 { return nil, fmt.Errorf("numPoints cannot be negative, got %d", numPoints) } if min := 1; axisWidth < min { return nil, fmt.Errorf("axisWidth must be at least %d, got %d", min, axisWidth) } brailleWidth := axisWidth * braille.ColMult usablePixels := brailleWidth - 1 // One pixel reserved for value zero. const min float64 = 0 max := float64(numPoints - 1) if max < 0 { max = 0 } diff := max - min step := NewValue(diff/float64(usablePixels), nonZeroDecimals) return &XScale{ Min: NewValue(min, nonZeroDecimals), Max: NewValue(max, nonZeroDecimals), Step: step, AxisWidth: axisWidth, brailleWidth: brailleWidth, }, nil } // PixelToValue given a X coordinate of the pixel, returns its value according // to the scale. The coordinate must be within bounds of the canvas width // provided to NewXScale. X coordinates grow right. func (xs *XScale) PixelToValue(x int) (float64, error) { if min, max := 0, xs.brailleWidth; x < min || x >= max { return 0, fmt.Errorf("invalid x coordinate %d, must be in range %v < x < %v", x, min, max) } switch { case x == 0: return xs.Min.Rounded, nil case x == xs.brailleWidth-1: return xs.Max.Rounded, nil default: return float64(x) * xs.Step.Rounded, nil } } // ValueToPixel given a value, determines the X coordinate of the pixel that // most closely represents the value on the line chart according to the scale. // The value must be within the bounds provided to NewXScale. X coordinates // grow right. func (xs *XScale) ValueToPixel(v int) (int, error) { fv := float64(v) if min, max := xs.Min.Value, xs.Max.Rounded; fv < min || fv > max { return 0, fmt.Errorf("invalid value %v, must be in range %v <= v <= %v", v, min, max) } if xs.Step.Rounded == 0 { return 0, nil } return int(numbers.Round(fv / xs.Step.Rounded)), nil } // CellLabel given an X coordinate of a cell on the canvas, determines value of the // label that should be next to it. The X coordinate must be within the // axisWidth provided to NewXScale. X coordinates grow right. func (xs *XScale) CellLabel(x int) (*Value, error) { if min, max := 0, xs.AxisWidth; x < min || x >= max { return nil, fmt.Errorf("invalid cell coordinate %d, must be in range %v <= x < %v", x, min, max) } v, err := xs.PixelToValue(x * braille.RowMult) if err != nil { return nil, err } return NewValue(v, xs.Min.NonZeroDecimals), nil } // positionToY, given a position within the height, returns the Y coordinate of // the position. Positions grow up, coordinates grow down. // // Positions Y Coordinates // 2 | 0 // 1 | 1 // 0 | 2 func positionToY(pos int, height int) (int, error) { max := height - 1 if min := 0; pos < min || pos > max { return 0, fmt.Errorf("position %d out of bounds %d <= pos <= %d", pos, min, max) } return max - pos, nil } // yToPosition is the reverse of positionToY. func yToPosition(y int, height int) (int, error) { max := height - 1 if min := 0; y < min || y > max { return 0, fmt.Errorf("Y coordinate %d out of bounds %d <= Y <= %d", y, min, max) } return -1*y + max, nil }