../_images/codigos_opcoes.png

DARQ

Função

Leitura de dados de associação de arquivos de entrada e saída. A partir da versão 11.02.00 é permitido que através de um arquivo de dados associado pelo código DARQ, seja dado outro código DARQ fornecendo outros arquivos de dados. Ao término de cada arquivo, a leitura continua no ponto onde parou no arquivo de dados de nível acima. São permitidos infinitos níveis de aninhamento de arquivo de dados, isto é, um segundo arquivo pode carregar um terceiro e assim sucessivamente, conforme apresenta a figura a seguir:

../_images/aninhamento_darq.png

Fig. 122 Estrutura de aninhamento infinito do DARQ

Atenção

A estrutura de aninhamento do DARQ presume que os arquivos informados estão relativos ao arquivo STB principal.

Utilização

Para a utilização do comando DARQ, os seguintes campos podem ser preenchidos:

Tipo

Tipo de arquivo a ser associado

C

Campo contextual: número do caso histórico para HIS e SAV; identificador do destino para PLT; formato PLT ou CSV para PLTCDU; em branco para os demais tipos

Nome do Arquivo

Nome do arquivo de entrada ou saída a ser associado

Nota

Para HIS e SAV, o número do caso é obrigatório, positivo e menor que 100. Para PLT, o campo C aceita um identificador de 0 a 999; em branco, PLT ou CSV preservam a declaração legada do destino 0. Para PLTCDU, o campo continua indicando o formato e o valor em branco equivale a PLT.

É possível declarar mais de uma linha PLT. O destino 0 preserva o nome informado, sem sufixo. Para cada identificador maior que zero, o Anatem acrescenta _número antes da extensão. Se o nome começar por %rótulo%, o sufixo passa a ser _rótulo; o rótulo deve começar por letra ou número, pode conter letras, números, _ e - e tem no máximo 32 caracteres. A extensão .plt ou .csv escolhe o formato do destino numérico; quando omitida, é adotado .plt.

Cada identificador maior que zero deve ser único. Nomes físicos repetidos, sem distinção entre maiúsculas e minúsculas, também são rejeitados. Se o destino 0 for declarado mais de uma vez, prevalece a última declaração, preservando o comportamento legado.

Os seguintes tipos de arquivos podem ser associados por meio do código DARQ:

OUT

Arquivo de relatório

LOG

Arquivo de mensagem

PLT

Arquivo de plotagem

SAV

Arquivo histórico do Anarede

HIS

Arquivo histórico do Anarede

BLT

Arquivo de modelos built-in

CDU

Arquivo de modelos Controladores Definidos pelo Usuário

DAT

Arquivo de dados e modelos

CTG

Arquivo de contingências

CDE

Arquivo do CDUEdit

RELE

Arquivo de plotagem de relés de impedância

MIIF

Arquivo CSV de resultados da análise de Multi-Infeed

RINE

Arquivo CSV de resultados de inércia gerados pela opção RINE

PWFOUT

Arquivo PWF com o ponto de operação ao final da simulação

SAGE

Arquivo LOGX com as mudanças topológicas ocorridas durante a simulação

DLCA

Arquivo de cache do recurso DLCA

SNP

Arquivo snapshot

PLTCDU

Arquivo de plotagem automática de variáveis de Controladores Definidos pelo Usuário

SINARQ

Arquivo de sinal externo

GEO

Arquivo JSON com a geografia da rede usado pela Visão Geoespacial

SUISHI

Pasta que contém os arquivos USIHID.csv oriundos do SUISHI

O caminho relativo do arquivo GEO é resolvido a partir do arquivo STB principal. O schema network-geography.schema.json, instalado com o Anatem, descreve a estrutura aceita. A página Arquivo de Dados Geográficos apresenta o schema, a correspondência entre os nomes do arquivo e da interface e a base genérica distribuída para o SIN de referência.

Dica

Os arquivos de saída OUT, LOG, PLT, MIIF, RELE, PWFOUT, SAGE, DLCA, RINE e SNP, além dos arquivos históricos SAV e HIS, podem omitir o nome. Nesse caso, o Anatem determina o nome e a extensão adequados a partir do caso em execução. O tipo SUISHI recebe uma pasta e exige barra ou contrabarra ao final quando ela é informada. Para OUT, LOG e PLT, recomenda-se deixar o nome em branco, salvo quando for necessário escolher um nome diferente do nome do caso.

Exemplo

Listagem 193 Exemplo da aplicação do código DARQ
 1DARQ
 2(Tipo) (C) ( Nome do Arquivo
 3( Arquivos de saída com nome automático
 4OUT        .\
 5LOG        .\
 6PLT        .\
 7PLT      1 .\
 8PLT      2 %maquinas%.\
 9( Arquivos de entrada
10SAV     2  exemplo.sav
11BLT        exemplo.blt
12CDU        exemplo.cdu
13GEO       exemplo.geo.json
14999999

Ver também

Para maiores detalhes acerca dos arquivos que podem ser associados, ver Arquivos Anatem.