4. Quickstart Guide Plotter
The MTB Plotter is a tool that allows plotting of the generated RMS and EMT results.
The tool is located in the folder "plotter" which includes the main script "plotter.py", subscripts, a figure setup file and a configuration file.
Before running the main script, you should configure both the figure setup file and the configuration file itself.
The configuration file, config.ini, contains the following parameters:
Keep in mind, that paths under the section header "[Simulation data paths]" can be appended to if needed, simply add a new line matching the folder containing data you want plotted. Additionally, the name assigned will be the name displayed in the results, by default it is "Path1LegendName", but can be configured however you like, to reflect the results being plotted.
The tool automatically categorizes results found in paths in the "[Simulation data paths]" section header. An RMS result file is defined as a .csv file with the leftmost column named b:tnow in s and an EMT result file (metafile) is defined as an .inf file with the first line starting with PGB(1). EMT datafiles are assumed to be in the same folder as the metafile. This is important if you want to plot data you've exported yourself.
The figure setup file, figureSetup.csv, is used to configure individual plot pane. Three EMT and RMS signals can be specified in each plot pane. A set of predefined signals have already been setup containing the following parameters:
The default setup contains:
- Phase-phase voltages at POC
- Phase-ground voltages at POC
- Positive- and Negative-sequence voltages at POC
- Total currents at POC
- Id current at POC
- Iq current at POC
- Active power at POC
- Reactive power at POC
- Frequency at POC
- Id current at POC measured by pll
- Iq component current at POC measured by pll
- Id and Iq currents, and positive-sequence voltage at a terminal
Execute the script and find the results in the results folder that has been defined in the config.ini file (default: PP-MTB\Plotter\results). The results should look similar to the example below. Keep in mind, that project-data is paired and plotted by the case ID, in this example case ID 07 is shown plotted, with all paths defined in the config.ini file under the "[Simulation data paths]" section header containing the ID 07 is plotted together. You must manually include only the relevant data in the "[Simulation data paths]" that you want to plot together.
