Add new data from NEEA and EPRI

Add entries for data from NEEA and EPRI. Update the README with instructions on how to contribute new data or raise issues regarding existing data on the site. Update the about page to link to the README instructions on contributing additional datasets.

Author: trynthink

README.md

@@ -1,3 +1,34 @@
 # Buildings Datasets
 
-This site provides a listing of datasets related to building energy use and building operations that might be useful to Catalyst prize participants and the broader Department of Energy Building Technologies Office (BTO) research and development community. 
+This site provides a listing of datasets related to building energy use and building operations that might be useful to the  U.S. Department of Energy Building Technologies Office (BTO) research and development community.
+
+## Issues
+
+If an API or dataset included on this site is no longer available or is using an outdated URL, please [open a new issue](https://github.com/trynthink/buildingsdatasets/issues) and provide a detailed description of the problem.
+
+## Contributions
+
+If you have a dataset you would like to see added, please fork this repository, update the database, and open a pull request. If you are unfamiliar with this process, there are many explanations and tutorails available online, such as [this one](https://git-scm.com/book/en/v2/GitHub-Contributing-to-a-Project). Note that the main branch for this project is `gh-pages`, not `master`.
+
+If you are not comfortable contributing changes directly, you may also [open a new issue](https://github.com/trynthink/buildingsdatasets/issues) and provide the URL and details of the dataset you'd like to have added.
+
+### How to Update the List of Data Resources
+
+To update the list of data resources on the site, begin by opening the file data/datasets.csv. In that file, each row corresponds to a data set shown on the site. To add your data, add a new row below the existing rows and populate the columns as indicated below. 
+
+- **status**: Populate this field with the value "1"
+- **sources**: Populate this field with the string "sunshot"
+- **category**: One of the three categories of data represented in the file (carefully observe the capitalization)
+- **title**: A short descriptive name for the data
+- **summary**: A description of the resource or available dataset(s)
+- **tags**: Include one or more *lowercase* strings separated by commas that describe the data format or formats available, e.g., "xlsx", "api", or "csv, xml"
+- **link**: The URL for the dataset or resource
+- **contact** (optional): If you would like to be associated with the data, add your full name to this field
+
+The remaining columns should be left blank.
+
+Once the CSV has been updated, the JSON database used to generate the website content must be updated to match. At a command prompt, navigate to the buildingsdatasets folder and use the following command:
+
+    ruby bin/csv_to_json.rb data/datasets.csv >data/datasets.json
+
+Commit and push the modified CSV and JSON files and then follow the standard process, as described in the tutorial linked above, for opening a new pull request.

about.md

@@ -6,4 +6,6 @@ permalink: /about/
 
 This website contains datasets on energy use and building operations and analysis tools for buildings-related datasets provided or collected by the U.S. Department of Energy [Building Technologies Office](http://www.energy.gov/eere/buildings/building-technologies-office). All data made available here are subject to the license terms, if any, specified by the original owners or stewards of the data.
 
+Have a dataset you'd like to see added? Fork us, make the update, and open a pull request. Detailed instructions are in the [readme](https://github.com/trynthink/buildingsdatasets#buildings-datasets).
+
 Additional data might be found by visiting [data.gov](http://www.data.gov), the home of the U.S. Government's open data.

data/datasets.csv

@@ -1 +1 @@
-status,sources,category,title,summary,description,value,tags,link,query,contact,identifier1,sunshot,Building Operations Data,One year occupant behavior/environment data for medium U.S. office,"One year of longitudinal data (fifteen minute interval) on local thermal conditions, related behaviors, and comfort of twenty-four occupants of a medium-sized office building in Philadelphia, PA.  Raw data in TXT format.",,,txt,http://en.openei.org/datasets/dataset/one-year-behavior-environment-data-for-medium-office,,Jared Langevin,1,sunshot,Building Operations Data,Long-term occupancy data for a residential and commercial building,Includes information about occupancy status of three rooms in a residential home and six commercial offices.  The residential and commercial occupancy data files cover one moth with a maximum time interval of approximately fifteen minutes.  Raw data are in CSV format.,,,csv,http://en.openei.org/datasets/dataset/long-term-occupancy-data-for-residential-and-commercial-building,,Bing Dong,1,sunshot,Building Operations Data,Long-term electricity and gas consumption for LBNL Building 74,15 minute electricity and 5 minute natural gas consumption data for Building 74 on the Lawrence Berkeley National Lab campus. Raw data in XLSX format.,,,xlsx,http://en.openei.org/datasets/dataset/lbnl-building-74,,,1,sunshot,Building Operations Data,Long-term energy/environment data for ORNL Research House # 3,"Oak Ridge National Laboratory, Building Technologies Research and Integration Center, Campbell Creek Research House #3 data for 2013-2014. Contains end use breakdowns of energy use and various indoor environmental conditions collected at a 15 minute time stamp.  Raw data in XLSX format.",,,xlsx,http://en.openei.org/datasets/dataset/ornl-research-house-3,,,1,sunshot,Building Operations Data,Long-term energy consumption & outdoor air temperature for 11 commercial buildings,Hourly energy consumption and outdoor air temperature data for 11 commercial buildings (office/retail).  Raw data in CSV format.,,,csv,http://en.openei.org/datasets/dataset/consumption-outdoor-air-temperature-11-commercial-buildings,,,1,sunshot,Building Operations Data,Long-term data on 3 office air-handling units,"Includes data on indoor/outdoor environmental conditions, supply/make up air conditions, and VAV box operations, at 1 minutes time resolution from 2014-2015. Raw data in the ZIP file are in CSV format.",,,csv,http://en.openei.org/datasets/dataset/long-term-data-on-3-office-air-handling-units,,,1,sunshot,Building Operations Data,ENERNOC 2012 Commercial Energy Consumption Data,"5-minute electricity consumption for 100 anonymized commercial and industrial sites. Metadata includes randomized lat/lng, facility square footage and industry. Raw data in GreenButton and CSV formats.",,,"csv, green button",http://open.enernoc.com/data/,,,1,sunshot,Building Operations Data,OpenBMS ,BMS data (energy/environment) for various buildings on the UC-Berkeley campus.  Data may be downloaded in CSV format or accessed via an API.  Further documentation at http://www.cs.berkeley.edu/~stevedh/smap2/intro.html#front-ends.,,,"csv, api",http://new.openbms.org/,,,1,sunshot,Building Operations Data,GSA Energy Usage Analysis System,"The EUAS application is a web based system which serves Energy Center of Expertise, under the Office of Facilitates Management and Service Programs. EUAS is used for tracking energy details for various energy sources namely electricity, natural gas, oil, chilled water, steam and renewable energy.  Contains monthly energy consumption data as well as Heating and Cooling degree data from associated weather stations, in XLSX format.",,,xlsx,http://www.gsa.gov/dg/EUAS.zip,,,1,sunshot,Building Stock & Energy Data,Buildings Energy Data Book,"The Data Book includes statistics on residential and commercial building energy consumption. Data tables contain statistics related to construction, building technologies, energy consumption, and building characteristics.",,,xlsx,http://buildingsdatabook.eren.doe.gov,,,1,sunshot,Developer Resources,Energy API browser,"Visual browser from the National Renewable Energy Laboratory of available energy data APIs.  The browser allows you to find new energy APIs based on keywords, so you can easily find data services that cover wind energy, building efficiency, Energy Star, or a host of other topics. API data are also available as a download.",,,api,http://en.openei.org/apps/api-browser/,,,1,sunshot,Developer Resources,LBNL Buildings APIs,This site provides everything website developers need to access Lawrence Berkeley National Lab's APIs for analyzing energy use in residential and commercial buildings.,,,api,https://developers.buildingsapi.lbl.gov,,,1,sunshot,Developer Resources,Building Performance Database API,"The Building Performance Database (BPD) is the nation's largest dataset of information about the energy-related characteristics of commercial and residential buildings. The BPD allows users to explore the data across real estate sectors and regions, and compare various physical and operational characteristics to gain a better understanding of market conditions and trends in energy performance.  This site has up-to-date documentation of the BPD Application Programming Interface (API).  The API enables the sharing of content and data between applications, meaning that third party web or mobile applications can be dynamically updated with BPD data.",,,api,https://sites.google.com/a/lbl.gov/bpd-api-documentation/,,,1,sunshot,Developer Resources,Technology Performance Exchange API,The Technology Performance Exchange API provides programmatic access to product and performance data.,,,api,https://performance.nrel.gov/developers,,,1,sunshot,Developer Resources,Building Components Library API,The Building Components Library is the U.S. Department of Energy's comprehensive online searchable library of energy modeling building blocks and descriptive metadata. ,,,api,https://bcl.nrel.gov/developer,,,1,sunshot,Developer Resources,National Residential Efficiency Measures Database,Here you will find tools intended to help software application developers access the data in the National Residential Efficiency Measures Database. This database of retrofit measures and associated costs can be used by software applications that evaluate residential efficiency measures. ,,,xml,http://www.nrel.gov/ap/retrofits/developer_tools.cfm,,,1,sunshot,Developer Resources,EIA Data API,"Access projected residential/commercial building stock and energy consumption (down to end use and technology type) for EIA Annual Energy Outlook, 2009-2040.",,,api,http://www.eia.gov/beta/api/,,,1,sunshot,Developer Resources,OpenEIS,Hosts open access algorithms for application to one's own building operations data.,,,api,https://github.com/VOLTTRON/openeis,,,
+status,sources,category,title,summary,description,value,tags,link,query,contact,identifier1,sunshot,Building Operations Data,One year occupant behavior/environment data for medium U.S. office,"One year of longitudinal data (fifteen minute interval) on local thermal conditions, related behaviors, and comfort of twenty-four occupants of a medium-sized office building in Philadelphia, PA.  Raw data in TXT format.",,,txt,http://en.openei.org/datasets/dataset/one-year-behavior-environment-data-for-medium-office,,Jared Langevin,1,sunshot,Building Operations Data,Long-term occupancy data for a residential and commercial building,Includes information about occupancy status of three rooms in a residential home and six commercial offices.  The residential and commercial occupancy data files cover one moth with a maximum time interval of approximately fifteen minutes.  Raw data are in CSV format.,,,csv,http://en.openei.org/datasets/dataset/long-term-occupancy-data-for-residential-and-commercial-building,,Bing Dong,1,sunshot,Building Operations Data,Long-term electricity and gas consumption for LBNL Building 74,15 minute electricity and 5 minute natural gas consumption data for Building 74 on the Lawrence Berkeley National Lab campus. Raw data in XLSX format.,,,xlsx,http://en.openei.org/datasets/dataset/lbnl-building-74,,,1,sunshot,Building Operations Data,Long-term energy/environment data for ORNL Research House # 3,"Oak Ridge National Laboratory, Building Technologies Research and Integration Center, Campbell Creek Research House #3 data for 2013-2014. Contains end use breakdowns of energy use and various indoor environmental conditions collected at a 15 minute time stamp.  Raw data in XLSX format.",,,xlsx,http://en.openei.org/datasets/dataset/ornl-research-house-3,,,1,sunshot,Building Operations Data,Long-term energy consumption & outdoor air temperature for 11 commercial buildings,Hourly energy consumption and outdoor air temperature data for 11 commercial buildings (office/retail).  Raw data in CSV format.,,,csv,http://en.openei.org/datasets/dataset/consumption-outdoor-air-temperature-11-commercial-buildings,,,1,sunshot,Building Operations Data,Long-term data on 3 office air-handling units,"Includes data on indoor/outdoor environmental conditions, supply/make up air conditions, and VAV box operations, at 1 minutes time resolution from 2014-2015. Raw data in the ZIP file are in CSV format.",,,csv,http://en.openei.org/datasets/dataset/long-term-data-on-3-office-air-handling-units,,,1,sunshot,Building Operations Data,ENERNOC 2012 Commercial Energy Consumption Data,"5-minute electricity consumption for 100 anonymized commercial and industrial sites. Metadata includes randomized lat/lng, facility square footage and industry. Raw data in GreenButton and CSV formats.",,,"csv, green button",http://open.enernoc.com/data/,,,1,sunshot,Building Operations Data,OpenBMS ,BMS data (energy/environment) for various buildings on the UC-Berkeley campus.  Data may be downloaded in CSV format or accessed via an API.  Further documentation at http://www.cs.berkeley.edu/~stevedh/smap2/intro.html#front-ends.,,,"csv, api",http://new.openbms.org/,,,1,sunshot,Building Operations Data,GSA Energy Usage Analysis System,"The EUAS application is a web based system which serves Energy Center of Expertise, under the Office of Facilitates Management and Service Programs. EUAS is used for tracking energy details for various energy sources namely electricity, natural gas, oil, chilled water, steam and renewable energy.  Contains monthly energy consumption data as well as Heating and Cooling degree data from associated weather stations, in XLSX format.",,,xlsx,http://www.gsa.gov/dg/EUAS.zip,,,1,sunshot,Building Stock & Energy Data,Buildings Energy Data Book,"The Data Book includes statistics on residential and commercial building energy consumption. Data tables contain statistics related to construction, building technologies, energy consumption, and building characteristics.",,,xlsx,http://buildingsdatabook.eren.doe.gov,,,1,sunshot,Developer Resources,Energy API browser,"Visual browser from the National Renewable Energy Laboratory of available energy data APIs.  The browser allows you to find new energy APIs based on keywords, so you can easily find data services that cover wind energy, building efficiency, Energy Star, or a host of other topics. API data are also available as a download.",,,api,http://en.openei.org/apps/api-browser/,,,1,sunshot,Developer Resources,LBNL Buildings APIs,This site provides everything website developers need to access Lawrence Berkeley National Lab's APIs for analyzing energy use in residential and commercial buildings.,,,api,https://developers.buildingsapi.lbl.gov,,,1,sunshot,Developer Resources,Building Performance Database API,"The Building Performance Database (BPD) is the nation's largest dataset of information about the energy-related characteristics of commercial and residential buildings. The BPD allows users to explore the data across real estate sectors and regions, and compare various physical and operational characteristics to gain a better understanding of market conditions and trends in energy performance.  This site has up-to-date documentation of the BPD Application Programming Interface (API).  The API enables the sharing of content and data between applications, meaning that third party web or mobile applications can be dynamically updated with BPD data.",,,api,https://sites.google.com/a/lbl.gov/bpd-api-documentation/,,,1,sunshot,Developer Resources,Technology Performance Exchange API,The Technology Performance Exchange API provides programmatic access to product and performance data.,,,api,https://performance.nrel.gov/developers,,,1,sunshot,Developer Resources,Building Components Library API,The Building Components Library is the U.S. Department of Energy's comprehensive online searchable library of energy modeling building blocks and descriptive metadata. ,,,api,https://bcl.nrel.gov/developer,,,1,sunshot,Developer Resources,National Residential Efficiency Measures Database,Here you will find tools intended to help software application developers access the data in the National Residential Efficiency Measures Database. This database of retrofit measures and associated costs can be used by software applications that evaluate residential efficiency measures. ,,,xml,http://www.nrel.gov/ap/retrofits/developer_tools.cfm,,,1,sunshot,Developer Resources,EIA Data API,"Access projected residential/commercial building stock and energy consumption (down to end use and technology type) for EIA Annual Energy Outlook, 2009-2040.",,,api,http://www.eia.gov/beta/api/,,,1,sunshot,Developer Resources,OpenEIS,Hosts open access algorithms for application to one's own building operations data.,,,api,https://github.com/VOLTTRON/openeis,,,1,sunshot,Building Operations Data,EPRI Load Shape Library,"Electric load shapes for individual and aggregated buildings, and energy conservation measures, for a variety of climate zones, building types, and grid operating regions. Data queries made on the website can be downloaded in CSV format.",,,csv,http://loadshape.epri.com,,,1,sunshot,Building Operations Data,NEEA Building Stock Assessments,"Residential sub-metered electricity use data and metadata, as well as reports and metadata for commercial and industrial buildings. Raw data in plain text and Microsoft Access formats, depending on the data or metadata set.",,,"txt, access",http://neea.org/resource-center/regional-data-resources,,,