Skip to content

Conversation

@tiyash-basu-frequenz
Copy link
Contributor

Voltage-transformers are used in voltmeters for pretection, whereas what we needed was a power transformer, which is used for bulk transfer of electrical energy with voltage stepping up or down.

This renaming makes the electrical component name more consistent with the underlying concept of the component.

@tiyash-basu-frequenz tiyash-basu-frequenz self-assigned this Jul 9, 2025
Copilot AI review requested due to automatic review settings July 9, 2025 13:04
@tiyash-basu-frequenz tiyash-basu-frequenz requested a review from a team as a code owner July 9, 2025 13:04
@tiyash-basu-frequenz tiyash-basu-frequenz linked an issue Jul 9, 2025 that may be closed by this pull request
@github-actions github-actions bot added part:docs Affects the documentation part:protobuf Affects the protocol buffer definition files labels Jul 9, 2025
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

Renames all occurrences of "voltage transformer" to "power transformer" to better reflect the component's role in bulk energy transfer.

  • Updated enum value and documentation in electrical_components.proto
  • Renamed VoltageTransformer message to PowerTransformer and updated the corresponding field in ElectricalComponentCategorySpecificInfo
  • Added entries to RELEASE_NOTES.md to document the renaming

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
proto/frequenz/api/common/v1alpha8/microgrid/electrical_components/electrical_components.proto Renamed the enum and message from VoltageTransformer to PowerTransformer, updated comments
RELEASE_NOTES.md Documented renaming of transformer identifiers in release notes
Comments suppressed due to low confidence (1)

proto/frequenz/api/common/v1alpha8/microgrid/electrical_components/electrical_components.proto:115

  • [nitpick] Consider noting that in real-world applications, output power is slightly less than input due to transformer efficiency losses, to give a more accurate technical description.
  // Since power transformers try to keep the output power same as the input

llucax
llucax previously approved these changes Jul 9, 2025
Copy link
Contributor

@llucax llucax left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM.

We are also using the term transformer in metrics.proto (METRIC_INVERTER_TEMPERATURE_TRANSFORMER and METRIC_CONNECTION_CATEGORY_TRANSFORMER). I guess this is s completely different concept, as it refers to the internals of a component, so it is OK that they don't match (and maybe even desirable to avoid confusion), but I thought I bring it up just in case.

Voltage-transformers  are used in voltmeters for pretection, whereas
what we needed was a power transformer, which is used for bulk transfer
of electrical energy with voltage stepping up or down.

This renaming makes the electrical component name more consistent with
the underlying concept of the component.

Signed-off-by: Tiyash Basu <[email protected]>
@tiyash-basu-frequenz
Copy link
Contributor Author

I fixed the typo pointed out by copilot. Since the PR was otherwise approved, I'll merge it. :)

@tiyash-basu-frequenz tiyash-basu-frequenz merged commit f6f8391 into frequenz-floss:v0.x.x Jul 9, 2025
6 checks passed
@tiyash-basu-frequenz tiyash-basu-frequenz deleted the 387_voltage_power_trafop branch July 9, 2025 14:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

part:docs Affects the documentation part:protobuf Affects the protocol buffer definition files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Review name and description of VoltageTransformer

2 participants