Skip to content

Releases: RoseauTechnologies/Roseau_Load_Flow

Version 0.12.0-alpha

09 Jan 11:43
@benoit9126 benoit9126
v0.12.0-alpha
5dfe47f
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
Version 0.12.0-alpha Pre-release
Pre-release

A new alpha version to test the new features 🎉

  • Some improvements of the underlying engine:
    • Simplify the center-tapped transformer model in order to improve the convergence speed (especially in case of a short-circuit).
    • Add the backward-forward algorithm for the single-phase transformers.
    • Improve the error message if a singular matrix is detected.
    • Build the engine using the manylinux_2_34 image for Linux distributions (previously it was manylinux_2_28).
  • #311 Add French aliases to line enumeration types.
  • #311 Fix TypeErrors in the LineParameters.from_coiffier_model. The error message of invalid models now indicates whether the line type or the conductor material is invalid.
  • #310 #308 Support star and zig-zag windings with non-brought out neutral. In earlier versions, vector groups like "Yd11" were considered identical to "YNd11".
  • #307 #296 Make line.res_violated and bus.res_violated return a boolean array indicating if the corresponding phase is violated. This is consistent with the dataframe results en.res_lines and en.res_buses_voltages. For old behavior, use line_or_bus.res_violated.any().
  • #305 Add missing tap column to en.transformers_frame.
  • #305 Add element_type column to en.potential_refs_frame to indicate if the potential reference is connected to a bus or a ground.
  • #305 Add missing information to results_to_dict with full=True. This adds loading to lines and transformers, voltage_levels to buses, and voltages to loads and sources.
  • #305 Improve the performance of res_violated of buses, lines and transformers.
  • #304 Add top-level modules rlf.constants and rlf.types. The old modules in the utils package are deprecated and will be removed in a future release. The utils package is for internal use only and should not be considered stable.
  • #304 Add top-level module rlf.sym for symmetrical components utilities. The sym_to_phasor, phasor_to_sym and series_phasor_to_sym functions are moved from the rlf.converters module to this module. The old functions are deprecated and will be removed in a future release.
  • #303 Fix missing voltage_level in en.res_buses_voltages when the buses define nominal voltage but not voltage limits.
  • #303 Add rlf.SQRT3 constant for the square root of 3. It can be useful for the conversion between phase-to-phase and phase-to-neutral voltages.
  • #303 Improve the performance of some dataframe properties.
  • #301 #299 Improve the error message when the Jacobian matrix contains infinite or NaN values.

What's Changed

Full Changelog: v0.11.0...v0.12.0-alpha

Contributors

benoit9126, dependabot, and 2 other contributors
Assets 4
Loading

Version 0.11.0

02 Dec 13:48
@benoit9126 benoit9126
v0.11.0
ea15961
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
Version 0.11.0 Latest
Latest

This release adds official support for Python 3.13 and adds a new experimental backward-forward solver. 🎉

Breaking changes

  • The min_voltage and max_voltage of Bus have been replaced by nominal_voltage (phase-to-phase, in V), a min_voltage_level (unitless) and a max_voltage_level (unitless).
  • The type parameter of TransformerParameters constructors becomes vg for vector group. Replace type="single" by vg="Ii0" and type="center" by vg="Iii0".
  • The type attribute of TransformerParameters now returns three-phase, single-phase or center-tapped. Use TransformerParameters.vg to get the vector group.
  • The names of the transformers in the catalogue have been modified to add voltage levels and vector groups. Use rlf.TransformerParameters.get_catalogue() to see the updated catalogue.
  • The max_current, section, insulator_type and conductor_type parameters of the LineParameters class are renamed to ampacities, sections, insulators and materials respectively. The new parameters accept arrays of values, one per conductor.
  • The enumeration InsulatorType.UNKNOWN is removed. Please use None if the insulator is unknown.
  • The definition of constant-current loads is modified to be the magnitudes of the currents and their phase shift from the voltages instead of the absolute phase shift. Currents should no longer be rotated by 120° to be in sync with the voltages.

Deprecations

  • The enumerated classes InsulatorType and ConductorType are renamed to Insulator and Material respectively. Their old names are deprecated and will be removed in a future release.
  • The deprecated method LineParameters.from_name_mv is removed.

Detailed changes

  • #293 Fixed loading calculation for lines and transformers

  • #291 Fixed several bugs in JSON serialization and deserialization.

  • #289 #264 Improve the TransformerParameters class and the transformers catalogue

    • Add 15kV transformers to the catalogue (SE and FT)
    • Add single-phase transformers to the catalogue (Schneider Imprego)
    • Add step-up transformers to the catalogue (Cahors "Serie Jaune")
    • Use the correct LV side no-load voltage as defined in the datasheets (some 400V became 410V)
    • Revert #282 to keep the IEC 600076 names uhv and ulv for the transformer voltages.
    • Replace the type parameter of TransformerParameters constructors by vg for vector group.
    • TransformerParameters.type now returns three-phase, single-phase or center-tapped. Use TransformerParameters.vg to get vector group.
    • Modify the names of the transformers in the catalogue to add voltage levels and vector groups

  • #285 #279 Add maximum loading for lines and transformers.

    • The constructors of Transformer and Line now accept a unitless max_loading parameter equal to 1 (=100%) by default.
    • The parameter max_currents of LineParameters is now called ampacities.
    • The Line class gained a new property max_currents that returns the maximal admissible currents (in Amps) for each conductor: line.max_current = line.parameters.ampacity * line.max_loading.
    • The res_violated property of Transformer and Line now take into account this max_loading.
    • The Line and Transformer classes have a new res_loading property to compute the loading of the element:
      • line.res_loading = line.res_currents / line.parameters.ampacities
      • transformer.res_loading = sum(transformer.res_powers) / transformer.parameters.sn

  • #286 The deprecated method LineParameters.from_name_mv is removed.

  • #283 Several changes related to the LineParameters:

    • The max_current, section, insulator_type and conductor_type parameters are renamed to max_currents, sections, insulators and materials respectively. The new parameters accept arrays of values, one per conductor.
    • The class method from_geometry now accepts several additional arguments related to the neutral (material_neutral, insulator_neutral, max_current_neutral)
    • The enumerated classes InsulatorType and ConductorType are renamed to Insulator and Material. Their old names are deprecated and will be removed in a future release.
    • The insulator UNKNOWN is removed. Please use None if the insulator is unknown.
    • The insulator NONE is added. It must be used to describe conductors without insulator.
    • The catalogue has now several additional columns related to the neutral parameters (resistance, reactance, susceptance, material, insulator, maximal current). The get_catalogue and the from_catalogue methods have been changed to accept filter on the columns (material_neutral, insulator_neutral, section_neutral)

  • #281 Add official support for Python 3.13.

  • #278 #280 Modify the Bus voltage limits:

    • The min_voltage and max_voltage parameters and attributes of Bus have been replaced by nominal_voltage (phase-to-phase, in V), a min_voltage_level (unitless) and a max_voltage_level (unitless).
    • Bus gained a new property res_voltage_levels that returns the voltage levels of the bus as a percentage of the nominal voltage;
    • The JSON file format also changed to take into account these changes. If a min_voltage or max_voltage existed in a file of a previous version, they are lost when upgrading the file.

  • #277 Fix the definition of constant current loads to be the magnitudes of the currents and their phase shift from the voltages instead of the absolute phase shift. Currents should no longer be rotated by 120° to be in sync with the voltages.

  • #276 Add a backward-forward solver (experimental).

  • #275 Use uv instead of Rye as dependency manager.

  • #273 Dynamically calculate the stacklevel of the first frame outside of roseau.load_flow for warnings

  • #272 #271: Fix segfault when phases of a potential reference are not the same as the bus phases.

  • #270 Use Rye instead of Poetry as dependency manager.

  • #269 Optimize the SVG files of the documentation.

  • #268 Set up ReadTheDoc to automatically compile the documentation.

  • #267 Add a section in the documentation on Google Colab secrets.

What's Changed

Full Changelog: v0.10.0...v0.11.0

Contributors

benoit9126, dependabot, and 2 other contributors
Assets 4
Loading

Version 0.10.0

04 Sep 10:04
@benoit9126 benoit9126
v0.10.0
382deaa
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
Version 0.10.0

A lot of improvements 🎉

Important

There is a main breaking change in this version. The constructor of the class ElectricalNetwork has changed:

  • it accepts keyword arguments only.
  • it accepts the arguments lines, transformers and switches in replacement of the argument branches.
  • As a consequence,
    • the results method res_branches has been removed. Please use res_lines, res_transformers
      and res_switches methods instead.
    • the field branches does not exist anymore. Please use the fields lines, transformers and switches.
  • A wheel for Python 3.13 is available.
  • The wheels for Windows are now available. The problem was the same as the one of the
    issue 28551 of the Matplotlib repository.
  • #237 Improvements of the Sphinx configuration.
  • #262 Raise a proper error when a transformer is defined with null impedance.
  • #259 The cache of the license object was not reset after the activation of a new license key.
  • #258 #261 #263 Add basic plotting functionality in the new roseau.load_flow.plotting
    module. The plot_interactive_map function plots an electrical network on an interactive map using
    the folium library and the plot_voltage_phasors function plots the voltage phasors of a bus, load
    or source in the complex plane. The revamped plotting section of the documentation demonstrates the
    plotting functionalities available in Roseau Load Flow with examples.
  • #258 The documentation gained a new "advanced" section with a page on floating neutrals
    and a page on potential references.
  • #257 #252 Updates to the LineParameters class:
    • The method from_name_lv, deprecated since version 0.6, has been removed. It can be easily
      replaced by the from_geometry method.
    • The method from_name_mv is deprecated. A new method from_coiffier_model is added with the
      same functionality and more flexibility. The new method computes the ampacity of the line based
      on Coiffier's model and works with different numbers of phases.
  • #256 #250:
    • Accept scalar values for the powers, currents, impedances parameters of the load classes.
    • Add rlf.PositiveSequence, rlf.NegativeSequence and rlf.ZeroSequence vectors for easier
      creation of balanced quantities.
  • #255 Update the figures of loads and of voltage sources in the documentation to be compliant with the work
    of #249.
  • #254 #251 Allow passing multiple phases to potential references. The phase
    attribute of the PotentialRef is replaced by phases.
  • #249 #248 Accept scalar values for the voltages parameter of the VoltageSource class.
  • #247 Add connect_neutral parameter to the loads and sources constructor to specify if the
    neutral is to be connected to the bus's neutral or to be left floating. This allows loads connected
    to the same bus to have different neutral connections. The default behavior remains the same as
    before where the neutral is connected when the bus has a neutral and floating otherwise.
  • #246 Improvements to the rlf.converters module:
    • Fix series_phasor_to_sym function with series that have different phases per element.
    • Make calculate_voltages take array-like potentials.
    • Improve typing of several functions.
  • #245 #244 Fix the LineParameters.from_geometry method to not crash when passed
    unknown insulator type or None.
  • Add res_voltages to the VoltageSource class for symmetry with the other elements.
    res_voltages is always equal to the supplied voltages for a voltage source.
  • #243 Fix cross-sectional area of DGS line types created from line elements and special case
    invalid PwF line geographical coordinates table.
  • #240 Add tests for switches imported from DGS and improve warning and error messages.
  • #235 BREAKING CHANGE: The constructor of the class ElectricalNetwork has changed:
    • it accepts keyword arguments only.
    • it accepts the arguments lines, transformers and switches in replacement of the argument branches.
    • As a consequence,
      • the results method res_branches has been removed. Please use res_lines, res_transformers
        and res_switches methods instead.
      • the field branches does not exist anymore. Please use the fields lines, transformers and switches.
  • #235 Move the Switch class into its own file roseau/load_flow/models/switches.py.
  • #235 #239 The JSON file format number is upgraded to the version 2. All the files in version 0 or 1
    can still be read. Please upgrade them manually using the following code: 
    path = "my_json_file.json"
ElectricalNetwork.from_json(path).to_json(path)
  • #235 The method results_to_dict now accepts the keyword-only argument full which allows the export of all
    the results of an element.
  • #235 Solve a bug concerning the accessors to the flexible powers result of flexible power loads. An unwanted
    error was raised.
  • #235 Replace the occurrences of the str.find method by the str.index function.
  • #235 The method to_graph of the class ElectricalNetwork now retrieves a graph with additional data store
    in the edges depending on the edge type: line, transformer or switch.
  • #242 Add optional data to the TransformerParameters class: manufacturer, efficiency and range.
  • #242 Fixed a bug in the unit of q_min and q_max in the constructor of FlexibleParameter.
  • #242 Add equality operator for the classes FlexibleParameter, Control and Projection.
Assets 4
Loading

Version 0.9.1

05 Jul 10:13
@benoit9126 benoit9126
v0.9.1
568c4d3
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
Version 0.9.1

Several improvements to better support importing PowerFactory models.

  • #231 Add LineParameters.from_power_factory and TransformerParameters.from_power_factory
    methods to easily import PowerFactory lines and transformer models into Roseau Load Flow.

  • #230 Improve the algorithm for assigning potential references for DGS networks.

  • #229 Several fixes and improvements to the PowerFactory import:

    • Update the "Export Definition Folder" bundled with Roseau Load Flow as a pfd file;
    • Support lines with missing type ID. This is the case when the TypLne objects are inherited
      from an external library in PowerFactory and not included in the project being exported; A
      LineParameters object is automatically created for these lines;
    • Support "General Load (ElmLod)" elements;
    • Preserve Geometry information on buses and branches;
    • Improve handling of phases of several elements. Previously, phases were hard-coded.
    • Fix the unit of the power of static generators;
    • Fix the re-sizing of the matrices of line types without neutral elements;
    • Fix the total power of "MV Loads (ElmLodmv)" to take into account its generation power;
    • Fix all loads to no longer ignore the scale factor of the power;
    • Fix the sign of the reactive power of MV and LV loads
    • Fix the ground connection to the source bus
    • And many more...

Please refer to the Data Exchange page for more information.

Note

Windows binaries (wheels) are temporarily unavailable since version 0.9.0. If you need them, please open an issue on GitHub.

What's Changed

Full Changelog: v0.9.0...v0.9.1

Contributors

benoit9126 and alihamdan
Assets 4
Loading

Version 0.9.0

22 Jun 08:35
@benoit9126 benoit9126
v0.9.0
696b4ce
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
Version 0.9.0

A lot of improvements 🎉 !

  • #227 Sources and loads are now allowed to have floating neutrals. This means that a load/source
    with phases="abcn" can now be connected to a bus with phases="abc".
  • #225 The calculate_voltages function now accepts and return pint quantities.
  • MacOS wheels for roseau-load-flow-engine are now published on PyPI. This means that pip install roseau-load-flow
    should now work on macOS.
  • Added support for running in Google Colab documents.
  • Fixed a bug in license checks caching on Windows.
  • Added support for Numpy 2.0.
  • #222 #223 from_catalogue() methods of the electrical network and transformer
    and line parameters now perform "full match" comparison on textual inputs. If you need the old
    behavior, use regular expression wild cards .* in the input string.
  • #220 #221 Add LineParameters.from_open_dss and TransformerParameters.from_open_dss methods to
    easily import OpenDSS lines and transformer models into Roseau Load Flow. More information is
    available in the documentation of these methods.
  • #210 #219 Add a parameter to LineParameters.from_catalogue to choose the number
    of phases of the created line parameters object.
  • #218 Add Transformer.res_power_losses to get the total power losses in a transformer.
  • #217 Add an ID override to TransformerParameters.from_catalogue similar to
    LineParameters.from_catalogue.
  • #216 #217 BREAKING CHANGE: Rename the id parameter of TransformerParameters
    catalogue methods to name to be consistent with LineParameters.
    If you call these methods by keyword arguments, make sure to update your usage of
    TransformerParameters.from_catalogue(id="xxx") to TransformerParameters.from_catalogue(name="xxx").
  • #212 BREAKING CHANGE: Modify the constructor of TransformerParameters to take the z2
    and ym parameters directly instead of the open and short circuit tests parameters. You can still
    create an object from these tests using the from_open_and_short_circuit_tests constructor. This
    change comes with other changes to TransformerParameters, notably:
    • The z2, ym, k, and orientation are now always available as attributes on the instance
    • The to_zyk method is deprecated in favour of the direct attribute access on the instance. This
      method will be removed in a future version
    • The parameters i0, p0, psc, and vsc are now optional. They return None for instances
      created using z2 and ym directly
    • The JSON representation of TransformerParameters has changed, but it is still compatible with
      the old representation.

What's Changed

Full Changelog: v0.8.1...v0.9.0

Contributors

benoit9126 and alihamdan
Assets 4
Loading

Version 0.8.1

11 Apr 16:30
@benoit9126 benoit9126
v0.8.1
b1c37f6
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
Version 0.8.1

A correction and documentation improvement:

  • #214 Solve a bug in the engine when using delta connected flexible loads.
  • #213 Better detection of poorly connected elements as described in #209. It raises a proper error
    message.
  • #211 Several improvements of the documentation:
    • Add Open Graph metadata to the documentation page.
    • Error on the susceptance unit in the tables of the LineParameters' catalogue.
    • Replot the networks of the catalogue (add a H1 title, use the Raleway font, only plot the lines to add their
      parameters id in the tooltip)

What's Changed

Full Changelog: v0.8.0...v0.8.1

Contributors

benoit9126 and Saelyos
Assets 4
Loading

Version 0.8.0

19 Mar 14:35
@benoit9126 benoit9126
v0.8.0
b3073d2
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
Version 0.8.0

Here comes the version 0.8.0 of Roseau Load Flow 🎉
The main changes are:

  • The three-phase transformer model had issues that are now solved.
  • A flexible power load can now have a zero power. This is useful for time-series simulations.

The detailed modifications are listed here:

  • #207 Fix a bug in the zig-zag three-phase transformer model that led to incorrect active power flow in the
    transformer. The bug affected the 50 kVA transformers that have the type Yzn11 in the catalogue.
  • #206 #187 Un-deprecate results_to_dict/json methods and remove deprecated
    results_from_dict/json methods.
  • #205 #200 Fix error when propagating the potentials from a voltage source with fewer phases
    than the bus.
  • #204 #193 Remove restrictions on geometry types. Allow specifying the CRS of the geometries.
  • #203 #186 Detect invalid element overrides when connecting a new element with the
    same ID and type of an existing element.
  • #202 #188 Explicitly prevent instantiation of abstract classes.
  • #201 #185 Add type attribute to the load classes and rename branches branch_type
    attribute to type for consistency. Please replace branch.branch_type by branch.type in your code.
    In addition, loads data frames gained two new columns:
    1. type indicating the load type: constant-(power, current, impedance);
    2. and flexible indicating if the load is flexible.
  • #197 Fix a bug in three-phase transformer models that led to excessive reactive power flow in the transformer.
  • #199 Add Schneider Electric EcoDesign transformers to the catalogue. These are tagged with the AA0Ak
    efficiency class. Other internal data have been added to the catalogue for testing purposes.
  • #198 Simplify the storage of the transformer catalogues. This is an internal change that should not have
    effects on user code.
  • #196 #194 Improve the error message when accessing res_flexible_powers on a non-flexible load
    and relax the flexible parameters plotting methods to accept an array-like of voltages.
  • #195 Use latexindent.pl to automatically indent LaTeX files in the documentation.
  • #192 Speed up results access by up to 3x using several optimization techniques. This is especially
    noticeable in timeseries simulations and when accessing results of large networks.
  • #184 Improve the documentation to have a better SEO (sitemap, metadata and canonical URLs). The navigation
    menu has also been improved.
  • #183 #181 Update the networks catalogue to better represent the real networks.
    LV loads are made single-phase, MV sources are connected in delta, and MV buses lost their neutral.
    Voltage, current, and power limits are added to the buses, lines, and transformers.
    The line parameters IDs are also updated to match the new line parameters catalogue.
  • #182 Improve the error message when trying to access results on the network before running the load flow.
  • #189 Allow flexible loads to have a null active theoretical power.

What's Changed

Full Changelog: v0.7.0...v0.8.0

Contributors

benoit9126, dependabot, and 2 other contributors
Assets 4
Loading

Version 0.7.0

08 Feb 15:29
@benoit9126 benoit9126
v0.7.0
221105e
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
Version 0.7.0

Important

Starting with this version, Roseau Load Flow is no longer supplied as a SaaS. The software is
available as a standalone Python library. Please contact us at [email protected] in order to get a license key.

This release includes:

  • Fix a bug in the engine: it was impossible to change the parameters of center-tapped and single phase transformers.
  • #179 Fix a bug in the propagation of potentials when a center-tapped transformer is used without neutral at the primary side.
  • #178 #176 Merge the results_to_json, results_from_json, results_to_dict and results_from_dict methods of the ElectricalNetwork and Elements classes into the methods to_json, from_json, to_dict and from_dict respectively. The old results_ methods are deprecated and will be removed in a future release. The new methods will include the results by default, but you can pass include_results=False to exclude them.
  • #175 #174 Fix JSON serialization of network with line parameters created from the catalogue.
  • #173 Remove the conda installation option.

It also includes all the modifications of the alpha release #171 :

  • #168 #166 Fix initial potentials' propagation.
  • #167 #161 Add a catalogue of lines using the IEC standards. You can use the method LineParameters.get_catalogue() to get a data frame of the available lines and the method LineParameters.from_catalogue() to create a line from the catalogue. Several line types, conductor material, and insulation types have been updated. Physical constants have been updated to match the IEC standards where applicable.
  • #167 The class LineParameters now takes optional arguments line_type, conductor_type, insulator_type and section. These parameters are accessible as properties. They are filled automatically when creating a line from the catalogue or from a geometry.
  • #167 Replace all print_catalogue() methods by get_catalogue() methods that return a data frame instead of printing the catalogue to the console.
  • #167 Enumeration classes no longer have a from_string method, you can call the enumeration class directly with the string value to get the corresponding enumeration member. Case-insensitive behavior is preserved.
  • #167 #122 Add checks on line height and diameter in the LineParameters.from_geometry() alternative constructor. This method will try to guess a default conductor and insulation type if None is provided.
  • #163 BREAKING CHANGE: roseau-load-flow is no longer a SaaS project. Starting with version 0.7.0, the software is distributed as a standalone Python package. You need a license to use it for commercial purposes. See the documentation for more details. This comes with a huge performance improvement but requires a breaking change to the API:
    • The ElectricalNetwork.solve_load_flow() method no longer takes an auth argument.
    • To activate the license, you need to call roseau.load_flow.activate_license("MY LICENSE KEY") or set the environment variable ROSEAU_LOAD_FLOW_LICENSE_KEY (preferred) before calling ElectricalNetwork.solve_load_flow(). More information in the documentation.
    • Several methods on the FlexibleParameter class that previously required auth are changed. Make sure to follow the documentation to update your code.
  • #163 #158 Fix ElectricalNetwork.res_transformers returning an empty dataframe when max_power is not set.
  • #163 Several unused exception codes were removed. An EMPTY_NETWORK code was added to indicate that a network is being created with no elements.
  • #163 Remove the ElectricalNetwork.res_info attribute. ElectricalNetwork.solve_load_flow() now returns the tuple (number of iterations, residual).
  • #163 Remove the Bus.clear_short_circuits() and ElectricalNetwork.clear_short_circuits() methods. It is currently not possible to clear short-circuits from the network.
  • #163 Improve performance of network creation and results access.
  • #163 Attributes phases and bus are now read-only on all elements.
  • #151 Require Python 3.10 or newer.

What's Changed

Full Changelog: v0.6.0...v0.7.0

Contributors

benoit9126, dependabot, and 2 other contributors
Assets 4
Loading

Version 0.7.0-alpha

24 Jan 09:04
@benoit9126 benoit9126
v0.7.0-alpha
a407fda
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
Version 0.7.0-alpha Pre-release
Pre-release

Important

Starting with version 0.7.0, Roseau Load Flow will no longer be supplied as a SaaS. The software will
be available as a standalone Python library. Please contact us at [email protected] in order to get a license key.

  • #168 #166 Fix initial potentials' propagation.
  • #167 #161 Add a catalogue of lines using the IEC standards. You can use the method
    LineParameters.get_catalogue() to get a data frame of the available lines and the method
    LineParameters.from_catalogue() to create a line from the catalogue. Several line types, conductor
    material, and insulation types have been updated. Physical constants have been updated to match the
    IEC standards where applicable.
  • #167 The class LineParameters now takes optional arguments line_type, conductor_type,
    insulator_type and section. These parameters are accessible as properties. They are filled
    automatically when creating a line from the catalogue or from a geometry.
  • #167 Replace all print_catalogue() methods by get_catalogue() methods that return a
    data frame instead of printing the catalogue to the console.
  • #167 Enumeration classes no longer have a from_string method, you can call the enumeration
    class directly with the string value to get the corresponding enumeration member. Case-insensitive
    behavior is preserved.
  • #167 #122 Add checks on line height and diameter in the LineParameters.from_geometry()
    alternative constructor. This method will try to guess a default conductor and insulation type if
    none is provided.
  • #163 BREAKING CHANGE: roseau-load-flow is no longer a SaaS project. Starting with version
    0.7.0, the software is distributed as a standalone Python package. You need a license to use it for
    commercial purposes. See the documentation for more details. This comes with a huge performance
    improvement but requires a breaking change to the API:
    • The ElectricalNetwork.solve_load_flow() method no longer takes an auth argument.
    • To activate the license, you need to call roseau.load_flow.activate_license("MY LICENSE KEY")
      or set the environment variable ROSEAU_LOAD_FLOW_LICENSE_KEY (preferred) before calling
      ElectricalNetwork.solve_load_flow(). More information in the documentation.
    • Several methods on the FlexibleParameter class that previously required auth are changed. Make
      sure to follow the documentation to update your code.
  • #163 #158 Fix ElectricalNetwork.res_transformers returning an empty dataframe
    when max_power is not set.
  • #163 Several unused exception codes were removed. An EMPTY_NETWORK code was added to indicate
    that a network is being created with no elements.
  • #163 Remove the ElectricalNetwork.res_info attribute. ElectricalNetwork.solve_load_flow() now
    returns the tuple (number of iterations, residual).
  • #163 Remove the Bus.clear_short_circuits() and ElectricalNetwork.clear_short_circuits()
    methods. It is currently not possible to clear short-circuits from the network.
  • #163 Improve performance of network creation and results access.
  • #163 Attributes phases and bus are now read-only on all elements.
  • #151 Require Python 3.10 or newer.
Assets 4
Loading

Version 0.6.0

29 Nov 11:00
@benoit9126 benoit9126
v0.6.0
6eb6507
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
Version 0.6.0

Note

This is the last release to support Python 3.9!

A new version with the following improvement/bug correction:

  • #149 #145 Add custom pint wrapper for better handling of pint arrays.
  • #148 #122 deprecate LineParameters.from_name_lv() in favour of the more generic
    LineParameters.from_geometry(). The method will be removed in a future release.
  • #142 #136 Add Bus.res_voltage_unbalance() method to get the Voltage Unbalance
    Factor (VUF) as defined by the IEC standard IEC 61000-3-14.
  • #141 #137 Add ElectricalNetwork.to_graph() to get a networkx.Graph object
    representing the electrical network for graph theory studies. Install with the "graph" extra to
    get networkx.
    ElectricalNetwork also gained a new buses_clusters property that returns a list of sets of
    IDs of buses that are connected by a line or a switch. This can be useful to isolate parts of the
    network for localized analysis. For example, to study a LV subnetwork of a MV feeder. Alternatively,
    to get the cluster certain bus belongs to, you can use Bus.get_connected_buses().
  • #141 Add official support for Python 3.12. This is the last release to support Python 3.9.
  • #138 Add network constraints for analysis of the results.
    • Buses can define minimum and maximum voltages. Use bus.res_violated to see if the bus has
      over- or under-voltage.
    • Lines can define a maximum current. Use line.res_violated to see if the loading of any of the
      line's cables is too high.
    • Transformers can define a maximum power. Use transformer.res_violated to see if the transformer
      loading is too high.
    • The new fields also appear in the data frames of the network.
  • #133 #126 Add Qmin and Qmax limits of flexible parameters.
  • #132 #101 Document extra utilities including converters and constants.
  • #131 #127 Improve the documentation of the flexible loads.
    • Add the method compute_powers method to the FlexibleParameter class to compute the resulting flexible powers
      for a given theoretical power and a list of voltage norms.
    • Add the plot_control_p, plot_control_q and plot_pq methods to the FlexibleParameter class to plot the
      control curves and control trajectories.
    • Add the extra plot to install matplotlib alongside roseau-load-flow.
  • #131 Correction of a bug in the error message of the powers setter method.
  • #130 Mark some internal attributes as private, they were previously marked as public.
  • #128 Add the properties z_line, y_shunt and with_shunt to the Line class.
  • #125 Speed-up build of conda workflow using mamba.

What's Changed

Full Changelog: v0.5.0...v0.6.0

Contributors

benoit9126, dependabot, and 2 other contributors
Assets 4
Loading