Tipos de Arquivos e Dados

Os arquivos de entrada e saída do modelo SPTcpp são todos do tipo .csv, podendo ser abertos por softwares de planilha eletrônica, como o Microsoft Excel. Nos arquivos do SPT o separador decimal é "." (ponto) e o separador de campo é ";" (ponto e vírgula).

Para correta leitura dos dados no Excel, é necessário se alterar o separador decimal, que por padrão é "," (vírgula). Para isso, deve-se ir em: Arquivo>Opções>Avançado e em Separador decimal alterar para "." e Separador de milhar ",".

Além disso, ao se modificar algum arquivo no Excel, o programa muda o formato da data. Por exemplo: o padrão do formato da data utilizado no SPARHTACUS é 01/2020 ou jan/2020. Ao se abrir e salvar o arquivo no Excel, ele muda a data automaticamente para jan/20. Esse formato, jan/20 não é suportado pelo modelo, pois o ano só possui 2 dígitos. Sendo assim, é necessário se atentar neste ponto, pois ele não irá fazer a execução do modelo com os dados neste formato.

DICAS:

• Todo nome de atributo que inicia em verbo no infinitivo, ex. visitar_todos_cenarios_por_iteracao, é um atributo booleano e pode receber os valores: 0 ou 1, sim ou nao, s ou n, yes ou no, y ou n.
• A leitura do programa não é case sensitive, logo o programa reconhecerá o atributo visitar_todos_cenarios_por_iteracao estrito de diferentes formas, como Visitar_Todos_cenarios_por_Iteracao e VISITAR_TODOS_CENARIOS_POR_ITERACAO.

Operacional e Premissa

Uma das maiores dificuldades na adoção de modelos computacionais de alta complexidade, como o caso do SPARHTACUS II, está na validação dos cálculos realizados. Por esse motivo, neste projeto se teve atenção especial ao requisito “auditabilidade” do modelo. Um esquema elaborado de organização de dados e padronização da formulação matemática foi montado para que esse requisito fosse alcançado.

Nesse contexto, os pontos fundamentais a serem assimilados pelo usuário são:

1. Toda a entrada de dados na formulação do modelo é proveniente dos atributos chamados “Operacionais”;
2. A entrada de dados na formulação é íntegra, sem manipulação ou pré-processamento.

Os valores de atributos premissas são utilizados quando, na ausência de valores de um determinado atributo operacional, o usuário deseja que o modelo realize um pré-cálculo para a composição do valor do atributo operacional não lido. Nesse processo, o modelo realiza o pré-calculo e imprime um arquivo com os valores a comporem os atributos operacionais desejados.

Dessa forma, os dois tipos de arquivos no modelo são Operacional e Premissa.

Operacional: São dados que de fato estão presentes nas formulações utilizadas pelo modelo. Ao se olhar para o problema, estes são os dados de entrada. Caso o usuário deseja saber todas as informações que foram utilizadas como input, deve-se acessar estes arquivos.

Premissa: São dados de entrada que foram utilizados para calcular os dados do tipo Operacional.

A seguir serão apresentados dois exemplos que relacionam estes dois tipos de arquivos.

Exemplo 1)

O arquivo (premissa) contendo o valor da demanda média em cada submercado e o arquivo (premissa) que contém o valor percentual de quanto essa demanda média varia em cada patamar de carga formam o arquivo (operacional) de demanda média por submercado e por patamar.

Exemplo 2)

Os arquivos premissa TERMELETRICA_AttMatrizPremissa_PorPeriodoPorIdPatamarCarga e TERMELETRICA_AttVetorPremissa_PorPeriodo contém respectivamente a potência mínima e disponibilidade de cada usina termelétrica. Eles formam o atributo potencia_minima_disponivel no arquivo TERMELETRICA_AttMatrizOperacional_PorPeriodoPorIdPatamarCarga.

Em ambos os exemplo, ou o usuário informa os arquivos de premissa ou os arquivos operacionais no diretório de entrada de dados. Caso sejam informados as premissas e os respectivos operacionais, o modelo encerrará a execução lançando uma exceção no arquivo de status.

---

Tipos de Atributo

De maneira geral, foram definidas três estruturas arquivos, aos quais diferem no tipo do atributo a ser informado, podendo ser:

1. Atributo Comum (AttComum), para atributos escalares;
2. Atributo Vetor (AttVetor), para atributos vetoriais;
3. Atributo Matriz (AttMatriz), para atributos matriciais.

Atributo Comum

Tem a característica de ser atribuído um atributo (ou mais) de tamanho 1 x 1 para cada instância. Caso o arquivo possua apenas uma instância, os atributos estarão dispostos na vertical (Exemplo 1). Caso o arquivo possua mais de uma instância, os atributos estarão na horizontal (Exemplo 2).

Exemplo 1): O arquivo DADOS_AttComumOperacional. Neste caso, a instância é "dados". A imagem é de um estudo de médio prazo.

Exemplo 2): O arquivo HIDRELETRICA_AttComumOperacional. Existem 163 instâncias no arquivo, que imprime diversos atributos das usinas hidrelétricas consideradas pelo modelo no MP. Em diferentes estudos como de MP e PD, as usinas hidrelétricas consideradas são diferentes, então estes atributos em seus respectivos arquivos e diretórios serão diferentes.

Atributo Vetor

Para cada instância é atribuído um atributo (ou mais) do tipo vetor de tamanho 1 x n.

Exemplo 1): O arquivo HIDRELETRICA_AFLUENCIA_AttVetorPremissa_PorPeriodo, em que cada instância recebe o vetor natural_histórico contendo a série histórica de afluências com início em jan/1931.

Exemplo 2): O arquivo TERMELETRICA_AttVetorOperacional_PorPeriodo mostra as instâncias tipo_detalhamento_producao e disponibilidade para cada usina considerada no estudo.

Atributo Matriz

Cada instância recebe um ou mais atributo do tipo matriz de tamanho m x n. É caracterizado por considerar patamares de carga.

Exemplo 1): O arquivo SUBMERCADO_AttMatrizOperacional_PorPeriodoPorIdPatamarCarga. Cada submercado irá receber o atributo demanda que consiste de uma matriz com os valores de demanda em três patamares de carga para cada período de estudo.

Exemplo 2): Um exemplo de múltiplo instanciamento é o arquivo HIDRELETRICA_FPH_AttMatrizOperacional_PorPeriodoPorInteiro.csv onde cada hidrelétrica recebe os atributos matriciais "FC", "QH", "RHS", "SH" e "VH". Onde cada um possui múltiplos iteradores.

Assim como no formato vetorial, todos os atributos matriciais contidos em um arquivo devem possuir o mesmo tipo de iterador linha e mesmo tipo de iterador coluna.

---