Support ComputedTopology protocol buffer

.github/workflows/golang.yaml

@@ -21,11 +21,11 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-        if: ${{ github.event_name == 'pull_request' }}
+        if: ${{ startsWith(github.event_name, 'pull_request') }}
         with:
           ref: ${{github.event.pull_request.head.ref}}
       - uses: actions/checkout@v4
-        if: ${{ github.event_name != 'pull_request' }}
+        if: ${{ !startsWith(github.event_name, 'pull_request') }}
       - run: git config --global url.https://[email protected]/.insteadOf https://github.com/
       - uses: bufbuild/buf-setup-action@v1
       - uses: bufbuild/buf-lint-action@v1

RELEASE_NOTES.md

@@ -1,6 +1,10 @@
 # ProtoBuf Release Notes
 
-## 0.0.4-dev - 2024-02-13
+## 0.0.4-dev - 2024-02-19
+
+### Features
+
+- Topology protobuf and any notification params (PR #39 by @hiimjako)
 
 ### Continuous Integration
 

docs/task.proto.md

@@ -9,8 +9,9 @@ services.
 
 ## Imports
 
-| Import | Description |
-|--------|-------------|
+| Import                    | Description |
+|---------------------------|-------------|
+| google/protobuf/any.proto |             |
 
 
 
@@ -99,8 +100,9 @@ direction LR
 
 class Parameter {
   + string name
-  + string value
+  + google.protobuf.Any value
 }
+Parameter --> `google.protobuf.Any`
 
 ```
 ### Task Diagram
@@ -160,10 +162,10 @@ Notification --> `Parameter`
 A parameter of a `Task` or `Notification`
 
 
-| Field   | Ordinal | Type     | Label | Description          |
-|---------|---------|----------|-------|----------------------|
-| `name`  | 1       | `string` |       | The parameter name   |
-| `value` | 2       | `string` |       | The parameter value  |
+| Field   | Ordinal | Type                  | Label | Description          |
+|---------|---------|-----------------------|-------|----------------------|
+| `name`  | 1       | `string`              |       | The parameter name   |
+| `value` | 2       | `google.protobuf.Any` |       | The parameter value  |
 
 
 

docs/topology.proto.md

@@ -41,6 +41,65 @@ class Topology {
   + bytes tp
 }
 
+```
+### TopologicalNode Diagram
+
+```mermaid
+classDiagram
+direction LR
+
+%% A topology Node information.
+%% * To be used in ComputedTopology message.
+%% 
+
+class TopologicalNode {
+  + double BaseVoltage
+  + string BaseVoltageId
+  + string ConnectivityNodeContainerId
+  + List~string~ ConnectivityNodeIds
+  + List~string~ PowerTransferEndIds
+  + List~string~ TerminalIds
+}
+
+```
+### TopologicalIsland Diagram
+
+```mermaid
+classDiagram
+direction LR
+
+%% A topology Island information.
+%% * To be used in ComputedTopology message.
+%% 
+
+class TopologicalIsland {
+  + List~string~ TopologicalNodeIds
+}
+
+```
+### ComputedTopology Diagram
+
+```mermaid
+classDiagram
+direction LR
+
+%% A processed topology information.
+%% Headers used in rabbitMQ:
+%% * `id` (string): id of the `Topology`
+%% * `type` (string): always `ComputedTopology`
+%% * `producerId` (string): the id of the producer (e.g. a PMU) linked to the dataset.
+%% * `timestampId` (int64): related measurement Unix msec timestamp (if any)
+%% * `subnetworkId` (string): the sub network id for which the topology was computed
+%% 
+
+class ComputedTopology {
+  + string eqId
+  + Map~string,  TopologicalIsland~ topologicalIslands
+  + Map~string,  TopologicalNode~ topologicalNodes
+}
+ComputedTopology .. ` TopologicalIsland`
+ComputedTopology .. ` TopologicalNode`
+
 ```
 
 ## Message: Topology
@@ -65,6 +124,66 @@ Headers used in rabbitMQ:
 
 
 
+## Message: TopologicalNode
+
+**FQN**: grid.v1.TopologicalNode
+
+A topology Node information.
+* To be used in ComputedTopology message.
+
+
+
+| Field                         | Ordinal | Type     | Label    | Description                                                      |
+|-------------------------------|---------|----------|----------|------------------------------------------------------------------|
+| `BaseVoltage`                 | 6       | `double` |          | The BaseVoltage in the TopologicalNode.                          |
+| `BaseVoltageId`               | 5       | `string` |          | The id of the BaseVoltage in the TopologicalNode.                |
+| `ConnectivityNodeContainerId` | 4       | `string` |          | The id of the ConnectivityNodeContainer in the TopologicalNode.  |
+| `ConnectivityNodeIds`         | 2       | `string` | Repeated | The list of ConnectivityNode ids in the TopologicalNode.         |
+| `PowerTransferEndIds`         | 3       | `string` | Repeated | The list of PowerTransferEnd ids in the TopologicalNode.         |
+| `TerminalIds`                 | 1       | `string` | Repeated | The list of Terminal ids in the TopologicalNode.                 |
+
+
+
+
+## Message: TopologicalIsland
+
+**FQN**: grid.v1.TopologicalIsland
+
+A topology Island information.
+* To be used in ComputedTopology message.
+
+
+
+| Field                | Ordinal | Type     | Label    | Description                                                |
+|----------------------|---------|----------|----------|------------------------------------------------------------|
+| `TopologicalNodeIds` | 1       | `string` | Repeated | The list of TopologicalNode ids in the TopologicalIsland.  |
+
+
+
+
+## Message: ComputedTopology
+
+**FQN**: grid.v1.ComputedTopology
+
+A processed topology information.
+Headers used in rabbitMQ:
+* `id` (string): id of the `Topology`
+* `type` (string): always `ComputedTopology`
+* `producerId` (string): the id of the producer (e.g. a PMU) linked to the dataset.
+* `timestampId` (int64): related measurement Unix msec timestamp (if any)
+* `subnetworkId` (string): the sub network id for which the topology was computed
+
+
+
+| Field                | Ordinal | Type                        | Label | Description                                     |
+|----------------------|---------|-----------------------------|-------|-------------------------------------------------|
+| `eqId`               | 1       | `string`                    |       | The id of the EQ file used.                     |
+| `topologicalIslands` | 3       | `string, TopologicalIsland` | Map   | The map of TopologicalIslands in the Topology.  |
+| `topologicalNodes`   | 2       | `string, TopologicalNode`   | Map   | The map of TopologicalNodes in the Topology.    |
+
+
+
+
 
 
 <!-- Created by: Proto Diagram Tool -->