Revit2019公式应用案例

高级样例族包含不同种类的公式示例，演示了公式如何用于计算参数值并控制族的几何图形。 样例族还说明了常用公式类型的语法。

高级样例族 (rac_advanced_sample_family.rfa) 随产品一起安装在以下目录：%ProgramFiles%\Autodesk\Autodesk Revit 2019\Samples. 联机用户也可以从样例族文件页面下载文件。

高级样例族是放置于窗上方或项目中窗上的遮阳装置。 用户定义遮光罩族与窗口关联方式的参数。 遮光罩的几何图形将根据公式进行修改以提供窗口遮阳。 以下图像显示了项目中遮光罩族的三维和立面视图。

基本数学

这些示例演示了公式中的基本数学函数。

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”是通过支座的长度和所需的遮阳物而计算得出的。  

• 公式首先将百分比转换为小数值，然后将该值乘以支座长度。 结果值即为用天窗覆盖所需的遮阳量。  

舍入和三角函数

支座长度是由三角函数计算得出的，然后向上舍入为最接近的毫米 (mm)。

Support_Length

roundup((Shadow_Length/1mm)*tan(Rel_Angle))*1mm

• 所需的 Support_Length 是一个函数，由 Shadow_Length 乘以阳光与遮阳装置相对角度的正切（根据一年中的时间和项目的位置）。

  这些变量条件将更改所需支座的必须长度以实现窗口彻底遮阳。

• 舍入函数获取计算的值并将其舍入到最接近的 mm。 对于要使用的舍入函数，要舍入的数字必须为无单位。  

• 在示例公式中，长度单位公式从 Shadow_Length 参数中删除，方法是首先将参数除以 1mm，然后再进行计算。  

• 在数字舍入为最接近的毫米时，单位将乘以 1mm 再添加回数字。  

条件语句

在公式中可以使用条件语句来检查其他参数的值并根据这些值返回结果。 有关其他信息，请参见在公式中使用条件语句。 在该示例中，Support_Hanger 参数为 "Yes/No" 参数，用于控制遮光罩附加支座的可见性。

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 参数超出 400mm，则语句为真，该参数值设置为“Yes”并且其他支座将可见。

  如果在公式中使用条件语句来定义 Yes/No 参数，则结果“如果真”和结果“如果假”为隐含，无法按照公式的语法写入。

• Shade_Factor 参数使用嵌套条件语句以得到 1 个结果（共 4 个结果），包括 低、中、高或最大。  

• 检查根据 Desired_Shading_Percent 完成，并且基于此值，返回文本结果。  

• 每个连续的 IF 语句都处于选中状态。 如果条件不为真，则接下来的 IF 语句为估值，直到得到真实的结果。  

阵列公式

族中的阵列可使用整数参数进行控制。 如果阵列由公式控制，则公式必须包含语法来确保阵列值始终大于 1（阵列值必须始终大于 1）。

Number of Supports

(Length/Max_Support_Spacing)+1

Louver Number

(Support_Length/Max Louver Spacing)+1

• Number of Supports 参数是基本数学函数，用于根据间距信息查找所需的支座数量和着色图元的总计长度。  

• Louver Number 创建阵列值以根据支座的长度和百叶窗所需的间距来将百叶窗放置到遮光罩中。  

• 两种公式中都包含附加的 " + 1"，以确保阵列值始终至少为 2。  

• 由于此例中的这两个参数都定义为整数参数，公式中无需包含舍入函数。