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
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
|
# TextGraph
A small terminal utility which displays graphs as plain text,
with the goal of having few dependencies,
being lightweight, and reasonably performant.
It is meant to be used in a traditional unix way,
by piping data through it.
It was written because I sometimes have the need to
watch some state in a sql table for a short while.
The documentation is in the manual file `tg.1`.
It is only tested with glibc and terminals with ansi escape code support.
## Usage
You can compile it with `cargo build --release`,
there is also a script in `packaging` which can be used to make a `.deb`.
If you are on a debian based distro, you should be able to run `./packaging/package-debian.sh`.
Then a `textgraph.deb` file should be made somewhere in `/tmp/`.
There is a spec file for rpms as well, but I haven't gotten around to making a script to build for that.
If you compile with `cargo build --release`, you can copy it to your path, e.g.
```
sudo install target/release/textgraph /usr/local/bin/tg
sudo install tg.1 /usr/share/man/man1/tg.1
```
## Example 1
Some examples of the different modes, from the same input file with random numbers
### Star mode
```
100┌─────────────────────────────────────────────┐
89 │ * * │
79 │ * * * ** │
68 │ ** * * │
58 │ * * * * * * * │
47 │ * * * * * **│
37 │* * *** * * * * * │
26 │ * * * * * │
16 │ ** * * * │
5 └─────────────────────────────────────────────┘
```
### Ascii mode
```
100┌─────────────────────────────────────────────┐
89 │ ╭╮ ╭╮ │
79 │ ││╭╮ ╭╮ ╭╮ ╭─╮ ││ │
68 │ ╭─╯│││ ╭╯│ ││ ╭╮ │ │ ││ │
58 │╭╮ ╭╮ │ ││╰╮ │ │ ╭╮││ │╰╮│ │ ╭╮ ╭╯│ │
47 ││╰╮ │╰╮│ ││ ╰╮│ │ │││╰╮ │ ││ ╰╮││ │ │╭──┤
37 ├╯ │ │ ╰╯ ││ ││ ╰──╯╰╯ │ ╭╮│ ╰╯ ╰╯│ │ ╰╯ │
26 │ ╰╮ │ ╰╯ ╰╯ │╭╯││ │╭╯ │
16 │ ╰─╯ ╰╯ ╰╯ ╰╯ │
5 └─────────────────────────────────────────────┘
```
### Braille mode (Probably the most buggy mode)
```
100┌────────────────────┐
89 │ ⠄⠂ │
79 │ ⠄ │
68 │ ⠠ ⠂ ⠠ │
58 │⠠ ⠠ ⠄ ⠂⠠ │
47 │ ⠄ ⠂ ⠂│
37 │ ⠠ ⠂ ⠄ ⠐ ⠠ ⠐ │
26 │ ⠠ ⠂ ⠂ │
16 │⠂ ⠠ ⠂ ⠐ │
5 └────────────────────┘
```
## Example 2
Example of a simple sinusoid
### Star
```
10 ┌──────────────────────────────────────────────────────────────────────┐
8 │ ********** │
6 │ ***** ***** │
3 │ *** *** │
1 │ *** *** │
-1 │ *** *** │
-3 │ *** *** │
-6 │ **** **** │
-8 │******** **********│
-10└──────────────────────────────────────────────────────────────────────┘
```
### Ascii
```
10 ┌──────────────────────────────────────────────────────────────────────┐
8 │ ╭─────────╮ │
6 │ ╭────╯ ╰────╮ │
3 │ ╭──╯ ╰──╮ │
1 │ ╭──╯ ╰──╮ │
-1 │ ╭──╯ ╰──╮ │
-3 │ ╭──╯ ╰──╮ │
-6 │ ╭───╯ ╰───╮ │
-8 ├───────╯ ╰──────────┤
-10└──────────────────────────────────────────────────────────────────────┘
```
### Braille
```
10 ┌───────────────────────────────────┐
8 │ ⠠⠔⠊⠉⠉⠑⠢⠄ │
6 │ ⠔⠁ ⠈⠢ │
3 │ ⠠⠊ ⠑⠄ │
1 │ ⠔⠁ ⠈⠢ │
-1 │ ⠌ ⠡ │
-3 │ ⠠⠊ ⠑⠄ │
-6 │ ⠠⠔⠁ ⠈⠢⠄ │
-8 │⠤⠤⠤⠒⠁ ⠈⠒⠤⠤⠤⠒│
-10└───────────────────────────────────┘
```
## Manual
For reference, this is a translation of the manual page.
Best is to check to manual page itself, not the README `man -l tg.1`.
```
TG(1) General Commands Manual TG(1)
name
tg - TermGraph - Text graphing utility
SYNOPSIS
tg [-s|--silent] [-l|--last-n N] [-h|--height N] [-w|--width N] [-t
type]
DESCRIPTION
tg TermGraph is a utility for graphing
OPTIONS
-h, --help
Display help information.
-s, --silent
Disable distracting elements, such as axis and non-graph text.
-a, --ascii
Shorthand for -t ascii, if multiple options setting mode is
specified, the last will likely be respected.
-b, --braille
Shorthand for -t braille, if multiple options setting mode is
specified, the last will likely be respected.
-n, --last-n count
If specified, only the newest count samples will be plotted.
This can be useful if you want to follow the latest state of a
graph that is piped in.
-c, --cut
This is a special case of --last-n. Where the number of columns
--width will be used for the count.
-t type
The type of graph to draw, it defaults to star, which is the
fastest one. Options are star, ascii and braille. Ascii is
slightly prettier to look at.
-w, --width width
Specify a width for the output. If not specified, it will at‐
tempt to determine the TTY width and use that. If it cannot be
automatically determined, it will fail.
-h, --height height
Specify a height for the output. If not specified, it will at‐
tempt to determine the TTY height and use that. If it cannot be
automatically determined, it will fail.
EXAMPLES
The simplest version is if you have a text file of values
cat file | tg
2024-06-08 TG(1)
```
|
