1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
|
{{alias}}( [data,] [options] )
Returns a sparkline win/loss chart instance.
Glyphs:
| Value | Glyph |
|:-----:|:-----:|
| 1 | ╵ |
| -1 | ╷ |
| 2 | └ |
| -2 | ┌ |
If a `2` or `-2` is preceded by a `2` or `-2`,
| Value | Glyph |
|:-----:|:-----:|
| 2 | ┴ |
| -2 | ┬ |
Based on the win/loss analogy,
- 1: win away
- 2: win at home
- -1: loss away
- -2: loss at home
If provided any value other than 1, -1, 2, or -2, the value is encoded as a
missing value.
The `data` argument takes precedence over the `data` option.
Parameters
----------
data: ArrayLike|ndarray (optional)
Chart data.
options: Object (optional)
Options.
options.autoRender: boolean (optional)
Boolean indicating whether to re-render on a 'change' event. Default:
false.
options.bufferSize: integer|null (optional)
Data buffer size. If provided, data is kept in a first-in first-out
(FIFO) buffer which cannot exceed the buffer size. Default: +infinity.
options.data: ArrayLike|ndarray (optional)
Chart data.
options.description: string (optional)
Chart description.
options.isDefined: Function (optional)
An accessor function indicating whether a datum is defined.
options.label: string (optional)
Data label.
Returns
-------
chart: WinLossChart
Chart instance.
chart.autoRender
Rendering mode. If `true`, an instance renders on each 'change' event;
otherwise, rendering must be triggered manually.
chart.bufferSize
Data buffer size.
chart.description
Chart description.
chart.data
Chart data.
chart.label
Data label.
chart.isDefined( d, i )
An accessor function which defines whether a datum is defined. This
accessor is used to define how missing values are encoded. The default
behavior is to ignore any values which are not 1, -1, 2, or -2.
chart.render()
Renders a win/loss chart sparkline.
Examples
--------
> var data = [ -2, 1, 2, 2, 1, -1, -1, 1 ];
> var chart = new {{alias}}( data );
> chart.render()
'┌╵└┴╵╷╷╵'
See Also
--------
|
