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 2022\Samples. Usuários on-line também pode efetuar o download do arquivo da 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 em 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 ao obter a altura de montagem da família e ao subtrair 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 a partir de uma constante, 90.

  Este 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 é necessária.
• A fórmula primeiro converte um percentual para um valor decimal e, a seguir, multiplica este 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.

  Estas condições variáveis irão alterar 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 ao dividir o parâmetro por 1 mm e, a seguir, 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 ao multiplicar por 1 mm.

Declarações condicionais

As declarações condicionais podem ser utilizados 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 é verdadeira, o valor do parâmetro é 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 utiliza uma declaraçã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 neste 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. Quando a matriz é controlada com uma fórmula, a fórmula deve conter sintaxe para garantir que o valor da matriz seja sempre maior do que um valor (um valor de matriz deve sempre ser maior do que 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 utilizada 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.