GridLAB-D™ Resources

Most of the GridLAB-D™ resources and documentation are maintained on the GridLAB-D™ GitHub or Shoutwiki sites (and there is a lot of it). Here are a few useful resources:


We strive to keep track of all publications that use GridLAB-D™, but it is getting challenging! Here is the most up-to-date list, including common references: publications. If you don't see yours on there, let us know!


Prototypical Circuits: A repository for the taxonomy of prototypical feeders, which were developed in order to give researches in academia, as well as industry, access to a set of detailed distribution feeder models that could be used to study and evaluate smart grid technologies. These feeders are representative of those found in the Continental United States and are designed to work with GridLAB-D™ version 2.0 and higher.

PG&E Prototypical Circuits: PG&E and CEC have volunteered to provide the GridLAB-D™ community with a set of 12 prototypical feeder models obtained from a k-means cluster analysis of PG&E's 2,700 primary distribution feeders. These are statistically representative of PG&E's system and have been converted from the native CYMDIST formats to GridLAB-D™ formats. More information about those models can be found at the Shoutwiki site.

IEEE Models: As part of the IEEE Distribution System Analysis Subcommittee's Test Feeder Working Group, we strive to validate our tools against others. We keep a library of these models in GridLAB-D™ format for others to use. For more information about the models, please see the Test Feeder Working Group website.

Other great tools

We try to push as many of our tricks, tools, scripts, etc. out to the open-source repository, too. Here's a brief list of some of the key ones:

Equipment Database: Model files with a list of standard overhead and underground line conductors, generators, and transformers. Nice if you just want some standard configurations or equipment types.

Conversion Scripts: Converts models from CYME and Synergee into GridLAB-D™ format. These are getting a little long in the tooth and are not highly reliable, as they were created a number of years ago, but they can be a good starting point. New efforts are updating these, typically as Python scripts or other processes. See NRECA's Open Modeling Framework or PNNL's GridAPPS-D projects for other examples, although there are other efforts out there, too.

MATLAB scripts: A couple handy scripts that some of the developers use when debugging.

Autotest: If you are looking for a specific example of an object, the "autotest" folders might be one of the best places to do this. As part of our unit testing, we create relatively simple sample models with defined solutions. If the solution changes, developers know they may have made a mistake. Over time, the team has created 500+ of these tests. The objects in these models are great for getting a skeleton of an object or seeing a variety of ways an object might be used. You will typically need to remove the assert object and module, but otherwise the GLM should be a great starting point for understanding what you can and should set in a specific object. To find these, navigate to the appropriate module (e.g., powerflow) in the source code, then select the autotest folder.