{"id":64133,"name":"GridLAB-D","description":"A simulation platform for future electricity distribution power systems.","url":"https://github.com/arras-energy/gridlabd","last_synced_at":"2026-04-18T23:30:24.727Z","repository":{"id":243890992,"uuid":"695255118","full_name":"arras-energy/gridlabd","owner":"arras-energy","description":"Arras Energy simulator","archived":false,"fork":false,"pushed_at":"2025-12-08T17:09:46.000Z","size":187033,"stargazers_count":12,"open_issues_count":66,"forks_count":8,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-04-03T18:24:43.354Z","etag":null,"topics":["agent-based","gridlabd","powerflow","simulation"],"latest_commit_sha":null,"homepage":"https://www.arras.energy/","language":"C++","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/arras-energy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"COPYRIGHT","agents":null,"dco":null,"cla":null}},"created_at":"2023-09-22T17:41:24.000Z","updated_at":"2026-02-19T08:40:15.000Z","dependencies_parsed_at":"2025-10-22T15:35:18.968Z","dependency_job_id":"a523f900-e2b0-41ec-aa71-69df0b1259bc","html_url":"https://github.com/arras-energy/gridlabd","commit_stats":{"total_commits":13,"total_committers":2,"mean_commits":6.5,"dds":0.07692307692307687,"last_synced_commit":"e83bb2d414fd0bb165cf539c7849c523bbc2e0bd"},"previous_names":["arras-energy/gridlabd"],"tags_count":14,"template":false,"template_full_name":"arras-energy/gridlabd-old","purl":"pkg:github/arras-energy/gridlabd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arras-energy%2Fgridlabd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arras-energy%2Fgridlabd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arras-energy%2Fgridlabd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arras-energy%2Fgridlabd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arras-energy","download_url":"https://codeload.github.com/arras-energy/gridlabd/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arras-energy%2Fgridlabd/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31693274,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-11T13:07:20.380Z","status":"ssl_error","status_checked_at":"2026-04-11T13:06:47.903Z","response_time":54,"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":"arras-energy","name":"arras-energy","uuid":"118282969","kind":"organization","description":null,"email":null,"website":null,"location":null,"twitter":null,"company":null,"icon_url":"https://avatars.githubusercontent.com/u/118282969?v=4","repositories_count":1,"last_synced_at":"2023-05-12T15:27:50.053Z","metadata":{"has_sponsors_listing":false},"html_url":"https://github.com/arras-energy","funding_links":[],"total_stars":null,"followers":null,"following":null,"created_at":"2023-05-12T15:27:50.054Z","updated_at":"2023-05-12T15:27:50.054Z","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arras-energy","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arras-energy/repositories"},"packages":[],"commits":{"id":1256840,"full_name":"arras-energy/gridlabd","default_branch":"master","total_commits":21,"total_committers":2,"total_bot_commits":0,"total_bot_committers":0,"mean_commits":10.5,"dds":0.04761904761904767,"past_year_total_commits":4,"past_year_total_committers":1,"past_year_total_bot_commits":0,"past_year_total_bot_committers":0,"past_year_mean_commits":4.0,"past_year_dds":0.0,"last_synced_at":"2026-04-15T22:33:39.554Z","last_synced_commit":"e0dedd7630f06ea93a10cead138d9c4d6339c13c","created_at":"2023-06-02T14:30:13.231Z","updated_at":"2026-04-15T22:33:39.152Z","committers":[{"name":"David P. Chassin","email":"david.chassin@me.com","login":"dchassin","count":20},{"name":"Alyona Teyber","email":"Ivanova.alyona5@gmail.com","login":"aivanova5","count":1}],"past_year_committers":[{"name":"David P. Chassin","email":"david.chassin@me.com","login":"dchassin","count":4}],"commits_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub/repositories/arras-energy%2Fgridlabd/commits","host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2026-04-17T00:00:13.716Z","repositories_count":6214384,"commits_count":900574289,"contributors_count":34924714,"owners_count":1144542,"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":"arras-energy/gridlabd","html_url":"https://github.com/arras-energy/gridlabd","last_synced_at":"2026-03-16T07:01:42.269Z","status":"error","issues_count":63,"pull_requests_count":300,"avg_time_to_close_issue":5632756.888888889,"avg_time_to_close_pull_request":901009.5472440945,"issues_closed_count":45,"pull_requests_closed_count":254,"pull_request_authors_count":4,"issue_authors_count":6,"avg_comments_per_issue":0.42857142857142855,"avg_comments_per_pull_request":0.04666666666666667,"merged_pull_requests_count":225,"bot_issues_count":0,"bot_pull_requests_count":0,"past_year_issues_count":21,"past_year_pull_requests_count":112,"past_year_avg_time_to_close_issue":3688959.214285714,"past_year_avg_time_to_close_pull_request":709673.8526315789,"past_year_issues_closed_count":14,"past_year_pull_requests_closed_count":95,"past_year_pull_request_authors_count":3,"past_year_issue_authors_count":4,"past_year_avg_comments_per_issue":1.0,"past_year_avg_comments_per_pull_request":0.026785714285714284,"past_year_bot_issues_count":0,"past_year_bot_pull_requests_count":0,"past_year_merged_pull_requests_count":85,"created_at":"2023-06-02T14:30:44.750Z","updated_at":"2026-03-16T07:01:42.270Z","repository_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/arras-energy%2Fgridlabd","issues_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/arras-energy%2Fgridlabd/issues","issue_labels_count":{"bug":43,"enhancement":12,"build":6,"deprecation":1,"documentation":1,"duplicate":1},"pull_request_labels_count":{"bug":30,"enhancement":22,"build":8,"documentation":6,"validate":4,"deprecation":2,"deploy":1},"issue_author_associations_count":{"MEMBER":47,"CONTRIBUTOR":9,"COLLABORATOR":5,"NONE":2},"pull_request_author_associations_count":{"MEMBER":262,"CONTRIBUTOR":19,"COLLABORATOR":19},"issue_authors":{"dchassin":45,"aivanova5":12,"Thistleman":3,"sashakames":1,"ftuffner":1,"MitchellAV":1},"pull_request_authors":{"dchassin":252,"Thistleman":29,"aivanova5":14,"MitchellAV":5},"host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2026-04-17T00:00:09.649Z","repositories_count":14300147,"issues_count":34555531,"pull_requests_count":113101455,"authors_count":11237074,"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":{"bug":7,"build":2,"enhancement":2,"deprecation":1},"past_year_pull_request_labels_count":{"bug":8,"enhancement":6,"deprecation":2,"validate":2,"build":1},"past_year_issue_author_associations_count":{"MEMBER":10,"CONTRIBUTOR":1,"NONE":1},"past_year_pull_request_author_associations_count":{"MEMBER":64,"CONTRIBUTOR":3},"past_year_issue_authors":{"dchassin":10,"aivanova5":1,"sashakames":1},"past_year_pull_request_authors":{"dchassin":60,"Thistleman":4,"aivanova5":3},"maintainers":[{"login":"dchassin","count":297,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/dchassin"},{"login":"Thistleman","count":31,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/Thistleman"},{"login":"aivanova5","count":5,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/aivanova5"}],"active_maintainers":[{"login":"dchassin","count":70,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/dchassin"},{"login":"Thistleman","count":4,"url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors/Thistleman"}]},"events":{"total":{"ReleaseEvent":5,"DeleteEvent":45,"MemberEvent":1,"PullRequestEvent":131,"ForkEvent":3,"IssuesEvent":42,"WatchEvent":4,"IssueCommentEvent":24,"PushEvent":338,"PullRequestReviewCommentEvent":13,"PullRequestReviewEvent":18,"CreateEvent":51},"last_year":{"ReleaseEvent":2,"DeleteEvent":27,"PullRequestEvent":64,"ForkEvent":2,"IssuesEvent":19,"WatchEvent":1,"IssueCommentEvent":19,"PushEvent":153,"PullRequestReviewEvent":2,"CreateEvent":31}},"keywords":["agent-based","gridlabd","powerflow","simulation"],"dependencies":[{"ecosystem":"actions","filepath":".github/workflows/develop-image.yml","sha":null,"kind":"manifest","created_at":"2024-06-11T21:24:45.909Z","updated_at":"2024-06-11T21:24:45.909Z","repository_link":"https://github.com/arras-energy/gridlabd/blob/master/.github/workflows/develop-image.yml","dependencies":[{"id":18546815523,"package_name":"actions/checkout","ecosystem":"actions","requirements":"v3","direct":true,"kind":"composite","optional":false},{"id":18546815524,"package_name":"aws-actions/configure-aws-credentials","ecosystem":"actions","requirements":"v2","direct":true,"kind":"composite","optional":false},{"id":18546815525,"package_name":"docker/login-action","ecosystem":"actions","requirements":"v1","direct":true,"kind":"composite","optional":false},{"id":18546815526,"package_name":"docker/build-push-action","ecosystem":"actions","requirements":"v2","direct":true,"kind":"composite","optional":false}]},{"ecosystem":"actions","filepath":".github/workflows/develop.yml","sha":null,"kind":"manifest","created_at":"2024-06-11T21:24:46.030Z","updated_at":"2024-06-11T21:24:46.030Z","repository_link":"https://github.com/arras-energy/gridlabd/blob/master/.github/workflows/develop.yml","dependencies":[{"id":18546815527,"package_name":"actions/checkout","ecosystem":"actions","requirements":"v3","direct":true,"kind":"composite","optional":false},{"id":18546815528,"package_name":"actions/upload-artifact","ecosystem":"actions","requirements":"v2","direct":true,"kind":"composite","optional":false}]},{"ecosystem":"actions","filepath":".github/workflows/master-image.yml","sha":null,"kind":"manifest","created_at":"2024-06-11T21:24:46.351Z","updated_at":"2024-06-11T21:24:46.351Z","repository_link":"https://github.com/arras-energy/gridlabd/blob/master/.github/workflows/master-image.yml","dependencies":[{"id":18546815529,"package_name":"actions/checkout","ecosystem":"actions","requirements":"v3","direct":true,"kind":"composite","optional":false},{"id":18546815530,"package_name":"aws-actions/configure-aws-credentials","ecosystem":"actions","requirements":"v2","direct":true,"kind":"composite","optional":false},{"id":18546815531,"package_name":"aws-actions/configure-aws-credentials","ecosystem":"actions","requirements":"v1","direct":true,"kind":"composite","optional":false},{"id":18546815532,"package_name":"docker/login-action","ecosystem":"actions","requirements":"v1","direct":true,"kind":"composite","optional":false},{"id":18546815533,"package_name":"docker/build-push-action","ecosystem":"actions","requirements":"v2","direct":true,"kind":"composite","optional":false}]},{"ecosystem":"actions","filepath":".github/workflows/master.yml","sha":null,"kind":"manifest","created_at":"2024-06-11T21:24:46.456Z","updated_at":"2024-06-11T21:24:46.456Z","repository_link":"https://github.com/arras-energy/gridlabd/blob/master/.github/workflows/master.yml","dependencies":[{"id":18546815534,"package_name":"actions/checkout","ecosystem":"actions","requirements":"v3","direct":true,"kind":"composite","optional":false},{"id":18546815535,"package_name":"actions/upload-artifact","ecosystem":"actions","requirements":"v2","direct":true,"kind":"composite","optional":false}]},{"ecosystem":"docker","filepath":"docker/Dockerfile","sha":null,"kind":"manifest","created_at":"2024-06-11T21:24:46.536Z","updated_at":"2024-06-11T21:24:46.536Z","repository_link":"https://github.com/arras-energy/gridlabd/blob/master/docker/Dockerfile","dependencies":[{"id":18546815536,"package_name":"ubuntu","ecosystem":"docker","requirements":"22.04","direct":true,"kind":"build","optional":false}]},{"ecosystem":"pypi","filepath":"cloud/servers/version.arras.energy/aws_requirements.txt","sha":null,"kind":"manifest","created_at":"2025-05-16T22:46:33.662Z","updated_at":"2025-05-16T22:46:33.662Z","repository_link":"https://github.com/arras-energy/gridlabd/blob/master/cloud/servers/version.arras.energy/aws_requirements.txt","dependencies":[{"id":23167005579,"package_name":"pandas","ecosystem":"pypi","requirements":"\u003e=1.3.5","direct":true,"kind":"runtime","optional":false},{"id":23167005580,"package_name":"numpy","ecosystem":"pypi","requirements":"\u003e=1.22.2","direct":true,"kind":"runtime","optional":false}]},{"ecosystem":"pypi","filepath":"cloud/websites/version.arras.energy/lambda/requirements.txt","sha":null,"kind":"manifest","created_at":"2025-05-16T22:46:33.717Z","updated_at":"2025-05-16T22:46:33.717Z","repository_link":"https://github.com/arras-energy/gridlabd/blob/master/cloud/websites/version.arras.energy/lambda/requirements.txt","dependencies":[{"id":23167005581,"package_name":"psycopg2-binary","ecosystem":"pypi","requirements":"*","direct":true,"kind":"runtime","optional":false}]},{"ecosystem":"pypi","filepath":"python/pyproject.toml","sha":null,"kind":"manifest","created_at":"2025-09-09T11:43:33.892Z","updated_at":"2025-09-09T11:43:33.892Z","repository_link":"https://github.com/arras-energy/gridlabd/blob/master/python/pyproject.toml","dependencies":[]},{"ecosystem":"pypi","filepath":"python/setup.py","sha":null,"kind":"manifest","created_at":"2025-09-09T11:43:33.939Z","updated_at":"2025-09-09T11:43:33.939Z","repository_link":"https://github.com/arras-energy/gridlabd/blob/master/python/setup.py","dependencies":[]},{"ecosystem":"pypi","filepath":"requirements.txt","sha":null,"kind":"manifest","created_at":"2025-09-09T11:43:33.983Z","updated_at":"2025-09-09T11:43:33.983Z","repository_link":"https://github.com/arras-energy/gridlabd/blob/master/requirements.txt","dependencies":[{"id":25062322744,"package_name":"CensusData","ecosystem":"pypi","requirements":"==1.15","direct":true,"kind":"runtime","optional":false},{"id":25062322758,"package_name":"Fiona","ecosystem":"pypi","requirements":"==1.8.22","direct":true,"kind":"runtime","optional":false},{"id":25062323436,"package_name":"PYPOWER","ecosystem":"pypi","requirements":"==5.1.16","direct":true,"kind":"runtime","optional":false},{"id":25062323490,"package_name":"Pillow","ecosystem":"pypi","requirements":"==9.3.0","direct":true,"kind":"runtime","optional":false},{"id":25062323491,"package_name":"Shapely","ecosystem":"pypi","requirements":"==1.8.4","direct":true,"kind":"runtime","optional":false},{"id":25062323504,"package_name":"address","ecosystem":"pypi","requirements":"==0.1.1","direct":true,"kind":"runtime","optional":false},{"id":25062323532,"package_name":"boto3","ecosystem":"pypi","requirements":"==1.26.115","direct":true,"kind":"runtime","optional":false},{"id":25062323533,"package_name":"build","ecosystem":"pypi","requirements":"==0.9.0","direct":true,"kind":"runtime","optional":false},{"id":25062323534,"package_name":"cfo","ecosystem":"pypi","requirements":"==1.0.1","direct":true,"kind":"runtime","optional":false},{"id":25062323562,"package_name":"control","ecosystem":"pypi","requirements":"==0.9.2","direct":true,"kind":"runtime","optional":false},{"id":25062323590,"package_name":"cvxpy","ecosystem":"pypi","requirements":"==1.5.3","direct":true,"kind":"runtime","optional":false},{"id":25062323591,"package_name":"docker","ecosystem":"pypi","requirements":"==4.4.4","direct":true,"kind":"runtime","optional":false},{"id":25062323592,"package_name":"elevation","ecosystem":"pypi","requirements":"==1.1.3","direct":true,"kind":"runtime","optional":false},{"id":25062323656,"package_name":"flask","ecosystem":"pypi","requirements":"==3.0.3","direct":true,"kind":"runtime","optional":false},{"id":25062323657,"package_name":"flask-restful-swagger","ecosystem":"pypi","requirements":"==0.20.1","direct":true,"kind":"runtime","optional":false},{"id":25062323742,"package_name":"folium","ecosystem":"pypi","requirements":"==0.12.1","direct":true,"kind":"runtime","optional":false},{"id":25062323743,"package_name":"geocoder","ecosystem":"pypi","requirements":"==1.38.1","direct":true,"kind":"runtime","optional":false},{"id":25062323744,"package_name":"geojson","ecosystem":"pypi","requirements":"==3.2.0","direct":true,"kind":"runtime","optional":false},{"id":25062323745,"package_name":"geopandas","ecosystem":"pypi","requirements":"==0.12.2","direct":true,"kind":"runtime","optional":false},{"id":25062323746,"package_name":"geopy","ecosystem":"pypi","requirements":"==2.1.0","direct":true,"kind":"runtime","optional":false},{"id":25062323747,"package_name":"haversine","ecosystem":"pypi","requirements":"==2.3.0","direct":true,"kind":"runtime","optional":false},{"id":25062323748,"package_name":"imageio","ecosystem":"pypi","requirements":"==2.31.5","direct":true,"kind":"runtime","optional":false},{"id":25062323749,"package_name":"ipinfo","ecosystem":"pypi","requirements":"==4.2.1","direct":true,"kind":"runtime","optional":false},{"id":25062323750,"package_name":"ipykernel","ecosystem":"pypi","requirements":"==5.5.5","direct":true,"kind":"runtime","optional":false},{"id":25062323751,"package_name":"ipyplot","ecosystem":"pypi","requirements":"==1.1.1","direct":true,"kind":"runtime","optional":false},{"id":25062323784,"package_name":"ipython","ecosystem":"pypi","requirements":"==8.10.0","direct":true,"kind":"runtime","optional":false},{"id":25062323785,"package_name":"ipython_genutils","ecosystem":"pypi","requirements":"==0.2.0","direct":true,"kind":"runtime","optional":false},{"id":25062323786,"package_name":"kaleido","ecosystem":"pypi","requirements":"==0.2.1","direct":true,"kind":"runtime","optional":false},{"id":25062323787,"package_name":"marimo","ecosystem":"pypi","requirements":"==0.10.17","direct":true,"kind":"runtime","optional":false},{"id":25062323800,"package_name":"matplotlib_inline","ecosystem":"pypi","requirements":"==0.1.6","direct":true,"kind":"runtime","optional":false},{"id":25062323801,"package_name":"metar","ecosystem":"pypi","requirements":"==1.9.0","direct":true,"kind":"runtime","optional":false},{"id":25062323802,"package_name":"networkx","ecosystem":"pypi","requirements":"==2.8.8","direct":true,"kind":"runtime","optional":false},{"id":25062323803,"package_name":"numpy","ecosystem":"pypi","requirements":"==1.24.4","direct":true,"kind":"runtime","optional":false},{"id":25062323804,"package_name":"openpyxl","ecosystem":"pypi","requirements":"==3.1.0","direct":true,"kind":"runtime","optional":false},{"id":25062323805,"package_name":"pandas","ecosystem":"pypi","requirements":"==2.2.2","direct":true,"kind":"runtime","optional":false},{"id":25062323806,"package_name":"pandas_access","ecosystem":"pypi","requirements":"==0.0.1","direct":true,"kind":"runtime","optional":false},{"id":25062323813,"package_name":"plotly","ecosystem":"pypi","requirements":"==5.24.1","direct":true,"kind":"runtime","optional":false},{"id":25062323814,"package_name":"pymysql","ecosystem":"pypi","requirements":"==1.0.2","direct":true,"kind":"runtime","optional":false},{"id":25062323815,"package_name":"pyproj","ecosystem":"pypi","requirements":"==3.4.0","direct":true,"kind":"runtime","optional":false},{"id":25062323816,"package_name":"pyrlu","ecosystem":"pypi","requirements":"==0.2.0","direct":true,"kind":"runtime","optional":false},{"id":25062323832,"package_name":"pysolar","ecosystem":"pypi","requirements":"==0.9","direct":true,"kind":"runtime","optional":false},{"id":25062323852,"package_name":"rasterio","ecosystem":"pypi","requirements":"==1.3.6","direct":true,"kind":"runtime","optional":false},{"id":25062323857,"package_name":"scipy","ecosystem":"pypi","requirements":"==1.13.1","direct":true,"kind":"runtime","optional":false},{"id":25062323858,"package_name":"simplekml","ecosystem":"pypi","requirements":"==1.3.6","direct":true,"kind":"runtime","optional":false},{"id":25062323859,"package_name":"timezonefinder","ecosystem":"pypi","requirements":"==5.2.0","direct":true,"kind":"runtime","optional":false},{"id":25062323889,"package_name":"xlrd","ecosystem":"pypi","requirements":"==2.0.1","direct":true,"kind":"runtime","optional":false}]}],"score":5.049856007249537,"created_at":"2023-09-18T12:26:35.316Z","updated_at":"2026-04-18T23:30:24.729Z","avatar_url":"https://github.com/arras-energy.png","language":"C++","category":"Energy Systems","sub_category":"Grid Analysis and Planning","monthly_downloads":0,"total_dependent_repos":0,"total_dependent_packages":0,"readme":"---\n\n\u003cdiv align=center\u003e\u003cH3\u003eIMPORTANT NOTICE\u003c/H3\u003e\u003c/div\u003e\n\nThis is the last release of HiPAS GridLAB-D before it is transferred to LF Energy's [Arras Energy project](https://github.com/arras-energy).\n\n---\n\n| Repository | Build | Deploy |\n| :---: | :---: | :---: |\n| [GridLAB-D](https://github.com/arras-energy/gridlabd) | ![master](https://github.com/arras-energy/gridlabd/actions/workflows/master.yml/badge.svg?branch=master) ![develop](https://github.com/arras-energy/gridlabd/workflows/develop/badge.svg?branch=develop) | [![master-images](https://github.com/arras-energy/gridlabd/actions/workflows/master-image.yml/badge.svg)](https://github.com/arras-energy/gridlabd/actions/workflows/master-image.yml) [![develop-images](https://github.com/arras-energy/gridlabd/actions/workflows/develop-image.yml/badge.svg)](https://github.com/arras-energy/gridlabd/actions/workflows/develop-image.yml) |\n| [Templates](https://github.com/arras-energy/gridlabd-template) | [![master](https://github.com/arras-energy/gridlabd-template/actions/workflows/master.yml/badge.svg)](https://github.com/arras-energy/gridlabd-template/actions/workflows/master.yml) [![develop](https://github.com/arras-energy/gridlabd-template/actions/workflows/develop.yml/badge.svg)](https://github.com/arras-energy/gridlabd-template/actions/workflows/develop.yml)\n| [Weather](https://github.com/arras-energy/gridlabd-weather) | [![validate](https://github.com/arras-energy/gridlabd-weather/actions/workflows/validate.yml/badge.svg)](https://github.com/arras-energy/gridlabd-weather/actions/workflows/validate.yml)\n| [Library](https://github.com/arras-energy/gridlabd-library) | [![validate](https://github.com/arras-energy/gridlabd-library/actions/workflows/master.yml/badge.svg)](https://github.com/arras-energy/gridlabd-library/actions/workflows/master.yml) [![validate](https://github.com/arras-energy/gridlabd-library/actions/workflows/develop.yml/badge.svg)](https://github.com/arras-energy/gridlabd-library/actions/workflows/develop.yml)\n| [Models](https://github.com/arras-energy/gridlabd-models) | [![validate](https://github.com/arras-energy/gridlabd-models/actions/workflows/validate.yml/badge.svg)](https://github.com/arras-energy/gridlabd-models/actions/workflows/validate.yml)\n| [Benchmarks](https://github.com/arras-energy/gridlabd-benchmarks) | Manual test (see [README.md](https://github.com/arras-energy/gridlabd-benchmarks/blob/main/README.md))\n| [Examples](https://github.com/arras-energy/gridlabd-examples) | Manual test (see [README.md](https://github.com/arras-energy/gridlabd-examples/blob/master/README.md))\n\n\nThe documentation for this project is located at http://docs.gridlabd.us/.\n\nThis respository contains the source code to HiPAS GridLAB-D, which is being developed by SLAC National Accelerator Laboratory for the California Energy Commission under grant [EPC-17-046](https://www.energy.ca.gov/filebrowser/download/1147).  This version of GridLAB-D is intended to be a commercial-grade version of the [US Department of Energy's research version of GridLAB-D developed by Pacific Northwest National Laboratory](https://github.com/gridlab-d/gridlab-d).\n\n*Note*: This fork of [GridLAB-D](https://github.com/gridlab-d/gridlab-d) does not support MS Windows directly. You must use docker or a virtual machine running linux.\n\n# Quick start using Docker\n\nThe preferred method for running HiPAS GridLAB-D is to download the master image from docker hub (see https://hub.docker.com/repository/docker/arras-energy/gridlabd).  You must install the docker daemon to use docker images.  See https://www.docker.com/get-started for details.\n\nOnce you have installed docker, you may issue the following commands to run GridLAB-D at the command line:\n\n~~~\ndocker run -it -v $PWD:/model arras-energy/gridlabd:latest gridlabd -W /model [LOADOPTIONS] [FILENAME.EXT] [RUNOPTIONS] \n~~~ \n\nOn many systems, an alias can be used to make this a simple command that resembles the command you would normally issue to run a host-based installation:\n\n~~~\nalias gridlabd='docker run -it -v $PWD:/tmp arras-energy/gridlabd:latest gridlabd'\n~~~\n\nNote that this alias will interfere with any host-based installation. You may use the `gridlabd docker` command to manage the use of docker images concurrently with host-based installations.\n\n# Downloading pre-built images\n\nInstallation from downloads may require `sudo` priviledges and always requires `curl`. The `install` script will automatically download and install the latest production image for your system if you use the following command:\n\n~~~\ncurl -sL http://install.gridlabd.us/install.sh | [sudo] sh\n~~~\n\nYou can download the latest development image using the command:\n\n~~~\ncurl -sL http://install-dev.gridlabd.us/install.sh | [sudo] sh\n~~~\n\nIf you must use `sudo`, then don't forget to grant user permission to access the build and runtime virtual environments created by the installer, e.g.,\n\n~~~\nsudo chmod -R g+rwx ~root /usr/local\nsudo adduser $USER root\n~~~\n\nIf you want to use a more secure approach to sharing the install among multiple users, see [install/README.md](install/README.md#Security).\n\nThe installer recognizes the following environment variables:\n\n| Variable | Default | Description\n| -------- | ------- | -----------\n| `INSTALL_SOURCE` | `http://install.gridlabd.us` | URL from which image is downloaded\n| `INSTALL_TARGET` | `/usr/local/opt` | Folder in which image is installed\n| `INSTALL_STDERR` | `/dev/stderr` | File to which error messages are sent\n| `INSTALL_STDOUT` | `/dev/stdout` | File to which output messages are sent\n| `GRIDLABD_IMAGE` | *varies* | Install image name, e.g., `$OSNAME_$VERMAJOR-$MACHINE`\n\nThis procedure may also be used in AWS EC2 instances and Docker containers.\n\nIf you have installed the AWS CLI, you can use the following command to get a list of available images:\n\n~~~\naws s3 ls s3://install.gridlabd.us | grep tarz\n~~~\n\nNote that the installer only works with image name that conform to the name pattern `VERSION-BUILD-BRANCH-SYSTEM-MACHINE.tarz`.\n\n# Build from source\n\nThe prerequesites for building HiPAS GridLAB-D from source include `git` and `curl`.  In general you can use the `setup.sh` script to verify and update your system so that the prerequesites are satisifed.  \n\nOn most systems, the process is as follows:\n\n~~~\ngit clone https://code.gridlabd.us/ [-b BRANCH] gridlabd\ncd gridlabd\n./setup.sh --local\n./build.sh --system --validate\n~~~\n\nIf you want to clone an alternate repository, use the following `git` command instead:\n\n~~~\ngit clone https://github.com/ORG/REPO [-b BRANCH] gridlabd\n~~~\n\nIf you do not specify the `--local` then by default the `setup.sh` source will match the `git` repository origin and branch if any. Otherwise the default source will be `arras-energy/gridlabd/master`. If you want to setup from a different origin, use the command `export GRIDLABD_ORIGIN=ORG/REPO/BRANCH` to specify an alternate source for `setup.sh`.  The `build.sh` will also match the current `git` repository.\n\n*Do not* run the `setup.sh` and `build.sh` scripts with `sudo`, as that will usually create a broken install. If necessary, you should give yourself permission to write `/usr/local` and `brew`'s install folder. If you have not already done so, add `brew` to your path.\n\nTo upload the image to the AWS installer you must install the AWS CLI, and obtain credentials to access the installer's S3 buckets before using the command:\n\n~~~\n./build.sh --upload\n~~~\n\nTo make the image the latest release, use the command:\n\n~~~\n./build.sh --release\n~~~\n\nWhen you are working in a master branch, these command will update `install.gridlabd.us`, otherwise the upload will go to `install-dev.gridlabd.us`.\n\n## Docker\n\nDevelopers should use the following command to build GridLAB-D in a Docker container:\n\n~~~\ndocker/build.sh\n~~~\n\nNote that Docker will build the currently checked out branch *from the repository rather than from your local code*.\n\nTo push the docker image to your personal Dockerhub, use the command:\n\n~~~\ndocker/build.sh --push\n~~~\n\nThe Dockerhub account is assumed to match the name of your GitHub account.\n\nTo release the docker image, use the command:\n\n~~~\ndocker/build.sh --release\n~~~\n\n## AWS EC2\n\nThe latest development and master builds of HiPAS gridlabd are available as community AMIs.\nSimply launch an ec2, browse the community AMIs and search for HiPAS Gridlabd\n\nIf you want to build gridlabd yourself, use the AWS Ubuntu AMI on AWS EC2 using the commands\n\n~~~\ngit clone https://code.gridlabd.us/ [-b BRANCH] gridlabd\ncd gridlabd\n./setup.sh --local\n./build.sh --system --validate\n~~~\n\n## Windows WSL\n\nGenerally, running HiPAS GridLAB-D on Docker is preferred because it is usually faster. Building, running and installing Gridlabd in WSL is not that different from a normal linux installation. You can follow Microsoft's instructions on setting up WSL and adding/changing distro's [here](https://learn.microsoft.com/en-us/windows/wsl/install). These instructions work for both cases on supported operating systems, which you can find in the build-aux directory.\n\n1) Open PowerShell as administrator or run the WSL (Ubuntu) from the start menu to open a dedicated terminal\n2) Run `wsl` (Using Ubuntu)\n3) Follow the Linux build procedure above.\n\n## Manual Build\n\nYou can build HiPAS GridLAB-D manually by running following commands in the top level repository folder:\n\n1. Create the target folder:\n\n~~~\nmkdir -p /usr/local/opt/gridlabd\n~~~\n\n2. Activate the python build environment\n\n~~~\n. $HOME/.gridlabd/bin/activate\n~~~\n\n3. Create the configuration script\n\n~~~\nautoreconf -isf\n~~~\n\n4. Run the configuration script\n\n~~~\n./configure\n~~~\n\n5. Compile everything\n\n~~~\nmake\n~~~\n\n6. Install everything\n\n~~~\nmake install\n~~~\n\n7. Validate the install\n\n~~~\nmake validate\n~~~\n\n8. Release install to all users\n\n~~~\nmake system\n~~~\n\n## Pro Tips\n\n1. If you accumulate a lot of local branches that no longer exist on the remote repo, you can use the following command to purge them:\n\n~~~\nhost% git fetch -p \u0026\u0026 git branch -vv | awk '/: gone]/{print $1}' | xargs git branch -D\n~~~\n\n2. You can manage multiple installs using the `gridlabd version` command.  See `gridlabd version help` for details\n\n3. You can prevent `./configure` using the configure cache by deleting the `config.cache` folder.\n\n4. You can start a clean build using `--clean` option with `./build.sh`. Note that this will delete any new files not added with `git add`.\n\n5. You can change the install prefix using the `--prefix FOLDER` option with `./build.sh`.\n\n## Citation\n\nIf you use this fork of GridLAB-D for a publication you are required to cite it, e.g.,\n\nChassin, D.P., et al., \"GridLAB-D Version _major_._minor_._patch_-_build_ (_branch_) _platform_\", (_year_) [online]. Available at _url_, Accessed on: _month_ _day_, _year_.\n\nYou may use the `--cite` command option to obtain the correct citation for your version:\n\n~~~\nhost% gridlabd --cite\nChassin, D.P., et al. \"GridLAB-D 4.2.0-191008 (fix_python_validate) DARWIN\", (2019) [online]. Available at https://source.gridlabd.us/commit/dfc392dc0208419ce9be0706f699fdd9a11e3f5b, Accessed on: Oct. 8, 2019.\n~~~\n\nThis will allow anyone to identify the exact version you are using to obtain it from GitHub.\n\n## US Government Rights\n\nThis version of GridLAB-D is derived from the original US Department of Energy version of GridLAB-D developed at Pacific Northwest National Laboratory. The US Government retains certain rights as described in [the original GridLAB-D license](https://raw.githubusercontent.com/gridlab-d/gridlab-d/master/LICENSE).\n\n## Contributions\n\nPlease see https://source.gridlabd.us/blob/master/CONTRIBUTING.md for information on making contributions to this repository.\n\n","funding_links":[],"readme_doi_urls":[],"works":{},"citation_counts":{},"total_citations":0,"keywords_from_contributors":["grid-simulation","power-simulator","power-systems","power-systems-analysis","smartgrid","transactive-energy","transforms","measur","archiving","compose"],"project_url":"https://ost.ecosyste.ms/api/v1/projects/64133","html_url":"https://ost.ecosyste.ms/projects/64133"}