edit

Histogram

This repo describes how to draw histogram on ReScreen. Similar to the Line Charts library, you can use this to display raw sensor values to visualize readings on screen. This library is very flexible and can modify to your own need.

Libraries Installation

Installing Histogram Libraries

  • Visit Seeed_Arduino_Histogram and download the entire repo to your local drive.

  • Now, the library can be installed to the Arduino IDE. Open the Arduino IDE, and click sketch -> Include Library -> Add .ZIP Library, and choose the Seeed_Arduino_Histogram file that you've have just downloaded.

InstallLibrary

Getting Started

To Initialize for drawing Histogram

Include the Histogram library and initialize the histogram as follow:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
#include <TFT_eSPI.h> // Hardware-specific library
#include <SPI.h>
#include"Histogram.h"

TFT_Histogram histogram=TFT_Histogram(); //Initializing Histogram
TFT_eSPI tft = TFT_eSPI(); //Initializing TFT

void setup(void) {
  tft.init();
  histogram.initHistogram(&tft);
  ...
}

Creating Columns in Histogram

To create columns in histogram:

1
void formHistogram(String label,int NO,double Histogram_value,int Histogram_WIDTH,uint32_t colour);

where label is the column name under its column , NO is the number tag of the histogram column, Histogram_value is the value of histogram column, Histogram_WIDTH is the width of the histogram column and colour is the colour of histogram column colour.

To Show Histogram

To show the Histogram:

1
void showHistogram();

Changing the Column values

To change the values of existed columns:

1
void changeParam(uint8_t NO, String lable, float Histogram_value, uint32_t colour);

where NO refers back to the number tag of the histogram column(which column to change).

Deleting a Column

To delete a column from histogram:

1
void deleteCylinder(uint8_t NO);

where NO refers to the number tag of histogram column.

Adding Line Chart to Histogram

Adding line chart:

1
void lineChart(uint32_t colour);

where color is the colour of the line chart.

Hiding the Axis of Histogram

1
void notShowAxis();

Others useful functions

For more other useful functions of the histogram library, please refer to the Histogram.h. Further, it also provides sets of examples as well as a full function demo that can be found in the examples folder.

Example Code

 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
#include <TFT_eSPI.h> //Hardware-specific library
#include <SPI.h>
#include"Histogram.h" //include histogram library

TFT_Histogram histogram=TFT_Histogram(); //Initializing tft and histogram
TFT_eSPI tft = TFT_eSPI();

void setup() {
  tft.init();
  histogram.initHistogram(&tft);
  histogram.formHistogram("a",1,50.55,40,TFT_RED); //Column 1
  histogram.formHistogram("b",2,20,40,TFT_BLACK); //Column 2
  histogram.formHistogram("c",3,100,50,TFT_GREEN); //Column 3
  histogram.formHistogram("d",4,53,50,TFT_BLUE); //Column 4
  histogram.formHistogram("e",5,133,30,TFT_YELLOW); //Column 5
  histogram.formHistogram("f",6,53,50,TFT_ORANGE); //Column 6
  histogram.formHistogram("g",7,80,50,TFT_PINK); //Column 7

  histogram.showHistogram(); //show histogram
  delay(3000);

  histogram.changeParam(6,"F",55,TFT_PINK);//change column 6
  histogram.deleteCylinder(7);//delete colum 7
  histogram.lineChart(TFT_BLACK);

  delay(2000);
  histogram.notShowAxis();//hiding the axis of histogram
}
void loop() {

}