Skip to content


Welcome to The Linux Foundation's Arras Energy Project

Arras Energy is the commercial-grade release of HiPAS GridLAB-D supported and distributed by Linux Foundation Energy.

The documentation for this project is located at

This organization contains the source code and support repositories to Arras Energy, which was developed by SLAC National Accelerator Laboratory for the California Energy Commission under grant EPC-17-046. This version of GridLAB-D is a commercial-grade version of the US Department of Energy's research version of GridLAB-D developed by Pacific Northwest National Laboratory.

Note: This fork of GridLAB-D does not support MS Windows directly. You must use docker or a virtual machine running linux.

The following options are available for using Arras Energy:

Run on GitHub

You can run Arras Energy with GitHub Actions using the template The simulation results are stored in a downloadable file that can accessed from the Actions tab in your GitHub project. A tutorial for using Arras Energy with GitHub is available at

Run on Docker

docker run -it -v $PWD:/model lfenergy/arras:latest gridlabd -W /model [LOADOPTIONS] [FILENAME.EXT] [RUNOPTIONS]

See Dockerhub HiPAS repositories for a list of available images.

Run on AWS

  1. Sign into your AWS console.
  2. Launch an EC2 instance.
  3. Search the community AMI for images starting with gridlabd in the us-west-1 (N. California) region.
  4. Choose an instance type with sufficient memory, e.g., >4GB.
  5. Download and save your keypair.
  6. Launch the instance.
  7. Connect to the instance.
  8. Download your model into the instance, e.g., from GitHub.
  9. Run the simulation using the usual command line options.
  10. Save the results, e.g., to GitHub.

You can also start the instance from the command line:

aws ec2 run-instances --image-id AMINAME --count 1 --instance-type INSTANCETYPE --key-name KEYPAIRNAME --security-group-ids SECURITYGROUPID --subnet-id SUBNETID

You can search the AWS AMI Catalog for Community AMIs matching "Arras Energy HiPAS GridLAB-D" in the us-west-1 region. The version number will be included in the name.

Download on Mac, Windows WSL, or Ubuntu Linux

curl -sL | [sudo] sh

Build your own

git clone [-b BRANCH] gridlabd
cd gridlabd
./ --local
./ --system --validate

Access remote resources

HiPAS GridLAB-D requires access to many remote resources. To ensure that access is possible, please verify that your site supports the HiPAS GridLAB-D cybersecurity plan.

Current Project Status

Repository Build Deploy
GridLAB-D master develop master-images develop-images
Templates master develop
Weather validate
Library validate validate
Models validate
Benchmarks Manual test (see
Examples Manual test (see
Tutorials Topic Status
Lesson 1 Create a GitHub project, download a reference model, solve powerflow, and plot a voltage profile. Simulation
Lesson 2 Modify, create, and delete static loads. Simulation
Lesson 3 Create distributed generation resources such as rooftop solar, wind, and backup generators. Simulation
Lesson 4 Create energy storage devices such as residential wall-mount batteries and community energy storage Simulation
Lesson 5 Running simulations over time Simulation
Lesson 6 Managing weather Simulation
Lesson 7 Adding quasi-static loads Simulation
Lesson 8 Exporting data Simulation
Lesson 9 Importing data Simulation

Pinned Loading

  1. tsc tsc Public

    Arras Energy Technical Steering Committee files

    1 2

  2. gridlabd gridlabd Public

    Arras Energy simulator

    C++ 4 5


Showing 10 of 14 repositories
  • gridlabd Public

    Arras Energy simulator

    arras-energy/gridlabd’s past year of commit activity
    C++ 4 BSD-3-Clause 5 64 2 Updated Jul 11, 2024
  • tsc Public

    Arras Energy Technical Steering Committee files

    arras-energy/tsc’s past year of commit activity
    1 CC-BY-4.0 2 13 0 Updated Jun 20, 2024
  • Public

    Arras Energy main documentation pages

    arras-energy/’s past year of commit activity
    HTML 0 0 0 0 Updated Apr 21, 2024
  • gridlabd-template Public

    Templates for analysis using HiPAS GridLAB-D

    arras-energy/gridlabd-template’s past year of commit activity
    Python 2 6 3 5 Updated Mar 20, 2024
  • static-website Public

    Website source for Arras Energy

    arras-energy/static-website’s past year of commit activity
    CSS 1 MIT 1 0 1 Updated Feb 16, 2024
  • .github Public
    arras-energy/.github’s past year of commit activity
    0 0 0 0 Updated Oct 2, 2023
  • module_template Public template

    External module template

    arras-energy/module_template’s past year of commit activity
    C++ 0 0 0 0 Updated Sep 25, 2023
  • gridlabd-old Public archive

    HiPAS GridLAB-D is the California Energy Commission (CEC) version of GridLAB-D.

    arras-energy/gridlabd-old’s past year of commit activity
    C++ 31 BSD-3-Clause 31 0 6 Updated Sep 22, 2023
  • arras-energy/gridlabd-converters’s past year of commit activity
    Python 3 BSD-3-Clause 1 0 0 Updated Apr 14, 2023
  • gridlabd-benchmarks Public Forked from hipas/gridlabd-benchmarks

    HiPAS GridLAB-D Performance Benchmarks

    arras-energy/gridlabd-benchmarks’s past year of commit activity
    Jupyter Notebook 0 BSD-3-Clause 2 0 0 Updated Apr 14, 2023

Top languages


Most used topics