Getting Started with KPG Run

This guide walks you through your first power system optimization using KPG Run, from launch to results analysis.

Prerequisites

Before starting, ensure you have:

• KPG Run installed

• Julia environment configured with the required packages

• Solver Engines: Ipopt, Gurobi and Knitro

  • Gurobi and Knitro require valid license

• Basic understanding of power systems (helpful but not required)

→ Installation Guide

Your First Optimization

Interface Overview

• Data Source: Select the test system folder.

• Problem Type: Choose ED, UC, DC-OPF, or AC-OPF.

• Parameter Configuration: Set the day and any additional options.

• Main Workspace

  • Editor Tab: File editing and customization

  • Network Data Tab: Tools for data inspection

  • Time Series Tab: Demand and renewable generation profiles

  • Console Tab: Real-time solver output

  • Results Tab: Solution summary and details

Detailed User Interface Guide →

Tutorial

Tutorial: Running DC Optimal Power Flow (DC-OPF)

Let’s solve a DC-OPF for the KPG 193 system.

Step 1: Select Problem Type

• Click DC OPF - DC Optimal Power Flow in the problem type selector.

• The interface updates to show DC-OPF-specific options.

Step 2: Configure Parameters

Test System:

• Select the KPG 193 dataset folder.

Day Selection:

• Enter 200 (summer day, mid-July).

Step 3: Solve

• Click the Solve button

• Monitor console output in real-time:

[DC-OPF] Starting DC Optimal Power Flow...
[DC-OPF] Test system: KPG193_ver1_5

...

Optimization complete: OPTIMAL
Objective value: 6.5328039886964634e7

Step 4: View Results

• When KPG Run switches to the Results tab, review the results.

Tutorial: Running Unit Commitment

Now let’s solve a 24-hour Unit Commitment problem.

Step 1: Select UC Solver

1. Click UC - Unit Commitment in the problem type selector.

2. The interface updates to show UC-specific options.

Step 2: Configure 24-Hour Problem

Data Source:

• Select the KPG 193 dataset folder.

Day/Period Selection:

• Day: 200 (same summer day)

• Period: 1 day

Step 3: Solve

• Click the Solve button.

• Monitor console output in real-time:

[SolverFactory] Available solvers: Ipopt, Gurobi, KNITRO
[UC] Using solver: Gurobi
...

Optimization complete: OPTIMAL
Objective value: 5.918295911596663e7
[SolverFactory] Available solvers: Ipopt, Gurobi, KNITRO
✓ UC commitment saved - you can now use it for DC/AC OPF

Step 4: View Results

• When KPG Run switches to the Results tab, review the results.

Next Steps After First Run

1. Explore Different Scenarios

Try different days:

• Day 15: Cold winter, evening peak

• Day 75: Moderate spring, high renewables

• Day 200: Hot summer, afternoon peak (you just ran this!)

• Day 290: Moderate fall, shoulder season

2. Compare Solvers

Run same scenario with different models:

# Same day
day = 200

# Economic Dispatch (ignore network)
# DC-OPF (with linearized network)
# AC-OPF (with AC network)

# Compare costs

3. Visualize in KPG View

Export results to GeoJSON:

1. Click Save to Folder.

2. Save the file to a directory of your choice.

3. Open the exported GeoJSON in KPG View.

→ KPG View Guide

Next Steps

• Full installation: Installation Guide →

• Learn the interface: User Interface Guide →

• Understand mathematical model: Formulations →