5,838
edits
AnnualDataSummary: Difference between revisions
From Cumulus Wiki
Jump to navigationJump to search
m
Small tweaks to the version as at 17 Dec 2012
m (Small tweaks to the version as at 17 Dec 2012) |
|||
|
{{AddOnBanner|name=Annual Data Summary|type=HTML & Javascript|author=David Jamieson|contact=[[User:Daj|DAJ]]|updated=7 March 2011|version=1.1|updated=17 December 2012|version=1.2 BCJKiwi}} ▼
Revision as of 22:41, 27 November 2012
Name: Annual Data Summary
Type: HTML & Javascript
Author: David Jamieson
Contact: DAJ
Last update: 7 March 2011
Version: 1.1
Updated by BCJKiwi:
An working example is [http://www.grantownweather.co.uk/historic/dataSummary.php here]▼
▲{{AddOnBanner|name=Annual Data Summary|type=HTML & Javascript|author=David Jamieson|contact=[[User:Daj|DAJ]]
'''An updated article, that supercedes this one is called [[Daily_Summary]]'''
'Annual Data Summary' is a small tool to read the [[dayfile.txt]] produced by Cumulus and summarise this in a table, arranged like a calendar, showing a full years worth of a selected criterion such as maximum daily temperature.
*The tool uses HTML, jQuery (a library script that produces Javascript) and a CSS file.
*The JavaScript version does not require a webserver with PHP services enabled. (Many of the free hosting services do not offer PHP so this was a solution to that problem).
*The alternative is a PHP version (included so you have the option to use either).
*Both provide identical looking output and functionality, however if you have PHP services on your web server use the PHP version as it is slightly faster.
▲An working example
= Requirements =
*optionally, PHP enabled web server if you wish to use the PHP version
== Configuration Variables ==
Here is a revised set of files (PHP only) ver 1.2▼
by default, the script (the file 'readDayfile.js' or 'readDayfile.php' depending on your choice) will do the following:
These are available here and update the Ver 1.1 fileset below to eliminate errors in validation due to deprecated code routines.▼
* (both versions) Assume the dayfile.txt is read from a subfolder called 'data'.
They also include a couple of updates from DAJ advised by posts in the Forum.▼
* (JS version only) Insert the table it generates into a HTML element with attribute ''id='tableData' ''
The files include additional notes and explanations on the changes where relevant.▼
* (both versions) Assume the date format in the dayfile is ''dd/mm/yy'' (the month is always in the middle for all Cumulus log files)
A working example is [http://silveracorn.co.nz/weather/datasummary.php here]▼
* (both versions) Assume the data in the dayfile is separated with a ''comma''
*download the follwing file...[http://wiki.sandaysoft.com/files/AnnualDataSummary_12.zip AnnualDataSummary_12.zip]▼
The last two assumptions are fine for UK based systems, however others should check their dayfile.txt and adjust as necessary
*Look for the line 'dayfile='/data/dayfile.txt';' around line 15 and change this to point to your dayfile.txt on your webserver.
:for ''PHP'' version the path should start from the / (root),
:for '''JavaScript''' version the path should start from where the HTML will be stored.
* (JS Version only) '''tableDiv''' - the HTML element ''id attribute'' on your webpage to insert the table into
* (both versions) '''field_delimiter''' - the symbol separating each of your fields in the dayfile.txt. For most people this is a '''comma''' but (if you use comma to separate integer and decimal parts of real numbers) it could be a semi-colon (''';''') or other symbol.
* (both versions) '''date_delimiter''' - the symbol separating your date format. See [[setup]].
Change as needed, save and test
== Revised PHP ==
▲Here is a revised set of files (PHP only) ver 1.2.
▲These are available here and update the Ver 1.1 fileset
▲They also include a couple of updates from DAJ version as advised by posts in the Forum.
▲The files include additional notes, and explanations on the changes, where relevant.
▲*A working example
▲*
*#'''readDayfile.php''' - script for reading the dayfile.txt and for creating the table structure that displays selected statistics in a calendar style
*#'''datasummary.php''' - example 'carrier' web page, this one uses the Saratoga template system, so also requires 2 more scripts (not provided) ''Settings.php'' and ''common.php''. You can use your own page instead of this file.
*#'''datasummary.css''' - styling sheet for the table structure that displays selected statistics in a calendar style
*Follow the instructions below for the PHP version.
Original Fileset and instructions:-▼
▲= Original 1.1 Fileset and instructions:- =
*download the following file...[http://wiki.sandaysoft.com/files/AnnualDataSummary.zip AnnualDataSummary.zip]
<br>
== Opening a specific data set when the page is first loaded ==
By default (in the original version) the table created will
*The parameter 'data' (in the original version) takes mintemp, maxtemp, avgtemp, minmaxt, rainfall, windgust. (You can add further data sets or change the language of these values - see Localization). '''Note''' the specified data will be displayed even if it is assigned 'false' and does not appear as a button.
▲By default the table will summaries the maximum temperature for the current year, however you can start with any dataset or year (assuming you have the data in the dayfile.txt) but adding a string to the end of your URL in the browser. examples....,
*You can supply both data set and year parameters, one only, or none
examples....,
*JS version --myserver.com/datasummary.html?year=2010▼
*PHP version -- myserver.com/datasummary.php?year=2010▼
:This will open the data set initially showing year 2010▼
▲*JS version -- '''myserver.com/datasummary.html?year=2010'''
▲*PHP version -- ''myserver.com/datasummary.php?year=2010''
▲:This will open the default (maximum temperature) data set but initially showing year 2010
*myserver.com/datasummary.html?data=rainfall&year=2009▼
:This will open the rainfall dataset for the year 2009.▼
▲*JS version -- myserver.com/datasummary.html?data=rainfall&year=2009
== Styling ==
= Version Control =
1.2 New PHP version
1.1 PHP version included
1.0 Public launch
[[Category:WebTools]]
| |||
