Formelbeispiele

In diesem Abschnitt werden Beispiele für die Verwendung von Formeln zur Berechnung der Werte von Parametern in Familien gegeben.

Die erweiterte Beispielfamilie enthält Beispiele für verschiedenartige Formeln. Hier wird außerdem gezeigt, wie Formeln zur Berechnung von Parameterwerten und zur Steuerung der Geometrie der Familie verwendet werden können. Darüber hinaus wird in der Beispielfamilie die Syntax für häufig verwendete Formeltypen gezeigt.

Die erweiterte Beispielfamilie (rac_advanced_sample_family.rfa) wird zusammen mit dem Produkt im folgenden Verzeichnis installiert: %ProgramFiles%\Autodesk\Autodesk Revit 2022\Samples. Online-Benutzer können die Datei auch von der Seite mit den Beispielfamiliendateien herunterladen.

Die erweiterte Beispielfamilie ist ein Sonnenschutz, der über einem oder mehreren Fenstern im Projekt angebracht werden kann. Der Benutzer definiert die Parameter für das Verhältnis von Sonnenschutzfamilie und Fenster. Die Geometrie des Sonnenschutzes wird mithilfe von Formeln so angepasst, dass wie gewünscht Schatten auf das Fenster fällt. Die folgenden Abbildungen zeigen 3D-Ansichten und Ansichten der Sonnenschutzfamilie im Projekt.

Einfache Berechnung

Diese Beispiele verdeutlichen einfache mathematische Funktionen in Formeln.

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

• Der Parameter Shadow_Length wird durch Subtraktion der Brüstungshöhe von der Installationshöhe der Familie berechnet.
• Das Ergebnis ist die Schattenlänge, die benötigt wird, damit das Lamellensystem das Fenster vollständig beschatten kann.
• Der Parameter Rel_Angle wird durch Subtraktion des Sonnenwinkels von einer Konstanten mit dem Wert 90 berechnet.

  Dieser Parameter wird später in einer weiteren Formel verwendet, in der mithilfe trigonometrischer Funktionen die Länge der Haltekonstruktion berechnet wird, die für einen Schatten mit der im Parameter Shadow_Length definierten Länge erforderlich ist.

• Für die Berechnung von Max Louver Spacing werden die Länge der Haltekonstruktion und der benötigte Anteil beschatteter Fläche zugrunde gelegt.
• Die Formel konvertiert zuerst einen Prozentwert in einen Dezimalwert und multipliziert diesen mit der Länge der Haltekonstruktion. Der resultierende Wert wird ist der Anteil des Sonnenschutzes, der mit Lamellen abgedeckt sein muss.

Rundungs- und trigonometrische Funktion

Die Länge der Haltekonstruktion wird mithilfe einer trigonometrischen Funktion berechnet und auf den nächsten Millimenter gerundet.

Parameter	Formel
Support_Length	roundup((Shadow_Length/1mm)*tan(Rel_Angle))*1mm

• Der erforderliche Wert für Support_Length ist eine Funktion von Shadow_Length multipliziert mit der Tangente für den relativen Winkel der Sonne zum Sonnenschutz, wobei die Jahreszeit und der Standort des Projekts zugrunde gelegt werden.

  Die für eine vollständige Beschattung des Fensters erforderliche Länge der Haltekonstruktion ist in Abhängigkeit von diesen variablen Bedingungen veränderlich.

• Die Rundungsfunktion übernimmt den berechneten Wert und rundet ihn auf den nächsten Millimeter. Diese Funktion kann nur für Zahlen ohne Einheiten verwendet werden.
• In der Beispielformel werden die Längeneinheiten aus dem Parameter Shadow_Length entfernt, indem dieser zuerst durch 1 mm dividiert und anschließend die Berechnung durchgeführt wird.
• Nachdem der Zahlenwert auf den nächsten Millimeter gerundet wurde, werden die Einheiten durch Multiplizieren mit 1 mm wieder hinzugefügt.

Bedingungsanweisungen

Bedingungsanweisungen können in einer Formel dazu verwendet werden, die Werte anderer Parameter zu prüfen und Ergebnisse anhand dieser Werte auszugeben. Weitere Informationen finden Sie unter Verwenden von Bedingungsanweisungen in Formeln. In diesem Beispiel ist der Parameter Support_Hanger ein Ja/Nein-Parameter, der die Sichtbarkeit einer zusätzlichen Haltekonstruktion für den Sonnenschutz steuert.

Parameter	Formel
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.")))

• Sobald der Wert von Support_Length 400 mm überschreitet, gilt die Anweisung als "true", der Parameter nimmt den Wert Ja an, und die zusätzliche Haltekonstruktion wird eingeblendet.

  Wenn in einer Formel ein Ja/Nein-Parameter mithilfe einer Bedingungsanweisung definiert wird, werden die Ergebnisse für "true" und "false" der Anweisung automatisch bestimmt, d. h., sie müssen nicht eigens in die Syntax der Formel geschrieben werden.

• Der Parameter Shade_Factor verwendet eine verschachtelte Bedingungsanweisung, um 1 von 4 Ergebnissen zurückzugeben: Niedrig, Med., Hoch oder Max.
• Die Überprüfung erfolgt anhand von Desired_Shading_Percent, und der Ergebnistext wird auf Basis dieses Werts ausgegeben.
• Jede weitere IF-Anweisung wird geprüft. Wenn die Bedingung nicht zutrifft, wird die nächste IF-Anweisung geprüft, bis ein Ergebnis mit dem Wert "true" gefunden wird.

Reihenformel

Reihen in Familien können mithilfe von Ganzzahlparametern gesteuert werden. Wenn die Reihe durch eine Formel gesteuert wird, muss durch entsprechende Syntax in der Formel sichergestellt werden, dass der Wert der Reihe immer größer als 1 ist. (Werte von Reihen müssen immer größer als 1 sein.)

Parameter	Formel
Number of Supports	(Length/Max_Support_Spacing)+1
Louver Number	(Support_Length/Max Louver Spacing)+1

• Der Parameter Number of Supports ist eine einfache mathematische Funktion, mit deren Hilfe die Anzahl der benötigten Halterungen anhand der Angaben zum Abstand und zur Gesamtlänge des Sonnenschutzes ermittelt wird.
• Louver Number erstellt anhand der Länge der Haltekonstruktion und des Lamellenabstands einen Reihenwert für die Platzierung der Lamellen im Sonnenschutz.
• Beide Formeln enthalten einen zusätzlichen Eintrag "+ 1" um sicherzustellen, dass der Wert der Reihe immer mindestens 2 beträgt.
• Da beide Parameter in diesem Fall als ganzzahlige Parameter definiert wurden, muss die Rundungsfunktion nicht in die Formeln aufgenommen werden.