.. _anatem13-cdi:

.. only:: html

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

************************************
CDI — Controle Definido Internamente
************************************

.. only:: latex

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

O **Controle Definido Internamente (CDI)** permite distribuir um controlador
CDU em uma estrutura protegida. Assim, o modelo pode ser usado em simulações
sem que suas equações ou seu código-fonte sejam entregues com o caso.

O que o CDI protege
===================

O CDI encapsula a implementação do controlador em uma estrutura criptografada.
O usuário recebe a interface necessária para configurar e observar o modelo,
enquanto a lógica protegida permanece inacessível. Isso permite compartilhar
modelos proprietários entre fabricantes, fornecedores, instituições e equipes
de estudo.

Informações fornecidas com o modelo
===================================

O proprietário do CDI pode definir a interface pública necessária para a
utilização do modelo, incluindo:

* parâmetros obrigatórios;
* parâmetros opcionais;
* valores padrão, quando aplicáveis;
* entradas e condições necessárias ao funcionamento;
* variáveis de saída disponíveis para plotagem;
* nomes e identificadores usados para localizar essas variáveis;
* informações necessárias para documentar o uso do modelo.

Essa separação permite que o usuário configure e monitore o controle sem ter
acesso à implementação protegida. Os dados que precisam ser informados no
caso continuam sendo declarados pelos códigos de entrada correspondentes; o
CDI fornece a implementação e define quais informações são aceitas pelo
modelo.

Exemplo: AVR MD14 do caso MBINF
================================

O `MD14` usado como exemplo de CDI corresponde ao regulador automático de
tensão (AVR) implementado em CDU no caso `MBINF_AVR`. O caso está disponível
em **Exemplos > 01_MAQBARRAINF**, e a implementação do controle pode ser
consultada no bloco `DCDU` do arquivo `MBINF_AVR.STB`.

O exemplo em CDI é a versão protegida do mesmo controle implementado em CDU.
Assim, o caso permite comparar as duas formas de distribuição do AVR, mantendo
a mesma finalidade de controle. Na versão CDI, permanece visível apenas a
interface necessária para usar e observar o controlador. A documentação que
acompanhar cada CDI informa seus parâmetros, unidades, condições de aplicação
e variáveis de saída.

O `MD14` deste exemplo de controle não corresponde à opção de mesmo nome usada
por `DREL` e `DRGT`.

Uso em estudos
==============

Para quem utiliza o CDI, o fluxo é semelhante ao de um modelo CDU documentado:

* disponibilizar a estrutura protegida no ambiente de execução;
* declarar o modelo no caso conforme a documentação recebida;
* preencher os parâmetros obrigatórios;
* preencher os parâmetros opcionais quando necessário;
* associar os equipamentos e condições de uso;
* selecionar as variáveis de interesse para plotagem;
* executar o caso e analisar as respostas no ``OUT`` e no ``PLT``.

O usuário não precisa conhecer a implementação interna para utilizar o modelo,
mas precisa conhecer sua documentação de interface, seus requisitos de
licenciamento e as condições de aplicação. A proteção da implementação não
significa que parâmetros incorretos ou uma aplicação inadequada serão aceitos
automaticamente pelo ANATEM.

Antes de usar um CDI
====================

Confira a documentação entregue com o modelo: parâmetros obrigatórios e
opcionais, unidades, valores padrão, equipamentos compatíveis, requisitos de
licenciamento e variáveis disponíveis para plotagem. A proteção da
implementação não verifica se os parâmetros escolhidos ou a aplicação do
controlador são adequados ao estudo.

O proprietário do CDI é responsável pela implementação, pela documentação da
interface e pelas condições de uso. A equipe do estudo é responsável por usar
a versão correta do modelo, preencher sua interface e avaliar os resultados no
``OUT`` e no ``PLT``.

Interesse em disponibilizar um CDI
==================================

Organizações interessadas em desenvolver ou disponibilizar controles
protegidos para uso no Anatem podem entrar em contato com o **CEPEL** pelo
endereço:

.. centered:: **anatem@cepel.br**

No contato inicial, informe a finalidade do modelo, sua família de aplicação,
a interface de parâmetros pretendida, as variáveis de plotagem e o contexto de
distribuição esperado. O CEPEL poderá orientar os procedimentos técnicos e as
condições aplicáveis à disponibilização.