https://github.com/vicanso/charts-rs
A charts library for rust
https://github.com/vicanso/charts-rs
Last synced: 6 months ago
JSON representation
A charts library for rust
- Host: GitHub
- URL: https://github.com/vicanso/charts-rs
- Owner: vicanso
- License: mpl-2.0
- Created: 2023-03-28T11:19:46.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-01T08:33:22.000Z (about 1 year ago)
- Last Synced: 2024-10-01T08:41:27.515Z (about 1 year ago)
- Language: Rust
- Homepage: https://charts.npmtrend.com/
- Size: 2.88 MB
- Stars: 189
- Watchers: 4
- Forks: 7
- Open Issues: 1
-
Metadata Files:
- Readme: README-zh.md
- License: LICENSE
Awesome Lists containing this project
README
# charts-rs
`charts-rs` 是纯rust实现的图表库，使用简单而且性能高效，生成svg低于10ms，而png也低于50ms，便于在各种无法直接渲染svg的场景下使用，现已支持更多的图片格式，如：jpeg，webp，以及avif。
[![Crates.io][crates-badge]][crates-url]
[![MPL licensed][mpl2-badge]][mpl2-url]
[](https://github.com/vicanso/charts-rs/actions/workflows/ci.yml)
[crates-badge]: https://img.shields.io/crates/v/charts-rs.svg
[crates-url]: https://crates.io/crates/charts-rs
[mpl2-badge]: https://img.shields.io/badge/license-mpl2-blue.svg
[mpl2-url]: https://github.com/vicanso/charts-rs/blob/main/LICENSE
## 概要
`charts-rs`提供简单的方式生成图表，它支持`svg`、`png`、`jepg`、`webp`以及`avif`等多种输出格式，以及支持`light`， `dark`， `grafana`，`ant`，`vintage`, `walden`, `westeros`, `chalk`与`shine`主题，默认的主题为`light`。现已支持以下类型的图表：`Bar`， `HorizontalBar`， `Line`， `Pie`， `Radar`，`Scatter`，`Candlestick`，`Table`，`Heatmap` 以及 `MultiChart`，其相关样式参考`Apache ECharts`。
## 更多主题色
[更多主题色](./theme.md)
## 特性
- 所有图表均支持多种主题，当前已支持了9种主题颜色
- 可通过ttf或otf中加载更多的字体库，默认的`Roboto`字体并未支持中文，需要选择`Noto Sans SC`
- 支持平滑，填充，最低最高点以及线标示
- 图表使用多种文本标示，例如：圆角矩形、圆形以及矩形等
- 曲线图支持平滑曲线、拆线、区域填充等效果
- 饼图支持普通与玫瑰饼图
- 支持两组Y轴线的展示
- 图表中的所有元素均支持颜色、字体、字体颜色等基本属性配置
- 支持以`json`的形式初始化图表，更简单易用
- svg、png、jpeg、webp以及avif的格式便于更多的应用场景
- 网页版的json编辑器可用于一步式尝试各选项的效果，填充简化与完整版的配置选择
## 示例
可以使用网页版尝试使用`charts-rs`的相关图表示例，可以直接改动配置后，重新生成效果图，非常简单而有用。
示例地址: [https://charts.npmtrend.com/](https://charts.npmtrend.com/)
示例项目代码: [https://github.com/vicanso/charts-rs-web](https://github.com/vicanso/charts-rs-web)
## Mix line bar
## Horizontal bar
## Line
## Pie
## Radar
## Scatter
## Candlestick
## Table
## Heatmap
## Multi Chart
## Rust示例
### 使用Option的形式创建图表
```rust
use charts_rs::{
BarChart, Box, SeriesCategory, THEME_GRAFANA
};
let mut bar_chart = BarChart::new_with_theme(
vec![
("Evaporation", vec![2.0, 4.9, 7.0, 23.2, 25.6, 76.7, 135.6]).into(),
(
"Precipitation",
vec![2.6, 5.9, 9.0, 26.4, 28.7, 70.7, 175.6],
)
.into(),
("Temperature", vec![2.0, 2.2, 3.3, 4.5, 6.3, 10.2, 20.3]).into(),
],
vec![
"Mon".to_string(),
"Tue".to_string(),
"Wed".to_string(),
"Thu".to_string(),
"Fri".to_string(),
"Sat".to_string(),
"Sun".to_string(),
],
THEME_GRAFANA,
);
bar_chart.title_text = "Mixed Line and Bar".to_string();
bar_chart.legend_margin = Some(Box {
top: bar_chart.title_height,
bottom: 5.0,
..Default::default()
});
bar_chart.series_list[2].category = Some(SeriesCategory::Line);
bar_chart.series_list[2].y_axis_index = 1;
bar_chart.series_list[2].label_show = true;
bar_chart
.y_axis_configs
.push(bar_chart.y_axis_configs[0].clone());
bar_chart.y_axis_configs[0].axis_formatter = Some("{c} ml".to_string());
bar_chart.y_axis_configs[1].axis_formatter = Some("{c} °C".to_string());
println!("{}", &bar_chart.svg().unwrap());
svg_to_png(&bar_chart.svg().unwrap()).unwrap();
```
### 通过JSON字符串配置的形式创建图表
```rust,no_run
use charts_rs::{BarChart, svg_to_png};
let bar_chart = BarChart::from_json(
r###"{
"width": 630,
"height": 410,
"margin": {
"left": 10,
"top": 5,
"right": 10
},
"title_text": "Bar Chart",
"title_font_color": "#345",
"title_align": "right",
"sub_title_text": "demo",
"legend_align": "left",
"series_list": [
{
"name": "Email",
"label_show": true,
"data": [120.0, 132.0, 101.0, 134.0, 90.0, 230.0, 210.0]
},
{
"name": "Union Ads",
"data": [220.0, 182.0, 191.0, 234.0, 290.0, 330.0, 310.0]
}
],
"x_axis_data": [
"Mon",
"Tue",
"Wed",
"Thu",
"Fri",
"Sat",
"Sun"
]
}"###,
).unwrap();
println!("{}", bar_chart.svg().unwrap());
svg_to_png(&bar_chart.svg().unwrap()).unwrap();
```
## 加载更多的字体集
```rust
let buf = fs::read(file).unwrap();
get_or_try_init_fonts(vec![&buf]));
```
## 开源协议声明
This project is licensed under the [MPL-2.0 license].
[MPL-2.0 license]: https://github.com/vicanso/charts-rs/blob/main/LICENSE