This release contains these significant new features:

• OED now supports virtually any unit including site defined units. Users can graph in any unit and that can be different from what meters collect in. For example, OED supports energy units, power units, mass units, temperature, money and CO₂. To support this feature there are new admin pages for conversions and units. As such, it is more than an energy dashboard and has become a resource dashboard.
• Information can now be normalized by area. As such, any graphic can show the data per square feet or square meters.
• Most admin pages have had their look completely redone so information shows up on cards and there are separate pop-ups for creating and editing items.
• Many of the underlying software packages used by OED have been updated for better features and continued security.
• Each meter knows the frequency at which readings are provided and uses this information to more intelligently choose the quality of data shown when graphing. This now means that OED can graph data in a nice way that is provided on long time scales, such as monthly.
• There are many UI (User Interface) updates across the OED pages.
• Many other issues were addressed.

Updating note

The significant upgrade of the database version requires special steps if you are upgrading/migrating from a previous release. The documentation covers the needed steps.

While this is currently listed as a draft, it should be ready for production use. It has been in testing for a while with some changes to the code. Thus, a final check is in progress and should be done soon.

This release contains these new features:

• For maps: maps can include groups, the time range can be selected as day/week/4 weeks, auto select map if only one available, sort map names alphabetically on menu, full support for maps rotated from true north, admins can set the maximum circle size, and maps can be made the default graphic type.
• The speed of getting data for graphing was improved. This change also allows for the seeing of the original meter values instead of minute points when the user zooms in on a line graphic.
• The x-axis date on line graphics now gives the middle of the dates included in the raw data in the point. The dates labeling bar graphics are now inclusive to remove the next day.
• Admins can now view/edit all values on groups such as GPS, note, etc.
• Exported data includes both start and end time/date and bar data is sorted by date.

Other changes:

• Obvius uploads now use the Obvius OED user so the old environment variable is eliminated.
• More items are internationalized and all Spanish strings are done.
• Improved site installation and directions.
• Uncalibrated maps cannot be made visible by the admin.
• Leaving a page edited by the admin now warns about unsaved changes.
• Rate limiting was added to total requests and requests for raw data. The default limits can be adjusted by the admin. This should stop users from making repeated requests either by mistake or to be malicious.
• Chart links: chart links for bar graphics now work and resized line graphics have better links.
• Packages were updated so most security issues have been addressed.

Significant features in release

Data acquisition

• OED now accepts both meter and reading upload via CSV files.
• CSV uploads can either be done via a drop zone on an admin page or through a script
• OED accepts readings in many new ways including cumulative with or without reset, only having end only date/time, either chronological order, control over gaps between readings and variation in the length a reading spans and files with duplicated readings.
• CSV files can be either gziped or not and can have a header row or not.
• Significant enhancements in error checking and reporting for acquired readings.
• Acquisition of MAMAC and Obvius data go through the enhanced data acquisition pipeline so these have all the new features.

Other changes

• Map enhancements include correct calculation of circle size and allowing arbitrarily rotated maps (admin interface coming on that).
• You can now export the raw meter data on a graphic and not just the graphic points.
• OED now supports multiple types of users so you can grant access for admin, CSV upload & Obvius upload, and ability to export larger quantities of data rights individually.
• Anyone using OED can now change to another supported language to override default language.
• Color of lines, bars and circles were improved.
• Hovering over a graphic now shows fewer digits so more user friendly.
• User warned if JavaScript is not enables since site will not function properly.
• A number of general issues/bugs were addressed.

Graphics Changes

• Use Plotly for all graphics which allows for zooming and scrolling in line graphic.
• Added a map graphic to show usage geographically.
• Simplified comparison graphic.

Other Changes

• Help popups inside OED web pages that link to full help pages.
• OED is now time zone aware. This means that all graphics now show the meter time rather than local time which varied by user.
• Support for acquiring meter data from Obvius.
• Created standard pipeline for acquiring data and clear API for its usage.
• Many issues/bugs were addressed.

TODO

New features:

• Comparison charts for meters and groups
• Admin panel which allows admin users to both import meter readings and set default preferences for non-admin users
• Ability to share charts
• Added preset time intervals to bar and comparison charts
• Improved design (using Bootstrap 4)
• Improved mobile device support
• Simplified installation process

Bug fixes:

• Fixed groups not graphing in certain circumstances
• Fixed exporting groups with commas in their name
• Show an error notification if an admin user attempts to create a cyclic group

The first official release of OED.

See the README for installation instructions.