You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+15-56Lines changed: 15 additions & 56 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,14 +10,11 @@ ABCE is a module to perform agent-based capacity expansion (CE) modeling for ele
10
10
*[Installation](#installation)
11
11
-[Linux / MacOS / Windows Subsystem for Linux](#linux--macos--windows-subsystem-for-linux)
12
12
-[Windows 10](#windows-10)
13
-
-[Optional, Argonne only: installing with A-LEAF](#optional--argonne-only-installing-with-a-leaf)
14
13
-[Optional: installing with CPLEX](#optional-installing-with-cplex)
15
14
*[Usage](#usage)
16
15
-[Running ABCE](#running-abce)
17
16
-[Input files](#input-files)
18
17
-[Outputs](#outputs)
19
-
*[Contributing](#contributing)
20
-
*[Testing](#testing)
21
18
*[License](#license)
22
19
23
20
## Installation
@@ -28,33 +25,25 @@ ABCE is a module to perform agent-based capacity expansion (CE) modeling for ele
28
25
29
26
`git clone https://github.com/abce-dev/abce`
30
27
31
-
2. If using A-LEAF, see the optional [Installing with A-LEAF](#optional--argonne-only-installing-with-a-leaf) section below. Currently, only users with Argonne gitlab credentials can use A-LEAF, but a public release is coming soon!
28
+
2. If using CPLEX, see the optional [Installing with CPLEX](#optional-installing-with-cplex) section below
32
29
33
-
3. If using CPLEX, see the optional [Installing with CPLEX](#optional-installing-with-cplex) section below
34
-
35
-
4. Inside your local `abce` directory, run the installation script with:
30
+
3. Inside your local `abce` directory, run the installation script with:
36
31
37
32
`bash ./install.sh`
38
33
39
-
5. When prompted for the A-LEAF repository, do one of the following:
40
-
41
-
* Enter the absolute path to the directory where you cloned A-LEAF, or
34
+
4. Wait for the installation script to run to completion. Review any errors/issues printed for your reference at the end of execution.
42
35
43
-
* Press Enter without entering any text, if not using A-LEAF
36
+
5. Restart your terminal session, or re-source your `.bashrc` file.
44
37
45
-
6. Wait for the installation script to run to completion. Review any errors/issues printed for your reference at the end of execution.
46
-
47
-
7. Restart your terminal session, or re-source your `.bashrc` file.
48
-
49
-
8. If using Conda to manage environments, activate the ABCE conda environment with:
38
+
6. If using Conda to manage environments, activate the ABCE conda environment with:
50
39
51
40
`conda activate abce_env`
52
41
53
-
9. Rerun the installation script to complete the environment setup:
42
+
7. Rerun the installation script to complete the environment setup:
54
43
55
44
`bash ./install.sh`
56
45
57
-
10. Test the installation using one of the examples:
46
+
8. Test the installation using one of the examples:
58
47
59
48
`cd examples/single_agent_example`
60
49
@@ -64,7 +53,7 @@ ABCE is a module to perform agent-based capacity expansion (CE) modeling for ele
11. Once the previous command runs to completion without failing, generate a precompiled Julia sysimage file from within the `abce/env` directory.
56
+
9. Once the previous command runs to completion without failing, generate a precompiled Julia sysimage file from within the `abce/env` directory.
68
57
69
58
`julia make_sysimage.jl`
70
59
@@ -75,25 +64,23 @@ ABCE is a module to perform agent-based capacity expansion (CE) modeling for ele
75
64
76
65
2. Download and install [Julia 1.8](https://julialang.org/downloads/). Check the box in the installer to add Julia to the PATH.
77
66
78
-
3. If using A-LEAF, see the optional [Installing with A-LEAF](#optional--argonne-only-installing-with-a-leaf) section below. Currently, only users with Argonne gitlab credentials can use A-LEAF, but a public release is coming soon!
79
-
80
-
4. If using CPLEX, see the optional [Installing with CPLEX](#optional-installing-with-cplex) section below
67
+
3. If using CPLEX, see the optional [Installing with CPLEX](#optional-installing-with-cplex) section below
81
68
82
-
5. Using the Anaconda Powershell, clone this repo to your local machine:
69
+
4. Using the Anaconda Powershell, clone this repo to your local machine:
83
70
84
71
`git clone https://github.com/abce-dev/abce`
85
72
86
-
6. Create the local conda environment:
73
+
5. Create the local conda environment:
87
74
88
75
`conda env create -f .\environment_win.yml`
89
76
90
-
7. Activate the `abce_anv` conda environment:
77
+
6. Activate the `abce_anv` conda environment:
91
78
92
79
`conda activate abce_env`
93
80
94
-
8. Set the `ABCE_DIR` environment variable to the absolute path to your `abce` repo (e.g. `C:\Users\myname\abce`)
81
+
7. Set the `ABCE_DIR` environment variable to the absolute path to your `abce` repo (e.g. `C:\Users\myname\abce`)
95
82
96
-
9. Test the installation using one of the examples:
83
+
8. Test the installation using one of the examples:
97
84
98
85
`cd examples\single_agent_example`
99
86
@@ -103,30 +90,10 @@ ABCE is a module to perform agent-based capacity expansion (CE) modeling for ele
10. Once the previous command runs to completion without failing, generate a precompiled Julia sysimage file from within the `abce\env` directory.
107
-
108
-
`julia make_sysimage.jl`
109
-
110
-
### Optional / Argonne only: installing with A-LEAF
111
-
112
-
1. Clone the ABCE A-LEAF repo:
113
-
114
-
`git clone git-out.gss.anl.gov/kbiegel/kb_aleaf`
115
-
116
-
2. Inside the A-LEAF directory, run the A-LEAF environment setup script:
117
-
118
-
`julia make_julia_environment.jl`
119
-
120
-
3. Test the A-LEAF install by running the following within your A-LEAF directory:
121
-
122
-
`julia execute_ALEAF.jl`
123
-
124
-
4. Once the previous command runs to completion without failing, generate a precompiled Julia sysimage file with:
93
+
9. Once the previous command runs to completion without failing, generate a precompiled Julia sysimage file from within the `abce\env` directory.
125
94
126
95
`julia make_sysimage.jl`
127
96
128
-
5. Set the `ALEAF_DIR` environment variable to the absolute path to your A-LEAF repo
129
-
130
97
### Optional: installing with CPLEX
131
98
132
99
1. Download the [CPLEX (IBM ILOG STUDIO 20.10) binaries](https://www.ibm.com/docs/en/icos/20.1.0?topic=cplex-installing)
@@ -226,14 +193,6 @@ ABCE also outputs plots of the evolution of the overall system portfolio and the
226
193
### Use ABCE with `watts`
227
194
The[ Workflow and Template Toolkit for Simulations (`watts`)](https://github.com/watts-dev/watts) has a plugin for ABCE. Please see the `watts` documentation for usage. This workflow tool is useful for conducting sensitivity analyses and other experiments with ABCE.
228
195
229
-
## Testing
230
-
231
-
### Julia Unit Tests
232
-
233
-
Julia tests may be run with the following command from within the `test/` directory:
0 commit comments