https://github.com/ericoc/watertable
Water (Data)Table(s) Usage
https://github.com/ericoc/watertable
Last synced: 11 months ago
JSON representation
Water (Data)Table(s) Usage
- Host: GitHub
- URL: https://github.com/ericoc/watertable
- Owner: ericoc
- Created: 2024-11-15T16:45:28.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-30T17:18:32.000Z (over 1 year ago)
- Last Synced: 2024-11-30T18:27:19.910Z (over 1 year ago)
- Language: HTML
- Size: 935 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
See https://github.com/ericoc/utilities/
# 💧 Water Table 🚰
The [Philadelphia Water Department](https://water.phila.gov/) website
allows for a residential account holder to download an export of their water usage
in "comma-separated values" (CSV) file format.
---
## Export
A CSV can be downloaded by "Gallons" of water used "Daily" from the
"[Detailed Usage](https://secure8.i-doxs.net/CityOfPhiladelphiaWRB/Secure/Usage.aspx)"
section of the Philadelphia Water Department (PWD) website.
The default export file is named "`ChartData.csv`", containing data such as
the following:
```
Access Code, Time Interval, Consumption, Units
00145xxxx, 11/27/2024, 18.7013, Gallons
00145xxxx, 11/28/2024, 35.9065, Gallons
00145xxxx, 11/29/2024, 35.1584, Gallons
00145xxxx, 11/30/2024, 44.8831, Gallons
00145xxxx, 12/01/2024, 71.8130, Gallons
00145xxxx, 12/02/2024, 25.4338, Gallons
00145xxxx, 12/03/2024, 23.9377, Gallons
etc..
```
Only the second and third columns of this CSV file truly matter, since the first
column seems to be associated to the PWD account, while the fourth column value
should always be " ` Gallons`".
## Import
With a `ChartData.csv` file from PWD, the Django management command `fill`
is used to import records into the Django database from the `.CSV` file data:
```python
$ python3 manage.py fill
Created: Wednesday, November 27, 2024 (2024-11-27) [18.7013 gallons]
Created: Thursday, November 28, 2024 (2024-11-28) [35.9065 gallons]
Created: Friday, November 29, 2024 (2024-11-29) [35.1584 gallons]
Created: Saturday, November 30, 2024 (2024-11-30) [44.8831 gallons]
Created: Sunday, December 01, 2024 (2024-12-01) [71.813 gallons]
Created: Monday, December 02, 2024 (2024-12-02) [25.4338 gallons]
Created: Tuesday, December 03, 2024 (2024-12-03) [23.9377 gallons]
Total: 7
Done.
```
---
## Refreshing
Finally, downloading a fresh `ChartData.csv` file from the Philadelphia Water
Department website, and running `manage.py fill` again will update, or create,
any water usage records for the appropriate days.
It appears that the Philadelphia Water Department website may only preserve
approximately two (2) years of historical water usage.
---
## Statistics
Once water usage data is present in the database, the management command
`manage.py weekend` will display interesting statistics about the water usage:
```python
$ python3 manage.py weekend
From: Thursday, September 15, 2022 (2022-09-15)
To: Wednesday, December 04, 2024 (2024-12-04)
Weekdays: 19,359.5858 gallons / 578 week days = average 33.4941 gallons.
Weekends: 13,119.3358 gallons / 229 weekend days = average 57.2897 gallons.
Total: 32,478.9216 gallons / 807 days = average 40.2465 gallons.
```
The total and average water usage per day is shown, as well as the total
and average water usage on week-days versus weekends.
---
## Software
The main page (`/`) uses DataTables, while `/chart/` uses HighCharts.
Both DataTables and HighCharts depend upon identical JSON data from the same
Django REST framework API location:
`/api/usage/?format=json`
---
## Examples
### DataTables
- https://water.ericoc.com/
### HighCharts
- https://water.ericoc.com/chart/
### Django REST framework API
- https://water.ericoc.com/api/usage/