Valis e Cálculos

Os Valis são parâmetros de conceção de Blocos, Requisitos ou Análises que podem ser utilizados em cálculos e documentação. Um Vali tem um valor numérico e também contém informações adicionais, como tipo, unidade, fórmula, descrição e requisitos mín./máx.

Criar um Vali

Ao visualizar as propriedades de um Bloco, pode criar Valis neste Bloco clicando no botão  no canto superior direito da página. Na janela Create Property que se abre, selecione o tipo de propriedade que pretende criar. Para um Vali, introduza o Name do Vali (que pode ser qualquer nome ou um nome de Valitype), defina a Formula and unit (obrigatória) e Display Unit (opcional). Além disso, utilizando o campo Add to Block, pode definir a que Blocos pretende adicionar este Vali.

Tenha em atenção que, ao criar uma propriedade, pode criar Valis de diferentes tipos: Vali normal, Matrix, Textvali, Datevali ou Dataset.

Adicionar fórmulas

Um Vali pode ser calculado com uma fórmula utilizando expressões matemáticas comuns ou adicionando constantes ou funções. Uma fórmula também pode conter outros Valis.

No campo Formula and unit, pode referenciar Valis que estejam disponíveis no projeto atual ou noutros projetos. Para o fazer, escreva $ no campo. Na janela pop-up que aparece, localize e selecione o Vali pretendido.

Chamar Valis – em qualquer ponto do Requirements Portal, pode utilizar o símbolo de dólar $ para abrir uma lista pendente que mostra qualquer objeto referenciável (por exemplo, Valis, Requisitos, etc.).

Caso pretenda utilizar Valis de um projeto diferente, pode deslocar-se até ao fim da janela pop-up para selecionar a opção show other projects.

Tipos comuns de fórmulas

Pode:

• utilizar um valor fixo, como 42.7kg, ou

• utilizar uma fórmula, como 5/(3+17.3*9), ou

• utilizar outros Valis, usando o sinal $: $car.speed+5.

As operações matemáticas disponíveis nas fórmulas são:

• +, -, *, /

• % (operação módulo)

• ^

• sqrt()

• exp()

• log10(), ln(), log()

• sin(), cos(), tan()

• asin(), acos(), atan()

• sinh(), cosh(), tanh()

• fabs(): devolve o valor absoluto

• soc() = "Soma dos filhos": soma de todos os Valis do mesmo tipo nos sub-Blocos

• poc() = "Produto dos filhos": produto de todos os Valis do mesmo tipo nos sub-Blocos

Também pode utilizar as seguintes funções lógicas nas fórmulas:

• if(condition, formula_if_true, formula_if_false)

• max(formula1, formula2)

• min(formula1, formula2)

Funções incorporadas do Requirements Portal

• soc(): significa "soma dos filhos", soma todos os Valis do mesmo tipo nos Blocos um nível abaixo

• rssoc(): significa “root sum squared of children” sqrt(x1^2+x2^2+⋯+xn^2). Por exemplo, se tiver três massas de 2 kg, 5 kg e 6 kg, a função rssoc dá-lhe o resultado 8,062257

• aoc(): significa "média dos filhos", calcula o valor médio dos Valis do mesmo tipo nos Blocos um nível abaixo

• poc(): significa "produto dos filhos", multiplica todos os Valis do mesmo tipo nos Blocos um nível abaixo

• average_of_datasets() ou aod(): o resultado do Vali é a média para cada ponto dos datasets pertencentes a esse Vali. Se existir apenas um dataset, esse dataset é o resultado e é utilizado em cálculos posteriores

• sum_of_datasets() ou sod(): o resultado do Vali é a soma para cada ponto dos datasets pertencentes a esse Vali. Se existir apenas um dataset, esse dataset é o resultado e é utilizado em cálculos posteriores

• property($vali, property_name): obter uma propriedade de um Vali. As possibilidades para property_name são:

  • min e max (para obter os requisitos mín. e máx., respetivamente)

  • wc_minus e wc_plus (para obter os piores casos negativo e positivo, respetivamente)

• minoc(): mínimo dos filhos. Devolve o valor mínimo de todos os Valis com o mesmo tipo nos sub-Blocos

• maxoc(): máximo dos filhos. Devolve o valor máximo de todos os Valis com o mesmo tipo nos sub-Blocos

• round(): a função segue as especificações da função round do Python, em que os valores são arredondados para o múltiplo de 10 mais próximo elevado à potência negativa de ndigits

Exemplo de fórmulas:

• $SolarPanel.width * $SolarPanel.length

• max(soc(), $SolarPanel.lowest_mass)

• if($SolarPanel.width*2 > $SolarPanel.length, 10, 5)

Informação do Vali

Pode ver mais informações sobre o Vali clicando no respetivo nome. Isto abrirá uma vista de detalhes do Vali, com a informação apresentada no separador Info.

Informação do Vali – ao clicar num Vali, será aberta uma vista com informações adicionais. Aqui pode definir mais propriedades, adicionar descrição e definir impactos.

A informação básica sobre um Vali apresentada na vista é:

• ID – o ID é um número aleatório adicionado automaticamente pelo Valiengine, que é utilizado no backend.

• Name – aqui pode introduzir e editar o nome do Vali.

• Description – no campo de descrição pode introduzir uma descrição do Vali. Também pode formatar e editar tarefas conforme mostrado abaixo.

Também pode adicionar/alterar as margens/unidades e adicionar os requisitos (mín./máx.). Os requisitos (mín./máx.) são os limites que tem para a propriedade em questão.

Outras informações que podem ser adicionadas/visualizadas aqui incluem Referências, Using e Used by, bem como os Impactos deste Vali.

Histórico dos Valis

Quando um Vali é alterado direta ou indiretamente, as alterações são automaticamente guardadas na base de dados do Requirements Portal. O separador History do Vali mostra o valor anterior, o valor posterior e quem alterou os valores. O Requirements Portal regista as alterações mesmo que o Vali alterado não esteja diretamente referenciado ao Vali.

Para ver o histórico das alterações de um Vali, clique no nome do Vali e selecione o separador History. Neste separador, pode encontrar um gráfico que mostra as alterações ao longo do tempo. Abaixo do gráfico, está presente uma tabela Recent Changes preenchida com os dados Time, Value Before, Value After e Reason.

Histórico do Vali – no separador History, é apresentada uma representação gráfica e tabular da alteração de um Vali ao longo do tempo.

Notificações sobre alterações

Para receber uma notificação quando um determinado Vali for alterado, pode subscrevê-lo clicando no botão de três pontos na coluna Ações e selecionando o comando Add » Subscribe no menu que se abre.

Para mais informações sobre notificações, consulte a página Notifications.