https://github.com/fluffysquirrels/rt-graph-rs

Real-time graphing experiment written in Rust
https://github.com/fluffysquirrels/rt-graph-rs

Last synced: about 2 months ago
JSON representation

Real-time graphing experiment written in Rust

• Host: GitHub
• URL: https://github.com/fluffysquirrels/rt-graph-rs
• Owner: fluffysquirrels
• License: mit
• Created: 2020-08-19T18:07:14.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2020-10-30T19:07:03.000Z (about 4 years ago)
• Last Synced: 2024-10-16T04:12:27.330Z (2 months ago)
• Language: Rust
• Homepage:
• Size: 214 KB
• Stars: 19
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# rt-graph

A real-time graphing experiment written in Rust.

![Screenshot](docs/example-simple_screenshot.png)

Many other graphing tools do not efficiently update the display when

new data is added, for example redrawing the whole screen when only a

few pixels of new data are added.

This crate tries to do the minimum incremental work required to update

the graph when new data is added: draw the few pixels of new data, and

scroll the graph with efficient large copies, which can and should be

accelerated by GPU hardware.

As a result of this design rt-graph easily copes with 30k new points

per second, at 60 FPS, using just 3% CPU (tested on a Lenovo T460

laptop from 2016 with 2.4 GHz Intel Core i5-6300U, running Ubuntu

18.04.5).

Source repository: 

(issues and pull requests are welcome!)

Documentation: 

Crate: 

## Prerequisites

First install GTK 3 dependencies.

On OS X with brew try: `brew install gtk+3`

On Ubuntu try: `sudo apt-get install libgtk-3-dev`

## Run an example

Clone the source repository from

 then try to run an

example with some simulated data:

```

cargo run --package "example-simple" --release

```

You can scroll back and forth with the scrollbar under the graph, or

go back to following the latest data by clicking the "Follow" button,

and zoom in and out with the buttons. Click on the graph to show an

information bar underneath it with the raw data where you clicked.

## Build your own application

To use your own data implement the `DataSource` trait and pass an

instance of your struct to the `ConfigBuilder::data_source()` method

while building a `Graph` or `GraphWithControls`.

`rt-graph` uses GTK (via the [gtk-rs](https://gtk-rs.org/) Rust

bindings) for its UI and is designed to be embedded into any

`gtk::Container` in your application.

## Helpful links

GTK 3 documentation:  

gtk-rs (Rust GTK bindings) documentation: 

## Changelog

### 0.3.4

* Swap B and R color channels, they were backwards.

### 0.3.3

* Add `.show` and `.hide` methods to `Graph`.

* A hidden `Graph` ticks less frequently (1Hz), reducing CPU usage dramatically.

* `Graph::tick()` does less when no data is ingested from a DataSource.

### 0.3.2

* Add `.show` and `.hide` methods to `GraphWithControls`.

### 0.3.1

* Fix panic when clicking on a graph with no data points.

* Add NullDataSource.

### 0.3.0

* Flip y axis so increasing values are higher on the screen.

* Make `Store` private.

* Add per-item documentation for all public items.

* Replace naked `u16` and `u32` usage with type aliases `Value` and `Time`.

### 0.2.0

* Refactor out Graph, GraphWithControls, so consumers can write their own controls.

### 0.1.1

* Add more content to the README, including a screenshot.