Esempi di formule

I seguenti esempi mostrano l'utilizzo di formule per calcolare i valori dei parametri in una famiglia.

La famiglia avanzata di esempio contiene esempi di diversi tipi di formule e ne mostra l'utilizzo per il calcolo dei valori dei parametri e per il controllo la geometria della famiglia stessa. La famiglia di esempio mostra inoltre la sintassi per tipi di formula di comune utilizzo.

Gli utenti in linea possono accedere alla famiglia di esempio avanzata nella pagina dei Revit. Scaricare rac_advanced_sample_family.rfa e aprirlo in Revit LT per visualizzare la modalità di applicazione delle formule alla famiglia.

La famiglia avanzata di esempio è una famiglia di persiane, che vengono sovrapposte ad una o più finestre nel progetto. L'utente definisce i parametri per la correlazione tra la famiglia di persiane e la finestra. La geometria della persiana viene modificata in base alle formule, per fornire l'ombra necessaria alla finestra. Le immagini seguenti mostrano viste 3D e di prospetto della famiglia di persiane in un progetto.

Funzioni matematiche di base

Questi esempi mostrano funzioni matematiche di base nelle formule.

Parametro	Formula
Shadow_Length	Mounting_Height-Window_Sill_Height
Rel_Angle	90º-Sun_Angle
Max Louver Spacing	Support_Length-(Support_Length*(Desired_Shading_Percent*0.01))

• Il parametro Shadow_Length viene calcolato sottraendo all'altezza di montaggio della famiglia l'altezza del davanzale.
• Il risultato è la lunghezza di ombra necessaria affinché l'ombra della persiana copra completamente la finestra.
• Il parametro Rel_Angle viene calcolato sottraendo l'angolo del sole da una costante, 90.

  Questo parametro viene successivamente utilizzato in un'altra formula con funzioni trigonometriche, per calcolare la lunghezza del supporto necessaria per proiettare un'ombra della lunghezza definita dal parametro Shadow_Length.

• Max Louver Spacing viene calcolata in base alla lunghezza del supporto e alla quantità di ombra necessaria.
• In primo luogo la formula converte una percentuale in un valore decimale, quindi moltiplica il valore ottenuto per la lunghezza del supporto. Il valore risultante è l'area della persiana che deve essere coperta da lamelle.

Funzioni di arrotondamento e trigonometriche

La lunghezza del supporto viene calcolata utilizzando una funzione trigonometrica, quindi arrotondata al millimetro (mm) più vicino.

Parametro	Formula
Support_Length	roundup((Shadow_Length/1mm)*tan(Rel_Angle))*1mm

• Il valore di Support_Length richiesto è una funzione di Shadow_Length moltiplicata per la tangente dell'angolo relativo tra il sole e la persiana, in base al periodo dell'anno e alla posizione del progetto.

  Queste condizioni variabili modificano a loro volta la lunghezza del supporto necessaria per ombreggiare completamente la finestra.

• La funzione di arrotondamento arrotonda il valore calcolato al millimetro più vicino. Affinché la funzione di arrotondamento risulti valida, il numero deve essere privo di unità di misura.
• Nella formula di esempio l'unità della lunghezza viene rimossa dal parametro Shadow_Length, prima dividendo il parametro per 1 mm, quindi effettuando il calcolo.
• Una volta che il numero è stato arrotondato al mm più vicino, l'unità viene nuovamente aggiunta al numero moltiplicandolo per 1 mm.

Istruzioni condizionali

Le istruzioni condizionali possono essere utilizzate in una formula per controllare i valori di altri parametri e per produrre risultati sulla base di tali valori. Per ulteriori informazioni, vedere Utilizzo di istruzioni condizionali nelle formule. Nell'esempio, Support_Hanger è un parametro di tipo yes/no utilizzato per controllare la visibilità di un supporto aggiuntivo per la persiana.

Parametro	Formula
Support_Hanger	Support_Length>400mm
Shade_Factor	if(Desired_Shading_Percent<65,"Low",if(Desired_Shading_Percent<79,"Med",if(Desired_Shading_Percent<99,"High","Max.")))

• Quando il parametro Support_Length supera i 400 mm, l'istruzione diventa true (vera), il valore del parametro viene impostato su "yes" e il supporto aggiuntivo risulta visibile.

  Quando in una formula si utilizza un'istruzione condizionale per definire un parametro di tipo yes/no, i risultati restituiti quando l'istruzione risulta true o false sono impliciti, e non è necessario che appaiano nella sintassi della formula.

• Il parametro Shade_Factor utilizza un'istruzione condizionale nidificata per restituire un risultato tra quattro possibili: Low, Med., High o Max.
• La verifica avviene rispetto a Desired_Shading_Percent: a seconda del valore rilevato viene restituito il risultato di testo.
• Vengono verificate tutte le istruzioni IF successive. Se la condizione non è true, viene valutata l'istruzione IF successiva, fino a quando non viene rilevato un risultato true.

Formula con matrice

Le matrici di una famiglia possono essere controllate mediante un parametro intero. Quando la matrice viene controllata per mezzo di una formula, tale formula deve contenere sintassi atta a garantire che il valore della matrice sia sempre maggiore di 1 (un valore di matrice deve essere sempre maggiore di 1).

Parametro	Formula
Number of Supports	(Length/Max_Support_Spacing)+1
Louver Number	(Support_Length/Max Louver Spacing)+1

• Il parametro Number of Supports è una funzione matematica di base che determina il numero di supporti necessari, sulla base dei dati dello spazio e della lunghezza totale della persiana.
• Louver Number crea un valore matrice per il posizionamento di lamelle nella persiana, sulla base della lunghezza del supporto e della spaziatura necessaria tra le lamelle.
• Entrambe le formule includono un "+1" aggiuntivo, per garantire che il valore della matrice non sia mai inferiore a 2.
• Poiché in questo caso entrambi i parametri sono definiti come parametri di tipo intero, non è necessario includere nelle formule la funzione di arrotondamento.