Version 0.14.0

[benoit9126]

This version 0.14.0 has some major improvements! Please note that some deprecated functions, packages and attributes have been removed in this version.

Changelog

• BUG: rlf.LineParameters.to_sym() should perform Kron's reduction for 4-wire lines #435 Optional Kron reduction when converting to symmetrical components #436 Add rlf.converters.kron_reduction function to perform Kron reduction on any nxn matrix reducing it to an (n-1)x(n-1) matrix by eliminating the last row and column. Also add eliminate_neutral parameter to rlf.LineParameters.to_sym to optionally eliminate the neutral conductor using Kron's reduction when converting line parameters to symmetrical components.

• Add LV cables to the catalogue #434 ENH: Add LV cables to the catalogue #422 Add LV line parameters to the catalogue (e.g. U_AL_3x150+70). You can get all added LV lines with rlf.LineParameters.get_catalogue(r"^[UOT]_[A-Z]+_3x(\d+)\+(\d+(?:\.\d+)?)$").

• Add voltage profile plotting #429 ENH: A function to plot the voltage profile of a network #298 Add rlf.plotting.voltage_profile function to plot the voltage profile of a network. The function returns an object with plot_matplotlib() and plot_plotly() methods to create plots using Matplotlib or Plotly respectively.

• Add missing transformer tap to the networkx graph #427 Add missing transformer tap to the edge data in the graph generated by ElectricalNetwork.to_graph.

• Interactive map plotting with results #426 Add rlf.plotting.plot_results_interactive_map for plotting a network with load flow results on an
  interactive map. Buses are colored according to their voltage levels and lines are colored according to their loading
  levels.

• Enforce some deprecations #425 Enforce the following deprecations:

  • The side parameter of rlf.GroundConnection, rlf.plotting.plot_voltage_phasors and
    rlf.plotting.plot_symmetrical_voltages is removed. Pass a branch side directly instead (e.g.
    rlf.GroundConnection(ground=ground, element=transformer.side_hv)).
  • The potentials attribute and constructor parameter of Bus is removed. Use initial_potentials instead.
  • The bus of a disconnected load or source no longer returns None. Use the new is_disconnected property to check
    if the load or source is disconnected.
  • The phase parameter of rlf.PotentialRef is removed. Use phases instead.
  • The res_voltages_hv and res_voltages_lv attributes of rlf.Transformer are removed. Use <side>.res_voltages instead.
  • Deprecated names in rlf.constants, rlf.types and rlf.sym modules are removed.
  • Deprecated modules in the rlf.utils package are removed. This package is for internal use only and should not be considered stable.

• Improve voltage propagation involving delta sources #421 Improve initial voltage guesses in the Newton algorithm for networks involving delta connected sources.

• Drop support for Python 3.11 #419 Simplify finding external modules for warnings #420 Require Python 3.12 or newer and bump the minimum supported versions of some dependencies per SPEC-0.

• Improve interactive map plots #418 Many improvements to the styles of interactive map plots:

  • Different voltage levels are represented with different marker sizes and line widths. Nominal voltages are used to
    determine the voltage levels automatically. If nominal voltages are not available, they are inferred from the
    transformers and sources
  • Underground lines are dashed while other lines are solid including lines with unknown line type
  • Transformers are now represented with a square icon with a divider in the middle and with both HV and LV buses
    information in the tooltip and popup
  • Sourcers are represented with a bigger square icon
  • If the new parameter fit_bounds is set to True (default), the bounds of the map will be automatically adjusted
    using folium.FitOverlays to fit the network elements.

  Note that the markers of buses, transformers and sources now use the folium.DivIcon icon which means the style
  function must now return a style dictionary of the form {'html': ...} for these elements.

• Restore bus and line in interactive map layer control #413 Restore bus and layers to the layer control in the interactive map plot. This was broken in version 0.13.0.

• Run tests on dev and free-threaded pythons #404 Fix filtering catalogues using compiled regular expressions with newer versions of pandas.

[alihamdan]

Let’s go 🚀