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 contém também informação adicional, como tipo, unidade, fórmula, descrição e requisitos mín./máx.

Criar Valis

Pode criar Valis num Bloco clicando primeiro no símbolo “+” no canto inferior direito do ecrã. Depois, continue preenchendo um nome (que pode ser qualquer nome ou um nome de Valitype - 1), uma Fórmula e Unidade (obrigatório - 2), uma Unidade de Visualização (opcional - 3), e clique em “Create” ou “Create & add New” (ver Figura Adding a Vali). Para um guia sobre Unidades e a sua conversão, consulte Units and Automatic Unit Conversion.

Além disso, pode decidir a que Blocos pretende adicionar este Vali (4).

Pro-tip: No campo Fórmula e Unidade, prima “\“ para obter uma lista de tipos de cálculo possíveis.

Adicionar um Vali - Janela pop-up para adicionar diferentes tipos de Valis.

Tenha em atenção que, ao criar uma propriedade, o utilizador pode criar diferentes Valis, por exemplo, Vali normal, Matriz, Text Vali, Datevali ou Dataset.

Type	Use-case
Vali	Propriedade do Bloco que tem apenas um único valor, por exemplo, massa, custo, densidade, etc..
Matriz	Uma matriz é um grupo de Valis individuais organizados em linhas e colunas. Um Vali de matriz é normalmente utilizado quando a propriedade dos Blocos tem modos diferentes. Por exemplo, consumo de energia durante diferentes modos, valores de inércia em eixos diferentes.
Text Vali	Um Vali que armazena cadeias de caracteres/texto, por exemplo,
DateVali	Um Vali que armazena informação de data, por exemplo,
Dataset	Aqui, o utilizador pode importar ou adicionar os valores do conjunto de dados, criar um gráfico e utilizar os seus valores no cálculo de outros valores.

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 Fórmula e Unidade, o utilizador pode referenciar Valis que estejam disponíveis quer no projeto quer noutros projetos. Para o fazer, pode ir a “Formula and Unit” e escrever “$”, abre-se uma pequena caixa de diálogo com Valis no interior (ver Figura Calling Valis). Os utilizadores podem escrever palavras-chave para encontrar facilmente o Vali.

Chamar Valis - Em qualquer ponto do Requirements & Systems 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 o utilizador pretenda usar Valis de um projeto diferente, pode deslocar-se até ao fim da caixa de diálogo para selecionar a opção “show other projects”.

Tipos comuns de fórmulas

Pode

• utilizar um valor fixo, como 42.7kg

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

• 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 todos os Valis do mesmo tipo nos sub-Blocos

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

Pode também 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 & Systems 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 de 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 de 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

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

  • wc_minus

  • 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 incorporada round( ) segue as especificações da Python's round function, 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)

Vali Information

Pode ver mais informação sobre o Vali clicando no seu nome. Isto abrirá uma vista de detalhes (1) e o utilizador poderá encontrar a informação (2). Consulte a Figura Vali Information para mais detalhes.

Informação do Vali - Ao clicar num Vali, abre-se uma janela com informação adicional. Aqui pode definir mais propriedades, adicionar descrição e definir impactos.

No separador de informação, os utilizadores têm várias possibilidades para adicionar/alterar margens/unidades e também adicionar os requisitos (mín./máx.). Os requisitos (mín./máx.) são os limites que tem para essa propriedade específica. Sempre que o valor ou o pior caso aumenta ou diminui e os valores excedem/ficam abaixo dos limites do seu requisito, o Requirements & Systems Portal apresenta um aviso junto ao nome do Vali. Consulte a secção Warnings para mais informação.

Tenha em atenção que a margem total apresentada nas propriedades do Vali é a margem do Bloco e as margens totais acumuladas do Bloco filho. Para mais informação sobre Margens, visite a nossa página de ajuda sobre Margins.

ID: o ID é um número aleatório adicionado automaticamente pelo Valiengine, que é utilizado no backend. Pode introduzir o ID de um Vali no campo de pesquisa da Rest API para encontrar o Vali. Consulte a documentação da Rest API.

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.

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

Histórico de Valis

Quando um Vali é alterado direta ou indiretamente, as alterações são automaticamente guardadas na base de dados do Requirements & Systems Portal. O separador de histórico do Vali mostra o valor anterior, o valor posterior e quem alterou os valores. O Requirements & Systems 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 (ver Figura Vali History), clique no nome do Vali (1) e abre-se o separador de detalhes (2). Selecione o ícone “History” (2) e, em seguida, abaixo, pode encontrar o gráfico que mostra as alterações ao longo do tempo. Em “Recent Changes” (3) o utilizador pode encontrar uma tabela 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 subscrever esse Vali clicando em Subscribe no menu pendente do botão Action do Vali. Consulte a Figura Subscribing to a Vali para ver como.

Subscrever um Vali - Ao subscrever um Vali, serão apresentadas notificações automáticas no separador Notification (símbolo do sino no canto superior direito) quando o Vali for alterado.

Verá uma nova notificação no sino de notificações no canto superior direito quando alguém alterar um valor ao qual está subscrito (4). Depois, pode clicar no ícone do sino para consultar as notificações.