summaryrefslogtreecommitdiffstats
path: root/docusaurus
diff options
context:
space:
mode:
Diffstat (limited to 'docusaurus')
-rw-r--r--docusaurus/docs/bus.md31
-rw-r--r--docusaurus/docs/capacitor.md24
-rw-r--r--docusaurus/docs/const.md8
-rw-r--r--docusaurus/docs/controlEditor.md10
-rw-r--r--docusaurus/docs/divider.md10
-rw-r--r--docusaurus/docs/exponential.md21
-rw-r--r--docusaurus/docs/gain.md6
-rw-r--r--docusaurus/docs/graphViewer.md8
-rw-r--r--docusaurus/docs/heatmap.md8
-rw-r--r--docusaurus/docs/indMotor.md29
-rw-r--r--docusaurus/docs/inductor.md26
-rw-r--r--docusaurus/docs/io.md2
-rw-r--r--docusaurus/docs/limiter.md29
-rw-r--r--docusaurus/docs/line.md29
-rw-r--r--docusaurus/docs/load.md27
-rw-r--r--docusaurus/docs/mathExpression.md151
-rw-r--r--docusaurus/docs/multiplier.md10
-rw-r--r--docusaurus/docs/rateLimiter.md35
-rw-r--r--docusaurus/docs/sum.md20
-rw-r--r--docusaurus/docs/syncGenerator.md69
-rw-r--r--docusaurus/docs/syncMotor.md24
-rw-r--r--docusaurus/docs/tabularReport.md8
-rw-r--r--docusaurus/docs/text.md8
-rw-r--r--docusaurus/docs/transformer.md29
-rw-r--r--docusaurus/sidebars.js8
-rw-r--r--docusaurus/src/css/custom.css11
-rw-r--r--docusaurus/static/images/expForm.pngbin0 -> 2770 bytes
-rw-r--r--docusaurus/static/images/limiterForm.pngbin0 -> 2418 bytes
-rw-r--r--docusaurus/static/images/mathExpressionForm.pngbin0 -> 8458 bytes
-rw-r--r--docusaurus/static/images/rateLimitForm.pngbin0 -> 11140 bytes
-rw-r--r--docusaurus/static/images/sumForm.pngbin0 -> 1841 bytes
-rw-r--r--docusaurus/static/images/syncGeneratorStabForm.pngbin19604 -> 14625 bytes
32 files changed, 571 insertions, 70 deletions
diff --git a/docusaurus/docs/bus.md b/docusaurus/docs/bus.md
index f005c7c..02affa1 100644
--- a/docusaurus/docs/bus.md
+++ b/docusaurus/docs/bus.md
@@ -7,6 +7,9 @@ import useBaseUrl from "@docusaurus/useBaseUrl";
<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} />
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
>Condutor de baixa impedância ao qual vários circuitos elétricos podem ser conectados em pontos separados.
Nota - Em muitos casos, o barramento consiste em uma barra. [*tradução livre* - IEC 60050](
http://www.electropedia.org/iev/iev.nsf/display?openform&ievref=151-12-30).
@@ -29,8 +32,17 @@ Esse formulário é subdividido em quatro contextos distintos:
- **Estabilidade**: contendo opções de visualização de dados da barra em gráficos no tempo e inserção de faltas trifásicas no cálculo de estabilidade transitória;
- **Qualidade de energia**: contém a opção de de visualização da impedância harmônica vista pela barra.
----
-### Geral
+<Tabs
+ groupId="bus-tabs"
+ defaultValue="general"
+ values={[
+ {label: 'Geral', value: 'general'},
+ {label: 'Falta', value: 'fault'},
+ {label: 'Estabilidade', value: 'stability'},
+ {label: 'Qualidade de energia', value: 'powerQuality'},
+ ]
+}>
+<TabItem value="general">
#### Nome
Identificação do elemento elétrico. Podem ser inseridos quaisquer números de caracteres no padrão [Unicode](https://pt.wikipedia.org/wiki/Unicode).
@@ -54,8 +66,8 @@ O valor poderá ser inserido em p.u. ou em volts (ou kV caso a tensão nominal e
#### Barra de referência
Caracteriza o barramento como **barra de referência ([Barra de oscilação](powerFlow))**. Essa opção é somente válida caso esteja conectado um gerador síncrono, caso contrário uma mensagem de erro será exibida ao usuário ao realizar algum dos cálculos do programa.
----
-### Falta
+</TabItem>
+<TabItem value="fault">
#### Inserir falta
@@ -78,8 +90,8 @@ Seleciona a fase em que se situa a falta (ou combinação delas no caso de falha
#### Resistência e reatância de falta
Representam a impedância da falta. Curtos-circuitos francos (sem impedância de falta) são representados inserindo valor zero em ambos os campos.
----
-### Estabilidade
+</TabItem>
+<TabItem value="stability">
#### Imprimir dados
Mostra os dados da barra editada no gráfico gerado pelo estudo de estabilidade transitória. Os seguintes dados são exibidos:
@@ -101,8 +113,11 @@ Duração da falta inserida ($\Delta t_{falta}$) no estudo de estabilidade. A fa
#### Resistência e reatância de falta
Impedância de falta nos estudos de estabilidade. Uma falta franca é representada pela inserção de um valor de impedância shunt de valor muito baixo ($j10^{-5} p.u.$).
----
-### Qualidade de energia
+</TabItem>
+<TabItem value="powerQuality">
#### Imprimir impedância harmônica da barra
Imprime a impedância harmônica vista por essa barra referente ao estudo de [Resposta na Frequência](harmonics).
+
+</TabItem>
+</Tabs> \ No newline at end of file
diff --git a/docusaurus/docs/capacitor.md b/docusaurus/docs/capacitor.md
index cd5491f..9c9c0c8 100644
--- a/docusaurus/docs/capacitor.md
+++ b/docusaurus/docs/capacitor.md
@@ -7,6 +7,9 @@ import useBaseUrl from "@docusaurus/useBaseUrl";
<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} />
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
>Um dispositivo constituído essencialmente por dois eletrodos separados por um dielétrico. [*tradução livre* - IEC 60050](
http://www.electropedia.org/iev/iev.nsf/display?openform&ievref=436-01-03).
@@ -28,8 +31,15 @@ Além do único contexto geral, pode ser observado o botão "Estabilidade" na pa
<div><center><img src={useBaseUrl("images/swCapacitor.png")} alt="Formulário de chaveamento do capacitor" title="Formulário de chaveamento do capacitor" /></center></div>
----
-### Geral
+<Tabs
+ groupId="transformer-tabs"
+ defaultValue="general"
+ values={[
+ {label: 'Geral', value: 'general'},
+ {label: 'Botão Estabilidade', value: 'stability'},
+ ]
+}>
+<TabItem value="general">
#### Nome
Identificação do elemento elétrico. Podem ser inseridos quaisquer números de caracteres no padrão [Unicode](https://pt.wikipedia.org/wiki/Unicode).
@@ -39,8 +49,12 @@ Todos os componentes de potência do PSP-UFU possuem esse campo.
#### Potência reativa
Os capacitores e reatores exigem somente sua potência reativa como parâmetro, inserida em Mvar, kvar, var ou $p.u.$ (na base de potência do sistema).
----
-### Botão Estabilidade
+</TabItem>
+<TabItem value="stability">
+
O botão "Estabilidade" irá abrir um formulário, comum a vários outros elementos, que permite a inserção e/ou remoção do transformador durante o estudo de [estabilidade](stability).
-Nesse formulário pode ser criada uma lista genérica de inserções e remoções da linha no tempo, personalizada por um contexto de propriedades de chaveamento que são editados o tipo de chaveamento (inserção ou remoção) e o instante (em segundos) do evento. Essas propriedades são atribuídas e retiradas da lista genérica por meio dos botões "Adicionar" e "Remover", respectivamente. \ No newline at end of file
+Nesse formulário pode ser criada uma lista genérica de inserções e remoções da linha no tempo, personalizada por um contexto de propriedades de chaveamento que são editados o tipo de chaveamento (inserção ou remoção) e o instante (em segundos) do evento. Essas propriedades são atribuídas e retiradas da lista genérica por meio dos botões "Adicionar" e "Remover", respectivamente.
+
+</TabItem>
+</Tabs>
diff --git a/docusaurus/docs/const.md b/docusaurus/docs/const.md
index 4209d90..bc2eb39 100644
--- a/docusaurus/docs/const.md
+++ b/docusaurus/docs/const.md
@@ -5,4 +5,10 @@ sidebar_label: Constante
---
import useBaseUrl from "@docusaurus/useBaseUrl";
-<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} /> \ No newline at end of file
+<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} />
+
+As constantes são valores numéricos reais que permanecem inalteradas em todo o período de simulação. Esses elementos possuem somente um nó de saída, o qual poderá ser conectado a qualquer outro nó de entrada dos elementos de controle.
+
+:::info Informação
+Esse elemento pode, por exemplo, ser utilizado para definir valores alvos ou deslocamentos de sinal.
+::: \ No newline at end of file
diff --git a/docusaurus/docs/controlEditor.md b/docusaurus/docs/controlEditor.md
index b9a94f5..c27ac87 100644
--- a/docusaurus/docs/controlEditor.md
+++ b/docusaurus/docs/controlEditor.md
@@ -15,6 +15,14 @@ O acesso ao editor é realizado por meio de dois botões presentes no [formulár
- [Editar AVR](syncGenerator#utilizar-avr-e-regulador-de-velocidade)
- [Editar regulador de velocidade](syncGenerator#utilizar-avr-e-regulador-de-velocidade)
+:::caution Atenção!
+No PSP-UFU a opção de editar o **AVR** engloba mais que somente o controle de tensão da máquina. Nele **deve** ser inserida a malha de controle da máquina assim como a **excitatriz da máquina síncrona**. Outras estratégias de controle (opcionais), como PSS (*Power System Stabilizer*) e/ou controles de sobre e sub excitação, são também implementadas em conjunto (como apresentado na figura anterior).
+:::
+
+:::caution Atenção!
+Assim como no AVR, o **Regulador de Velocidade** engloba mais que a regulação primária da máquina. Nessa opção **deve** ser inserida ao menos a malha de controle da regulação primária de velocidade, assim como o **modelo da turbina**. Estratégias opcionais de controle da velocidade também são inseridas nessa opção.
+:::
+
## Elementos de Controle
O acesso aos elementos de controle é realizado em uma janela (removível e encaixável) por meio de ícones relacionados.
@@ -92,6 +100,8 @@ Nesse formulário é possível inserir o comportamento de **todas as entradas do
- **Passo de integração ($h$)**: Passo do método de integração Trapezoidal Implícito;
- **Tempo de simulação ($t_f$)**: Tempo total de simulação.
+Após a simulação os resultados são exibidos no [visualizador de gráficos](graphViewer).
+
:::caution Atenção!
A mesma parametrização de entrada é aplicada em todos os blocos de [entrada](io) do sistema.
:::
diff --git a/docusaurus/docs/divider.md b/docusaurus/docs/divider.md
index 2dd7315..af3bcae 100644
--- a/docusaurus/docs/divider.md
+++ b/docusaurus/docs/divider.md
@@ -5,4 +5,12 @@ sidebar_label: Divisor
---
import useBaseUrl from "@docusaurus/useBaseUrl";
-<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} /> \ No newline at end of file
+<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} />
+
+Esse elemento é bastante simples e cumpre com a função matemáticas de seu nome.
+
+Possui duas entradas de valores reais e sua saída é computada na sequência do nó superior pelo inferior, ou seja, a saída será o valor presente no nó 1 dividido pelo nó 2.
+
+:::caution Atenção!
+Nós não conectados no divisor são considerados como valor nulo. Caso a divisão possua numerador zero, o valor da saída é definida como sendo $10^{15}$.
+::: \ No newline at end of file
diff --git a/docusaurus/docs/exponential.md b/docusaurus/docs/exponential.md
index 351d63b..a327ef8 100644
--- a/docusaurus/docs/exponential.md
+++ b/docusaurus/docs/exponential.md
@@ -5,4 +5,23 @@ sidebar_label: Exponencial
---
import useBaseUrl from "@docusaurus/useBaseUrl";
-<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} /> \ No newline at end of file
+<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} />
+
+A função exponencial dos elementos de controle realiza essa operação com uma entrada real, obedecendo a expressão:
+$$
+y_n = \bold{A} e^{\bold{B} u_n}
+$$
+Em que:
+- $u_n$ e $y_n$ é a entrada e a saída do bloco exponencial, respectivamente;
+- $\bold{A}$ e $\bold{B}$ são constantes definidas pelo usuário.
+
+## Formulário de edição de dados do bloco Exponencial
+A figura abaixo apresenta o formulário de edição de dados do bloco exponencial.
+
+<div><center><img src={useBaseUrl("images/expForm.png")} alt="Formulário de edição de dados do bloco exponencial no PSP-UFU" title="Formulário de edição de dados do bloco exponencial no PSP-UFU" /></center></div>
+
+Esse bloco não linear é definido pelas constantes A e B, inseridas pelo usuário.
+
+:::info Informação
+Tais blocos são úteis na representação de não linearidades, como, por exemplo, modelagem da saturação de máquinas de corrente contínuas presentes em alguns reguladores automáticos de tensão.
+:::
diff --git a/docusaurus/docs/gain.md b/docusaurus/docs/gain.md
index 09e54f9..0e4edf1 100644
--- a/docusaurus/docs/gain.md
+++ b/docusaurus/docs/gain.md
@@ -5,4 +5,8 @@ sidebar_label: Ganho
---
import useBaseUrl from "@docusaurus/useBaseUrl";
-<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} /> \ No newline at end of file
+<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} />
+
+O bloco de ganho multiplica o valor de entrada por uma constante definida pelo usuário, possuindo comportamento idêntico à combinação de uma [constante](const) e um bloco [multiplicador](multiplier).
+
+Esse valor de ganho permanece fixo durante todo o tempo de simulação e é identificado no elemento gráfico exibido no editor de elementos de controle. \ No newline at end of file
diff --git a/docusaurus/docs/graphViewer.md b/docusaurus/docs/graphViewer.md
new file mode 100644
index 0000000..5498f9a
--- /dev/null
+++ b/docusaurus/docs/graphViewer.md
@@ -0,0 +1,8 @@
+---
+id: graphViewer
+title: Visualizador de Gráficos
+sidebar_label: Visualizador de Gráficos
+---
+import useBaseUrl from "@docusaurus/useBaseUrl";
+
+<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} /> \ No newline at end of file
diff --git a/docusaurus/docs/heatmap.md b/docusaurus/docs/heatmap.md
new file mode 100644
index 0000000..30ea55f
--- /dev/null
+++ b/docusaurus/docs/heatmap.md
@@ -0,0 +1,8 @@
+---
+id: heatmap
+title: Mapa de Tensão
+sidebar_label: Mapa de Tensão
+---
+import useBaseUrl from "@docusaurus/useBaseUrl";
+
+<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} /> \ No newline at end of file
diff --git a/docusaurus/docs/indMotor.md b/docusaurus/docs/indMotor.md
index bba7503..6f4a923 100644
--- a/docusaurus/docs/indMotor.md
+++ b/docusaurus/docs/indMotor.md
@@ -7,6 +7,9 @@ import useBaseUrl from "@docusaurus/useBaseUrl";
<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} />
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
> Uma máquina assíncrona da qual apenas um enrolamento é energizado. [*tradução livre* - IEC 60050](
http://www.electropedia.org/iev/iev.nsf/display?openform&ievref=411-31-10).
@@ -134,8 +137,16 @@ No formulário pode ser observado o botão "Chaveamento" na parte inferior esque
<div><center><img src={useBaseUrl("images/indMotorSw.png")} alt="Formulário de chaveamento do motores de indução" title="Formulário de chaveamento do motores de indução" /></center></div>
----
-### Geral
+<Tabs
+ groupId="indMotor-tabs"
+ defaultValue="general"
+ values={[
+ {label: 'Geral', value: 'general'},
+ {label: 'Estabilidade', value: 'stability'},
+ {label: 'Botão Chaveamento', value: 'switching'},
+ ]
+}>
+<TabItem value="general">
#### Nome
Identificação do elemento elétrico. Podem ser inseridos quaisquer números de caracteres no padrão [Unicode](https://pt.wikipedia.org/wiki/Unicode).
@@ -163,11 +174,11 @@ Caso essa opção não seja utilizada o motor será considerado uma [carga de po
A não utilização dessa opção poderá gerar erros de regime permamente no estudo de [estabilidade](stability).
:::
-Utilizar potência nominal como base
+#### Utilizar potência nominal como base
Caso essa opção seja marcada, o programa irá utilizar a potência nominal do gerador como base para a conversão das unidades, inclusive aqueles no formulário de estabilidade, caso contrário será usada a potência base do sistema.
----
-### Estabilidade
+</TabItem>
+<TabItem value="stability">
#### Imprimir dados da máquina de indução
Exibe os dados do gerador síncrono nos gráficos no tempo. Os seguintes dados são exibidos:
@@ -209,12 +220,16 @@ $$
A soma dos coeficientes ($a + b + c$) deve ser unitária.
:::
----
-### Botão Chaveamento
+</TabItem>
+<TabItem value="switching">
+
O botão "Chaveamento" irá abrir um formulário, comum a vários outros elementos, que permite a inserção e/ou remoção do gerador durante o estudo de [estabilidade](stability).
Nesse formulário pode ser criada uma lista genérica de inserções e remoções da linha no tempo, personalizada por um contexto de propriedades de chaveamento que são editados o tipo de chaveamento (inserção ou remoção) e o instante (em segundos) do evento. Essas propriedades são atribuídas e retiradas da lista genérica por meio dos botões "Adicionar" e "Remover", respectivamente.
+</TabItem>
+</Tabs>
+
## Referências
1. SÁNCHEZ, J. C.; OLIVARES, T. I. A.; ORTIZ, G. R.; VEGA, D. R. Induction Motor Static Models for Power Flow and Voltage Stability Studies. In: IEEE Power and Energy Society General Meeting, 2012, San Diego. doi: https://doi.org/10.1109/PESGM.2012.6345618
2. IEEE Std 399-1997. IEEE Recommended Practice for Industrial and Commercial Power Systems Analysis (Brown Book). IEEE, New York, ago. 1998. doi: https://doi.org/10.1109/IEEESTD.1998.88568
diff --git a/docusaurus/docs/inductor.md b/docusaurus/docs/inductor.md
index b126deb..e66e60b 100644
--- a/docusaurus/docs/inductor.md
+++ b/docusaurus/docs/inductor.md
@@ -7,6 +7,9 @@ import useBaseUrl from "@docusaurus/useBaseUrl";
<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} />
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
>Um reator destinado à conexão de derivação em uma rede para compensar a corrente capacitiva. [*tradução livre* - IEC 60050](
http://www.electropedia.org/iev/iev.nsf/display?openform&ievref=421-01-03).
@@ -24,8 +27,15 @@ Além do único contexto geral, pode ser observado o botão "Estabilidade" na pa
<div><center><img src={useBaseUrl("images/indSw.png")} alt="Formulário de chaveamento do indutor" title="Formulário de chaveamento do indutor" /></center></div>
----
-### Geral
+<Tabs
+ groupId="transformer-tabs"
+ defaultValue="general"
+ values={[
+ {label: 'Geral', value: 'general'},
+ {label: 'Botão Estabilidade', value: 'stability'},
+ ]
+}>
+<TabItem value="general">
#### Nome
Identificação do elemento elétrico. Podem ser inseridos quaisquer números de caracteres no padrão [Unicode](https://pt.wikipedia.org/wiki/Unicode).
@@ -35,8 +45,12 @@ Todos os componentes de potência do PSP-UFU possuem esse campo.
#### Potência reativa
Os capacitores e reatores exigem somente sua potência reativa como parâmetro, inserida em Mvar, kvar, var ou $p.u.$ (na base de potência do sistema).
----
-### Botão Estabilidade
-O botão "Estabilidade" irá abrir um formulário, comum a vários outros elementos, que permite a inserção e/ou remoção do indutor durante o estudo de [estabilidade](stability).
+</TabItem>
+<TabItem value="stability">
+
+O botão "Estabilidade" irá abrir um formulário, comum a vários outros elementos, que permite a inserção e/ou remoção do transformador durante o estudo de [estabilidade](stability).
+
+Nesse formulário pode ser criada uma lista genérica de inserções e remoções da linha no tempo, personalizada por um contexto de propriedades de chaveamento que são editados o tipo de chaveamento (inserção ou remoção) e o instante (em segundos) do evento. Essas propriedades são atribuídas e retiradas da lista genérica por meio dos botões "Adicionar" e "Remover", respectivamente.
-Nesse formulário pode ser criada uma lista genérica de inserções e remoções da linha no tempo, personalizada por um contexto de propriedades de chaveamento que são editados o tipo de chaveamento (inserção ou remoção) e o instante (em segundos) do evento. Essas propriedades são atribuídas e retiradas da lista genérica por meio dos botões "Adicionar" e "Remover", respectivamente. \ No newline at end of file
+</TabItem>
+</Tabs> \ No newline at end of file
diff --git a/docusaurus/docs/io.md b/docusaurus/docs/io.md
index 561ab10..2879f6b 100644
--- a/docusaurus/docs/io.md
+++ b/docusaurus/docs/io.md
@@ -25,7 +25,7 @@ O usuário deve sinalizar o tipo de bloco entre entrada e saída e, então, sele
- **Velocidade** (*entrada: AVR e RV*): Velocidade da máquina síncrona, em rad/s, variável no tempo. Normalmente utilizada no cálculo do erro de velocidade nos reguladores de velocidade, além de entrada do PSS em AVRs;
- **Potência ativa e reativa** (*entrada: AVR*): Potência ativa fornecida pela máquina síncrona, em $p.u.$, variável no tempo. Normalmente utilizada como entrada do PSS (potência ativa) e controle de sub e sobrecorrente de excitação nos AVRs;
- **Tensão terminal inicial** (*entrada: AVR*): Módulo da tensão no barramento da máquina síncrona prévia ao estudo dinâmico originado do fluxo de carga, em $p.u.$, fixo no tempo. Essa variável está normalmente associada à referência de tensão do AVR;
-- **Velocidade inicial** (*entrada: AVR e RV*): Velocidade do sistema (2πf_ref), definida nas opções de simulação, em rad/s, fixa no tempo. Normalmente utiliza-se essa variável como referência de velocidade em RVs e normalização da velocidade;
+- **Velocidade inicial** (*entrada: AVR e RV*): Velocidade do sistema ($2 \pi f_{ref}$), definida nas [opções de simulação](simulationConfig), em rad/s, fixa no tempo. Normalmente utiliza-se essa variável como referência de velocidade em RVs e normalização da velocidade;
- **Potência mecânica inicial** (*entrada: RV*): Potência mecânica inicial, calculada após a inicialização das máquinas síncronas com os dados originados do fluxo de carga, em $p.u.$, fixa no tempo. Normalmente é utilizada como referência de potência mecânica nos reguladores de velocidade;
- **Variação de velocidade e potência ativa** (*entrada: AVR*): Cálculo da variação dessas entradas entre os passos de integração normalizada pelo passo de integração, conforme a equação:
$$
diff --git a/docusaurus/docs/limiter.md b/docusaurus/docs/limiter.md
index 3e829f0..adb4e04 100644
--- a/docusaurus/docs/limiter.md
+++ b/docusaurus/docs/limiter.md
@@ -5,4 +5,31 @@ sidebar_label: Limitador absoluto
---
import useBaseUrl from "@docusaurus/useBaseUrl";
-<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} /> \ No newline at end of file
+<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} />
+
+Os blocos de limite absoluto cumprem a função de restringir os valores de entrada de acordo com os limites máximos e mínimos inseridos pelo usuário. Caso a entrada ultrapasse algum dos limites impostos, a saída será igual a esse valor limite até que a entrada retorne para a faixa permitida.
+
+As restrições máximas e mínimas de valores dos sistemas de controle são modeladas utilizando um Limitador, cuja implementação é bastante simples e segue a seguinte expressão:
+$$
+y_n =
+\begin{cases}
+L_{sup}{,} & \text{se } u_n > L_{sup} \\
+u_n{,} & \text{se } L_{inf} \le u_n \le L_{sup}\\
+L_{inf}{,} & \text{se } u_n < L_{inf}
+\end{cases}
+$$
+Em que:
+- $y_n$ Éé o valor de saída atual do bloco
+- $L_{sup}$ e $L_{inf}$ são os limites superior e inferior, respectivamente
+- $u_n$ é o valor de entrada atual do bloco
+
+## Formulário de edição do bloco Limitador
+A figura abaixo apresenta o formulário de edição de dados do bloco limitador.
+
+<div><center><img src={useBaseUrl("images/limiterForm.png")} alt="Formulário de edição de dados do bloco limitador no PSP-UFU" title="Formulário de edição de dados do bloco limitador no PSP-UFU" /></center></div>
+
+Esse bloco não linear é definido pelo **limite superior e inferior**, inseridos pelo usuário.
+
+:::info Informação
+Tais blocos são bastante encontrados nos sistemas de controle para limitar a atuação do controlador, além de representar limites físicos de modelos implementados, como, por exemplo, valores máximos de corrente de excitação ou potência mecânica fornecida pelas turbinas.
+::: \ No newline at end of file
diff --git a/docusaurus/docs/line.md b/docusaurus/docs/line.md
index f7062fa..67e04e7 100644
--- a/docusaurus/docs/line.md
+++ b/docusaurus/docs/line.md
@@ -7,6 +7,9 @@ import useBaseUrl from "@docusaurus/useBaseUrl";
<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} />
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
>Um meio de transmissão fabricado usado para transmitir energia eletromagnética entre dois pontos com um mínimo de radiação. [*tradução livre* - IEC 60050](
http://www.electropedia.org/iev/iev.nsf/display?openform&ievref=704-02-02).
@@ -56,8 +59,16 @@ Além desses dois contextos, pode ser observado o botão "Estabilidade" na parte
<div><center><img src={useBaseUrl("images/lineSw.png")} alt="Formulário de chaveamento da linha" title="Formulário de chaveamento da linha" /></center></div>
----
-### Geral
+<Tabs
+ groupId="line-tabs"
+ defaultValue="general"
+ values={[
+ {label: 'Geral', value: 'general'},
+ {label: 'Falta', value: 'fault'},
+ {label: 'Botão Estabilidade', value: 'stability'},
+ ]
+}>
+<TabItem value="general">
#### Nome
Identificação do elemento elétrico. Podem ser inseridos quaisquer números de caracteres no padrão [Unicode](https://pt.wikipedia.org/wiki/Unicode).
@@ -88,8 +99,8 @@ O comprimento da linha é ignorado caso não sejam utilizadas as unidades por qu
#### Utilizar potência nominal como base
Caso essa opção seja marcada, o programa irá utilizar a potência nominal da linha como base para a conversão das unidades, caso contrário será usada a [potência base do sistema](simulationConfig).
----
-### Falta
+</TabItem>
+<TabItem value="fault">
#### Parâmetros do modelo $\pi$ de sequência zero
Esses parâmetros são necessários para o correto cálculo das correntes de [falta desbalanceadas](fault) (fase-fase, fase-fase-terra e fase-terra) e devem ser inseridos em $p.u.$
@@ -98,8 +109,12 @@ Esses parâmetros são necessários para o correto cálculo das correntes de [fa
A não inserção desses dados acarretarão em resultados incorretos para [faltas desbalanceadas](fault).
:::
----
-### Botão Estabilidade
+</TabItem>
+<TabItem value="stability">
+
O botão "Estabilidade" irá abrir um formulário, comum a vários outros elementos, que permite a inserção e/ou remoção da linha durante o estudo de [estabilidade](stability).
-Nesse formulário pode ser criada uma lista genérica de inserções e remoções da linha no tempo, personalizada por um contexto de propriedades de chaveamento que são editados o tipo de chaveamento (inserção ou remoção) e o instante (em segundos) do evento. Essas propriedades são atribuídas e retiradas da lista genérica por meio dos botões "Adicionar" e "Remover", respectivamente. \ No newline at end of file
+Nesse formulário pode ser criada uma lista genérica de inserções e remoções da linha no tempo, personalizada por um contexto de propriedades de chaveamento que são editados o tipo de chaveamento (inserção ou remoção) e o instante (em segundos) do evento. Essas propriedades são atribuídas e retiradas da lista genérica por meio dos botões "Adicionar" e "Remover", respectivamente.
+
+</TabItem>
+</Tabs>
diff --git a/docusaurus/docs/load.md b/docusaurus/docs/load.md
index 6db0aac..0f2b6f3 100644
--- a/docusaurus/docs/load.md
+++ b/docusaurus/docs/load.md
@@ -7,6 +7,9 @@ import useBaseUrl from "@docusaurus/useBaseUrl";
<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} />
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
>1. a potência ativa, reativa ou aparente gerada, transmitida ou distribuída dentro de um sistema;
1. a potência demandada por um grupo de consumidores classificados de acordo com suas particularidades e características, por exemplo, carga de aquecimento, carga reativa diurna, etc. [*tradução livre* - IEC 60050](
http://www.electropedia.org/iev/iev.nsf/display?openform&ievref=601-01-15).
@@ -83,8 +86,16 @@ Além desses dois contextos, pode ser observado o botão "Chaveamento" na parte
<div><center><img src={useBaseUrl("images/loadSw.png")} alt="Formulário de chaveamento da carga" title="Formulário de chaveamento da carga" /></center></div>
----
-### Geral
+<Tabs
+ groupId="load-tabs"
+ defaultValue="general"
+ values={[
+ {label: 'Geral', value: 'general'},
+ {label: 'Estabilidade', value: 'stability'},
+ {label: 'Botão Chaveamento', value: 'switching'},
+ ]
+}>
+<TabItem value="general">
#### Nome
Identificação do elemento elétrico. Podem ser inseridos quaisquer números de caracteres no padrão [Unicode](https://pt.wikipedia.org/wiki/Unicode).
@@ -100,8 +111,8 @@ Parcela de potência reativa da carga. Pode ser inserido em Mvar, kvar var ou $p
#### Tipo de carga (fluxo de carga)
Tipo da carga para o estudo de fluxo de carga, podendo ser selecionado dois tipos: Potência constante e Impedância constante. As cargas de potência constantes são inseridas nos vetores de potência e permanecem invariantes no cálculo, enquanto que para as cargas de impedância constante determina-se o valor da impedância utilizando a potência e tensão nominal, a qual é inserida na matriz admitância.
----
-### Estabilidade
+</TabItem>
+<TabItem value="stability">
#### Imprimir dados
Exibe os dados da carga nos gráficos no tempo.
@@ -124,8 +135,12 @@ Caso todas as barras possuírem o mesmo comportamento de carga ZIP, a parametriz
#### Composição de potência ativa e reativa
Valores da composição da carga ZIP, inseridas para potência ativa e reativa separadamente, em porcentagem. A soma da composição deve ser igual a 100%, caso contrário será exibida uma mensagem de erro ao usuário.
----
-### Botão Chaveamento
+</TabItem>
+<TabItem value="switching">
+
O botão "Chaveamento" irá abrir um formulário, comum a vários outros elementos, que permite a inserção e/ou remoção do transformador durante o estudo de [estabilidade](stability).
Nesse formulário pode ser criada uma lista genérica de inserções e remoções da linha no tempo, personalizada por um contexto de propriedades de chaveamento que são editados o tipo de chaveamento (inserção ou remoção) e o instante (em segundos) do evento. Essas propriedades são atribuídas e retiradas da lista genérica por meio dos botões "Adicionar" e "Remover", respectivamente.
+
+</TabItem>
+</Tabs> \ No newline at end of file
diff --git a/docusaurus/docs/mathExpression.md b/docusaurus/docs/mathExpression.md
index be330f9..a9f62f4 100644
--- a/docusaurus/docs/mathExpression.md
+++ b/docusaurus/docs/mathExpression.md
@@ -5,4 +5,153 @@ sidebar_label: Expressão Matemática
---
import useBaseUrl from "@docusaurus/useBaseUrl";
-<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} /> \ No newline at end of file
+<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} />
+
+O bloco de expressão matemática utiliza a biblioteca externa [fparser](http://warp.povusers.org/FunctionParser/) e permite ao usuário inserir expressões matemáticas genéricas de qualquer complexidade combinadas a estruturas condicionais em um diagrama de controle, aumentando significativamente a capacidade de generalização do programa.
+
+## Sintaxe das expressões matemáticas
+As sintaxes das operações (para expressões `A` e `B`) são apresentadas na tabela abaixo:
+
+|Operador|Expressão|
+|--------|---------|
+|`( )` |Expressão em parênteses primeiro
+|`A unit` |Um multiplicador de unidade (se um estiver sido adicionado)
+|`A^B` |Exponenciação (`A` elevado à potência `B`)
+|`-A` |Operação unária de oposto
+|`!A` |Operação lógica unária de negação (resulta em $1$ se `int(A)` é $0$, senão $0$)
+|`A*B` `A/B` `A%B` |Multiplicação, divisão e módulo
+|`A+B` `A-B` |Adição e subtração
+|`A=B` `A<B` `A<=B` `A!=B` `A>B` `A>=B` |Comparação entre `A` e `B` (resulta em $1$ ou $0$)
+|`A&B` |Resulta em $1$ se `int(A)` e `int(B)` forem diferentes de $0$, senão $0$
+|`A`\|`B` |Resulta em $1$ se `int(A)` ou `int(B)` forem diferentes de $0$, senão $0$
+
+As **funções matemáticas** suportadas pela biblioteca, as quais podem ser utilizadas na construção de diagrama de blocos, são descritas na tabela abaixo:
+
+|Expressão|Descrição
+|---------|---------|
+|`abs(A)`|Valor absoluto de `A`. Para números reais, se `A` é negativo, retorna `–A`, senão retorna `A`. Para números complexos a expressão é equivalente a `hypot(real(x),imag(x))`.
+|`acos(A)`|Arco cosseno de `A`. Retorna o ângulo em radianos.
+|`acosh(A)`|O mesmo que `acos()` mas para cosseno hiperbólico
+|`arg(A)`|Ângulo de fase de um número complexo `A`.
+|`asin(A)`|Arco seno de `A`. Retorna o ângulo em radianos.
+|`asinh(A)`|Mesmo que `asin()`, mas para seno hiperbólico
+|`atan(A)`|Arco tangente de `A`. Retorna o ângulo em radianos.
+|`atan2(A,B)`|Arco tangente de `A/B`, a qual os sinais dos dois argumentos para determinar o quadrante do resultado. Retorna a solução de do seguinte sistema: `hypot(A,B)*sin(x)=A, hypot(A,B)*cos(x)=B`. O valor retornado varia de $-\pi$ a $\pi$.
+|`atanh(A)`|Mesmo que `atan()`, mas para tangente hiperbólica.
+|`cbrt(A)`|Raiz cúbica de `A`.
+|`conj(A)`|Conjugado complexo de `A`.
+|`ceil(A)`|Teto de `A`. Arredonda para o próximo maior inteiro.
+|`cos(A)`|Cosseno de `A`. Retorna o ângulo em radianos.
+|`cosh(A)`|Mesmo que `cos()`, mas para cosseno hiperbólico
+|`cot(A)`|Cotangente de `A`. Retorna o ângulo em radianos.
+|`csc(A)`|Cossecante de `A`. Retorna o ângulo em radianos.
+|`exp(A)`|Exponencial de `A`. Retorna o valor de e elevado a potência A.
+|`exp2(A)`|Exponencial de `A` na base $2$.
+|`floor(A)`|Piso de `A`. Arredonda para o próximo menor inteiro.
+|`hypot(A,B)`|Função de distância Euclidiana.
+|`if(A,B,C)`|Se `int(A)` é diferente de $0$, retorna o valor de `B`, senão retorna `C`.
+|`imag(A)`|Retorna a parte imaginária do número complexo `A`.
+|`int(A)`|Arredonda `A` para o inteiro mais próximo.
+|`log(A)`|Logaritmo natural (base $e$) de `A`.
+|`log2(A)`|Logaritmo na base $2$ de `A`.
+|`log10(A)`|Logaritmo na base $10$ de A.
+|`max(A,B)`|Se `A>B`, o resultado é `A`, senão é `B`.
+|`min(A,B)`|Se `A<B`, o resultado é `A`, senão é `B`.
+|`polar(A,B)`|Retorna o número complexo de magnitude `A` e ângulo de fase `B` (em radianos).
+|`pow(A,B)`|Exponenciação (`A` elevado à potência `B`)
+|`real(A,B)`|Retorna a parte real do número complexo `A`.
+|`sec(A)`|Secante de `A`.
+|`sin(A)`|Seno de `A`. Retorna o ângulo em radianos.
+|`sinh(A)`|Mesmo que `sin()`, mas para seno hiperbólico.
+|`sqrt(A)`|Raiz quadrada de `A`.
+|`tan(A)`|Tangente de `A`. Retorna o ângulo em radianos.
+|`tanh(A)`|Mesmo que `tan()`, mas para tangente hiperbólica.
+|`trunc(A)`|Valor truncado de `A`. Retorna o número inteiro de `A` sem a parcela fracionada.
+
+É possível atribuir novas variáveis utilizando a seguinte sintaxe:
+
+``` cpp
+<nome da variável> := <expressão>; <função>
+```
+
+Por exemplo:
+``` cpp
+comprimento := sqrt(x*x+y*y); 2*comprimento*sin(comprimento)
+```
+
+:::tip Dica
+O caractere de espaço e de nova linha são ignorados na interpretação da expressão, portanto para maior organização, o código anterior pode ser escrito da seguinte forma:
+``` cpp
+comprimento := sqrt(x*x+y*y);
+2*comprimento*sin(comprimento)
+```
+:::
+
+:::warning Cuidado!
+Note que a expressão que determina o valor de saída do bloco **não possui** o caractere `;` em seu final.
+:::
+
+## Formulário de edição de dados do bloco de Expressão Matemática
+O formulário de inserção e edição das entradas do bloco e da expressão matemática genérica, assim como ferramentas de auxílio de sua construção é apresentado na figura abaixo.
+
+<div><center><img src={useBaseUrl("images/mathExpressionForm.png")} alt="Formulário de edição de dados do bloco de expressão matemática no PSP-UFU" title="Formulário de edição de dados do bloco de expressão matemática no PSP-UFU" /></center></div>
+
+No campo de “Variáveis de entrada” é inserida uma lista com os nomes das entradas separados por espaços. Um número qualquer de entrada pode ser definido nessa lista esses nomes são apresentados no ícone gráfico presente no editor de controle, além de serem destacados na expressão inserida pelo usuário. O número de entradas e saídas se comporta de forma semelhante aos [blocos somadores](sum).
+
+Abaixo do campo das variáveis de entrada está presente o local para inserção da expressão matemática. A sintaxe da expressão inserida pelo usuário possui realce (por meio de diferentes formas e cores da fonte) para números, operadores, variáveis de entrada, funções e constantes, facilitando a criação, manipulação e identificação de erros de digitação e lógica.
+
+:::info Informação
+Como ferramenta de auxílio ao usuário foi desenvolvida uma verificação da expressão inserida.
+:::
+
+Tal ferramenta irá encontrar erros e indicará ao usuário qual o tipo do erro, além da sua localização, destacando-o. A figura anterior exemplifica a identificação automática do erro pelo PSP-UFU, assim como sua posição na expressão inserida.
+
+## Exemplo de Expressão Matemática
+A corrente de campo em $p.u.$ pode ser estimada de forma aproximada utilizando as potências ativa ($P$) e reativa ($Q$), assim como as reatâncias transitórias de eixo direto ($x_d$) e em quadratura ($x_q$) e o módulo da tensão terminal ($V$) da máquina:
+$$
+i_f \approx \sqrt{ \left( V + Q' \right)^2 + P^2} + \left(\frac{x_d}{x_q} +1{,}0 \right) \times \frac{Q' \left( V + Q' \right) + {P'}^2}{\sqrt{\left( V + Q'\right)^2 + P^2}}
+$$
+Em que:
+- $P' = x_q \times \frac{P}{V}$
+- $Q' = x_q \times \frac{Q}{V}$
+
+Primeiramente, deve-se inserir no campo "variáveis de entrada" as grandezas fornecidas pelo PSP-UFU. Nesse caso, como pode ser observado no bloco de [entrada / saída](io), todas as variáveis necessárias são fornecidas: $P$, $Q$ e $V$. Essas variáveis devem ser inseridas separadas por espaço: `p q v`.
+
+Utilizando três blocos de [entrada / saída](io) pode-se fornecer tais dados ao conectá-los ao bloco de expressão matemática.
+
+As reatâncias transitórias de eixo direto ($x_d$) e em quadratura ($x_q$) podem ser definidas diretamente na expressão matemática:
+``` cpp
+xd := 0.146;
+xq := 0.0969;
+```
+
+Os valores de $P'$ e $Q'$ podem ser também calculados:
+``` cpp
+yp := xq * p / v;
+yq := xq * q / v;
+```
+
+Com todos os dados necessários pode-se calcular a corrente de campo:
+``` cpp
+i_f := sqrt((v + yq)^2 + p^2) + (xd / xq + 1.0) *
+ ((yq * (v + yq) + yp^2) / sqrt((v + yq)^2 + p^2));
+```
+
+Finalmente, pode-se definir a saída do bloco (não inserindo `;`):
+``` cpp
+i_f
+```
+
+Portanto, para as entradas definidas como `p q v`, a expressão matemática total para cálculo da corrente de campo será:
+``` cpp
+xd := 0.146;
+xq := 0.0969;
+yp := xq * p / v;
+yq := xq * q / v;
+i_f := sqrt((v + yq)^2 + p^2) + (xd / xq + 1.0) *
+ ((yq * (v + yq) + yp^2) / sqrt((v + yq)^2 + p^2));
+i_f
+```
+
+## Referências
+- NIEMINEN, J.; YLILUOMA, J. Function Parser for C++ v4.5.2. Disponível em: <http://warp.povusers.org/FunctionParser/>. \ No newline at end of file
diff --git a/docusaurus/docs/multiplier.md b/docusaurus/docs/multiplier.md
index 365f1aa..f21610b 100644
--- a/docusaurus/docs/multiplier.md
+++ b/docusaurus/docs/multiplier.md
@@ -5,4 +5,12 @@ sidebar_label: Multiplicador
---
import useBaseUrl from "@docusaurus/useBaseUrl";
-<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} /> \ No newline at end of file
+<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} />
+
+Esse elemento é bastante simples e cumpre com a função matemáticas de seu nome.
+
+Possui duas entradas de valores reais e sua saída é computada na sequência do nó superior pelo inferior, ou seja, a saída será o valor presente no nó 1 multiplicado pelo nó 2.
+
+:::caution Atenção!
+Nós não conectados no multiplicador são assumidos com o valor unitário e para o divisor é considerado valor nulo.
+::: \ No newline at end of file
diff --git a/docusaurus/docs/rateLimiter.md b/docusaurus/docs/rateLimiter.md
index 16abcb9..39419ea 100644
--- a/docusaurus/docs/rateLimiter.md
+++ b/docusaurus/docs/rateLimiter.md
@@ -5,4 +5,37 @@ sidebar_label: Limitador de taxa
---
import useBaseUrl from "@docusaurus/useBaseUrl";
-<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} /> \ No newline at end of file
+<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} />
+
+Os blocos de limite de taxa têm como objetivo conter a taxa de crescimento ou decrescimento da sua entrada a valores inseridos pelo usuário. A taxa de variação é calculada a partir dos valores de entrada atual e passado e, caso seja violada, será definida uma saída que respeite essas taxas (de crescimento ou decrescimento).
+
+A taxa ($r$) é calculada de acordo com a equação:
+$$
+r = \frac{u_n - y_{n-1}}{h}
+$$
+Em que:
+- $u_n$ é a entrada atual do bloco
+- $y_{n-1}$ é o valor de saída anterior do bloco
+- $h$ é o passo de integração
+
+Obtida a taxa, o bloco irá resultar em um valor calculado pelas seguintes condições:
+$$
+\begin{cases}
+h \times R_{cre}{,} & \text{se } r > R_{cre} \\
+u_n{,} & \text{se } R_{dec} \le r \le R_{cre}\\
+h \times R_{dec}{,} & \text{se } r < R_{dec}
+\end{cases}
+$$
+Em que:
+- $R_{cre}$ e $R_{dec}$ são as taxas de crescimento e decaimento, respectivamente
+
+## Formulário de edição de dados do Limitador de taxa
+A figura abaixo apresenta o formulário de edição de dados do bloco limitador de taxa.
+
+<div><center><img src={useBaseUrl("images/rateLimitForm.png")} alt="Formulário de edição de dados do bloco limitador de taxa no PSP-UFU" title="Formulário de edição de dados do bloco limitador de taxa no PSP-UFU" /></center></div>
+
+Esse bloco é definido pelo **limite superior (taxa de crescimento máxima) e inferior (taxa de decrescimento máxima)**, inseridos pelo usuário.
+
+:::info Informação
+Esses blocos são úteis para limitar variações bruscas na entrada que possam comprometer o controle ou limites físicos de modelos de turbina, por exemplo.
+::: \ No newline at end of file
diff --git a/docusaurus/docs/sum.md b/docusaurus/docs/sum.md
index 35afdbc..270b66c 100644
--- a/docusaurus/docs/sum.md
+++ b/docusaurus/docs/sum.md
@@ -5,4 +5,22 @@ sidebar_label: Somador
---
import useBaseUrl from "@docusaurus/useBaseUrl";
-<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} /> \ No newline at end of file
+<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} />
+
+Como o próprio nome sugere, os somadores são elementos de controle capazes de somar qualquer quantidade de valores reais.
+
+## Formulário de edição de dados do somador
+
+A quantidade de entradas, assim como seus sinais são definidas pelo usuário, como mostra a figura abaixo.
+
+<div><center><img src={useBaseUrl("images/sumForm.png")} alt="Formulário de edição de dados do somador no PSP-UFU" title="Formulário de edição de dados do somador no PSP-UFU" /></center></div>
+
+No seu único campo “**Sinais**” é inserida uma lista de sinais **separados por espaços** contendo os símbolos “+” para uma entrada positiva e “-” para negativa.
+
+:::info Informação
+O usuário pode inserir duas ou mais entradas de sinais no bloco.
+:::
+
+Uma vez inseridas novas entradas, nós correspondentes serão incluídos no elemento gráfico do somador, o qual poderá ser conectado por meio das linhas de conexão.
+
+De forma semelhante, o usuário poderá excluir entradas de sinais pré-existentes, as quais serão removidas no ícone gráfico pela remoção do nó e da linha (caso exista alguma conectada).
diff --git a/docusaurus/docs/syncGenerator.md b/docusaurus/docs/syncGenerator.md
index e43a51a..253d8a4 100644
--- a/docusaurus/docs/syncGenerator.md
+++ b/docusaurus/docs/syncGenerator.md
@@ -7,6 +7,9 @@ import useBaseUrl from "@docusaurus/useBaseUrl";
<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} />
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
> Uma máquina de corrente alternada na qual a frequência das tensões geradas e a velocidade da máquina estão em uma proporção constante. [*tradução livre* - IEC 60050](
http://www.electropedia.org/iev/iev.nsf/display?openform&ievref=411-31-08).
@@ -118,6 +121,23 @@ Na sequência são apresentados tais modelos, incluídos os efeitos da saturaç
Em todos os modelos as equações diferenciais mecânicas são solucionadas.
:::
+#### Saturação
+Para representar matematicamente o efeito da saturação nas equações das máquinas síncronas são introduzidos “fatores de saturação” que modificam as impedâncias do circuito equivalente, os quais dependem de uma reatância de dispersão efetiva, chamada de reatância de Potier ($x_p$).
+
+Tal reatância pode ser obtida por meio de ensaios (utilizando curvas de saturação de circuito aberto e carga de fator de potência zero) ou estimadas de forma aproximada por outros parâmetros da máquina. A reatância de dispersão ($x_l$), aqui substituída de forma aproximada por $x_p$, representa a parcela da reatância da máquina originados do fluxo magnético que percorrem o ar na maioria de seu caminho e, portanto, é independente da saturação.
+
+O método implementado no programa permite reproduzir a saturação em ambos os eixos (direto e em quadratura), diferindo entre si devido à divergência no tamanho do entreferro. É assumido que a soma vetorial das duas componentes do fluxo magnético saturado está em fase com a f.m.m. e proporcional à Tensão de Potier ($E_p$, a qual é a tensão atrás da reatância de Potier).
+
+Para isso, são utilizados internamente dois fatores de saturação, sendo um no eixo direto ($s_d$) e outro no eixo em quadratura ($s_q$). Esses fatores de saturação são **automaticamente calculados** a cada passo de integração e dependem da curva de saturação da máquina definida pelo [fator de saturação inserido no formulário de edição de dados](syncGenerator#fator-de-saturação).
+
+Portanto as reatâncias saturadas, que devem ser inseridas nas equações algébricas da máquina, são definidas pelas seguintes equações:
+$$
+x_{ds}=\frac{x_d-x_p}{s_d +x_p}\\
+x_{qs}=\frac{x_q-x_p}{s_q +x_p}
+$$
+
+Essas equações também são utilizadas para as reatâncias transitórias e subtransitórias, visto que o valor da reatância de Potier (ou de dispersão) não é alterada.
+
#### Barramento infinito
Algumas referências incluem um modelo sem equações diferenciais, em que a máquina é somente representada por uma tensão constante atrás de uma reatância transitória de eixo direto. Tal é utilizado na representação de um **barramento infinito**, o qual é normalmente constituído de um subsistema muito maior àquele simulado.
@@ -147,8 +167,17 @@ No formulário de estabilidade pode ser observado o botão "Chaveamento" na part
<div><center><img src={useBaseUrl("images/syncGeneratorSw.png")} alt="Formulário de chaveamento do gerador síncrono" title="Formulário de chaveamento do gerador síncrono" /></center></div>
----
-### Geral
+<Tabs
+ groupId="syncGenerator-tabs"
+ defaultValue="general"
+ values={[
+ {label: 'Geral', value: 'general'},
+ {label: 'Falta', value: 'fault'},
+ {label: 'Botão Estabilidade', value: 'stability'},
+ {label: 'Botão Chaveamento', value: 'switching'},
+ ]
+}>
+<TabItem value="general">
#### Nome
Identificação do elemento elétrico. Podem ser inseridos quaisquer números de caracteres no padrão [Unicode](https://pt.wikipedia.org/wiki/Unicode).
@@ -175,8 +204,8 @@ Limites de potência reativa máxima e mínima do gerador para controle de tens
#### Utilizar potência nominal como base
Caso essa opção seja marcada, o programa irá utilizar a potência nominal do gerador como base para a conversão das unidades, inclusive aqueles no formulário de estabilidade, caso contrário será usada a [potência base do sistema](simulationConfig).
----
-### Falta
+</TabItem>
+<TabItem value="fault">
#### Impedâncias de sequência
Valores de resistência e reatância para cálculo das correntes de falta. São inseridos dados de sequência positiva, negativa e zero.
@@ -187,8 +216,8 @@ Valores utilizados para o cálculo das correntes de falta do tipo fase-terra e f
#### Neutro aterrado
Indica se o neutro do gerador é aterrado.
----
-### Botão Estabilidade
+</TabItem>
+<TabItem value="stability">
#### Imprimir dados da máquina síncrona
Exibe os dados do gerador síncrono nos gráficos no tempo. Os seguintes dados são exibidos:
@@ -219,6 +248,13 @@ Representa o valor (em $p.u.$) de corrente de campo necessária para atingir 1,2
Esse valor deve ser **maior que 1,2**, ou irá gerar erros na simulação. Caso não seja informado, a saturação da máquina não é considerada nos cálculos.
:::
+#### Frequência de circuito aberto
+Indica a velocidade da máquina no caso de início da simulação desconectada da rede.
+
+:::info Informação
+Essa informação é particularmente útil na análise de conexão de geradores dessincronizados na rede.
+:::
+
#### Reatâncias síncronas
Valores de reatância síncrona (regime permanente) da máquina. Os valores de eixo direto e em quadratura devem ser iguais ou muito próximos para representação de uma máquina de polos lisos, enquanto para polos salientes esses valores são distintos.
@@ -234,12 +270,29 @@ De acordo com a quantidade de parâmetros inseridos é definido internamente pel
#### Reatâncias e constantes de tempo subtransitórias
Parâmetros subtransitórios da máquina síncrona em $p.u.$ ou segundos, representando em detalhes a presença de enrolamentos amortecedores. Assim como os dados transitórios, esses parâmetros definem o modelo da máquina.
----
-### Botão Chaveamento
+</TabItem>
+<TabItem value="switching">
+
O botão "Chaveamento" irá abrir um formulário, comum a vários outros elementos, que permite a inserção e/ou remoção do gerador durante o estudo de [estabilidade](stability).
Nesse formulário pode ser criada uma lista genérica de inserções e remoções da linha no tempo, personalizada por um contexto de propriedades de chaveamento que são editados o tipo de chaveamento (inserção ou remoção) e o instante (em segundos) do evento. Essas propriedades são atribuídas e retiradas da lista genérica por meio dos botões "Adicionar" e "Remover", respectivamente.
+</TabItem>
+</Tabs>
+
+## Acesso aos controles da máquina síncrona
+Como já [mencionado anteriormente](syncGenerator#utilizar-avr-e-regulador-de-velocidade), os reguladores de velocidade e tensão da máquina síncrona podem ser acionados ou inibidos por meio das caixas de seleção "[Utilizar AVR e regulador de velocidade](syncGenerator#utilizar-avr-e-regulador-de-velocidade)". Ambas as opções irão acessar o [editor de controles](controlEditor).
+
+O acesso aos controles do **AVR** poderão então ser criados e manipulados ao clicar no botão "Editar AVR", assim como o **Regulador de Velocidade** é acessado no botão "Editar regulador de velocidade".
+
+:::caution Atenção!
+No PSP-UFU a opção de editar o **AVR** engloba mais que somente o controle de tensão da máquina. Nele **deve** ser inserida a malha de controle da máquina assim como a **excitatriz da máquina síncrona**. Outras estratégias de controle (opcionais), como PSS (*Power System Stabilizer*) e/ou controles de sobre e sub excitação, são também implementadas em conjunto.
+:::
+
+:::caution Atenção!
+Assim como no AVR, o **Regulador de Velocidade** engloba mais que a regulação primária da máquina. Nessa opção **deve** ser inserida ao menos a malha de controle da regulação primária de velocidade, assim como o **modelo da turbina**. Estratégias opcionais de controle da velocidade também são inseridas nessa opção.
+:::
+
## Referências
1. MILANO, F. Power System Modelling and Scripting. London: Springer, 2010. doi: https://doi.org/10.1007/978-3-642-13669-6
2. ARRILLAGA, J.; WATSON, N. R. Computer Modelling of Electrical Power Systems. Wiley & Sons, New York, 2001. doi: https://doi.org/10.1002/9781118878286
diff --git a/docusaurus/docs/syncMotor.md b/docusaurus/docs/syncMotor.md
index b1b116c..fb5d005 100644
--- a/docusaurus/docs/syncMotor.md
+++ b/docusaurus/docs/syncMotor.md
@@ -7,6 +7,9 @@ import useBaseUrl from "@docusaurus/useBaseUrl";
<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} />
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
> Uma máquina síncrona operando sem carga mecânica e fornecendo ou absorvendo energia reativa. [*tradução livre* - IEC 60050](
http://www.electropedia.org/iev/iev.nsf/display?openform&ievref=411-34-03).
@@ -30,8 +33,16 @@ A imagem abaixo apresenta o formulário de inserção/alteração de dados dos c
<div><center><img src={useBaseUrl("images/syncMotorForm.png")} alt="Formulário dos compensadores síncronos no PSP-UFU" title="Formulário dos compensadores síncronos no PSP-UFU" /></center></div>
----
-### Geral
+
+<Tabs
+ groupId="syncMotor-tabs"
+ defaultValue="general"
+ values={[
+ {label: 'Geral', value: 'general'},
+ {label: 'Falta', value: 'fault'},
+ ]
+}>
+<TabItem value="general">
#### Nome
Identificação do elemento elétrico. Podem ser inseridos quaisquer números de caracteres no padrão [Unicode](https://pt.wikipedia.org/wiki/Unicode).
@@ -58,8 +69,8 @@ Limites de potência reativa máxima e mínima do compensador para controle de t
#### Utilizar potência nominal como base
Caso essa opção seja marcada, o programa irá utilizar a potência nominal do compensador como base para a conversão das unidades, inclusive aqueles no formulário de estabilidade, caso contrário será usada a [potência base do sistema](simulationConfig).
----
-### Falta
+</TabItem>
+<TabItem value="fault">
#### Impedâncias de sequência
Valores de resistência e reatância para cálculo das correntes de falta. São inseridos dados de sequência positiva, negativa e zero.
@@ -68,4 +79,7 @@ Valores de resistência e reatância para cálculo das correntes de falta. São
Valores utilizados para o cálculo das correntes de falta do tipo fase-terra e fase-fase-terra. Caso o neutro do gerador não seja aterrado, o valor inserido nesse campo é ignorado.
#### Neutro aterrado
-Indica se o neutro do gerador é aterrado. \ No newline at end of file
+Indica se o neutro do gerador é aterrado.
+
+</TabItem>
+</Tabs> \ No newline at end of file
diff --git a/docusaurus/docs/tabularReport.md b/docusaurus/docs/tabularReport.md
new file mode 100644
index 0000000..b59ad78
--- /dev/null
+++ b/docusaurus/docs/tabularReport.md
@@ -0,0 +1,8 @@
+---
+id: tabularReport
+title: Relatórios Tabulares
+sidebar_label: Relatórios Tabulares
+---
+import useBaseUrl from "@docusaurus/useBaseUrl";
+
+<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} /> \ No newline at end of file
diff --git a/docusaurus/docs/text.md b/docusaurus/docs/text.md
new file mode 100644
index 0000000..3242c56
--- /dev/null
+++ b/docusaurus/docs/text.md
@@ -0,0 +1,8 @@
+---
+id: text
+title: Texto Vinculado
+sidebar_label: Texto Vinculado
+---
+import useBaseUrl from "@docusaurus/useBaseUrl";
+
+<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} /> \ No newline at end of file
diff --git a/docusaurus/docs/transformer.md b/docusaurus/docs/transformer.md
index 5fc8c07..ead4e06 100644
--- a/docusaurus/docs/transformer.md
+++ b/docusaurus/docs/transformer.md
@@ -7,6 +7,9 @@ import useBaseUrl from "@docusaurus/useBaseUrl";
<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} />
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
>Aparelho estático com dois ou mais enrolamentos que, por indução eletromagnética, transforma um sistema de tensão e corrente alternada em outro sistema de tensão e corrente geralmente de valores diferentes e na mesma frequência com o objetivo de transmitir energia elétrica. [*tradução livre* - IEC 60050](
http://www.electropedia.org/iev/iev.nsf/display?openform&ievref=421-01-01).
@@ -88,8 +91,16 @@ Além desses dois contextos, pode ser observado o botão "Estabilidade" na parte
<div><center><img src={useBaseUrl("images/trafoSw.png")} alt="Formulário de chaveamento do transformador" title="Formulário de chaveamento do transformador" /></center></div>
----
-### Geral
+<Tabs
+ groupId="transformer-tabs"
+ defaultValue="general"
+ values={[
+ {label: 'Geral', value: 'general'},
+ {label: 'Falta', value: 'fault'},
+ {label: 'Botão Estabilidade', value: 'stability'},
+ ]
+}>
+<TabItem value="general">
#### Nome
Identificação do elemento elétrico. Podem ser inseridos quaisquer números de caracteres no padrão [Unicode](https://pt.wikipedia.org/wiki/Unicode).
@@ -141,8 +152,8 @@ Defasagem do transformador em relação ao primário, em graus. Esse valor indep
#### Utilizar potência nominal como base
Caso essa opção seja marcada, o programa irá utilizar a potência nominal do transformador como base para a conversão das unidades, caso contrário será usada a [potência base do sistema](simulationConfig).
----
-### Falta
+</TabItem>
+<TabItem value="fault">
#### Impedância de sequência zero do transformador
Esses parâmetros são necessários para o correto cálculo das correntes de [falta desbalanceadas](fault) (fase-fase, fase-fase-terra e fase-terra) e devem ser inseridos em $p.u.$
@@ -154,8 +165,12 @@ A não inserção desses dados acarretarão em resultados incorretos para [falta
#### Impedâncias de aterramento
As impedâncias de aterramento são somente utilizadas para conexão $Y_{aterrado}$ e devem ser inseridas em $p.u.$
----
-### Botão Estabilidade
+</TabItem>
+<TabItem value="stability">
+
O botão "Estabilidade" irá abrir um formulário, comum a vários outros elementos, que permite a inserção e/ou remoção do transformador durante o estudo de [estabilidade](stability).
-Nesse formulário pode ser criada uma lista genérica de inserções e remoções da linha no tempo, personalizada por um contexto de propriedades de chaveamento que são editados o tipo de chaveamento (inserção ou remoção) e o instante (em segundos) do evento. Essas propriedades são atribuídas e retiradas da lista genérica por meio dos botões "Adicionar" e "Remover", respectivamente. \ No newline at end of file
+Nesse formulário pode ser criada uma lista genérica de inserções e remoções da linha no tempo, personalizada por um contexto de propriedades de chaveamento que são editados o tipo de chaveamento (inserção ou remoção) e o instante (em segundos) do evento. Essas propriedades são atribuídas e retiradas da lista genérica por meio dos botões "Adicionar" e "Remover", respectivamente.
+
+</TabItem>
+</Tabs> \ No newline at end of file
diff --git a/docusaurus/sidebars.js b/docusaurus/sidebars.js
index 402bc74..2e0c2c2 100644
--- a/docusaurus/sidebars.js
+++ b/docusaurus/sidebars.js
@@ -28,7 +28,13 @@ module.exports = {
'fault',
'harmonics',
'stability',
- 'simulationConfig'
+ 'simulationConfig',
+ ],
+ 'Visualização dos Dados' : [
+ 'text',
+ 'tabularReport',
+ 'graphViewer',
+ 'heatmap'
],
},
};
diff --git a/docusaurus/src/css/custom.css b/docusaurus/src/css/custom.css
index 08cde97..7ab37bb 100644
--- a/docusaurus/src/css/custom.css
+++ b/docusaurus/src/css/custom.css
@@ -29,3 +29,14 @@ video {
width: 100%;
height: 100%;
}
+
+h4 {
+ display: block;
+ font-size: 1em;
+ margin-top: 1.33em;
+ margin-bottom: 1.33em;
+ margin-left: 0;
+ margin-right: 0;
+ font-weight: bold;
+ text-decoration: underline;
+} \ No newline at end of file
diff --git a/docusaurus/static/images/expForm.png b/docusaurus/static/images/expForm.png
new file mode 100644
index 0000000..896ad27
--- /dev/null
+++ b/docusaurus/static/images/expForm.png
Binary files differ
diff --git a/docusaurus/static/images/limiterForm.png b/docusaurus/static/images/limiterForm.png
new file mode 100644
index 0000000..3a8f83f
--- /dev/null
+++ b/docusaurus/static/images/limiterForm.png
Binary files differ
diff --git a/docusaurus/static/images/mathExpressionForm.png b/docusaurus/static/images/mathExpressionForm.png
new file mode 100644
index 0000000..004901b
--- /dev/null
+++ b/docusaurus/static/images/mathExpressionForm.png
Binary files differ
diff --git a/docusaurus/static/images/rateLimitForm.png b/docusaurus/static/images/rateLimitForm.png
new file mode 100644
index 0000000..bbd3d89
--- /dev/null
+++ b/docusaurus/static/images/rateLimitForm.png
Binary files differ
diff --git a/docusaurus/static/images/sumForm.png b/docusaurus/static/images/sumForm.png
new file mode 100644
index 0000000..75b8664
--- /dev/null
+++ b/docusaurus/static/images/sumForm.png
Binary files differ
diff --git a/docusaurus/static/images/syncGeneratorStabForm.png b/docusaurus/static/images/syncGeneratorStabForm.png
index 2dde53f..64b1695 100644
--- a/docusaurus/static/images/syncGeneratorStabForm.png
+++ b/docusaurus/static/images/syncGeneratorStabForm.png
Binary files differ