Przykłady wzorów

Można przejrzeć przykłady wzorów używanych do obliczenia wartości parametrów w rodzinie.

Zaawansowana rodzina przykładowa zawiera różne rodzaje wzorów. Za jej pomocą przedstawiono, jak można używać wzorów do obliczania wartości parametru i sterować geometrią rodziny. Pokazano również składnię najczęściej używanych typów wzoru.

Zaawansowana rodzina przykładowa (rac_advanced_sample_family.rfa) jest instalowana wraz z produktem w następującym katalogu: %ProgramFiles%\Autodesk\Autodesk Revit 2026\Samples. W trybie online można także pobrać plik ze strony Przykładowe pliki rodzin.

W projekcie jako zaawansowanej rodziny przykładowej użyto elementu zacienienia umieszczonego nad oknem lub oknami. Użytkownik definiuje parametry sposobu odniesienia rodziny zacienienia do okna. Na podstawie wzorów geometria cienia jest modyfikowana w celu zapewnienia zacienienia okna. Poniższe obrazy przedstawiają widoki elewacji i 3D rodzin zacienienia w projekcie.

Podstawowe funkcje matematyczne

Przykłady przedstawiają podstawowe funkcje matematyczne we wzorach.

Parametr	Wzór
Shadow_Length	Mounting_Height-Window_Sill_Height
Rel_Angle	90º-Sun_Angle
Max Louver Spacing	Support_Length-(Support_Length*(Desired_Shading_Percent*0.01))

• Parametr Shadow_Length jest obliczany poprzez odjęcie wysokości parapetu od wysokości montażowej.
• Wynikiem jest długość cienia potrzebnego w systemie żaluzji do całkowitego zacienienia okna.
• Parametr Rel_Angle jest obliczany poprzez odjęcie kąta podania słońca od stałej o wartości 90.

  Parametr ten zostanie później zastosowany w innym wzorze, w którym używana jest funkcja trygonometryczna, w celu obliczenia długości podpory potrzebnej do zacienienia długości zdefiniowanej za pomocą parametru Shadow_Length.

• Parametr Maksymalna odległość między żaluzjami obliczany jest na podstawie długości podpory i powierzchni wymaganego cienia.
• We wzorze najpierw wartość procentowa jest przekształcana na wartość dziesiętną, a następnie ta wartość jest mnożona przez długość podpory. Wynikiem jest powierzchnia cienia, który zostanie utworzony przez żaluzje.

Funkcja zaokrąglania i funkcja trygonometryczna

Długość podpory jest obliczana za pomocą funkcji trygonometrycznej, a następnie zaokrąglana (w mm) do najbliższej liczby całkowitej.

Parametr	Wzór
Support_Length	roundup((Shadow_Length/1mm)*tan(Rel_Angle))*1mm

• Wymagany parametr Support_Length jest funkcją parametru Shadow_Length pomnożonego przez styczną względnego kąta padania słońca do elementu zacienienia, na podstawie pory roku i położenia projektu.

  Te zmienne warunki mają wpływ na zmianę żądanej długości podpory wymaganej do całkowitego zacienienia okna.

• Funkcja zaokrąglania umożliwia zaokrąglenie obliczonej wartości (w mm) do najbliższej liczby całkowitej. Liczba, która ma być zaokrąglona, nie powinna zawierać jednostek.
• Przed wykonaniem obliczeń w przykładowym wzorze jednostki długości zostały usunięte z parametru Shadow_Length poprzez podzielenie go przez 1 mm.
• Po zaokrągleniu liczby (w mm) do najbliższej liczby całkowitej jednostki są ponownie dodawane przez pomnożenie przez 1 milimetr.

Instrukcje warunkowe

Instrukcji warunkowych można używać we wzorze, aby sprawdzić wartości innych parametrów i obliczać wyniki na podstawie tych wartości. Dodatkowe informacje zawiera temat Używanie instrukcji warunkowych we wzorach. Na przykład parametr Support_Hanger jest parametrem typu Tak/Nie używanym do sterowania widocznością dodatkowej podpory cienia.

Parametr	Wzór
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.")))

• Gdy wartość parametru Support_Length przekracza 400 mm, instrukcja ma wartość Prawda, parametr ma wartość Tak oraz widoczne są dodatkowe podpory.

  Jeśli w przypadku używania we wzorze instrukcji warunkowych do definiowania parametru typu Tak/Nie, wyniki instrukcji Jeśli prawda lub Jeśli fałsz są przyjęte z góry i nie muszą być zapisywane w składni wzoru.

• W parametrze Shade_Factor używana jest zagnieżdżona instrukcja warunkowa w celu zapewnienia jednego z czterech wyników: Low, Med., High lub Max.
• Sprawdzenie odbywa się względem parametru Desired_Shading_Percent i na podstawie tej wartości otrzymywany jest wynik tekstowy.
• Sprawdzana jest każda kolejna instrukcja IF (Jeśli). Jeśli warunek nie jest spełniony, sprawdzana jest następna instrukcja IF, aż do momentu uzyskania wartości Prawda.

Wzór szyku

Szykami w rodzinie można sterować za pomocą parametru o wartości całkowitej.

Uwaga: Wzory używane w tej rodzinie przykładowej opracowano przed wydaniem programu Revit 2025. Przed wersją 2025 wzór musiał mieć określoną składnię zapewniającą, że wartość szyku zawsze będzie większa niż jeden. Wyjaśnia to, dlaczego każdy wzór w przykładach zawiera znak pozycję „+1”.

Parametr	Wzór
Number of Supports	(Length/Max_Support_Spacing)+1
Louver Number	(Support_Length/Max Louver Spacing)+1

• Parametr Liczba podpór stanowi podstawową funkcję matematyczną używaną do określenia liczby potrzebnych podpór na podstawie informacji o odległości i całkowitej długości elementu zacienienia.
• Parametr Liczba żaluzji umożliwia utworzenie wartości szyku w celu umieszczenia żaluzji w miejscu zacienienia na podstawie długości podpory i odległości między wymaganymi żaluzjami.
• Oba wzory zawierają dodatkowe działanie „+ 1” w celu zapewnienia, że wartość szyku wynosi zawsze co najmniej 2.
• Obydwa parametry w tym przypadku są zdefiniowane jako parametry całkowite, dlatego też nie ma potrzeby uwzględniania funkcji zaokrąglania we wzorach.