Water Watcher Plasmoid

Water Watcher (QML Plasmoid)
http://code.google.com/p/plasma-wateriv/

Water Watcher is a QML Plasmoid that displays the most recent real-time water data from the USGS Instantaneous Values Web Service. Data readings are recorded every 15 minutes and transmitted to the service hourly. Water data is available from thousands of sites around the United States.

-------------
Requirements:

* KDE 4.7+ (http://www.kde.org)
* WaterIV Data Engine v0.3.1 (plasma-dataengine-wateriv)
* WaterSites Data Engine v0.1.0 (plasma-dataengine-watersites) (optional)

This plasmoid requires installation of the WaterIV Data Engine (included in the ALL download or available separately). The WaterSites Data Engine is optional but is required to "Search for Sites" from within the plasmoid.

-------------
Installation:

1) Install the required data engines.

$ sudo apt-get install build-essential cmake kdelibs5-dev
$ cd plasma-dataengine-wateriv-0.3.1/
$ cmake -DCMAKE_INSTALL_PREFIX=/usr ./
$ make
$ sudo make install
$ kbuildsycoca4

Repeat this process for the WaterSites data engine.
Note: when upgrading from a previous version it may be necessary to logout and login for the change to be recognized.

2) Install the Water Watcher plasmoid.

$ plasmapkg -i waterwatcher-0.3.2.plasmoid

OR use

Add Widgets -> Get New Widgets -> Install from local file

--------------
Configuration:

To configure the plasmoid you must provide a valid site code as the 'data source'.

You can search for site codes from within the plasmoid when the WaterSites data engine is installed. Double clicking an entry will use it as a source. Long clicking an entry will append it to the existing source.

You can also use the NSWIS Mapper (http://wdr.water.usgs.gov/nwisgmap/index.html) to find nearby site codes.

Valid data sources include:
* a single site code or comma separated list of site codes
* a fully formed request url or a partial url (everything after the ?)

Examples: a single code: 01646500
list of codes: 01646500,09506000
a partial url: sites=01646500&parameterCd=00060,00065

You can use the url generation tool to create request urls:
http://waterservices.usgs.gov/rest/IV-Test-Tool.html

----------------------------------
0.3.2 : plasma-applet-waterwatcher

* Add UI: added "Any County" and "Any Agency" filters to site search dialog.
* Add UI: net_error dialog now allows immediately retrying failed connections.
* BugFix: plasmoid remembers index of displayed timeseries between launches.
* BugFix: #17; fixed a crash occuring when switching between recent sources on unconfigured instances of the plasmoid.

----------------------------------
0.3.1 : plasma-applet-waterwatcher

* Add UI: the "recent value" tab now displays up to the last four values.
* BugFix: #16; colors and theme SVGs used; info displays correctly with various themes.
* Engine: now requires plasma-dataengine-wateriv-0.3.1 (engine bugfix: #15).

----------------------------------
0.3.0 : plasma-applet-waterwatcher

* Add UI: a site info_panel that displays id, lat, lon, and other site codes.
* BugFix: issue 14; plasmoid supports multiple qualifiers per value.
* BugFix: issue 9; plasmoid keyboard shortcut toggles visibility of the dialog.
* Add UI: a filter panel that constructs valid site search queries; available search filters are state, county, agency, and site type.
* Add UI: a site search panel that interacts with the USGS Site Web Service.
* Engine: (optional) "site search" requires plasma-dataengine-watersites-0.1.0.
* Engine: now requires plasma-dataengine-wateriv-0.3.0 (engine rewrite).

----------------------------------
0.2.1 : plasma-applet-waterwatcher

* Add UI: the configuration tab remembers recent sources (last ten) and allows switching between them with the up / down keys.
* Add UI: a net_error indicator that is displayed next to values that are from cache; a net_error dialog that shows a more detailed error message.
* BugFix: display / retain cached values when update results in network error.
* BugFix: polling interval reads correctly from config (units are mins not ms).
* BugFix: engine updates are recognized immediately and not after next update.
* Engine: now requires plasma-dataengine-wateriv-0.2.1 (engine update bugfix).

----------------------------------
0.2.0 : plasma-applet-waterwatcher

* Add UI: a "configuration" tab that allows changing the data source and viewing errors when the engine rejects a data source.
* Add UI: a "recent value" tab that displays additional information and allows switching between data series with the mouse or arrow keys.
* Add UI: a tabbed dialog that is toggled on single click on the plasmoid.
* Mod UI: switching between data series now done with long click on plasmoid.
* Mod UI: improved error reporting; major refactoring of UI into components.
* BugFix: displays all values in a series instead of only first set.
* Engine: now requires plasma dataengine-wateriv-0.2.0.

----------------------------------
0.1.0 : plasma-applet-waterwatcher

* Basic configuration provided by plasmoid settings dialog.
* UI allows switching between returned values with single click.
* Initial release: a basic plasmoid that displays the most recent value.