Skip to content

slacgismo/buildings

Repository files navigation

GridLAB-D Buildings

Building data by state and county.

Loading data

>>> from buildings import Buildings
>>> data = Buildings(state="NH",county="Grafton",aws_profile="gridlabd")
>>> data
                          climate  year   centroid                                          footprint  height  ground_area  code  class  mixed  type  windows  floors  floor_area
id                                                                                                                                                                               
87MCM9QG+43HG-13-13-13-12      6A  1972  drv0d1h7y                         drv0d1hebqt,7t62,7gy3,kqfz     4.0        112.5     1      1  False     1     0.14       1       112.5
87MCM9QG+2325-11-11-13-11      6A  1972  drv0d1h6h    drv0d1h66se,yu,7dx,krm,m9f,m2k,nhf,3u2v,45e,744     3.9         96.3     1      1  False     1     0.14       1        96.3
87MCM9QG+352F-11-9-10-8        6A  1972  drv0d1hdc                          drv0d1hddhr,e048,e0zx,g1q     3.0         49.5     1      1  False     1     0.14       1        49.5
87MCPFQ9+7RCP-14-12-14-13      6A     0  drv0u6316                            drv0u63158x,28m,f55,t5k    28.2        136.3     5      1  False     0     0.14       1       136.3
87MCMCR3+56M2-10-4-10-4        6A  1988  drv0dc8em                            drv0dc8ej17,t52,w7z,n9d     4.6         53.7     2      1  False     5     0.14       1        53.7
...                           ...   ...        ...                                                ...     ...          ...   ...    ...    ...   ...      ...     ...         ...
87MCH6HR+6VM4-29-21-29-21      6A  1975  drszzj5s9                         drszzj5mjz2,td9r,sjm8,eb7e     4.2        483.6     1      4  False   150     0.07       1       483.6
87MCPCVC+VP4X-17-17-19-17      6A  1972  drv0g5qr5                drv0g5qr2by,t3m,qzpd,qvdg,qty7,q6xy     4.1        242.4     1      8  False     5     0.21       1       242.4
87PC636M+9FXQ-16-14-17-13      6A  1920  druge825t                          druge825jyw,7wb,hjve,7bm3     7.4        148.5     1      1  False    20     0.14       2       296.9
87PC4397+H7H3-23-12-23-13      6A     0  drufgp95r                         drufgp968z0,4v6t,hn9y,7fn2    17.1        267.1     1      8  False     0     0.21       1       267.1
87M9PP46+R5Q3-16-16-16-16      6A     0  dru8eh8kh  dru8eh87ggb,96,fkr,fwt,k162,kdsx,kect,ks5g,kqn...     7.0        207.0     2      1  False    21     0.14       2       414.1

[47529 rows x 13 columns]

Notes

  1. Prior to August 7, 2023 access is retricted to users with permissiong to read the AWS repository using an AWS profile for the HiPAS GridLAB-D project.

Data Fields

Field Type Description
id str Building unique identifier (see AutoBEM-4 for details)
climate str Building climate zone
year int Year of construction
centroid str Geohash of building centroid
footprint str Geohash of building footprint (see Note 1)
height real Building height from imagery (m^2)
ground_area real Building footprint area (m^2)
code int Building code (see building_code.json)
class int Building class (see building_class.json)
mixed bool Mixed type flag
type int Building type (see building_type.json)
windows real Average window wall ratio (pu wall area)
floors int Number of floors
floor_area real Total conditioned floor area (m^2)

Notes:

  1. The building footprint is coded using geohashes, except that only the trailing characters of the hash code are recorded. For example
drv0d1hebqt,7t62,7gy3,kqfz

should be interpreted as

drv0d1hebqt,drv0d1h7t62,drv0d1h7gy3,drv0d1hkqfz

Data Accessors

Some fields are encoded for storage efficient. Data accessors are provided to decode these fields.

get_centroid(index)

Get the building centroid. Centroid are recorded with an accuracy of 2.4 cos(latitude) meters.

get_footprint(index)

Get the building footprint. Footprint vertices are recorded with an accurage of 7.4 cos(latitude) meter.

get_class(index)

Get the building class. See building_class.json for a list of known classes.

get_code(index)

Get the building construction code. See building_code.json for a list of known building codes.

get_type(index)

Get the building type. See building_type.json for a list of known building types.

Reference

  • New, Joshua et al, "AutoBEM-4", Oak Ridge National Laboratory, May 2023.

About

HiPAS GridLAB-D US building data

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages