Exemplos de fórmulas

Revise os exemplos de como as fórmulas são usadas para calcular os valores para os parâmetros em uma família.

A família de amostra avançada contém exemplos dos diferentes tipos de fórmulas e demonstra como as fórmulas podem ser usadas para calcular os valores de parâmetros e controlar a geometria da família. A família de amostra também ilustra a sintaxe para os tipos de fórmula de uso comum.

A família de amostra avançada (rac_advanced_sample_family.rfa) é instalada com o produto neste diretório: %ProgramFiles%\Autodesk\Autodesk Revit 2026\Samples. Os usuários on-line também pode efetuar o download do arquivo na página Arquivos de família de amostra.

A família de amostra avançada é um dispositivo de sombreamento do sol colocado acima de uma janela ou janelas no projeto. O usuário define os parâmetros para como a família de sombra se relaciona com a janela. Com base nas fórmulas, a geometria da sombra é modificada para fornecer o sombreamento para a janela. As imagens a seguir mostram vistas 3D e vistas de elevação da família de sombras em um projeto.

Matemática básica

Estes exemplos demonstram as funções matemáticas básicas em fórmulas.

Parâmetro	Fórmula
Shadow_Length	Mounting_Height-Window_Sill_Height
Rel_Angle	90º-Sun_Angle
Max Louver Spacing	Support_Length-(Support_Length*(Desired_Shading_Percent*0.01))

• O parâmetro Shadow_Length é calculado obtendo a altura de montagem da família e subtraindo a altura do peitoril.
• O resultado é o comprimento da sombra necessária para que o sistema de difusores projete por completo a sombra na janela.
• O parâmetro Rel_Angle é calculado subtraindo-se o ângulo do sol de uma constante, 90.

  Esse parâmetro depois será usado em uma fórmula usando funções trigonométricas para calcular o comprimento de suporte necessário para projetar uma sombra no comprimento definido pelo parâmetro Shadow_Length.

• O Espaçamento máx. do difusor é calculado com base no comprimento que o suporte terá e quanta sombra será necessária.
• A fórmula primeiro converte um percentual num valor decimal e, em seguida, multiplica esse valor pelo comprimento do suporte. O valor resultante é o montante de sombra que precisa ser coberta com difusores.

Arredondamento e funções trigonométricas

O comprimento do suporte é calculado usando uma função trigonométrica e, a seguir, arredondado para o milímetro (mm) mais próximo.

Parâmetro	Fórmula
Support_Length	roundup((Shadow_Length/1mm)*tan(Rel_Angle))*1mm

• O Support_Length requerido é uma função de Shadow_Length multiplicado pelo tangente do ângulo relativo do sol para o dispositivo de sombreamento, com base na hora do ano e a localização do projeto.

  Essas condições variáveis alterarão o comprimento necessário de suporte para sombrear por completo a janela.

• A função de arredondamento pega o valor calculado e o arredonda para o mm mais próximo. Para que a função de arredondamento funcione, o número que será arredondado deve ser sem unidades.
• Na fórmula de exemplo, as unidades de comprimento são removidos do parâmetro Shadow_Length primeiro dividindo o parâmetro por 1 mm e, em seguida, executando o cálculo.
• Após o número é arredondado para o mm mais próximo, as unidades são adicionadas de volta para o número multiplicando por 1 mm.

Declarações condicionais

É possível usar as declarações condicionais em uma fórmula para verificar os valores de outros parâmetros e retornar os resultados com base nesses valores. Consulte Usar declarações condicionais em fórmulas para obter informações adicionais. No exemplo, o parâmetro Support_Hanger é um parâmetro Sim/Não usado para controlar a visibilidade de um suporte adicional para a sombra.

Parâmetro	Fórmula
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 o parâmetro Support_Length exceder 400 mm, a declaração será verdadeira, o valor do parâmetro será definido como “sim” e o suporte adicional estará visível.

  Quando uma declaração condicional é usada em uma fórmula para definir um parâmetro Sim/Não, o resultado se verdadeiro ou o resultado se falso são implícitos e não precisam ser escritos na sintaxe da fórmula.

• O parâmetro Shade_Factor usa uma instrução condicional aninhada para retornar 1 de 4 resultados, Baixo, Médio, Alto ou Máx.
• A verificação é executada de acordo com o Desired_Shading_Percent e, com base nesse valor, retorna o resultado do texto.
• Cada declaração IF sucessiva é verificada. Se a condição não for verdadeira, então a declaração IF é avaliada até que um resultado verdadeiro seja encontrado.

Fórmula da matriz

Matrizes em uma família podem ser controlados usando um parâmetro inteiro.

Nota: As fórmulas usadas na família de exemplo foram desenvolvidas antes da versão do Revit 2025. Antes da versão 2025, era necessário que a fórmula incluísse sintaxe específica, assegurando que o valor da matriz fosse sempre maior que um. Isso explica por que cada fórmula nos nossos exemplos inclui um “+1”.

Parâmetro	Fórmula
Number of Supports	(Length/Max_Support_Spacing)+1
Louver Number	(Support_Length/Max Louver Spacing)+1

• O parâmetro Número de suportes é uma função matemática básica usada para localizar o número de suportes necessários com base na informação de espaçamento e no comprimento total do elemento de sombreamento.
• O Número do difusor cria uma matriz de valor para colocar difusores na sombra com base no comprimento do suporte e no espaçamento dos difusores necessários.
• Ambas as fórmulas incluem um “+1” adicional para garantir que o valor da matriz sempre é pelo menos 2.
• Já que ambos os parâmetros neste caso são definidos como parâmetros inteiros , a função de arredondamento não precisa ser incluída nas fórmulas.