Last update: 2024-04-23
This workshop was part of the ABM4Energy conference in Freiburg, Germany. It was held on March 22nd 2024.
Agenda
Time (CET) | Program |
---|---|
10:50-11:10 | Basics on AMIRIS' Agents |
11:10-11:25 | Installation and Execution |
11:25-11:50 | Result Analysis |
11:50-12:20 | Parameter Variations |
12:20-12:30 | Documentation |
Requested Preparations
AMIRIS requires Java JDK 11 or above, and Python version 3.9. AMIRIS operates on Windows, Linux and Mac.
In order to avoid waiting times for downloads and installation processes during the workshop, we ask all participants to check if their system meets these requirements.
Check Java
You can test if you have a JDK by using the command java --version
(or java -version
on some systems).
This should show your Java version if Java was found.
If you get a command not found error, or if Java version is less than 11 please download and install a recent JDK from e.g. here.
Check Python
You can test if you have Python available by using the command python --version
.
This should show your Python version if the Python command was found.
Note that if you use a Python environment manager you can have several Python versions on your system side by side.
If you do not have Python installed on your system, you may use e.g. conda or mamba.
Installation
You are free to try out your system by installing AMIRIS following these simple steps.
Set up Python Environment
In case you do not have any experience with creating a Python environment, we recommend to use anaconda. Install anaconda, start the anaconda prompt or powershell and enter:
conda create -n amirisEnv python=3.9
conda activate amirisEnv
In case you are using mamba, simple replace “conda” in the first command with “mamba” (but not in the second command).
Get AMIRIS-Py
We recommend to use AMIRIS-Py. AMIRIS-Py provides “one-command” installation and execution scripts, but you may also run AMIRIS using FAME scripts (see here).
In your AMIRIS Python environment (called “amirisEnv” above), run
pip install amirispy
Setup with AMIRIS-Py
- Create a new folder on your disk called, e.g., “AMIRIS”:
mkdir <AMIRIS>
- Open your Python-enabled shell and navigate to this newly created folder:
cd <AMIRIS>
- If not done yet, activate your Python environment with amiris-py:
conda activate <amirisEnv>
- Download the latest AMIRIS build:
amiris install
.
This should have downloaded the latest AMIRIS model and the latest version of AMIRIS examples into the current folder.
See the files in the folder - it should contain a file called “amiris-core_<x.y.z>-jar-with-dependencies.jar”, where <x.y.z>
stands for the latest published version.
Use this filename in the upcoming call to amiris run
.
Run AMIRIS with AMIRIS-Py
Use amirispy again to run AMIRIS:
amiris run -j ./amiris-core_<x.y.z>-jar-with-dependencies.jar -s ./examples/Simple/scenario.yaml -o simple
This runs the packaged AMIRIS Java archive (Jar) file specified after the -j
option and simulates the scenario specified after the -s
option.
Outputs of the simulation are stored in a folder as designated after the -o
option.
You should see some output messages stating that the scenario was compiled, AMIRIS ran, and that results were extracted.
If you experience any difficulties, do not hesitate to contact us.