`@antv/scale`

0.3 版本不兼容之前 0.1.X，大体上兼容 0.2.x 版本，一些差异在最下面列出

Description

scale 有很多中文名，标度、度量、比例尺等等。它是数据空间到图形空间的转换桥梁，负责将数据从数据空间（定义域）转换为图形属性空间区域（值域），下文都称为度量。

例如：

或者

Usage

import { getScale } from '@antv/scale';

const Linear = getScale('linear');

// 详情可参考单测用例
const scale = new Linear({
  min: 0,
  max: 100,
  range: [0, 1],
});

scale.scale(30); // 0.3
scale.invert(0.3); // 30
scale.getText(30); // '30'

API

Scale 度量模块提供了下面 3 大类的度量

分类度量：
- cat：分类度量
- timeCat: 时间分类度量
连续度量：
- linear: 线性度量
- time：连续的时间度量
- log: log 度量
- pow: pow 度量
- quantize：分段度量，用户可以指定不均匀的分段
- quantile: 等分度量，根据数据的分布自动计算分段
常量度量
- identity: 常量度量这些度量的使用通过 getScale 方法来获取

import { getScale } from '@antv/scale';

const Linear = getScale('linear');
const TimeCat = getScale('timeCat');

度量的属性大部分一致，可以将属性分为：

通用属性：所有度量都适用的属性
度量的专有属性：个别度量专有的属性，对其他度量无意义

通用属性

名称	类型	说明
type	string	度量类型
values	any[]	定义域
min	any	定义域的最小值，在分类型度量中为序号
max	any	定义域的最大值
range	[number, number]	值域的最小、最大值
tickCount	number	期望的 tick 数量，非最终结果
formatter	func(value, index)	格式化函数，用于 tooltip、tick 等展示
tickMethod	string	func(scale)

通用的 Methods

所有的 Scale 仅开放下面的方法，不提供任何其他方法

名称	类型	说明
scale	(value: any): number	将定义域的输入值转换为值域的输出值
invert	(scaled: number): any	将值域的输入值转换为定义域的输出值
translate	(value: any): number	分类型度量中，将定义域转化为序号
clone	(): void	复制度量实例
getTicks	(): Tick[]	获取所有 ticks 集合
getText	(value: any): string	获取输入值的展示结果
change	(cfg)	修改度量

专有属性

这里除了列举各个度量专有的属性，和一些属性适合的取值，例如 tickMethod 方法不同的度量适合的计算方式不一样，任意设置可能达不到想要的效果

pow

| 名称 | 类型 | 说明 | | exponent | number | 指数 |

log

| 名称 | 类型 | 说明 | | base | number | 对数底数 |

与 2.x 的兼容性问题

新增的属性

tickMethod：2.x 计算 ticks 的算法都是固定在各个度量内部，3.x 中提供了用户改变计算 ticks 算法的接口
min, max：3.x 中 cat、timeCat 类型的 min, max 可以指定