PHP JpGraph Graphs Package
Version 1.0
This is a package of scripts that will generate based off of a realtime.log history file a series of graphs.
Currently supported are:
Temp/Hum
Dewpt
Baro
Wind
Rain
REQUIREMENTS
This package requires the following to work:
1) PHP5 Server. Might work with PHP4 but I've not tested it.
2) JpGraph PHP Library installed. It is assumed that you have loaded a recent version of this pacakge into the root of your webserver in the directory jpgraph. It can be located elsewhere, but you need to know where.
3) GD with FreeType Support. These graphs use the following truetype fonts:
Verdana
You could change the source to use the standard GD default fonts, but it would require a lot of changes and positioning... and won't look nearly as nice.
4) An updating realtime.log file. This can be created with the realtimelog.php script. See
Forum Entry for realtimelog.php
Installation
The files come in a zip file and assume to be loaded into the sub-directory graphs off the main web directory. If the realtime.log file is located in the root directory above the graphs directory you won't need to make many changes to the configuration file.
The package comes with one configuration file called
GraphSettings.php.
This file is included by all the graphs to get the base colors, station name and field types.
The configuration section of that script is:
Code: Select all
############################################################################
# CONFIGURATION INFORMATION
############################################################################
$SITE['version'] = "1.0";
$SITE['hloc'] = "../";
$SITE['jpgraphloc'] = "../jpgraph/src/";
$SITE['datafile'] = "realtime.log";
$SITE['format'] = "png"; # Options: jpeg gif png
$SITE['sitename'] = "YOUR SITE NAME";
$SITE['tempunit'] = "°F";
$SITE['rainunit'] = "\"";
$SITE['barounit'] = " mb";
$SITE['windunit'] = " mph";
$SITE['bgncolor'] = "#EFEFEF";
$SITE['txtcolor'] = "#22464F";
$SITE['tz'] = "US/Arizona";
Lets go through them one at a time so you know what they are...
$SITE['version']
Basically just the version of the graph package.
$SITE['hloc']
Location of home from where the package is. This is a relative position and if you have loaded the package in a subdirectory off of the main web directory it should be just fine as it is.
$SITE['jpgraphloc']
Again, this is a relative address and assumes that the JpGraph library is located in jpgraph off the main web root. If you loaded it somewhere else, you will need to change this.
$SITE['datafile']
The datafile that contains the history.
DON'T PUT PATH INFO HERE, just the filename.
$SITE['sitename']
This is the name of your site.
$SITE['format']
The default is png which is what most will use. You can change it to other formats if you GD supports those formats. Note that Jpeg is NOT a recommended format as it will make fuzzy looking images.
$SITE['tempunit']
$SITE['rainunit']
$SITE['barounit']
$SITE['windunit']
These values should be changed to the types of values your station is outputing.
For tempunit, recommended that you just change the F to a C if you need to and leave the degree symbol alone.
For rain, the default is " which is escaped with a \. If you want to change it to in or mm...
$SITE['bgncolor']
$SITE['txtcolor']
Settings for colors. bgncolor is the background of the margin and txtcolor is for most of the labels. If you change these, you will most likely need to adjust other colors used on the graphs.
$SITE['tz']
This allows the server to be set to the proper timezone when getting the current date.
For US values, it should be something like
US/Eastern US/Pacific ...
For Europe,
EUROPE/London etc...
Look at the following page for hints to match your locale...
http://us.php.net/manual/en/timezones.php
That's basically it....
Using the Graphs...
A sample page is included called
samp-graphs.php
It provides examples of the various settings you can use when you call the charts.
This page shows how the same scripts can be used to display different numbers of hours and different frequency of samples.
Basically by adding:
level=X
You can set the hours to:
0 = 24hrs (default)
1 = 48hrs
2 = 72hrs
3 = 96hrs
freq=X
You can change the sample frequence to:
0 = once an hour (default)
1 = twice an hour
2 = four times an hour
Example:
Code: Select all
http://YOURWEBSITE/temp.php?level=2&freq=2
Would display 72 hours on the graph with a sample frequency of four times an hour.
Note about values displayed:
The modules search the database looking at the minutes of the entries.
If Frequency is set to 0, it looks for entries that end in 00 minutes.
If Frequency is set to 1, it looks for entries that end in 00 and 30 minutes.
If Frequency is set to 2, it looks for 00 15 30 and 45 minutes.
It ignores any entries that don't match the above. It is assumed that the realtime.log has entries for once a minute.
NOT SUPPORTED YET
o I've not yet added PHP CLI support. This would allow you to use cron to generate static images that an active web page could hit without having to dynamically generate the images each time.
o Language support. Adding a simple array to the configuration file could make it easy to select the language used for the titles and labels...
o Multi-site report. Just an idea, but if you pass it a site number, it could look for different versions of the realtime.log files to display multiple site images using the same scripts. This would be for someone that has multiple locations.
Source Code:
Almost forgot the source code...
Source is included in a zip file. It will extract with all the modules in a subdirectory called graphs.
TNET Cumulus Project Page
