Name: datasci-SF-Environment-Benchmark
Owner: SFBrigade
Description: Set of applications to visualize SF building energy consumption and greenhouse gas emissions.
Forked from: smoningi/SF-Environment-Benchmark
Created: 2016-08-12 22:26:41.0
Updated: 2018-03-05 05:22:40.0
Pushed: 2018-03-25 19:09:21.0
Homepage: http://old.codeforsanfrancisco.org/datasci-SF-Environment-Benchmark/
Size: 9364
Language: JavaScript
GitHub Committers
| User | Most Recent Commit | # Commits |
|---|
Other Committers
| User | Most Recent Commit | # Commits |
|---|
Set of applications to visualize SF building energy consumption and greenhouse gas emissions.
This project is part of Data Science Working Group at Code for San Francisco
The goal of this project is to visualize building energy consumption and greenhouse gas emissions to encourage owners and building managers to make proper changes. From the SF Environment website:
The Existing Commercial Buildings Ordinance requires commercial building owners to track how much energy their building uses each year, and every 5 years to have a professional identify opportunities to save money by saving energy.
More about the Existing Commercial Buildings Ordinance
The dashboard is a way to show building owners and property managers their building's performance in comparison to other buildings in San Francisco of similar use case and size.
| Name | Slack Handle | Contribution | | —| — | — | | Anna Kiefer | @askiefer | Planning/Development | | Eric Youngson | @eayoungs | Planning/Development | | Juliana Vislova | @juliana | Design | | Tyler Field | @tyler | Development | | Peter W | @peterw | Development | | Sanat Moningi | @sanat | Visualization | | Geoffrey Pay | @gpay | Visualization | | Baolin Liu | | Modeling |
Here's how to get started contributing:
Fork this repo, then clone your repo locally
t clone <your-repo>
<this-repo's-name>
t remote add upstream <this-repo>
Create a feature branch:
t checkout -b <feature-branch>
Do some work:
m <some-files>
When you're ready, commit, merge any upstream changes, deal with conflicts, and push your branch (aka, forking workflow)
t commit -am 'my awesome feature'
t pull upstream master
solve conflicts
t push
Create a Pull Request from your pushed branch (compare branch) to this repo (base branch)
Install dependencies:
dashboard
board$ npm install
Use Webpack to launch a server and watch files for changes:
board$ npm run start
Use Webpack to watch files, but not run a server:
board$ npm run watch
Use Webpack to bundle files for production site:
board$ npm run build
Now the files in dashboard/dist/ are all you need to copy to a production server.
The script pulls live data from DataSF using the function Dashboard.startQuery().
Buildings are identified using Assessor Parcel Numbers (APNs). The requested APN is read from url params with the function helpers.getUrlVars(). The AJAX request to DataSF is made using apiCalls.propertyQuery(), which is a wrapper around the soda-js library.
If the APN doesn't exist, the page gives the error message “The record for the chosen building was not found”.
If a requested property is of an unsupported use type (supported building types are “Office”, “Hotel”, or “Retail Store”), the page displays the message “The chosen building type is not supported by this dashboard interface”. Supported building types are defined as keys in the Dashboard.groups object.
If a building doesn't have data for the latest year, the page will show the data for the latest year available.
If a building has never complied, the page will display a message saying “{BUILDING NAME} could not be ranked against other {BUILDING TYPE}s using the latest benchmark data.”
The code in src/js/ is roughly split into modules by function:
javascript files for individual pages (estar, ghg, eui) in src set options and functions that are unique to each page