CDI — Controle Definido Internamente¶
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
OUTe noPLT.
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:
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.