Valis e calcoli

I Vali sono parametri di progettazione di Blocchi, Requisiti o Analisi che possono essere usati nei calcoli e nella documentazione. Un Vali ha un valore numerico e contiene anche informazioni aggiuntive come tipo, unità, formula, descrizione e requisiti min/max.

Creazione di un Vali

Quando visualizzi le proprietà di un Blocco, puoi creare dei Vali in questo Blocco facendo clic sul pulsante  in alto a destra nella pagina. Nella finestra Create Property che si apre, seleziona il tipo di proprietà che desideri creare. Per un Vali, inserisci il Name del Vali (che può essere qualsiasi nome oppure un nome di Valitype), definisci il Formula and unit (obbligatorio) e Display Unit (facoltativo). Inoltre, usando il campo Add to Block, puoi definire a quali Blocchi vuoi aggiungere questo Vali.

Tieni presente che durante la creazione di una proprietà puoi creare Vali di tipi diversi: normale Vali, Matrix, Textvali, Datevali oppure Dataset.

Aggiunta di formule

Un Vali può essere calcolato con una formula usando espressioni matematiche comuni oppure aggiungendo costanti o funzioni. Una formula può anche contenere altri Vali.

All’interno del campo Formula and unit, puoi fare riferimento ai Vali disponibili sia nel progetto corrente sia in altri progetti. Per farlo, digita $ nel campo. Nella finestra pop-up che appare, trova e seleziona il Vali richiesto.

Richiamo dei Vali – ovunque in Requirements Portal, puoi usare il simbolo del dollaro $ per aprire un menu a discesa che mostra qualsiasi oggetto referenziabile (ad esempio Vali, Requisiti, ecc.).

Se vuoi usare Vali da un progetto diverso, puoi scorrere fino alla fine del pop-up per selezionare l’opzione show other projects.

Tipi comuni di formule

Puoi:

• usare un valore fisso, come 42.7kg, oppure

• usare una formula, come 5/(3+17.3*9), oppure

• usare altri Vali, usando il segno $: $car.speed+5.

Le operazioni matematiche disponibili nelle formule sono:

• +, -, *, /

• % (operazione modulo)

• ^

• sqrt()

• exp()

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

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

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

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

• fabs(): restituisce il valore assoluto

• soc() = "Somma dei figli": somma di tutti i Vali dello stesso tipo nei sotto-Blocchi

• poc() = "Prodotto dei figli": prodotto di tutti i Vali dello stesso tipo nei sotto-Blocchi

Puoi anche usare le seguenti funzioni logiche nelle formule:

• if(condition, formula_if_true, formula_if_false)

• max(formula1, formula2)

• min(formula1, formula2)

Funzioni integrate di Requirements Portal

• soc(): sta per "somma dei figli", somma tutti i Vali dello stesso tipo nei Blocchi di un livello inferiore

• rssoc(): sta per “radice della somma dei quadrati dei figli” sqrt(x1^2+x2^2+⋯+xn^2). Per esempio, se hai tre masse di 2 kg, 5 kg e 6 kg, la funzione rssoc restituisce 8.062257

• aoc(): sta per "media dei figli", calcola il valore medio dei Vali dello stesso tipo nei Blocchi di un livello inferiore

• poc(): sta per "prodotto dei figli", moltiplica tutti i Vali dello stesso tipo nei Blocchi di un livello inferiore

• average_of_datasets() oppure aod(): il risultato del Vali è la media di ciascun punto dei dataset appartenenti a quel Vali. Se c’è un solo dataset, quel dataset è il risultato e viene usato nei calcoli successivi

• sum_of_datasets() oppure sod(): il risultato del Vali è la somma di ciascun punto dei dataset appartenenti a quel Vali. Se c’è un solo dataset, quel dataset è il risultato e viene usato nei calcoli successivi

• property($vali, property_name): ottiene una proprietà di un Vali. Le possibilità per property_name sono:

  • min e max (per ottenere rispettivamente i requisiti minimi e massimi)

  • wc_minus e wc_plus (per ottenere rispettivamente i worst case negativo e positivo)

• minoc(): minimo dei figli. Restituisce il valore minimo di tutti i Vali dello stesso tipo nei sotto-Blocchi

• maxoc(): massimo dei figli. Restituisce il valore massimo di tutti i Vali dello stesso tipo nei sotto-Blocchi

• round(): la funzione segue le specifiche della funzione round di Python, in cui i valori vengono arrotondati al multiplo di 10 più vicino elevato alla potenza meno ndigits

Esempi di formule:

• $SolarPanel.width * $SolarPanel.length

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

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

Informazioni sul Vali

Puoi vedere ulteriori informazioni sul Vali facendo clic sul suo nome. Si aprirà una vista dei dettagli del Vali, con le informazioni presentate nella scheda Info.

Informazioni sul Vali – facendo clic su un Vali, si aprirà una vista con informazioni aggiuntive. Qui puoi definire più proprietà, aggiungere una descrizione e definire gli impatti.

Le informazioni di base su un Vali presentate nella vista sono:

• ID – l’ID è un numero casuale aggiunto automaticamente dal Valiengine, usato nel backend.

• Name – qui puoi inserire e modificare il nome del Vali.

• Description – nel campo descrizione puoi inserire una descrizione del Vali. Puoi anche formattare e modificare le attività come mostrato sotto.

Puoi anche aggiungere/modificare i margini/le unità e aggiungere i requisiti (min/max). I requisiti (min/max) sono i limiti previsti per quella particolare proprietà.

Altre informazioni che possono essere aggiunte/visualizzate qui includono Riferimenti, Using e Used by, nonché gli Impacts di questo Vali.

Cronologia dei Vali

Quando un Vali viene modificato direttamente o indirettamente, le modifiche vengono salvate automaticamente nel database di Requirements Portal. La scheda History del Vali mostra il valore precedente, il valore successivo e chi ha modificato i valori. Requirements Portal registra le modifiche anche se il Vali modificato non è direttamente referenziato al Vali.

Per vedere la cronologia delle modifiche di un Vali, fai clic sul nome del Vali e seleziona la scheda History. In questa scheda si trova un grafico che mostra le modifiche nel tempo. Sotto il grafico è presente una tabella Recent Changes contenente i dati Time, Value Before, Value After e Reason.

Cronologia del Vali – nella scheda History viene mostrata una rappresentazione grafica e tabellare delle variazioni di un Vali nel tempo.

Notifiche sulle modifiche

Per ricevere una notifica quando un determinato Vali cambia, puoi iscriverti facendo clic sul pulsante con i tre puntini nella colonna Actions e selezionando il comando Add » Subscribe dal menu che si apre.

Per maggiori informazioni sulle notifiche, consulta la pagina Notifications.