Skip to content

@poblabs poblabs released this Jun 9, 2019 · 1 commit to master since this release

Changes

  • Adds more debugging capability. See Wiki "How to get help" section.
  • Adds default chart values for areaspline chart type.
  • Updates the areaspline and area charts threshold. Default is 0, now it's undefined so its a floating y axis range.
  • Fixes a chart bug with Highcharts options being set as a string, instead of integer, resulting in unexpected behavior.
  • Fixes a locale bug if a system locale is not defined (or is using C, which Python views as None)
  • Fixes an archive_interval bug if one is not defined in weewx.conf (e.g. when the station provides the archive interval, not weewx)
  • Fixes a belchertown_root_url bug which affects on certain scenarios. In 1.1 belchertown_root_url may be removed all together.
  • Fixes a moon translation label in the celestial information
  • Fixes a bug with scaletime and rolling time period charts. Unsure why scaletime was used but it's gone now.
  • Fixes a bug with point timestamp and using an odd minute like :59 instead of :00
  • Fixes a typo in the skin.conf labels section
  • Removes an invalid link from the "powered by" line in the header.

Install

If you are upgrading, you MUST read these instructions: https://github.com/poblabs/weewx-belchertown/wiki/Upgrading-to-Belchertown-skin-1.0


If you are installing Belchertown as a brand new skin:

You must be using weewx 3.9 or newer.

While unlikely something will go wrong, please make sure you have a backup your weewx.conf configuration.

Download:

wget https://github.com/poblabs/weewx-belchertown/releases/download/weewx-belchertown-1.0.1/weewx-belchertown-release-1.0.1.tar.gz

Then run:

sudo wee_extension --install weewx-belchertown-release-1.0.1.tar.gz

Configure the weewx.conf pre-requisites and restart weewx when done.

Assets 3

@poblabs poblabs released this Jun 1, 2019 · 26 commits to master since this release

Changes

BREAKING CHANGES FROM 0.9:

  • Chart system is 100% re-written. The old charts must be removed to avoid conflicts! See below installation for details.
  • In an effort to provide more options for translations, the following Extra's settings have moved to Labels --> Default. Please update your settings!
    • home_page_header
    • graphs_page_header
    • records_page_header
    • reports_page_header
    • about_page_header
    • powered_by
    • footer_copyright_text
    • footer_disclaimer_text

New or Updated Changes:

  • Complete overhaul of the chart system and introduction of graphs.conf. Please see the Charts Wiki for all the new configuration options.
    • This overhaul removes the Highcharts_Belchertown skin and bin/user file and moves everything under the 1 Belchertown skin.
    • Overview of the new chart system include ability to move charts around, remove charts, configure multiple observations per chart, and add a 2nd yAxis to associate an observation to for better readability, mix timespans between the graph groups (have both a year and a day chart on the same page), mirrored charts, wind rose, monthly aggregation and more!
    • You can also define which graph group from graphs.conf to show on the Graphs page. Show them All, show only the 1 you want. It's your choice!
  • Add support for wind rose with Highcharts.
  • Added rainTotal observation, unique to Belchertown, which aggregates the "rain" observation (bucket tips) over a timespan to return total rainfall for that time period.
  • Change the Station Observation table on the homepage to an Extras option for greater control of current weather station observations. You can add/remove and change the order of the observations. Only valid weewx schema names are accepted.
  • Locale now has an option to be auto detected by the system, or the ability to change it to a locale the site owner wants as long as that locale is installed on the server first.
  • Added pyephem almanac modal to the "Sun & Moon" section. Thanks to the Seasons skin for the quick work. At this time the detailed Almanac Information does not update in real time. You will need to reload the page to get updated detailed almanac information.
  • Add support for translating the skin through the use of Default Labels in skin.conf (which can be used in weewx.conf, too).
  • Upgrade to Bootstrap 3.4.1 and change to new bootstrap stackpath CDN
  • Added new Dark Theme. This is a combination of Bootstrap's "darkly" (on CDN) and Highcharts Dark Unica theme (hosted locally), and Belchertown overrides to remain consistent.
  • Added new skin.conf option called "theme". Options are "light", "dark" and "auto". Light (white) website theme. Dark (dark) website theme. Auto switches between the two at sunset (to dark) and sunrise (to light).
  • Added a toggle button to the navigation menu which will change the entire site's theme at the click of the button.
    NOTE If you are using the AUTO theme mode, and you click this button, it will disable auto mode until you close the page, tab or browser to reset back to auto mode.
  • Added belchertown_debug to aid in debugging the skin's options. Also available through the URL /?debug=true
  • Added permalink to the graphs page. For example to link to your weekly graphs, use http://yoursite/graphs/?graph=week, for month, it's /?graph=month, for year is /?graph=year and for today you can link to the graphs page, or use /?graph=today. To find a specific permalink URL you can go to the All Graphs Page, then click the header for that graph.
  • Added option reload_hook_images and hook image reload timers which when enabled will reload any images in the 4 custom content areas on the index page within their specified timers. Useful for webcam images. This option will only work if MQTT Websockets live updates are also enabled.
  • Upgrade Font Awesome to 4.7.0
  • Clean up of some old CSS

Install

If you are upgrading, you MUST read these instructions: https://github.com/poblabs/weewx-belchertown/wiki/Upgrading-to-Belchertown-skin-1.0


If you are installing Belchertown as a brand new skin:

You must be using weewx 3.9 or newer.

While unlikely something will go wrong, please make sure you have a backup your weewx.conf configuration.

wget https://github.com/poblabs/weewx-belchertown/releases/download/weewx-belchertown-1.0/weewx-belchertown-release-1.0.tar.gz

Then run

sudo wee_extension --install weewx-belchertown-release-1.0.tar.gz

Configure the weewx.conf pre-requisites and restart weewx when done.

Graph Generator

When you're ready, take a look at the Graphs Wiki to learn how to add, remove, customize graphs!

Here are some example graphs:

Wind Plot

Wind Rose

UV and Solar Radiation

image

image


Issues?

Please report any issues you find here. This helps me keep track of them.

Assets 3

@poblabs poblabs released this Mar 9, 2019 · 355 commits to master since this release

Changes

  • Fixed a locale bug with the windSpeed and windGust float values by using toString() instead of format(). This is backwards compatible with weewx 3.8.2
  • Fixed a bug where MQTT AJAX page updates weren't in locale decimal. (e.g. comma instead of period for decimal). Can't use parseFloat() on it's own if the culture is a comma for decimals. Need to use toLocaleString(). This requires converting the string to an int, to a float, back to a string.
  • Fixed a bug with the chart gapSize on the day charts to use the archive_interval and not an arbirary 5 minute setting.
  • Fixed a bug with windDir vectors not being consistent.
  • Fixed a bug with the forecast breaking the page if it wasn't enabled, but MQTT Websockets was.
  • Fixed a bug with DarkSky visibility units, since they don't seem to provide this themselves. So it's their bug that I'm trying to work around.
  • Now the charts use the system locale decimal point.
  • Update non-MQTT page timestamp to use moment.js to fall in line with other datetime stamp locale formatting.
  • On the front page, if both charts are hidden, hide the full row to save on whitespace.
  • On the charts page hide the chart if it's hidden in skin options.

Install

If you are upgrading, while unlikely something will go wrong, please make sure you have a backup your configuration.

wget https://github.com/poblabs/weewx-belchertown/archive/weewx-belchertown-0.9.1.tar.gz

Then run

sudo wee_extension --install weewx-belchertown-0.9.1.tar.gz

Configure the weewx.conf pre-requisites and restart weewx when done.


Issues?

Please report any issues you find here. This helps me keep track of them.

Assets 2

@poblabs poblabs released this Mar 1, 2019 · 391 commits to master since this release

Breaking Changes

  • BREAKING CHANGE - Updated all mqtt_* skin options to mqtt_websockets_* to reduce confusion. The skin needs MQTT Websockets in order to work. These variable names should help.

Other Changes and Fixes

  • A lot of work focused on locale for time formatting. All time should be auto-detected by the locale on your server and displayed in your locale format.
  • Charts hover tooltips are now in station's locale format.
  • Major bugfix for the rain charts. The old code was adding A LOT OF PLOTS. This resulted in slower chart generation time.
  • Forecast row is now JavaScript only and has been removed from the belchertown.py SLE. This makes it easier to manage in the future since it's only in 1 place now.
  • Updated almanac to work with weewx 3.9.0's new [Default] section within weewx.conf.
  • Added the option to show indoor temperature (inTemp) to the temperature charts. This option is disabled by default and is setup exactly like apparent temperature. Once you opt-in to show this data, it is only available for the day and week charts.
  • Added a manifest.json file which allows you to install your weather website like an "app" on your smart devices. Thanks user @WhiteNoseThunderPants for the initial work on this.
  • Added the matching Apple config so you can add your weather website like an "app" on your Apple devices.
  • Added $footer_disclaimer_text option to update the footer disclaimer. Thanks @biltmorelaker!
  • Added a robots.txt file.
  • Switched to the new Google Analytics method of tracking with gtag.js.
  • Added forecast windspeed next to the (existing) wind gust.
  • Updated windspeed forecast CSS on mobile.
  • Updated the records page for Consecutive Rain Days to show all time date range. Useful if your consecutive rain dates wrap around a new year and the math seems wrong (like https://BelchertownWeather.com shows)
  • Simplified the includes for the About page, Records page and home page. Before it had a lot of overhead to it, so now it's using a simple Cheetah #include. If you want to show something in these areas, you just need to create the .inc file and that's it. No options to set or anything. See the README for more information.
  • On the Pi page, added a timer to reconnect to MQTT if connection is lost to the MQTT broker.
  • Re-ordered some JavaScript functions due to improper grouping.
  • Fixed Pi page styles to match the 640x480 resolution for the PiTFT.
  • Fixed a bug on the Records page where certain custom observations were not in the station's locale formatting.
  • Fixed a bug certain users were seeing with UTF-8. Thanks user @spanishhighs!
  • Fixed a bug where if using a radar image (not windy.com, but a jpg, gif, png, etc.), it'll reload the image upon background updates.
  • Fixed a bug where the date of the weather records snapshot for "Today" and "Month of" on the home page didn't update if the page was automatically updated overnight into a new day or a new month.
  • Fixed a bug where rounding of rain and outTemp for custom Records page code wasn't honoring the number of decimal places from skin.conf.
  • Fixed a bug where the Highcharts timelines were in the viewer's timezone and not the station's timezone.
  • Fixed a bug where the Week and Month charts did not begin on a week before, or a month before (respectively).
  • Fixed a bug where the Year charts did not begin on January 1.
  • Fixed a bug where if there was missing data in the chart data, the chart would show a connecting line. Instead the correct behavior should be to show a gap which represents that data is missing.
    • Gaps will show if the following time ranges are missing in the chart:
    • Day chart: 5 minute gap
    • Week chart: 1 hour gap
    • Month: 24 hour gap
    • Year: 24 hour gap
  • Fixed a bug where the Facebook share button was using the O'Brien Labs Facebook App ID.

Install

If you are upgrading, while unlikely something will go wrong, please make sure you have a backup your configuration.

wget https://github.com/poblabs/weewx-belchertown/archive/weewx-belchertown-0.9.tar.gz

Then run

sudo wee_extension --install weewx-belchertown-0.9.tar.gz

Configure the weewx.conf pre-requisites and restart weewx when done.


Issues?

Please report any issues you find here. This helps me keep track of them.

Assets 2

@poblabs poblabs released this Jan 1, 2019 · 535 commits to master since this release

Changes

  • Fixed an error where the skin would fail when the date rolls to the New Year due to no data being in certain tables in the database yet.
  • Added the ability to show any weather alerts provided by the DarkSky API. Weather alerts are off by default, use forecast_alert_enabled in weewx.conf skin options to enable it.
  • New option to show cloudbase. You must have your database schema extended for the cloudbase observation to be calculated by weewx. Check the Belchertown skin wiki for details.
  • Fixes an issue where the MQTT updates showed altimeter instead of barometer.
  • Updated Google Analytics page to be in header based on Google recommendations.
  • Updated Google Analytics to a more recent script block.
  • Added a Google Analytics page view per MQTT update as per Google Recommendations on background updates.

Install

wget https://github.com/poblabs/weewx-belchertown/archive/weewx-belchertown-0.8.2.tar.gz

Then run

sudo wee_extension --install weewx-belchertown-0.8.2.tar.gz

Configure the weewx.conf pre-requisites and restart weewx when done.


Issues?

Please report any issues you find here. This helps me keep track of them.

Assets 2

@poblabs poblabs released this Dec 7, 2018 · 555 commits to master since this release

Changes

  • Fixes an edge case scenario where skin fails to generate due to N/A as a wind observation value.
  • Fixes some false positive errors with belchertown_root_url or station_url being reported it's not set.
  • On the front page, change the wording to Chart instead of Graphs above the chart region. Afterall, these are charts and not graphs. I should probably update everything to be "chart". That would be a breaking change for the /graphs URL though, so I'm still debating a full change to "Chart"

Install

wget https://github.com/poblabs/weewx-belchertown/archive/weewx-belchertown-0.8.1.tar.gz

Then run

sudo wee_extension --install weewx-belchertown-0.8.1.tar.gz

Configure the weewx.conf pre-requisites and restart weewx when done.


Issues?

Please report any issues you find here. This helps me keep track of them.

Assets 2

@poblabs poblabs released this Dec 2, 2018 · 572 commits to master since this release

Changes

  • A lot of metric conversion fixes. A lot.
  • More metric conversions fixes.
  • Now uses new option belchertown_root_url as preferred URL option and falls back to station_url for the URL of your weather station. The CSS and JavaScript files are dependant on this setting.
    • This new setting means you can run your station on a different URL than station_url. The station_url can be used to show your station on the weewx.com map. So the belchertown_root_url was added in case you did not want that, or if you want to run test sites, offline sites, or have Belchertown on a different folder or site all together than station_url.
  • You can now select your own graph order and also can pick from 7 graphs to show in 6 positions. Details on the user guide
  • 4 Custom rows now available on index page for you to customize content. Check the user guide for more info on how to use these areas.
  • Better fallback method if the earthquake data has no recent earthquakes.
  • Added option to change DarkSky language. Use darksky_lang in configs.
  • Add rainfall total line graph to year graphs.
  • Show rainRate on day, week, month charts instead of bucket tips. This makes for a much more interesting graph.
  • Remove rounding on the rainRate chart
  • Added a windy.png icon, which is a clone of wind.png. Sometimes DarkSky wants wind.png and other times windy.png
  • Added a Raspberry Pi kiosk page.
  • Other various bug fixes and code optimization.

Install

wget https://github.com/poblabs/weewx-belchertown/archive/weewx-belchertown-0.8.tar.gz

Then run

sudo wee_extension --install weewx-belchertown-0.8.tar.gz

Configure the weewx.conf pre-requisites and restart weewx when done.


Issues?

Please report any issues you find here. This helps me keep track of them.

Assets 2

@poblabs poblabs released this Sep 8, 2018 · 636 commits to master since this release

A lot of changes in this skin. Please read all instructions below!

Changes

  • Separated Highcharts from the main skin into its own skin. In testing this has shown to speed up skin generation times. Strongly advise you to uninstall Belchertown skin, and install 0.7 as a new skin. Also, be sure to have a backup of your skin customizations
  • The highcharts extension gets its options from the Belchertown main skin. Keep your highcharts options under Belchertown's main Extras section.
  • Moved highcharts timespans to our own intervals and not using the timespan intervals.
  • Better handling of default about and records page. Now includes an about.inc.example and records.inc.example to show what you can do. If about.inc or records.inc is missing, then the skin will show some default information rather than throwing an error.
  • Moved the forecast and earthquake functions into the main getData() class.
  • Adjusted .wind. on the records page to .windGust. which should fix the errors that have been reported.
  • Moved the moment.js utcOffset back to minutes instead of hours.
  • If no earthquake data is available in your region, we now display that information as "No recent earthquake data available!". If this affects you, you can expand your earthquake_maxradiuskm.
  • Cleaned up a lot of old code from the Highcharts extension included in this skin.

Uninstall v0.6 and older

If you have v0.6 or older installed, please backup your custom skin configurations and uninstall the skin completely. This is because I had to break apart the skin into 2 skins. One for the charts, and one for the website.

NOTE: If your weewx is in /home/weewx, you can find wee_extension at /home/weewx/bin/wee_extension

  1. sudo wee_extension --uninstall Belchertown
  2. Make sure you have no Belchertown folder in your skins folder.
  3. Make sure belchertown.py and belchertown_highchartsSearchX.py are not in the bin/user folder

Install

wget https://github.com/poblabs/weewx-belchertown/archive/weewx-belchertown-0.7.tar.gz

Then run

sudo wee_extension --install weewx-belchertown-0.7.tar.gz

Configure the weewx.conf pre-requisites and restart weewx when done.


Issues?

Please report any issues you find here. This helps me keep track of them.

Assets 2

@poblabs poblabs released this Aug 30, 2018 · 661 commits to master since this release

  • Skip NULL rain values in highcharts generator.
  • Updated rainRate value on the front page and records page.
  • Fix all time record for barometer. It was showing dewpoint. Oops!
  • Fixed a highcharts UTC graph error. Should prefer timezone offset now.
  • Updated highcharts rain rounding to 2 decimals.
  • Updated highcharts wind direction to have a hover and display the wind direction.
  • Consolidated the getSocialShare and getNOAAdata into getAllTime, and renamed getAllTime to getData. Larger plan is to consolidate as much as possible to be able to minimize the number of SLE loops. This may or may not have a better performance, but I'll try and consolidate where it makes sense in an attempt at better performance.
  • Added a version printout in syslog for easier troubleshooting.
  • Removed about.inc and reports.inc from the installer because the installer was overwriting them. Please read the README on how to create and edit these files.

Issues?

Please report any issues you find here. This helps me keep track of them.


All skin override options are advised to be in weewx.conf. If you have them in skin.conf, please have a backup before upgrading!

Quick install:

wget https://github.com/poblabs/weewx-belchertown/archive/weewx-belchertown-0.6.tar.gz

Then run

sudo wee_extension --install weewx-belchertown-0.6.tar.gz

Assets 2

@poblabs poblabs released this Aug 28, 2018 · 677 commits to master since this release

  • Fixed NOAA report conflict.
  • Updated highcharts to reflect the station's UTC timezone offset.
  • Front page MQTT live updates now optimized for metric and metricwx units.
  • Now uses UTC offset for moment.js and "Data Received" timestamp when using MQTT.
  • Fixed full moon icon.

All skin override options are advised to be in weewx.conf. If you have them in skin.conf, please have a backup before upgrading!

Quick install:

wget https://github.com/poblabs/weewx-belchertown/archive/weewx-belchertown-0.5.tar.gz

Then run

sudo wee_extension --install weewx-belchertown-0.5.tar.gz

Assets 2
You can’t perform that action at this time.