Highcharts for weewx extension

Description

The Highcharts for weewx extension provides a JSON data feed to support weekly and yearly observation plots using Highcharts. A sample HTML page and the JavaScript necessary to render the Highcharts plots is also included in the Highcharts for weewx repositry.

Pre-Requisites

The Highcharts for weewx extension requires weewx v3.4.0 or greater. The display of the Highcharts for weewx extension data on a web page using the included Javascript files requires the Highcharts Highstock charting tool and the JQuery JavaScript library.

Installation

The preferred method to install the Highcharts for weewx extension is to use the weewx wee_extension utility. To install the Highcharts for weewx extension using the weewx wee_extension utility:

Note: Symbolic names are used below to refer to some file location on the weewx system. These symbolic names allow a common name to be used to refer to a directory that may be different from system to system. The following symbolic names are used below:

$DOWNLOAD_ROOT. The path to the directory containing the downloaded Highcharts for weewx extension.

$HTML_ROOT. The path to the directory where weewx generated reports are saved. This directory is normally set in the [StdReport] section of weewx.conf. Refer to where to find things in the weewx User's Guide for further information.

$SKIN_ROOT. The path to the directory where weewx skin folders are located. This directory is normally set in the [StdReport] section of weewx.conf.Refer to where to find things in the weewx User's Guide for further information.

Download the latest Highcharts for weewx extension from the Highcharts for weewx releases page into a directory accessible from the weewx machine.
```
wget -P $DOWNLOAD_ROOT https://github.com/gjr80/weewx-highcharts/releases/download/v0.2.1/hfw-0.2.1.tar.gz
```

Stop weewx:

sudo /etc/init.d/weewx stop

sudo service weewx stop

Install the Highcharts for weewx extension downloaded at step 1 using the wee_extension utility:

wee_extension --install=$DOWNLOAD_ROOT/hfw-0.2.1.tar.gz

This will result in output similar to the following:

Request to install '/var/tmp/hfw-0.2.1.tar.gz'
Extracting from tar archive /var/tmp/hfw-0.2.1.tar.gz
Saving installer file to /home/weewx/bin/user/installer/Hfw
Saved configuration dictionary. Backup copy at /home/weewx/weewx.conf.20161123124410
Finished installing extension '/var/tmp/hfw-0.2.1.tar.gz'

Start weewx:

 sudo /etc/init.d/weewx start

 sudo service weewx start

This will result in the Highcharts for weewx JSON data files being generated during each report generation cycle. A default installation will resulting in the generated JSON data files being placed in the $HTML_ROOT/json directory. The Highcharts for weewx installation can be further customized (eg units of measure, file locations etc) by referring to the Highcharts for weewx wiki.

Support

General support issues may be raised in the Google Groups weewx-user forum. Specific bugs in the Highcharts for weewx extension code should be the subject of a new issue raised via the Issues Page.

Licensing

The Highcharts for weewx extension is licensed under the GNU Public License v3.