Skip to content

Latest commit

 

History

History
76 lines (66 loc) · 5.16 KB

README.md

File metadata and controls

76 lines (66 loc) · 5.16 KB

Simulation Toolkit for Electrical Power Systems

  • Maintainer: Changgang Li [email protected] from School of Electrical Engineering, Shandong University.
  • Documentation: [N/A]
  • Date of Readme: Sep. 13, 2020

Major functions

Simulation Toolkit for Electrical Power Systems (STEPS) is an open source power system simulator designed for balanced large-scale AC-DC hybrid power system analysis.
Currently, it supports powerflow solution and dynamic simulation. In the future, short circuit analysis and eigenvalue analysis will be supported with no timetable.
The data format of STEPS is improved based on PSS/E raw and dyr data format. Though BPA dat format is supported, it will be supported in the future version in stepspy and BPA data importer will be removed.[Sep. 13, 2020] You are encourage to join us for further development.

Major versions

  • v1.3.1: Fix minor bug in IEEEG1 when T1 or T2 is non-zero. Released on Sep. 13, 2020.
  • v1.3: Fix minor bug in building Z matrix. Released on April 22, 2020. This version is available for better compatibility.
  • v1.1: Improved performance version on March 8, 2020. About 20~30% improvement comparing to v1.0.
  • v1.0: Improved performance version on Feb. 12, 2020. Support synchronous generator, wind turbine generator, (basic) PV unit, HVDC, static and dynamic loads.
  • v0.0: Initialize project on March 21, 2018

Dependency

STEPS depends on CSparse, CXSparse, CppTest, and RapidJSON. The CXSparse is modified to avoid confliction between CSparse and CXSparse by changing prefix cs_ and CS_ to cxs_ and CSX_ . Though BLAS, CBLAS, and other SuiteSparse codes are included in the package, they will be removed in future.

Prerequisite

  1. Install Code::Blocks.
  2. Install C and C++ compiler supprting C++14. GCC>=4.9 is recommended.
  • For Unix-like systems, follow guides to install gcc and g++ with the latest version.
  • For Windows system, MinGW-64 is suggested.
    • Go to http://mingw-w64.org/ and go to its sourceforge download site for the latest version.
    • Install 32-bit version or 64-bit version as you like. 64-bit version is recommended.
  1. Start Code::Blocks, and configure its toolchain exectuable.
  2. Install Python if you want to try the stepspy module. 64-bit version is recommended. However, if you want to use 32-bit dynamic library of STEPS, you should install Python of the 32-bit version.

How to build with Code::Blocks

  1. Compile CSparse
  2. Open csparse.cbp in the code/ folder with Code::Blocks.
  3. Go 'Project'-'Properties'-'Build targets'and set type as 'static library'.
  4. Compile CSparse. You should get a libCSparse.a in folder build/bin/Release/.
  5. Complie CXSparse
  6. Open cxsparse.cbp in the code/ folder with Code::Blocks
  7. Go 'Project'-'Properties'-'Build targets'and set type as 'static library'.
  8. Compile CXSparse. You should get a libCXSparse.a in folder build/bin/Release/.
  9. Compile CppTest.
  10. Open cpptest.cbp in the code/ folder with Code::Blocks, set build target as 'static library'.
  11. Compile CppTest. You should get a libCppTest.a in folder build/bin/Release/.
  12. Build STEPS
  13. Open STEPS.cbp in the code/ folder with Code::Blocks.
  14. Go 'Project'-'Build options'-'Linker settings', and add the libCsparse.a, libCXSparse.a, and libCppTest.a library to 'Link libraries'.
  15. Go 'Project'-'Properties'-'Build Target', and select build target - If you want to compile STEPS as dynamic library, select 'Dynamic library', and set the output file name as 'libsteps.so' for Unix-like systems or 'libsteps.dll' for Windows systems. - If you want to compile STEPS as console application, select 'Console application'.
  16. If the target is dynamic library, disable 'Link' option for Source files with leading name of 'main'. If the target is console application, enable 'Link' option for only one of Source files with leading name of 'main'.
  17. Compile the STEPS. You should get the output file in folder build/bin/Release/.
  18. When compiling in Windows, remove -no-pie and -lgfortran options and remove libKLU.a, libBLAS.a, libUMFPACK.a

Here is a complete procedure of how to build STEPS.

  1. Compile CSparse as static library. You can find CSparse.cbp in the code/ folder.
  2. Compile CXSparse as static library. You can find CXSparse.cbp in the code/ folder.
  3. Compile CppTest as static library. You can find CppTest.cbp in the code/ folder.
  4. Compile STEPS as dynamic library or exectuable file. Include libCSparse.a, libCXSparse.a, and libCpptest.a.

How to build in shell mode (Linux)

To build in Linux shell mode, you can simply run the linux_make.sh. There is the procedure:

  1. Download and install the cbp2make from https://sourceforge.net/projects/cbp2make/. Remember to add x mode to the cbp2make file to make executable.
  2. Add x mode to the linux_make.sh file to make it executable.
  3. Run linux_make.sh.

How to use stepspy

stepspy is a Python module of advanced APIs of STEPS. It enables most of STEPS applications. It is recommended to use stepspy in Python 3 of 64-bit version.

stepspy has been uploaded to pypi.org, and can be installed via:

  • pip3 install stepspy
  • python -m pip install stepspy

Remember to copy the built libSTEPS.dll or libSTEPS.so in release folder to the stepspy folder.