Objeto Topologia

Topology Object

The module that implements View Energization in Unifilares is defined as a class, available from the Component TOPOLOGY of Action.NET.
To use this facility you must import this component into the project generated by DefaultNewProject and include the Topology template in the baytemplates.
There is a class defined in scripts within the project, which in turn uses a class defined in the Actiion.NET using the file, SPIN. ActionNet.Biz.Eletric.Dll, instalado normalmente com o installed normally with the Action.NET.
A metodologia utilizada considera que os unifilares e elementos de conexão formam um grafo. Os elementos de conexão são as interligações e os bays são os nodos do grafo.
Para modelar esta topologia é formada uma matriz de adjacência, com as bays/percursos utilizando cada linha e cada coluna da matriz. As interligações existentes são indicadas por uma sinalização nas células que interceptam linhas e colunas da matriz que representam bays adjacentes.
A topologia interna aos bays é utilizada para verificar, periodicamente, se a adjacência está confirmada ou interrompida. A cada avaliação, são novamente alterados adequadamente os estados dos tags BRANCH, utilizados para escolher as cores dos ramos de unifilares.

Métodos e Chamadas

A classe SS_TOPOLOGY, definida como script no componente importado para o projeto, basicamente tem duas partes: uma de inicialização e outra de avaliação periódica.

Inicialização

O método Initialize() da classe deve ser chamado uma única vez em uma TASK.
A implementação considera que uma tela de unifilar conterá um único conjunto de bays interligados. Não é necessário que todos os bays estejam em um único conjunto totalmente conexo. É possível o tratamento, mesmo se houverem ilhas, isto é mais de um conjunto conexo.
No método de Inicialização, é feita, para cada tela, a criação de um objeto interno, e neles a leitura dos registros de interligação dos bays guardados na tabela Topology e a criação de arrays em memória, que reproduzem a topologia salva. Os arrays criados incluem uma matriz de adjacência, com as indicações de interligações entre bays; um vetor com os bays que são supridores e estão na raiz do unifilar; e um vetor indicando para cada interligação se é feita entre percursos principais ou percursos secundários dentro dos bays.
A figura mostra uma TASK, que será executada periodicamente. Somente na primeira vez são executadas as inicializações, pelo método isInitiated.
Image Removed

Avaliação periódica

Para a avaliação periódica, deve-se chamar o método de Avaliação do estado atual de conexões entre os bays de cada tela, Evaluate(); Não há parâmetro pois o método percorre a lista de objetos de cálculo de energização de cada tela fazendo a avaliação para cada tela.
O método de cada objeto interno, verifica para cada bay se é raiz supridora e a partir dele segue as indicações de interligação da matriz de adjacência.
Para cada linha da matriz verifica cada coluna que contém um bay que está interligado. Confirma então se internamente ao bay a conectividade está mantida ou interrompida de acordo com o estado dos elementos de conexão inclusos no bay.
Para cada ramo que se segue à elementos conectados, marca que está energizado, se a entrada do bay estiver. A informação de energização é colocada nos tags dos BRANCH e BRANCHALT do template de topologia do bay.
Ao final, para cada bay é atualizada a tag BAYSTATE com o estado final do bay, de acordo com o estado de energização do ramo que define este estado.
A figura mostra a classe SS_TOPOLOGY, definida como um script no projeto.
Tenha certeza que o nome do objeto em que estão definidos os parâmetros é o mesmo que aparece no código desta classe. Se necessário altere para indicar este objeto corretamente.
Image Removed

Configuração de Constantes

A figura a seguir mostra o template de constantes para a funcionalidade de topologia. Nesta parte está a definição de constantes utilizadas no código dos métodos desta classe.
Caso o projeto utilize nomes ou constantes diferentes para indicar estes mesmos objetos deve-se fazer as alterações que forem necessárias, nos StartValues deste template
Image Removed
Constantes

• typeSta – Nome do sub template que contém os dados de estado do bay, já com pontos separadores. Neste template devem estar os tags que definem os elementos de conexão. Será procurado o tag: bay + staType + texto de tag contido em TAGCONNECTION. Esta tag pode ser vazia, se não houver o sub template .STA.

• typeMEA – Nome do sub template que contém dados de Medidas, já com os pontos separadores.

• typeTopg- Nome do sub template que contém os dados de topologia do bay, já com pontos separadores. Neste template devem estar os tags de BRANCHES e TAGCONNECTION;

• typeMea - Nome do sub template que contém os dados de medidas do bay, já com pontos separadores. Neste template deve estar o tags que definem a medida de suprimento dos bays raízes (supridores).

• tagPowerSupply – Tag que contém a medida de suprimento de potência do bay supridor com o atributo de valor.

Internamente na biblioteca estão sendo consideradas as seguintes constantes

• CT_OPEN e CT_CLOSED – Valores utilizados para os estados de aberto e fechado dos elementos de conexão.

• MAX_BRANCHES – O número máximo de ramais (ou branches) existentes em um percurso principal ou secundário de um bay.

• CT_ON e CT_OFF - Valores que serão colocados nos tags de BRANCH para indicar energizado ou não.

The methodology used considers that unifilares and connection elements form a graph. The connecting elements are the interconnections and the bays are the graph nodes.
To model this topology, an adjacency matrix is formed, with the bays/paths using each row and each column of the matrix. Existing interconnections are indicated by a signaling in cells that intersect rows and columns of the array that represent adjacent bays.
The internal topology to the bays is used to periodically check whether the adjacency is confirmed or interrupted. Each evaluation, the branch tag states are properly changed again, used to choose the colors of the unifilare branches.

Methods and Calls

The class SS_TOPOLOGY, defined as script in the component imported into the project, basically has two parts: one initialization and one periodic evaluation.

Startup

The method Initialize() class should be called only once in a TASK.
The implementation considers that a unifilar screen will contain a single set of interconnected bays. It is not necessary for all bays to be in a single fully connected set. Treatment is possible, even if there are islands, this is more than one connected set.
In the Initialization method, for each screen, an internal object is created, and in them the reading of the interconnection records of the bays stored in the table Topology and creating in-memory arrays, which reproduce the saved topology. Arrays created include an adjacency array, with indications of interconnections between bays; a vector with bays that are supplied and are at the root of the unifilar; and a vector indicating for each interconnection whether it is made between main paths or secondary paths within the bays.
The figure shows a TASK, which will run periodically. Only the first time the initializations are performed, by the method isInitiated.

Image Added

Periodic evaluation

For periodic evaluation, you must call the Method of Evaluating the current state of connections between the bays of each screen, Evaluate(); There is no parameter because the method traverses the list of energizing calculation objects of each screen by evaluating for each screen.
The method of each internal object checks for each bay if it is root supplying and from it follows the interconnection indications of the adjacency matrix.
For each row the array checks each column that contains a bay that is interconnected. It then confirms whether internally to the bay connectivity is maintained or interrupted according to the state of the connection elements included in the bay.
For each branch that follows the connected elements, mark that is energized, if the bay entrance is. The energizing information is placed in the BRANCH and BRANCHALT tags of the bay topology template.
At the end, for each bay is updated the BAYSTATE tag with the final state of the bay, according to the energizing state of the branch that defines this state.
The figure shows the class SS_TOPOLOGY, defined as a script in the project.
Make sure that the name of the object on which the parameters are defined is the same as that appears in the code of this class. If necessary change to indicate this object correctly.
Image Added

Constants Configuration

The following figure shows the constant template for topology functionality. In this part is the definition of constants used in the code of the methods of this class.
If the project uses different names or constants to indicate these same objects, you must make any changes that are necessary in the StartValues of this template
Image Added
Constants

• typeSta - Name of the sub template that contains the data bay state, already with sectionpoints. In this template should be the tags that define the connection elements. The tag: bay + staType + tag text contained in TAGCONNECTION will be searched. This tag can be empty if there is no sub template. STA.

• typeMEA - Name of the sub template that contains measurement data, already with the section points.

• typeTopg- Name of the sub template that contains the data bay topology, already with sectionpoints. In this template should be the tags of BRANCHES and TAGCONNECTION;

• typeMea - Name of the sub template that contains the data of bay measures, already with sectionpoints. In this template should be the tags that define the supply measure of the root bays (supplies).

• tagPowerSupply -Tag that contains the power supply measure of the supplier bay with the value attribute. The algorithm will check if this value is equal to or greater than 1, and if it is, it will consider this Root bay energized. Alternatively, this parameter can be set to NONE and, through scripts, properly trigger the ENERGIZED tag of the TOPG template in the ROOT bay.

Internally in the library are being considered the following constants

• CT_OPEN and CT_CLOSED - Values used for the open and closed states of the connection elements.

• MAX_BRANCHES - The maximum number of extensions (or branches) existing on a primary or secondary route of a bay.

• CT_ON and CT_OFF - Values that will be placed on branch tags to indicate energized or not.