.. _anatem13-multiplot:

.. only:: html

   .. image:: /img/anatem_13.png
      :alt: Anatem 13

********
MultiPLT
********

.. only:: latex

   .. image:: /img/anatem_13.png
       :alt: Anatem 13
       :width: 100%

O MultiPLT permite distribuir sinais de plotagem em múltiplos arquivos
`PLT`. Em casos com muitas curvas, os destinos ajudam a separar sinais por
equipamento, região ou finalidade da análise. A distribuição não recalcula a
solução dinâmica nem altera os valores das curvas.

Como configurar os destinos
===========================

O destino é identificado por um número inteiro de ``0`` a ``999``. O destino
``0`` é o padrão e preserva o comportamento tradicional quando não existe uma
associação explícita. Os demais valores permitem separar conjuntos de sinais
por finalidade, etapa de análise ou arquivo de saída.

O destino do arquivo é declarado no campo ``C`` da opção ``PLT`` em
:ref:`DARQ <darq>`. O identificador do destino de cada sinal é informado no
campo ``ID`` de :ref:`DPLT <dplt>`, nas colunas 48--50:

.. code-block:: anatem
   :caption: Associação de dois destinos de plotagem

   DARQ
   (Tipo) (C) ( Nome do Arquivo
   PLT      1  caso_tensao.plt
   PLT     12  caso_frequencia.plt
   999999

   DPLT
   (Tipo)M( El ) ( Pa) Nc Gp ( Br) Gr ( Ex)( Bl )P(ID(              Nome da Variável                )
   VOLT      538                                    1TENSAO BARRA 538
   FREQ      538                                   12FREQUENCIA BARRA 538
   999999

Cada ``DPLT.ID`` identifica um destino declarado em ``DARQ PLT.C``.
Quando o campo está vazio, o sinal permanece no destino ``0``.

O nome opcional do sinal ocupa as colunas 51--98, sem avançar sobre o campo
``ID``.

Resultado da configuração
==========================

* se nenhum destino explícito for usado, todos os sinais seguem para o arquivo
  PLT padrão;
* sinais destinados a ``0`` permanecem no arquivo PLT padrão;
* destinos adicionais geram arquivos PLT independentes;
* os valores são apenas distribuídos: não há novo cálculo da solução;
* sinais repetidos permanecem repetidos quando solicitados;
* o identificador permitido permanece entre ``0`` e ``999``;
* um destino informado em ``DPLT`` precisa estar declarado no ``DARQ``;
* associações ausentes ou incompatíveis são informadas como diagnóstico.

O recurso organiza a saída, mas não modifica o número de sinais que o ANATEM
produz nem substitui a leitura do ``OUT``. Cada arquivo resultante pode ser
aberto separadamente no Plot Cepel ou associado à análise correspondente.

.. figure:: ../anatem_13/img/anatem_13_multiplt.png
   :alt: Configuração do MultiPLT
   :width: 100%
   :name: fig-anatem13-multiplot

   Arquivos PLT separados por identificador, abertos simultaneamente no Plot
   Cepel.

.. versionadded:: 13.0.0
   É possível distribuir os sinais de ``DPLT`` entre múltiplos arquivos PLT
   por meio do identificador de destino ``0--999`` e das associações declaradas
   em ``DARQ``.