Skip to content

power-flow-analyzer/PowerFlowAnalyzer

Repository files navigation

PowerFlowAnalyzer

PowerFlowAnalyzer (PFA) is a toolbox for the analysis of power systems, written in Java and Matlab. Its main focus is the modelling and visualisation of network data for transmission and distribution grids. It interfaces Matlab and Matpower for computations and integrates various data sources (CSV, Excel, UCTE DEF, QGIS). PFA has its roots at the Technische Universität Berlin and was used in several research projects and student theses relating grid planning and operation topics.

PFA is free software: you can use it, modify it and redistribute it under the terms of the Apache License, Version 2.0.

For Users

No installation is required, just download, unzip and start in Matlab.

Download

Download a release from the release page (e.g. PowerFlowAnalyzer-2.3.0.zip).

Unzip

Unzip the zip file. A new folder PowerFlowAnalyzer-<VERSION> will be created. The final name is version dependant (e.g. PowerFlowAnalyzer-2.3.0).

Start in Matlab

Run pfa_start_application.m in Matlab.

For Developers

Building from Source

PFA can be build using the provided Maven POM-file. Simply execute the following two steps:

  • Download or clone this git repository
  • Create a release using mvn package (you need to have Maven installed)

For MATPOWER support in your builds, download a MATPOWER release or clone a git repository. The MATPOWER files must reside in a matpower folder inside this folder. In general, a matpower folder (if existing) will be copied to the distribution folder and added to Matlab's search path.

The data model classes can be rebuild from the XSL schema files using:

xjc -d src -p net.ee.pfanalyzer.model.data schema

A zip file containing a full distribution will be created at target/PowerFlowAnalyzer-<VERSION>.zip

The distribution will be assembled in target/distribution before zipping.

Installation

Clone this git repository and build a release from source (see above).

Start

Run pfa_start_application_dev.m in Matlab. You can start PFA from from the (dynamic) output folder of your maven toolchain (e.g. command line Maven or embedded Maven runtime in Eclipse). The script assumes the compiled classes to be located in the target/classes folder of this directory (as this is the case for the provided Maven build).

For the Java classes to be reloaded in Matlab after changes in those classes, stop PFA and run the start script again.

PFA can also be started outside Matlab without any Matlab interface (for special purposes mainly). Start the Java application directly:

  • from an IDE: main class: net.ee.pfanalyzer.PowerFlowAnalyzer
  • from the JAR file: java -jar PowerFlowAnalyzer-<VERSION>.jar

License


PowerFlowAnalyzer is released under the Apache License, Version 2.0 (see LICENSE file). You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.

This software includes MATPOWER (Github), MigLayout (Github) and Fatcow Hosting Icons (Github). See NOTICE file for more information.