electricpy.visu.phasorplot

electricpy.visu.phasorplot(phasors, title='Phasor Diagram', legend=False, bg=None, colors=None, radius=None, linewidth=None, size=None, label=False, labels=False, tolerance=None)[source]

Phasor Plotting Function.

This function is designed to plot a phasor-diagram with angles in degrees for up to 12 phasor sets (more may be used if additional colors are set). Phasors must be passed as a complex number set, (e.g. [ m+ja, m+ja, m+ja, … , m+ja ] ).

Examples

>>> import numpy as np
>>> from electricpy import phasors
>>> from electricpy import visu
>>> voltages = np.array([
...     [67,0],
...     [45,-120],
...     [52,120]
... ])
>>> phasors = phasors.phasorlist(voltages)
>>> plt = visu.phasorplot(phasors, colors=["red", "green", "blue"])
>>> plt.show()
../_images/PhasorPlot.png
Parameters:

  • phasors (list of complex) – The set of phasors to be plotted.

  • title (string, optional) – The Plot Title, default=”Phasor Diagram”

  • legend (bool, optional) – Control argument to enable displaying the legend, must be passed as an array or list of strings. label and labels are mimic- arguments and will perform similar operation, default=False

  • bg (string, optional) – Background-Color control, default=”#d5de9c”

  • radius (float, optional) – The diagram radius, unless specified, automatically scales

  • colors (list of str, optional) – List of hexidecimal color strings denoting the line colors to use.

  • size (float, optional) – Control argument for figure size. default=None

  • linewidth (float, optional) – Control argument to declare the line thickness. default=None

  • tolerance (float, optional) – Minimum magnitude to plot, anything less than tolerance will be plotted as a single point at the origin, by default, the tolerance is scaled to be 1/25-th the maximum radius. To disable the tolerance, simply provide either False or -1.

Returns:

matplotlib.pyplot – or plotting.

Return type:

Plotting object to be used for additional configuration