summaryrefslogtreecommitdiffstats
path: root/docusaurus/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docusaurus/docs')
-rw-r--r--docusaurus/docs/bus.md7
-rw-r--r--docusaurus/docs/cadTools.md2
-rw-r--r--docusaurus/docs/controlEditor.md6
-rw-r--r--docusaurus/docs/fault.md6
-rw-r--r--docusaurus/docs/harmonics.md6
-rw-r--r--docusaurus/docs/io.md6
-rw-r--r--docusaurus/docs/line.md97
-rw-r--r--docusaurus/docs/powerEditor.md7
-rw-r--r--docusaurus/docs/simulationConfig.md7
-rw-r--r--docusaurus/docs/stability.md6
-rw-r--r--docusaurus/docs/transferFunction.md6
-rw-r--r--docusaurus/docs/transformer.md138
12 files changed, 285 insertions, 9 deletions
diff --git a/docusaurus/docs/bus.md b/docusaurus/docs/bus.md
index 7baf6c9..323896c 100644
--- a/docusaurus/docs/bus.md
+++ b/docusaurus/docs/bus.md
@@ -11,7 +11,7 @@ import useBaseUrl from "@docusaurus/useBaseUrl";
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).
-O elemento **barramento**, ou simplemente **barra**, é um conector ou nó do diagrama unifilar do PSP-UFU. Essa barra pode representar um PAC (Ponto de Acoplamento Comum), um poste de distrubuição, uma subestação, um barramento da subestação, entre inúmeros outros tipos pontos de análise e conexão entre elementos.
+O elemento **barramento**, ou simplesmente **barra**, é um conector ou nó do diagrama unifilar do PSP-UFU. Essa barra pode representar um PAC (Ponto de Acoplamento Comum), um poste de distribuição, uma subestação, um barramento da subestação, entre inúmeros outros tipos pontos de análise e conexão entre elementos.
## Formulário de edição dos barramentos
:::caution Atenção!
@@ -24,7 +24,7 @@ A imagem abaixo apresenta o formulário de inserção/alteração de dados das b
Esse formulário é subdividido em quatro contextos distintos:
- **Geral**: no qual são inseridas informações gerais da barra e informações do fluxo de carga;
-- **Falta**: local onde o curto-circuito shunt deve ser inserido;
+- **Falta**: local onde o curto-circuito *shunt* deve ser inserido;
- **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.
@@ -32,7 +32,7 @@ Esse formulário é subdividido em quatro contextos distintos:
### Geral
#### Nome
-Identificação do elemento elétrico. Podem ser iseridos quaisquer números de caracteres no padrão [Unicode](https://pt.wikipedia.org/wiki/Unicode).
+Identificação do elemento elétrico. Podem ser inseridos quaisquer números de caracteres no padrão [Unicode](https://pt.wikipedia.org/wiki/Unicode).
Todos os componentes de potência do PSP-UFU possuem esse campo.
@@ -100,6 +100,7 @@ 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
#### Imprimir impedância harmônica da barra
diff --git a/docusaurus/docs/cadTools.md b/docusaurus/docs/cadTools.md
index 2889fa6..c741ba8 100644
--- a/docusaurus/docs/cadTools.md
+++ b/docusaurus/docs/cadTools.md
@@ -63,7 +63,7 @@ Ao utilizar essa ferramenta os objetos irão girar 45º a partir do seu ponto de
### Arrastar
Três ferramentas muito úteis na navegação do circuito, principalmente em grandes redes, são: arrastar, zoom e encaixar.
-A ferramenta arrastar possibilita mover todo o circuito **preservando as posições relativas entre os elementos**. Esta ferramenta pode ser acessada pelo submenu “Ferramentas” ou **mantendo pressionada o scroll do mouse**, ativando assim o “modo arrastar”. Ao ativá-lo todo o circuito será movido clicando e arrastando na direção desejada.
+A ferramenta arrastar possibilita mover todo o circuito **preservando as posições relativas entre os elementos**. Esta ferramenta pode ser acessada pelo submenu “Ferramentas” ou **mantendo pressionada o *scroll* do mouse**, ativando assim o “modo arrastar”. Ao ativá-lo todo o circuito será movido clicando e arrastando na direção desejada.
Para sair do “modo arrastar” basta pressionar a tecla Escape do teclado.
diff --git a/docusaurus/docs/controlEditor.md b/docusaurus/docs/controlEditor.md
new file mode 100644
index 0000000..d74a092
--- /dev/null
+++ b/docusaurus/docs/controlEditor.md
@@ -0,0 +1,6 @@
+---
+id: controlEditor
+title: Editor de Controle
+sidebar_label: Editor de Controle
+---
+import useBaseUrl from "@docusaurus/useBaseUrl"; \ No newline at end of file
diff --git a/docusaurus/docs/fault.md b/docusaurus/docs/fault.md
new file mode 100644
index 0000000..6f72859
--- /dev/null
+++ b/docusaurus/docs/fault.md
@@ -0,0 +1,6 @@
+---
+id: fault
+title: Curto-Circuito
+sidebar_label: Curto-Circuito
+---
+import useBaseUrl from "@docusaurus/useBaseUrl"; \ No newline at end of file
diff --git a/docusaurus/docs/harmonics.md b/docusaurus/docs/harmonics.md
new file mode 100644
index 0000000..17d49b8
--- /dev/null
+++ b/docusaurus/docs/harmonics.md
@@ -0,0 +1,6 @@
+---
+id: harmonics
+title: Harmônicos
+sidebar_label: Harmônicos
+---
+import useBaseUrl from "@docusaurus/useBaseUrl"; \ No newline at end of file
diff --git a/docusaurus/docs/io.md b/docusaurus/docs/io.md
new file mode 100644
index 0000000..c02cca2
--- /dev/null
+++ b/docusaurus/docs/io.md
@@ -0,0 +1,6 @@
+---
+id: io
+title: Entrada / Saída
+sidebar_label: Entrada / Saída
+---
+import useBaseUrl from "@docusaurus/useBaseUrl"; \ No newline at end of file
diff --git a/docusaurus/docs/line.md b/docusaurus/docs/line.md
index 51b82dd..ab48c1a 100644
--- a/docusaurus/docs/line.md
+++ b/docusaurus/docs/line.md
@@ -2,4 +2,99 @@
id: line
title: Linha
sidebar_label: Linha
---- \ No newline at end of file
+---
+import useBaseUrl from "@docusaurus/useBaseUrl";
+
+<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} />
+
+>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).
+
+As linhas no PSP-UFU são modelos $\pi$ equilibradas. Podem ser utilizadas como linhas de transmissão e distribuição de sistemas elétricos de potência.
+
+A figura abaixo mostra o modelo $\pi$ implementado no PSP-UFU:
+
+<img src={useBaseUrl("images/lineModel.svg")} alt="Modelo PI da linha" title="Modelo PI da linha" />
+
+Em que:
+- $\bold{r_L}$ é a resistência da linha;
+- $\bold{x_L}$ é a reatância indutiva da linha;
+- $\bold{b_{L}^{d}}$ é a susceptância capacitiva *shunt* da linha.
+
+:::caution Atenção
+O modelo utilizado no PSP-UFU é **equilibrado** e **não possui impedâncias mútuas** entre as fases.
+:::
+
+A linha pode ser inseridas com pontos de ancoragem, ou "nós", para maior personalização gráfica do elemento, como apresentado nas [Ferramentas CAD](cadTools#linha).
+
+:::warning Cuidado!
+A linha deve ser inserida entre duas barras de **mesma tensão nominal**. Caso você tente inseri-la entre barras de tensão diferentes, uma mensagem de erro será exibida.
+:::
+
+## Formulário de edição das linhas
+
+A imagem abaixo apresenta o formulário de inserção/alteração de dados das linhas de transmissão:
+
+<img src={useBaseUrl("images/lineForm.png")} alt="Formulário das linhas no PSP-UFU" title="Formulário das linhas no PSP-UFU" />
+
+Esse formulário é subdividido em dois contextos distintos:
+- **Geral**: no qual são inseridas informações gerais da linha e informações do fluxo de carga;
+- **Falta**: local onde as impedâncias de sequência zero são inseridas;
+
+:::note Nota
+Os parâmetros necessários para construção da linha segundo seu modelo $\pi$ são inseridos na aba Geral, utilizados para construção da matriz admitância de sequência positiva e negativa.
+
+Dados adicionais de impedâncias de sequência zero necessário para o cálculo de curtos-circuitos desbalanceados são editados na aba Falta, utilizados na construção da matriz admitância de sequência zero.
+:::
+
+Além desses dois contextos, pode ser observado o botão "Estabilidade" na parte inferior direita do formulário. Esse formulário, comum a vários outros elementos, permite a inserção e/ou remoção da linha durante o estudo de [estabilidade](stability).
+
+<img src={useBaseUrl("images/lineSw.png")} alt="Formulário de chaveamento da linha" title="Formulário de chaveamento da linha" />
+
+---
+### Geral
+
+#### 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).
+
+Todos os componentes de potência do PSP-UFU possuem esse campo.
+
+#### Tensão nominal
+Campo de informação *não editável* que apresenta a tensão nominal da linha. Para alterar esse campo é necessário editar o campo correspondente do [barramento](bus#geral) conectado.
+
+
+#### Potência nominal
+Potência nominal da linha, inserida em MVA, kVA ou VA.
+
+Esse campo é especialmente importante caso a opção "Utilizar a potência nominal como base" esteja marcada.
+
+#### Parâmetros do modelo $\pi$
+Resistência ($r_L$), Reatância indutiva ($x_L$) série e Susceptância capacitiva shunt **total** ($2b_{L}^{d}$) presentes no modelo $\pi$ da linha.
+
+Esses parâmetros são inseridos em $p.u.$, $\Omega$ ou $\Omega/km$ ($S$ ou $S/km$ para $b_{L}^{d}$).
+
+#### Comprimento da linha
+Utilizado para calcular o valor dos parâmetros da linha inseridos em $\Omega/km$ (ou $S/km$).
+
+:::info Informação
+O comprimento da linha é ignorado caso não sejam utilizadas as unidades por quilometro.
+:::
+
+#### 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
+
+#### 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.$
+
+:::warning Cuidado!
+A não inserção desses dados acarretarão em resultados incorretos para [faltas desbalanceadas](fault).
+:::
+
+---
+### 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 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
diff --git a/docusaurus/docs/powerEditor.md b/docusaurus/docs/powerEditor.md
index 7c0b949..93ddea7 100644
--- a/docusaurus/docs/powerEditor.md
+++ b/docusaurus/docs/powerEditor.md
@@ -64,4 +64,9 @@ Ao inserir um barramento, a mesma irá acompanhar o ponteiro do mouse até que v
| Transformador | T | Indutor | Shift + I |
| Gerador | G | Corrente harmônica | Shift + H |
| Motor de indução | I | Texto | A |
-| Compensador síncrono | K | \ No newline at end of file
+| Compensador síncrono | K |
+
+## Editando dados elétricos
+Ao inserir um elemento, seu respectivo formulário de edição é exibido para inserção dos dados elétricos d elemento. Todos os dados podem ser **alterados** ao **clicar duas vezes sobre o elemento** ou por opção do **menu de contexto** exibido ao clicar com o botão direito sobre o elemento.
+
+Cada formulário de edição de dados elétricos dos elementos possuem suas particularidades e são descritos em documentação específica: [Barramento](bus), [Linha](line), [Transformador](transformer), [Carga](load), [Capacitor](capacitor), [Indutor](inductor), [Fonte de Corrente Harmônica](harmSource), [Gerador Síncrono](syncGenerator), [Compensador Síncrono](syncMotor), [Motor de Indução](indMotor). \ No newline at end of file
diff --git a/docusaurus/docs/simulationConfig.md b/docusaurus/docs/simulationConfig.md
new file mode 100644
index 0000000..2346e18
--- /dev/null
+++ b/docusaurus/docs/simulationConfig.md
@@ -0,0 +1,7 @@
+---
+id: simulationConfig
+title: Configurações da Simulação
+sidebar_label: Configurações da Simulação
+---
+import useBaseUrl from "@docusaurus/useBaseUrl";
+
diff --git a/docusaurus/docs/stability.md b/docusaurus/docs/stability.md
new file mode 100644
index 0000000..37e2ed3
--- /dev/null
+++ b/docusaurus/docs/stability.md
@@ -0,0 +1,6 @@
+---
+id: stability
+title: Estabilidade
+sidebar_label: Estabilidade
+---
+import useBaseUrl from "@docusaurus/useBaseUrl"; \ No newline at end of file
diff --git a/docusaurus/docs/transferFunction.md b/docusaurus/docs/transferFunction.md
new file mode 100644
index 0000000..ea49854
--- /dev/null
+++ b/docusaurus/docs/transferFunction.md
@@ -0,0 +1,6 @@
+---
+id: transferFunction
+title: Função Transferência
+sidebar_label: Função Transferência
+---
+import useBaseUrl from "@docusaurus/useBaseUrl"; \ No newline at end of file
diff --git a/docusaurus/docs/transformer.md b/docusaurus/docs/transformer.md
index c37d3b0..e938ad3 100644
--- a/docusaurus/docs/transformer.md
+++ b/docusaurus/docs/transformer.md
@@ -1,5 +1,137 @@
---
id: transformer
-title: Transformer
-sidebar_label: Transformer
---- \ No newline at end of file
+title: Transformador
+sidebar_label: Transformador
+---
+import useBaseUrl from "@docusaurus/useBaseUrl";
+
+<link rel="stylesheet" href={useBaseUrl("katex/katex.min.css")} />
+
+>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).
+
+Transformadores com quaisquer conexões e defasagens entre as tensões primárias e secundárias podem ser inseridos no PSP-UFU. Para isso, os transformadores devem ser modelados representando seu tape ($t$) e defasagem ($\phi$), utilizando um transformador ideal de relação de transformação $\overline{t}:1$ em série com sua impedância ($\overline{y}_T = r_T + jx_T$), em que $\overline{t}$ é um número complexo ($t\angle\phi$)
+
+:::caution Atenção
+O modelo utilizado no PSP-UFU **não considera** o ramo magnetizante ou impedâncias mútuas entre as fases.
+:::
+
+A figura abaixo mostra o modelo do transformador implementado no PSP-UFU:
+
+<img src={useBaseUrl("images/transformerModel.svg")} alt="Modelo PI da linha" title="Modelo PI da linha" />
+
+Em que:
+- $\bold{r_T}$ é a resistência total do transformador;
+- $\bold{x_T}$ é a reatância indutiva total do transformador;
+- $\bold{\overline{t}}$ é a o tape complexo do transformador.
+
+A relação entre as tensões e correntes das barras genéricas $i$ e $j$ é obtida pela equação matricial:
+
+$$
+\begin{bmatrix}
+\dot{I}_{ij}\\
+\dot{I}_{ji}
+\end{bmatrix}
+=
+\begin{bmatrix}
+\displaystyle \frac{\overline{y}_T}{t^2} & -\displaystyle \frac{\overline{y}_T}{\overline{t}^*}\\
+-\displaystyle \frac{\overline{y}_T}{\overline{t}} & \overline{y}_T
+\end{bmatrix}
+\times
+\begin{bmatrix}
+\dot{V}_{i}\\
+\dot{V}_{j}
+\end{bmatrix}
+$$
+
+Assim como nas [linhas](line), o transformador de dois enrolamentos deve ser inserido entre barras, porém não há a necessidade das tensões nominais desses barramentos serem idênticas.
+
+:::caution Atenção!
+A primeira barra selecionada será o lado **primário**, o qual é indicado por um círculo. Para alterar o lado primário após a inserção basta desconectar os nós dos transformadores e reconectá-los alternando as barras, utilizando as [ferramentas CAD](cadTools#conexão-e-desconexão-de-elemetos-na-barra).
+:::
+
+## Formulário de edição dos transformadores
+
+A imagem abaixo apresenta o formulário de inserção/alteração de dados dos transformadores:
+
+<img src={useBaseUrl("images/trafoForm.png")} alt="Formulário dos transformadores no PSP-UFU" title="Formulário dos transformadores no PSP-UFU" />
+
+Esse formulário é subdividido em dois contextos distintos:
+- **Geral**: no qual são inseridas informações gerais dos transformadores, informações do fluxo de carga, sua conexão e defasagem;
+- **Falta**: local onde as impedâncias de sequência zero e impedâncias de aterramento são inseridas;
+
+Além desses dois contextos, pode ser observado o botão "Estabilidade" na parte inferior direita do formulário. Esse formulário, comum a vários outros elementos, permite a inserção e/ou remoção do transformador durante o estudo de [estabilidade](stability).
+
+<img src={useBaseUrl("images/trafoSw.png")} alt="Formulário de chaveamento do transformador" title="Formulário de chaveamento do transformador" />
+
+---
+### Geral
+
+#### 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).
+
+Todos os componentes de potência do PSP-UFU possuem esse campo.
+
+#### Tensão nominal
+Campo de informação *não editável* que apresenta a tensão primária e secundária do transformador. Para alterar esse campo é necessário editar o campo correspondente dos [barramento](bus#geral) conectados.
+
+#### Tensão base
+Tensão utilizada para converter os parâmetros de impedância inseridos em $\Omega$ para $p.u.$ As tensões selecionadas por uma caixa de escolha são editadas nos formulários dos [barramentos](bus#geral) conectados.
+
+:::info Informação
+A tensão base é ignorada caso os dados inseridos estejam em $p.u.$
+:::
+
+#### Potência nominal
+Potência nominal da linha, inserida em MVA, kVA ou VA.
+
+Esse campo é especialmente importante caso a opção "Utilizar a potência nominal como base" esteja marcada.
+
+#### Impedância do transformador
+Impedância série do transformador (resistência e reatância indutiva), inserida em $p.u.$ ou $\Omega$. Caso as impedâncias sejam inseridas em $\Omega$ será utilizada a tensão base selecionada para conversão para $p.u.$
+
+#### Conexão
+Conexão do transformador utilizada para cálculo das correntes de sequência zero nas faltas desbalanceadas com presença de terra (fase-terra e fase-fase-terra).
+
+As seguintes conexões estão disponíveis:
+1. $Y_{aterrado}-Y_{aterrado}$
+2. $Y-Y_{aterrado}$
+3. $Y_{aterrado}-Y$
+4. $Y-Y$
+5. $\Delta-Y_{aterrado}$
+6. $\Delta-Y$
+7. $Y_{aterrado}-\Delta$
+8. $Y-\Delta$
+9. $\Delta-\Delta$
+
+#### TAP
+Tape do transformador **em relação ao primário**.
+
+:::caution Atenção!
+O tape no PSP-UFU deve ser inserido pela relação entre a tensão primária nominal e a tensão de tape $\left(\text{TAP} = \frac{V_{nominal}}{V_{tape}}\right)$.
+:::
+
+#### Defasagem
+Defasagem do transformador em relação ao primário, em graus. Esse valor independe do tipo de conexão, portanto para conexões diferentes de $Y-Y$(aterrado ou não) e $\Delta-\Delta$, deve-se inserir o ângulo de defasagem correto.
+
+#### 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
+
+#### 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.$
+
+:::warning Cuidado!
+A não inserção desses dados acarretarão em resultados incorretos para [faltas desbalanceadas](fault).
+:::
+
+#### 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
+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