PyCanvass

CANVASS stands for Cyber Attacks and Network Vulnerability Analytics Software for Smart Grids. py-CANVASS is a Python-based free and open source library for computing resiliency of Smart Grid and power systems critical infrastructure. It has a unique resiliency computation engine, and it enables integration with other industry-standard power system simulation software like GridLAB-D, and Real-Time Digital Simulators.

PyCanvass is under active development in SGDRIL at Washington State University. The project is hosted on Github: https://github.com/sayonsom/pycanvass

If you have any questions, or find bugs – please email Sayonsom Chanda: sayon@ieee.org

Typical Use-Cases

• Easy power system modeling – you can use it to quickly build GridLAB-D Models.
• Data-driven Disaster response design (through reconfiguration algorithms)
• Cyber-physical power grid simulations
• Resource optimization during extreme events
• Resiliency computation (also, design your own resiliency metric)
• Connect with digital real-time simulators, like RTDS, Opal-RT.
• Simulate cyber attacks for education/research purposes

Installation

Using pip

These installations are stable and well-supported. The most preferred way of installing PyCanvass is using pip:

pip install pycanvass

If you have previously installed PyCanvass, it is recommended to frequently.

Build Your Own

These installations have the freshest code, but it may contain bugs. Please follow the steps:

1. Download this repository as a Zip file.
2. Extract it to a location of your choice.
3. Change directory to the folder in Command Prompt, and run.

python setup.py install Assumes you have Python installed and already set to your path.

Getting Started Guide

[Full documentation is coming soon] Your first pyCanvass program We try to make this library accessible to non-programmers, programming beginners, non-power engineers, as well as the most hardened software-professionals. Feel free to read in detail of each step, or skip – as appropriate for your skill-level.

• Make sure you have the latest versions of pyCanvass, Python, and GridLAB-D installed correctly.
• Create a new folder, and inside that include a user_preferences.json file, and project_config.json file. Examples of these are in the demo-data.
• Also download the example node-file.csv, node-file.csv, and threat-file.csv – and keep them in the same folder.
• Using any text editor (like Notepad++ or VS Code or Sublime Text), open the project_config.json file.
• Edit the data section of the project_config file, replacing the paths mentioned in the nodes, edges, and threat section of the file with the file path of where you just placed the node-file.csv, edge-file.csv, and threat-file.csv.
• In your text editor, open a new file and save as “mymodel.py”
• In mymodel.py, write:from pycanvass.all import * project, nodes, edges = load_project()
• Now you are ready to perform network Vulnerability analysis. If you want to find the least risk path, i.e. the most resilient path, from a node, say F1_2 in the node-file.csv in the sample to another node, F2_3, just add the following code to your program above:
• paths = path_search(mygraph, ‘F1_2’, ‘F2_3’, criterion=”least_risk”) print(paths)

Citation

If you use PyCanvass in your simulations, please cite the library in your work. The citation helps other researchers who are not familiar with PyCanvass to easily reproduce results of your work, thus increasing the credibility and re-usability of your work. Also, we will soon release a website that features different papers that have used PyCanvass. Please let us know so that we can help increase the visibility of your work by featuring it on our website.

• S. Chanda, A. Srivastava, R. Hovsapian, “pycanvass: an Open Source Cyber-Attack and Network Vulnerability Assessment Tool for Resiliency Analysis of Distribution Systems”, IEEE Trans. Smart Grid (to be submitted)

Resources

GitHub

Videos

Canvass – Intro Video

PyCanvass – An easy open-source tool resiliency simulations of power distribution systems

How to measure resiliency of power grid using CANVASS before a hurricane?

Community Contribution

There are many ways you help us.

• If you find some errors and bugs, please let us know.
• Submit feature requests.
• Submit pull requests with your own additions and contributions.

Social

• Cite PyCanvass in your research.
• Give us a “Star” on GitHub.
• Share the project on LinkedIn, Twitter, Facebook, and write about us in your blogs.
• Subscribe to our channel, comment and share PyCanvass Videos on YouTube.

Contact

Email: sayon@ieee.org