Comece pelo conceito
Três tipos de família, três finalidades
No Revit, todo elemento pertence a uma família. A primeira decisão é entender se o conteúdo deve nascer dentro do projeto ou existir como um arquivo reutilizável.
| Tipo | Como funciona | Quando usar | Atenção |
|---|---|---|---|
| Família de sistema | Faz parte do ambiente do projeto, como paredes, pisos, coberturas e dutos. | Elementos fundamentais que dependem do comportamento nativo do Revit. | Não é salva como um arquivo RFA independente. |
| Família carregável | É criada em um arquivo RFA e pode ser carregada em vários projetos. | Portas, equipamentos, conexões, mobiliário, símbolos, carimbos e componentes padronizados. | O template escolhido define comportamentos que podem ser difíceis de alterar depois. |
| Família no local | É modelada dentro do projeto e responde ao contexto daquele arquivo. | Uma geometria única, sem expectativa real de reutilização. | Possui apenas um tipo e o uso repetido prejudica padronização e desempenho. |
Decisão estrutural
Escolha o template pelo comportamento
A categoria informa o que o objeto representa. O template determina como ele será criado, hospedado e colocado. Escolha primeiro o comportamento necessário e depois confirme a categoria.
Parte de um nível e pode ser colocado livremente. É uma base flexível para componentes 3D que não dependem de parede, piso, teto ou face.
Pode ser colocado em um plano nomeado ou em uma face escolhida como plano. Uma família não hospedada pode receber esse comportamento; portas e janelas hospedadas em parede não podem.
É colocado sobre superfícies com qualquer orientação e pode acompanhar alterações da face. É útil para equipamentos, acessórios e componentes que precisam funcionar em diferentes hospedeiros.
Exige o hospedeiro correspondente no projeto. Use quando o componente realmente depende desse sistema e precisa acompanhar sua espessura ou abertura.
O comprimento é definido por dois pontos durante a colocação. Funciona bem para elementos lineares repetitivos.
Usa pontos adaptativos para responder a superfícies e geometrias complexas no ambiente conceitual.
Portas, janelas, pilares, estruturas, conexões MEP e outros conteúdos podem exigir recursos próprios do template. Não substitua um template especializado apenas por um modelo genérico.
Itens de detalhe, perfis, anotações, identificadores e carimbos têm comportamento gráfico e finalidade diferentes das famílias de modelo.
Modelo genérico não significa “sem regras”. É uma categoria ampla. A família ainda pode ser livre, baseada em face, linha ou plano de trabalho, conforme o template e suas propriedades.
Ordem de trabalho
Construa de dentro para fora
- 01Planeje
Defina uso, categoria, hospedagem, origem, tamanhos, vistas, nível de detalhe, parâmetros e dados que precisam aparecer em tabelas.
- 02Escolha o template
Confirme como o componente será colocado e se precisa cortar, acompanhar ou depender de um hospedeiro.
- 03Defina origem e referências
Crie planos e linhas de referência nomeados, com prioridades coerentes para alinhamento, cotagem e encaixe no projeto.
- 04Cote e parametrize o esqueleto
Rotule as cotas entre referências e teste os valores antes de modelar a forma final.
- 05Crie tipos
Monte as principais combinações de tamanho e propriedades que serão oferecidas ao usuário.
- 06Modele em etapas
Adicione sólidos e vazios gradualmente, sempre vinculados ao esqueleto de referências.
- 07Controle representação
Defina subcategorias, materiais, visibilidade por vista e nível de detalhe, além da representação 2D necessária.
- 08Flexione sempre
Altere tipos e parâmetros a cada etapa. Corrigir uma restrição cedo é muito mais simples do que desmontar a família pronta.
- 09Teste no projeto
Carregue em um arquivo de teste, use os hospedeiros reais, gere tabelas e verifique rotação, espelhamento e materiais.
- 10Documente e publique
Padronize o nome, elimine conteúdo desnecessário e registre finalidade, versão e parâmetros essenciais.
Caixa de ferramentas
O que cada recurso resolve
Referências
Planos de referência organizam largura, altura, eixos, origem e encaixes. Linhas de referência acrescentam direção e rotação. Prefira restringir a geometria às referências.
Cotas e rótulos
Cotas estabelecem relações. Ao receber um rótulo, tornam-se controláveis por parâmetros de Tipo, Instância ou Relatório.
Sólidos e vazios
Extrusão, mescla, revolução, varredura e mescla por varredura constroem a forma. Vazios recortam a geometria da família e, quando permitido, o hospedeiro.
Representação 2D
Linhas simbólicas, regiões de máscara e componentes de detalhe simplificam plantas e elevações sem carregar toda a geometria 3D.
Subcategorias e materiais
Subcategorias entregam controle gráfico no projeto. Parâmetros de material permitem variação sem duplicar geometria.
Visibilidade
Controle por vista, direção e níveis Baixo, Médio e Alto. Modele apenas o detalhe necessário em cada escala de documentação.
Famílias aninhadas
Reutilizam componentes e simplificam matrizes. Quando marcadas como compartilhadas, podem ser selecionadas, identificadas e tabeladas separadamente no projeto.
Conectores MEP
Definem domínio, tamanho, direção e ligação ao sistema. Posicione-os em faces adequadas e confira orientação e conector principal.
Catálogos e lookup
Catálogos de tipos carregam apenas combinações necessárias. Tabelas CSV e size_lookup atendem famílias de tubos e eletrodutos com muitas dimensões.
Estrutura de dados
Hierarquia dos parâmetros
Duas listas chamadas “grupo” têm funções diferentes. Entender essa separação evita inserir o parâmetro certo no lugar errado.
- 1Arquivo de parâmetros compartilhados
Arquivo TXT externo que armazena grupos e definições reutilizáveis.
- 2Grupo de definições do arquivo
Organiza os parâmetros dentro do TXT. Esse grupo não determina onde o parâmetro aparecerá na família.
- 3Definição compartilhada
Reúne nome, identificador GUID, disciplina e tipo de dado. O GUID mantém a identidade do parâmetro entre famílias e projetos.
- 4Inserção na família
Ao adicionar a definição, escolha “Agrupar parâmetro em” e se o valor será de Tipo ou Instância.
- 5Grupo de propriedades
Controla o cabeçalho de exibição, como Restrições, Cotas, Construção, Materiais e acabamentos ou Dados de identidade.
- 6Valor, fórmula ou associação
O parâmetro pode receber valor direto, fórmula ou associação com um parâmetro de uma família aninhada.
Como organizar “Agrupar parâmetro em”
| Grupo de propriedades | Use para | Exemplos |
|---|---|---|
| Restrições | Regras que controlam posicionamento e comportamento geométrico. | Deslocamento, bloqueio, plano de trabalho. |
| Cotas | Dimensões principais e resultados dimensionais. | Largura, altura, raio, diâmetro. |
| Construção | Características de montagem ou fabricação. | Espessura, composição, método. |
| Materiais e acabamentos | Materiais controláveis e informações de acabamento. | Material do corpo, acabamento. |
| Dados de identidade | Identificação, classificação e rastreabilidade. | Código, fabricante, descrição, modelo. |
| Grupos técnicos | Dados específicos da disciplina quando disponíveis. | Elétrica, Mecânica, Estrutural, IFC. |
Os grupos disponíveis variam conforme versão, categoria e tipo de parâmetro. Use o grupo mais próximo do significado do dado e mantenha a mesma convenção em toda a biblioteca.
Qual tipo de parâmetro escolher
Existe dentro da família e controla geometria ou dados locais. Não possui identidade compartilhada para uso consistente em tags e tabelas de vários conteúdos.
Usa uma definição externa com GUID. É a escolha adequada quando o dado precisa ser identificado, tabelado, etiquetado ou reutilizado de forma padronizada.
É fornecido pelo próprio Revit conforme a categoria e o template. Seu comportamento não é definido pelo arquivo compartilhado.
Regra de decisão
Tipo ou Instância?
Muda todas as peças iguais
Use quando o valor representa uma configuração do produto. Alterar um tipo atualiza todas as instâncias daquele tipo.
- Dimensões padronizadas
- Material de catálogo
- Código de modelo
- Potência nominal
Muda apenas o elemento selecionado
Use quando cada peça pode receber um valor próprio após ser colocada no projeto.
- Identificação única
- Deslocamento ajustável
- Comentário de montagem
- Parâmetro de relatório
Pergunta prática: se o usuário mudar o valor, todos os exemplares iguais devem acompanhar? Se sim, use Tipo. Se não, use Instância. Parâmetros de relatório são necessariamente de Instância.
Referência rápida
Fórmulas aceitas pelo Revit
Digite a expressão na coluna Fórmula, sem repetir o nome do parâmetro. Os nomes são sensíveis a maiúsculas e minúsculas, e a Autodesk recomenda evitar hífen nos nomes.
| Categoria | Sintaxe | Uso | Exemplo |
|---|---|---|---|
| Aritmética | + - * / ^ | Soma, subtração, multiplicação, divisão e potência. | Altura_total - 2 * Espessura |
| Constante | pi | Razão entre circunferência e diâmetro. | pi * Raio ^ 2 |
| Raiz e módulo | sqrt(x)abs(x) | Raiz quadrada e valor absoluto. | sqrt(Area) |
| Logaritmos | log(x)ln(x)exp(x) | Logaritmo decimal, logaritmo natural e constante e elevada a x. | ln(Fator) |
| Trigonometria | sin(x)cos(x)tan(x) | Seno, cosseno e tangente. A entrada deve ser um ângulo. | Comprimento * sin(Angulo) |
| Trigonometria inversa | asin(x)acos(x)atan(x) | Arco seno, arco cosseno e arco tangente. A razão de entrada é sem unidade. | atan(Altura / Comprimento) |
| Arredondamento | round(x)roundup(x)rounddown(x) | Arredonda para o inteiro mais próximo, para cima ou para baixo. | roundup(Comprimento / 100 mm) * 100 mm |
| Comparação | < > = | Compara valores em condições. Para “menor ou igual”, use not(a > b); para “maior ou igual”, use not(a < b). | Largura > 1000 mm |
| Lógica | and(a, b)or(a, b)not(a) | Combina ou inverte condições. | and(Largura > 600 mm, Altura > 1200 mm) |
| Condição | if(condição, verdadeiro, falso) | Retorna um dos dois resultados. Ambos precisam ter o mesmo tipo de dado. | if(Largura > 1000 mm, 2, 1) |
| Sim/Não | condição | Um parâmetro Sim/Não pode receber diretamente uma expressão lógica. | Quantidade > 1 |
| Texto condicional | if(condição, "texto A", "texto B") | Retorna textos literais conforme a condição. | if(Exibir_alca, "Com alça", "Sem alça") |
| Tabela de consulta | size_lookup(...) | Lê valores numéricos ou de texto de uma tabela CSV incorporada, especialmente em famílias de tubos e eletrodutos. | size_lookup(Tabela, "Diametro", Padrao, DN) |
Regras de unidades
- Na soma e na subtração, entradas e resultado devem usar o mesmo tipo de unidade.
- Na multiplicação, a unidade do resultado deve corresponder ao produto das entradas, como comprimento × comprimento = área.
- Funções trigonométricas recebem ângulo e retornam um número sem unidade.
- Em
if, o primeiro argumento é lógico; os dois resultados devem ter o mesmo tipo de dado. - Informe unidades nas constantes, como
25 mm, para evitar que o Revit precise inferi-las.
Evite retrabalho
Limitações e erros comuns
Template e hospedeiro não são escolhas cosméticas
Uma família dependente de parede precisa desse hospedeiro para ser colocada. Não conte com uma conversão simples para outro tipo de hospedagem depois que a biblioteca estiver pronta.
Restringir geometria diretamente torna a família frágil
Alinhe e bloqueie a geometria em planos ou linhas de referência. Restrições de geometria com geometria podem falhar quando os parâmetros mudam.
Fórmula não é uma planilha completa
O Revit oferece matemática, trigonometria, lógica e condições, mas não oferece loops, funções personalizadas ou um conjunto amplo de funções de texto. Evite cadeias longas de condições quando tipos bem definidos resolvem o problema.
Unidades incompatíveis impedem o cálculo
Comprimento, área, volume, ângulo e números sem unidade seguem análise dimensional. Uma fórmula pode estar matematicamente correta e ainda ser inválida para o tipo do parâmetro.
Geometria excessiva custa desempenho
Detalhes invisíveis na escala do projeto, importações pesadas, muitos vazios e aninhamentos profundos aumentam o tamanho do arquivo e o tempo de regeneração.
Família aninhada compartilhada muda a leitura no projeto
Quando compartilhada, a família interna pode ser selecionada, identificada e tabelada separadamente. Quando não compartilhada, participa do conjunto como parte da família hospedeira.
“Não é possível criar o tipo” tem várias causas
Procure restrições conflitantes, valores negativos, perfis que se cruzam, faces muito pequenas, vazios inválidos, matrizes mal restringidas e diferenças entre o hospedeiro de teste e o hospedeiro real.
Antes de distribuir
Checklist de uma família confiável
Aprofundamento
Fontes oficiais consultadas
O conteúdo foi revisado com a documentação oficial da Autodesk. Os documentos fornecidos pelo BIM Guaxinim foram usados como referência de pauta; nomes, parâmetros e exemplos internos foram substituídos por exemplos genéricos.