Skip to content

Getting Started¤

This guide will help you set up and start using a basic version of EnergyScope, which we call the "core" version and which is documented here. EnergyScope is written in AMPL (A Mathematical Programming Language, see the documentation here ⧉). AMPL is free for academics and students, and includes licences for commercial solvers (e.g., Gurobi). Once you have familiarized yourself with AMPL and the core version, you can adapt these instructions to run other model versions of EnergyScope.

Prerequisites¤

To start with, please:

  1. Install AMPL

    • Visit the AMPL webpage ⧉ to download and install the appropriate version for your operating system.
    • For MacOS and Linux users, make sure to add AMPL to your system PATH.

  2. Install Python

    • Version: Python 3.6 or higher.
    • Environment: We recommend using a virtual environment to manage package dependencies.

Options for using EnergyScope

There are two options for using EnergyScope.

  • Option A: Direcly using AMPL and amplpy
    • Allows running any version of EnergyScope and offers full flexibility to customize inputs, constraints, or model structure.
    • Does not include built-in tools for preprocessing or postprocessing.
  • Option B: Using the energyscope Python Library
    • The energyscope Python Library makes it easier to run EnergyScope models and includes helpers for postprocessing results and visualizing outputs.
    • May be less flexible and not compatible with all EnergyScope versions.

If you are not sure about which option to choose, don't worry! Both options will allow you to get your first results in a few minutes.

Running your first model¤

Option A: Using AMPL and amplpy¤

  1. Download the core version AMPL files:

    Move the files into your working folder.

  2. Run the core model:

    pip install amplpy
    • Load and solve the model using the following python code. The following code reads in the model and data files and solves them using the open-source solver Highs. 
    import amplpy

# Initialize AMPL
ampl = AMPL()  # or AMPL(env) if you specify an environment

# Set the path to your model and data files
model_path = "path/to/your_project/"  # Adjust this to your project path

# Load model and data files
ampl.read(model_path + "ESTD_model_core.mod")  # The main AMPL model
ampl.readData(model_path + "ESTD_12TD.dat")  # The corresponding timeseries file
ampl.readData(model_path + "ESTD_data_core.dat")  # The corresponding data file

# Optionally set solver
ampl.setOption("solver", "highs")  # or "cplex", "gurobi", etc.

# Solve the model
ampl.solve()
    • After having solved the model you can print, export and manipulate the solution using amplpy commands. 
    # Get results (example: TotalCost)
TotalCost = ampl.getVariable("TotalCost")
print("Total cost:", TotalCost.get().value())

Option B: Using the Python Library¤

  1. Install the energyscope library and core version via pip:

    pip install energyscope

  2. Run the core model:

    • Load and solve the model using the following python code. The following code reads in the model and data files and solves them. 
    # Import necessary libraries
from energyscope.energyscope import Energyscope
from energyscope.models import core

# Load the model
es_core = Energyscope(model=core)

# Solve the model
results_core = es_core.calc()
    • After having solved the model you can print, export and manipulate the solution using commands of the library. 
    # Access results
results_core.variables['TotalCost']

Want to learn more?¤