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.
La famiglia avanzata di esempio (rac_advanced_sample_family.rfa) viene installata insieme al prodotto nella seguente directory: %ProgramFiles%\Autodesk\Autodesk Revit 2025\Samples. Gli utenti in linea possono anche scaricare il file dalla pagina dei file di famiglia di esempio.
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
| 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 delle informazioni sulla spaziatura 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.