Synchrophasor module represents implementation of IEEE C37.118.2 standard in Python. synchrophasor module is still in development phase but we have few very interesting tools.

Synchrophasor module is made to be easy to install and run.

You will need python3 to run module correctly. Check your Python version:

python --version

If you're using Python 2 version you can install Python 3 alongside with Python 2.

• Clone this repository git clone https://github.com/sstevan/synchrophasor.git or
• Download this repository as .zip file and extract or
• Install using pip or
• Use PyCharm to clone this repo.

Add synchrophasor folder to PYTHONPATH:

• If you're using GNU/Linux or Mac OS X add synchrophasor folder (located inside repo folder) to your $PYTHONPATH like this:

  For Ubuntu preferred option¹:

  echo export PYTHONPATH="${PYTHONPATH}:/path/to/to/pypmu" >> ~/.profile && source ~/.profile

  For Mac OS X preferred option²:

  echo export PYTHONPATH="${PYTHONPATH}:/path/to/pypmu" >> ~/.bash_profile && source ~/.bash_profile

  Or you can add it each time you run per-interactive-shell³:

  echo export PYTHONPATH="${PYTHONPATH}:/path/to/pypmu" >> ~/.bashrc && source ~/.bashrc

• If you're using Windows switch to GNU/Linux and check previous solution or

• Add module folder following this tutorial or

• If you've installed it using pip it's already there or

• If you've cloned repository using PyCharm - PyCharm will handle it for you.

Note

• ¹(./profile)

  ~/.profile: executed by the command interpreter for login shells. This file is not read by bash(1), if ~/.bash_profile or ~/.bash_login exists.

• ²(./bash_profile)

  ~/.bash_profile: The personal initialization file, executed for login shells

• ³(~/.bashrc)

  ~/.bashrc: The individual per-interactive-shell startup file

Right now we have only one test for frame encapsulation validation. You can check it like this:

python tests/validate_frames.py

If you have Python 3 installed alongside with Python 2 you should try like this:

python3 tests/validate_frames.py

If AssertionError is not shown you're good to go!

Inside examples folder you will find few useful examples that utilize synchrophasor module.

Possible practical use of synchrophasor module would be data-stream splitter. In case you need to send phasor measurements to multiple destinations following 4 lines of code will do it:

from synchrophasor.splitter import StreamSplitter

sp = StreamSplitter(source_ip='127.0.0.1', source_port=1410, listen_ip='127.0.0.1', listen_port=1502)
sp.run()

With only few lines of code you can bring up PMU simulator which will send constant phasor measurements to connected PDCs.

from synchrophasor.pmu import Pmu


pmu = Pmu(ip="127.0.0.1", port=1410)

pmu.set_configuration()  # This will load default PMU configuration specified in IEEE C37.118.2 - Annex D (Table D.2)
pmu.set_header()  # This will load default header message "Hello I'm tinyPMU!"

pmu.run()  # PMU starts listening for incoming connections

while True:
    if pmu.clients:  # Check if there is any connected PDCs
        pmu.send(pmu.ieee_data_sample)  # Sending sample data frame specified in IEEE C37.118.2 - Annex D (Table D.1)

pmu.join()

Here's an example of very simple PDC. tinyPDC supports only one connection to PMU and still cannot understand measurements or configuration but with your help we can learn tinyPDC to read Data Frames and Configuration Frames

from synchrophasor.pdc import Pdc

pdc = Pdc(pdc_id=7, pmu_ip='127.0.0.1', pmu_port=1410)

pdc.run()  # Connect to PMU

header = pdc.get_header()  # Get header message from PMU
config = pdc.get_config()  # Get configuration from PMU

pdc.start()  # Request to start sending measurements

while True:
    data = pdc.get()  # Keep receiving data
    if not data:
        pdc.quit()  # Close connection
        break

If you really don't want to know what is inside of these scripts we've prepared applications for you inside apps folder.

Make them executable like this:

chmod +x splytter.py

Then you can ask for help like this and you will find usage example there:

./splytter --help

If you don't want to bother writing your own script for stream splitter you can run splytter application like this:

./splytter.py -i 10 -sip 127.0.0.1 -sp 1410 -lip 127.0.0.1 -lp 9991'

If you need PMU simulator for network test or something like that you can run pmy application which will send constant data frames to all connected PDCs:

./pmy.py -i 511 -ip 127.0.0.1 -p 1995 -r 30'

Since synchrophasor module is in early development phase we're missing few very important things.

• We're working on Windows fix to support multiprocessing.
• We don't have Configuration Frame version 1 and version 3 implemented but Configuration Frame version 2 is working just fine.
• We don't have convert2frame() methods for converting raw bytes into DataFrame or ConfigFrame. We do have it for CommandFrame and HeaderFrame.
• We don't have UDP connection supported yet but TCP looks like it's working as it should

If you feel like you could help us, with testing or developing please do not hesitate to contact us: stevan.sandi@gmail.com or tp0x45@gmail.com.

1. Please check TODO.md to find out where you can help us.
2. Fork this repo.
3. Create new branch: git checkout -b fixing-your-stupid-bug
4. Commit changes: git commit -m 'There you go! Fixed your stupid bug.'
5. Push changes to the branch: git push origin fixing-your-stupid-bug
6. Submit pull request.

• Tomo Popovic - synchrophasor module project leader.
• Bozo Krstajic - synchrophasor module project adviser.
• Stevan Sandi - synchrophasor module project developer.

Please check LICENSE.txt.

• C37.118.2-2011 - IEEE Standard for Synchrophasor Data Transfer for Power Systems, >>

If you use the pyPMU code for your research, please cite the following publication:

• S. Sandi, T. Popovic, "pyPMU – Open Source Python Package for Synchrophasor Data Transfer", IEEE 24th Telecommunications Forum (TELFOR), Belgrade, Serbia, Nov 22-23

• S. Sandi, T. Popovic, B. Krstajic, "Python Implementation of IEEE C37.118 Communication Protocol", Journal of Electrical Engineering, Faculty of Electrical Engineering, University, Podgorica, Montenegro, Vol. 21, No. 1, December 2015, pp 108-117