From 47964ed97a8671cff75fa049f1bf56d6dec09fc9 Mon Sep 17 00:00:00 2001 From: "David P. Chassin" Date: Tue, 5 Apr 2022 13:56:48 -0700 Subject: [PATCH 1/3] Update README.md --- README.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/README.md b/README.md index f7f4e7c73..ee4871839 100644 --- a/README.md +++ b/README.md @@ -69,6 +69,17 @@ You use `make install` to build only. To use an inactive build run the `gridlabd Before using a build of gridlabd, you should always validate it using `gridlabd --validate` in the root folder of the source tree. Be careful to verify that the branch of the source tree matches the branch of the version you are running. This is not checked automatically. +## Windows WSL + +1) Open PowerShell as administrator +2) Run `wsl` (the Debian distro is preferred, but Ubuntu should work also) +3) Update `apt` and install `git` +4) Clone `gridlabd` +5) Run `autoconf` +6) Run `configure` +7) Make `system` +8) Validate `gridlabd`. + ## Building and Debugging You can configure a debugging version using `make reconfigure-debug`. When debugging is enabled you can use the [`gridlabd trace`](http://docs.gridlabd.us/index.html?owner=slacgismo&project=gridlabd&branch=master&folder=/Subcommand&doc=/Subcommand/Trace.md) command and the [`gridlabd gdb`](http://docs.gridlabd.us/index.html?owner=slacgismo&project=gridlabd&branch=master&folder=/Subcommand&doc=/Subcommand/Gdb.md) (for linux) or [`gridlabd lldb`](http://docs.gridlabd.us/index.html?owner=slacgismo&project=gridlabd&branch=master&folder=/Subcommand&doc=/Subcommand/Lldb.md) (for Mac OSX) commands to debug a simulation. From d96115a1b40462b4a4c652ca94593c7993ec8d9e Mon Sep 17 00:00:00 2001 From: "David P. Chassin" Date: Tue, 5 Apr 2022 15:59:03 -0700 Subject: [PATCH 2/3] Update README.md --- README.md | 33 +++++++++++++++++++++++++++------ 1 file changed, 27 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index ee4871839..88788ea4c 100644 --- a/README.md +++ b/README.md @@ -73,12 +73,33 @@ Before using a build of gridlabd, you should always validate it using `gridlabd 1) Open PowerShell as administrator 2) Run `wsl` (the Debian distro is preferred, but Ubuntu should work also) -3) Update `apt` and install `git` -4) Clone `gridlabd` -5) Run `autoconf` -6) Run `configure` -7) Make `system` -8) Validate `gridlabd`. +3) Change directory to `/usr/local/src` +4) Update `apt` and install `git` +~~~ + root@host:/usr/local/src# apt update -y + root@host:/usr/local/src# apt install git -y +~~~ +5) Clone `gridlabd` and change to the `gridlabd` directory +~~~ + root@host:/usr/local/src# git clone https://source.gridlabd.us/ + root@host:/usr/local/src# cd gridlabd +~~~ +6) Run `autoconf` +~~~ + root@host:/usr/local/src/gridlabd# autoreconf -isf +~~~ +7) Run `configure` +~~~ + root@host:/usr/local/src/gridlabd# ./configure +~~~ +8) Make `system` +~~~ + root@host:/usr/local/src/gridlabd# make system +~~~ +9) Validate `gridlabd` +~~~ + root@host:/usr/local/src/gridlabd# gridlabd --validate +~~~ ## Building and Debugging From e0ff83ff4023218d8b3336cda95ac4f5954679db Mon Sep 17 00:00:00 2001 From: "David P. Chassin" Date: Tue, 5 Apr 2022 16:26:24 -0700 Subject: [PATCH 3/3] Update README.md --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 88788ea4c..d01dd757d 100644 --- a/README.md +++ b/README.md @@ -71,6 +71,8 @@ Before using a build of gridlabd, you should always validate it using `gridlabd ## Windows WSL +Generally, running HiPAS GridLAB-D on Docker is preferred because it is usually faster. You can build, install, and run GridLAB-D in WSL as well by doing the following: + 1) Open PowerShell as administrator 2) Run `wsl` (the Debian distro is preferred, but Ubuntu should work also) 3) Change directory to `/usr/local/src`