Примеры формул

Просмотрите примеры использования формул для вычисления значений параметров в семействе.

Пример сложного семейства содержит примеры различных формул и демонстрирует способ их использования для вычисления значений параметров и управления геометрией семейства. Пример семейства также иллюстрирует синтаксис наиболее часто используемых формул.

Пример сложного семейства (rac_advanced_sample_family.rfa) устанавливается вместе с программным продуктом в папке %ProgramFiles%\Autodesk\Autodesk Revit 2025\Samples. Онлайн-пользователи также могут скачать файл со страницы Файлы примеров семейств.

Пример сложного семейства — это солнцезащитное устройство, размещаемое поверх окон в проекте. Пользователь определяет параметры того, каким образом семейство навесов связано с окном. Геометрия навеса изменяется с помощью формул для обеспечения защиты окна от солнца. На следующих изображениях приведено семейство навесов в проекте на 3D-виде и виде фасада.

Основные математические функции

В этих примерах иллюстрируется использование в формулах основных математических функций.

Параметр	Формула
Shadow_Length	Mounting_Height-Window_Sill_Height
Rel_Angle	90º-Sun_Angle
Max Louver Spacing	Support_Length-(Support_Length*(Desired_Shading_Percent*0.01))

• Для вычисления параметра Shadow_Length из высоты монтажа семейства вычитается высота подоконника.
• В результате получается длина навеса, которую необходимо использовать для полного затенения окна.
• Для вычисления параметра Rel_Angle из константы 90 вычитается угол падения солнечных лучей.

  Этот параметр впоследствии будет использован в другой формуле с использованием тригонометрических функций для расчета длины опоры, необходимой для создания навеса, длина которого определяется параметром Shadow_Length.

• Параметр Max Louver Spacing вычисляется на основе длины опоры и необходимого размера навеса.
• Сначала формула преобразовывает процентное значение в десятичное, а затем полученное значение умножается на длину опоры. Полученное значение указывает, какая часть навеса должна быть закрыта жалюзи.

Функции округления и тригонометрические функции

Для расчета длины опоры используется тригонометрическая функция, а затем полученное значение округляется до миллиметров (мм).

Параметр	Формула
Support_Length	roundup((Shadow_Length/1mm)*tan(Rel_Angle))*1mm

• Требуемое значение параметра Support_Length получается в результате умножения значения Shadow_Length на тангенс относительного угла падения солнечных лучей на солнцезащитное устройство в зависимости от времени года и местоположения проекта.

  Эти переменные условия влияют на требуемую длину опоры, необходимую для полного затенения окна.

• Функция округления округляет вычисленное значение до ближайших миллиметров. Чтобы использовать функцию округления, округляемое значение должно быть безразмерным.
• В формуле примера единицы длины удалены из параметра Shadow_Length, для этого сначала значение параметра было разделено на 1 мм, после чего был выполнен расчет.
• После округления полученного значения до ближайших миллиметров оно умножается на 1 мм, чтобы вернуть единицы измерения.

Условные операторы

Использование условных операторов в формулах позволяет проверять значения других параметров и возвращать значения на основе этих параметров. Дополнительные сведения приведены в разделе Условные выражения для формул. В нашем примере параметр Support_Hanger является параметром типа «Да/нет», который используется для управления видимостью дополнительной опоры навеса.

Параметр	Формула
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.")))

• Если значение параметра Support_Length превышает 400 мм, оператор принимает значение «истина», параметру присваивается значение «да» и дополнительная опора становится видимой.

  Если в формуле используется условный оператор для определения параметра типа «Да/нет», результаты «если истина» и «если ложь» подразумеваются, и их можно не вносить в синтаксис формулы.

• В параметре Shade_Factor используется вложенный условный оператор, возвращающий один из четырех результатов: Low, Med., High или Max.
• Сравнение выполняется с параметром Desired_Shading_Percent и на основе этого значения возвращается текстовый результат.
• Проверяется каждый последующий оператор IF. Если условие не выполняется, то оценивается следующий оператор IF, пока не будет найден истинный результат.

Формулы для работы с массивами

Для управления массивами в семействе используется целочисленный параметр.

Прим.: Формулы, используемые в этом примере, были разработаны до выпуска Revit 2025. До версии 2025 необходимо было включить в формулу специальный синтаксис, чтобы значение массива всегда было больше единицы. Это объясняет, почему каждая формула в наших примерах содержит «+1».

Параметр	Формула
Number of Supports	(Length/Max_Support_Spacing)+1
Louver Number	(Support_Length/Max Louver Spacing)+1

• Параметр Number of Supports — это основная математическая функция, используемая для нахождения необходимого числа опор с учетом данных о расстоянии между ними и общей длины солнцезащитного элемента.
• Параметр Louver Number создает значение массива, позволяющее разместить жалюзи в навесе на основе требуемых значений длины опоры и расстояния между жалюзи.
• Обе формулы содержат дополнительный элемент «+1», который обеспечивает, что значение массива не опускается ниже 2.
• Поскольку в этом случае оба параметра определяются как целочисленные, включать в эти формулы функцию округления необязательно.