Skip to content

Commit 5214de2

Browse files
committed
voltage pmod + fix typos current sensor docs
Signed-off-by: Martijn Govers <Martijn.Govers@Alliander.com>
1 parent 81e0334 commit 5214de2

File tree

2 files changed

+22
-2
lines changed

2 files changed

+22
-2
lines changed

docs/user_manual/calculations.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -96,6 +96,11 @@ also of importance, i.e., the measurements should be topologically independent.
9696
Global angle current measurements require at least one voltage angle measurement to make sense. See also the [current sensor component documentation](./components.md#global-angle-current-sensors).
9797
```
9898

99+
```{note}
100+
It is not possible to add both a [power sensor](./components.md#generic-current-sensor) and a [current sensor](#./components.mdgeneric-current-sensor) to the same terminal of the same component.
101+
It is, however, allowed to have both a power sensor and a current sensor on the same branch if they are on different terminals.
102+
```
103+
99104
```{warning}
100105
The [iterative linear](#iterative-linear-state-estimation) and [Newton-Raphson](#newton-raphson-state-estimation) state estimation algorithms will assume angles to be zero by default (see the details about voltage sensors).
101106
In observable systems this helps better outputting correct results. On the other hand with unobservable systems, exceptions raised from calculations due to faulty results will be prevented.
@@ -462,6 +467,11 @@ $$
462467

463468
Where $S_k$ and $\sigma_{P,k}$ and $\sigma_{Q,k}$ are the measured value and the standard deviation of the individual appliances.
464469

470+
```{note}
471+
It is not possible to add both a [power sensor](./components.md#generic-current-sensor) and a [current sensor](#./components.mdgeneric-current-sensor) to the same terminal of the same component.
472+
It is, however, allowed to have both a power sensor and a current sensor on the same branch if they are on different terminals.
473+
```
474+
465475
#### State estimate sensor transformations
466476

467477
Sometimes, measurements need to be transformed between coordinate spaces. For example, current measurements are in polar coordinates (magnitude and angle), but it is beneficial to transform them to separate real and imaginary components per phase, with each their own variances.

docs/user_manual/components.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -650,6 +650,11 @@ In the state estimation result, the power from this injection is distributed equ
650650
Because of this distribution, at least one appliance is required to be connected to the node where an injection sensor is placed for it to function.
651651
```
652652

653+
```{note}
654+
It is not possible to add both a [power sensor](#generic-current-sensor) and a [current sensor](#generic-current-sensor) to the same terminal of the same component.
655+
It is, however, allowed to have both a power sensor and a current sensor on the same branch if they are on different terminals.
656+
```
657+
653658
##### Input
654659

655660
| name | data type | unit | description | required | update | valid values |
@@ -741,6 +746,11 @@ The terminal is connecting the from/to end of a `branch` (except `link`) and a `
741746
Due to the high admittance of a `link` it is chosen that a current sensor cannot be coupled to a `link`, even though a link is a `branch`
742747
```
743748

749+
```{note}
750+
It is not possible to add both a [power sensor](#generic-current-sensor) and a [current sensor](#generic-current-sensor) to the same terminal of the same component.
751+
It is, however, allowed to have both a power sensor and a current sensor on the same branch if they are on different terminals.
752+
```
753+
744754
##### Input
745755

746756
| name | data type | unit | description | required | update | valid values |
@@ -826,11 +836,11 @@ As a result, the local angle current sensors have a different sign convention fr
826836
$$
827837
\begin{eqnarray}
828838
& i_{\text{residual}} = i_{\text{measured}} - i_{\text{state}} && \\
829-
& i_{\text{angle},\text{residual}} = i_{\text{angle},\text{measured}} - i_{\text{angle},\text{state}} \pmod 2 \pi
839+
& i_{\text{angle},\text{residual}} = i_{\text{angle},\text{measured}} - i_{\text{angle},\text{state}} \pmod{2 \pi}
830840
\end{eqnarray}
831841
$$
832842

833-
The $\pmod 2\pi$ is handled such that $-\pi \lt i_{\text{angle},\text{residual}} \leq \pi$.
843+
The $\pmod{2\pi}$ is handled such that $-\pi \lt i_{\text{angle},\text{residual}} \leq \pi$.
834844

835845
## Fault
836846

0 commit comments

Comments
 (0)