{"id":192499,"name":"ComStock","description":"National scale modeling of the U.S. commercial building stock supported by U.S. DOE, LADWP, and others and maintained by NREL.","url":"https://github.com/NatLabRockies/ComStock","last_synced_at":"2026-05-16T01:01:01.391Z","repository":{"id":49021111,"uuid":"305039288","full_name":"NatLabRockies/ComStock","owner":"NatLabRockies","description":"National scale modeling of the U.S. commercial building stock supported by U.S. DOE, LADWP, and others and maintained by NREL","archived":false,"fork":false,"pushed_at":"2026-05-06T17:04:51.000Z","size":650115,"stargazers_count":50,"open_issues_count":70,"forks_count":27,"subscribers_count":12,"default_branch":"main","last_synced_at":"2026-05-06T19:10:30.275Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NatLabRockies.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-10-18T06:40:02.000Z","updated_at":"2026-05-06T17:04:55.000Z","dependencies_parsed_at":"2022-09-20T08:30:52.357Z","dependency_job_id":"255f44e3-9103-4ac7-b7de-2e447c2e3dbe","html_url":"https://github.com/NatLabRockies/ComStock","commit_stats":{"total_commits":662,"total_committers":17,"mean_commits":38.94117647058823,"dds":0.8413897280966767,"last_synced_commit":"4d7baa7d1009afa3689ed0c120c4ae8b9f1a1719"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/NatLabRockies/ComStock","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NatLabRockies%2FComStock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NatLabRockies%2FComStock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NatLabRockies%2FComStock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NatLabRockies%2FComStock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NatLabRockies","download_url":"https://codeload.github.com/NatLabRockies/ComStock/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NatLabRockies%2FComStock/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33086727,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T20:25:35.270Z","status":"ssl_error","status_checked_at":"2026-05-15T20:25:34.732Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"owner":{"login":"NatLabRockies","name":"National Laboratory of the Rockies","uuid":"1906800","kind":"organization","description":"","email":null,"website":"http://www.nrel.gov","location":"Golden, CO","twitter":null,"company":null,"icon_url":"https://avatars.githubusercontent.com/u/1906800?v=4","repositories_count":599,"last_synced_at":"2026-01-22T09:57:55.744Z","metadata":{"has_sponsors_listing":false},"html_url":"https://github.com/NatLabRockies","funding_links":[],"total_stars":9633,"followers":1309,"following":0,"created_at":"2022-11-02T20:42:15.539Z","updated_at":"2026-01-22T09:57:55.745Z","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NatLabRockies","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NatLabRockies/repositories"},"packages":[],"commits":{"id":11615202,"full_name":"NatLabRockies/ComStock","default_branch":"master","total_commits":1593,"total_committers":21,"total_bot_commits":0,"total_bot_committers":0,"mean_commits":75.85714285714286,"dds":0.8336472065285625,"past_year_total_commits":337,"past_year_total_committers":14,"past_year_total_bot_commits":0,"past_year_total_bot_committers":0,"past_year_mean_commits":24.071428571428573,"past_year_dds":0.6617210682492581,"last_synced_at":"2026-05-11T02:28:20.417Z","last_synced_commit":"f25ac375311acb2448b4ee1665a8680e92abd24b","created_at":"2026-01-25T01:00:29.709Z","updated_at":"2026-05-11T02:26:48.436Z","committers":[{"name":"JanghyunJK","email":"janghyun.kim@nrel.gov","login":"JanghyunJK","count":265},{"name":"Matthew Dahlhausen","email":"matthew.dahlhausen@gmail.com","login":"mdahlhausen","count":227},{"name":"Praprost","email":"mprapros@nrel.gov","login":null,"count":193},{"name":"Landan Taylor","email":"landan.taylor@nrel.gov","login":"LandanT","count":167},{"name":"Xiong","email":"jie.xiong@nrel.gov","login":"JieXiong9119","count":142},{"name":"Eric Ringold","email":"ericringold@gmail.com","login":"eringold","count":135},{"name":"Andrew Parker","email":"asparke2@gmail.com","login":"asparke2","count":129},{"name":"Wenyi Kuang","email":"wkuang@nrel.gov","login":"wenyikuang","count":85},{"name":"Chris CaraDonna","email":"50876267+ChristopherCaradonna","login":"ChristopherCaradonna","count":83},{"name":"Ry Horsey","email":"horsey.henry@gmail.com","login":"rHorsey","count":55},{"name":"CaraDonna","email":"ccaradon@nrel.gov","login":null,"count":37},{"name":"Amy Van Sant","email":"41447070+amylebar","login":"amylebar","count":15},{"name":"Allen","email":"aallen@nrel.gov","login":null,"count":15},{"name":"David Goldwasser","email":"david.goldwasser@nrel.gov","login":"DavidGoldwasser","count":13},{"name":"Eric Bonnema","email":"eric.bonnema@nrel.gov","login":"bonnema","count":11},{"name":"Alex Swindler","email":"Alex.Swindler@nrel.gov","login":"axelstudios","count":6},{"name":"carlobianchi89","email":"carlo.bianchi@utah.edu","login":"carlobianchi89","count":4},{"name":"Lauren Adams","email":"48136858+laurenliz22","login":"laurenliz22","count":3},{"name":"Marley Praprost","email":"41025458+mpraprost","login":"mpraprost","count":3},{"name":"Amy Allen","email":"amy.allen@colorado.edu","login":null,"count":3},{"name":"Lauren Klun","email":"60903520+laurenklun","login":"laurenklun","count":2}],"past_year_committers":[{"name":"Landan Taylor","email":"landan.taylor@nrel.gov","login":"LandanT","count":114},{"name":"Matthew Dahlhausen","email":"matthew.dahlhausen@gmail.com","login":"mdahlhausen","count":77},{"name":"Praprost","email":"mprapros@nrel.gov","login":null,"count":37},{"name":"Andrew Parker","email":"asparke2@gmail.com","login":"asparke2","count":34},{"name":"christophercaradonna","email":"christopher.caradonna@nrel.gov","login":"ChristopherCaradonna","count":24},{"name":"Eric Ringold","email":"ericringold@gmail.com","login":"eringold","count":21},{"name":"JieXiong9119","email":"69597597+JieXiong9119","login":"JieXiong9119","count":10},{"name":"Alex Swindler","email":"Alex.Swindler@nrel.gov","login":"axelstudios","count":6},{"name":"Ry Horsey","email":"horsey.henry@gmail.com","login":"rHorsey","count":3},{"name":"Lauren Adams","email":"48136858+laurenliz22","login":"laurenliz22","count":3},{"name":"Amy Van Sant","email":"41447070+amylebar","login":"amylebar","count":3},{"name":"Amy Allen","email":"amy.allen@colorado.edu","login":null,"count":3},{"name":"Marley Praprost","email":"41025458+mpraprost","login":"mpraprost","count":1},{"name":"Eric Bonnema","email":"eric.bonnema@nrel.gov","login":"bonnema","count":1}],"commits_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub/repositories/NatLabRockies%2FComStock/commits","host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2026-05-16T00:00:17.015Z","repositories_count":6234866,"commits_count":894568456,"contributors_count":34908014,"owners_count":1153603,"icon_url":"https://github.com/github.png","host_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub/repositories"}},"issues_stats":{"full_name":"NatLabRockies/ComStock","html_url":"https://github.com/NatLabRockies/ComStock","last_synced_at":"2026-05-11T02:03:02.639Z","status":"active","issues_count":7,"pull_requests_count":38,"avg_time_to_close_issue":null,"avg_time_to_close_pull_request":483368.02777777775,"issues_closed_count":0,"pull_requests_closed_count":36,"pull_request_authors_count":11,"issue_authors_count":4,"avg_comments_per_issue":0.0,"avg_comments_per_pull_request":0.3157894736842105,"merged_pull_requests_count":31,"bot_issues_count":0,"bot_pull_requests_count":0,"past_year_issues_count":7,"past_year_pull_requests_count":38,"past_year_avg_time_to_close_issue":null,"past_year_avg_time_to_close_pull_request":483368.02777777775,"past_year_issues_closed_count":0,"past_year_pull_requests_closed_count":36,"past_year_pull_request_authors_count":11,"past_year_issue_authors_count":4,"past_year_avg_comments_per_issue":0.0,"past_year_avg_comments_per_pull_request":0.3157894736842105,"past_year_bot_issues_count":0,"past_year_bot_pull_requests_count":0,"past_year_merged_pull_requests_count":31,"created_at":"2026-02-05T02:00:09.374Z","updated_at":"2026-05-11T02:03:02.640Z","repository_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/NatLabRockies%2FComStock","issues_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/NatLabRockies%2FComStock/issues","issue_labels_count":{"postprocessing":2,"upgrade measure":1,"bug":1},"pull_request_labels_count":{"postprocessing":10,"upgrade measure":5,"sampling":4,"documentation":4,"infrastructure":2,"reporting measure":2,"workflow measure":2,"Pull Request - Ready for CI":1,"bug":1},"issue_author_associations_count":{"CONTRIBUTOR":7},"pull_request_author_associations_count":{"CONTRIBUTOR":33,"COLLABORATOR":3,"MEMBER":1,"NONE":1},"issue_authors":{"mdahlhausen":3,"amylebar":2,"amyeallen1":1,"ChristopherCaradonna":1},"pull_request_authors":{"mdahlhausen":8,"ChristopherCaradonna":7,"mpraprost":7,"LandanT":5,"JanghyunJK":2,"JieXiong9119":2,"amyeallen1":2,"eringold":2,"bonnema":1,"asparke2":1,"rHorsey":1},"host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2026-05-16T00:00:24.458Z","repositories_count":14606578,"issues_count":34167615,"pull_requests_count":111900848,"authors_count":11263494,"icon_url":"https://github.com/github.png","host_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories","owners_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/owners","authors_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors"},"past_year_issue_labels_count":{"postprocessing":2,"bug":1,"upgrade measure":1},"past_year_pull_request_labels_count":{"postprocessing":10,"upgrade measure":5,"documentation":4,"sampling":4,"workflow measure":2,"infrastructure":2,"reporting measure":2,"Pull Request - Ready for CI":1,"bug":1},"past_year_issue_author_associations_count":{"CONTRIBUTOR":7},"past_year_pull_request_author_associations_count":{"CONTRIBUTOR":33,"COLLABORATOR":3,"MEMBER":1,"NONE":1},"past_year_issue_authors":{"mdahlhausen":3,"amylebar":2,"amyeallen1":1,"ChristopherCaradonna":1},"past_year_pull_request_authors":{"mdahlhausen":8,"ChristopherCaradonna":7,"mpraprost":7,"LandanT":5,"amyeallen1":2,"eringold":2,"JanghyunJK":2,"JieXiong9119":2,"asparke2":1,"bonnema":1,"rHorsey":1},"maintainers":[{"login":"JieXiong9119","count":2,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/JieXiong9119"},{"login":"asparke2","count":1,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/asparke2"},{"login":"rHorsey","count":1,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/rHorsey"}],"active_maintainers":[{"login":"JieXiong9119","count":2,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/JieXiong9119"},{"login":"asparke2","count":1,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/asparke2"},{"login":"rHorsey","count":1,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/rHorsey"}]},"events":{"total":{"DeleteEvent":4,"IssuesEvent":4,"WatchEvent":1,"IssueCommentEvent":1,"PushEvent":29,"PullRequestReviewEvent":1,"CreateEvent":4},"last_year":{"DeleteEvent":4,"IssuesEvent":4,"WatchEvent":1,"IssueCommentEvent":1,"PushEvent":29,"PullRequestReviewEvent":1,"CreateEvent":4}},"keywords":[],"dependencies":[{"ecosystem":"pypi","filepath":"build/singularity/requirements.txt","sha":null,"kind":"manifest","created_at":"2022-09-20T08:30:52.251Z","updated_at":"2022-09-20T08:30:52.251Z","repository_link":"https://github.com/NatLabRockies/ComStock/blob/main/build/singularity/requirements.txt","dependencies":[{"id":5615952254,"package_name":"boto3","ecosystem":"pypi","requirements":"*","direct":true,"kind":"runtime","optional":false},{"id":5615952255,"package_name":"requests","ecosystem":"pypi","requirements":"*","direct":true,"kind":"runtime","optional":false}]}],"score":7.832014180505469,"created_at":"2024-05-10T00:04:29.674Z","updated_at":"2026-05-16T01:01:01.398Z","avatar_url":"https://github.com/NatLabRockies.png","language":"Ruby","category":"Consumption","sub_category":"Buildings and Heating","monthly_downloads":0,"total_dependent_repos":0,"total_dependent_packages":0,"readme":"# ComStock\nComStock is an NREL model of the U.S. commercial building stock. The model takes some building characteristics from the\nU.S. Department of Energy's (DOE's) Commercial Prototype Building Models and Commercial Reference Building. However,\nunlike many other building stock models, ComStock also combines these with a variety of additional public- and\nprivate-sector data sets. Collectively, this information provides high-fidelity building stock representation with a\nrealistic diversity of building characteristics.\n\nThis repository contains the source code used to build and execute ComStock models, including upgrade scenarios. In\naddition, the sampling of buildings characteristics used for the initial ComStock (V1.0) release is provided.  The ComStock model is under active calibration and development, which is publicly visible on this repository.\n\nExecution of the ComStock workflow is managed through the [buildstockbatch repository](https://github.com/NREL/buildstockbatch), a shared asset of ResStock and ComStock,\nspecifically developed to scale to execution of tens of millions of simulations through multiple infrastructure\nproviders.\n\nThe dataset output from the initial ComStock (V1.0) release can be found at the accompanying\n[ComStock data viewer website](https://comstock.nrel.gov) and additional information about ComStock found on the\n[NREL Buildings Website](https://www.nrel.gov/buildings/comstock.html). For more details about ongoing model development\nplease consult the [End Use Load Profiles](https://www.nrel.gov/buildings/end-use-load-profiles.html) website.\n\nComStock is a direct result of the NREL residential stock modeling tool\n[ResStock](https://www.nrel.gov/buildings/resstock.html) (recipient of a\n[R\u0026D100 award](https://www.rdworldonline.com/rd100/resstock-a-21st-century-tool-for-energy-efficiency-modeling-with-unparalleled-granularity/))\nand was inspired by the high-fidelity solar \u0026 storage adoption model [dGen](https://www.nrel.gov/analysis/dgen/).\nAdditionally, this tool would not be possible without the decades of work undertaken by the\n[OpenStudio](https://www.openstudio.net/) and [EnergyPlus](https://energyplus.net/) visionaries and contributors,\nsignificant funding, feedback and support from the [Los Angeles Department of Water and Power](https://www.ladwp.com/),\nand the [Department of Energy's Building Technology Office](https://www.energy.gov/eere/buildings/building-technologies-office)\nongoing support of and investment in building energy modeling software.\n\n## Directories\n- [**`/build`**](https://github.com/NREL/ComStock/tree/main/build) contains instructions for building Singularity images for running ComStock on HPC systems.\n- [**`/documentation`**](https://github.com/NREL/ComStock/tree/main/documentation) contains LaTeX documentation and instructions for building the documentation.\n- [**`/measures`**](https://github.com/NREL/ComStock/tree/main/measures) contains the high-level \"meta\" measures used to call other measures, and the reporting measures used to summarize outputs.\n- [**`/national`**](https://github.com/NREL/ComStock/tree/main/national) contains seed directories necessary for a ComStock run using buildstockbatch.\n- [**`/postprocessing`**](https://github.com/NREL/ComStock/tree/main/postprocessing) contains postprocessing scripts to create graphics for viewing results and comparing to other data sources.\n- [**`/resources`**](https://github.com/NREL/ComStock/tree/main/resources) contains workflow and upgrade measures\n- [**`/samples`**](https://github.com/NREL/ComStock/tree/main/samples) contains sample buildstock.csv files, which describe the set of models included in a run.\n- [**`/sampling`**](https://github.com/NREL/ComStock/tree/main/sampling) contains instructions and code to generate buildstock.csv files.\n- [**`/ymls`**](https://github.com/NREL/ComStock/tree/main/ymls) contains sample .yml files, which are the configuration files used to execture a ComStock run with buildstockbatch.\n\n## Usage\nComStock is under an open source license. See [LICENSE.txt](https://github.com/NREL/ComStock/blob/develop/LICENSE.txt) in this directory.\nYou are welcome to use this repository for your own use. However, we do not provide technical support. Please refer to our [technical assistance documentation](https://nrel.github.io/ComStock.github.io/docs/resources/resources.html) instead. We strongly suggest and support using the public datasets instead of attempting to run millions of building energy models yourself.\n","funding_links":[],"readme_doi_urls":[],"works":{},"citation_counts":{},"total_citations":0,"keywords_from_contributors":["energyplus","openstudio","openstudio-coalition","openstudio-sdk","openstudio-application","openstudio-models","qt"],"project_url":"https://ost.ecosyste.ms/api/v1/projects/192499","html_url":"https://ost.ecosyste.ms/projects/192499"}