Skip to Content
📚 Guia do usuário da Catena Build agora tem site próprio.
Script IFC com IA

Script IFC com IA

No visualizador 3D, Script IFC com IA edita o modelo aberto ou extrai uma tabela a partir de um pedido em português. A IA escreve um script em JavaScript e a vista executa sozinha. A pessoa lê, ajusta e pode dar Play de novo. O IFC novo só nasce no botão Baixar IFC, e vai para a máquina — não entra no projeto e não cria versão.

Cada play relê o IFC original e roda o script inteiro. A corrida anterior não acumula. O arquivo dessa versão fica no servidor depois da primeira leitura; as seguintes não baixam de novo. Mudar o texto depois do play exige um play novo antes de baixar.


Onde fica e quem usa

O botão fica na barra do viewer, no mesmo bloco de estrutura e níveis. Some para quem só visualiza.

AçãoProprietário e coordenadorMembro
Pedir script, editar, dar play, baixar IFC e planilhasimsim
Gravar, renomear e apagar na biblioteca do projetosimnão

A biblioteca guarda nome, texto, autor e datas. O nome é único no projeto. Carregar copia o texto para o painel; editar depois não grava sozinho. Um .js local reabre no painel e também não dá play.

O chat fica no painel da direita. Dá para anexar uma imagem (jpeg, png, webp ou gif, até quatro, 4 MB cada) arrastando, colando ou pelo botão. O seletor de modelos aceita um, vários ou todos os que estão ligados na vista. O play aplica o script em cada um marcado. Ocultar outros modelos vem marcado e esconde os que ficaram de fora. Fechar o painel guarda o chat e o script nesta sessão do navegador. A imagem não entra nessa gravação.

O script abre num painel ao lado. Carregar fica ao lado do título e copia um texto da biblioteca. Salvar fica ao lado e grava na biblioteca do projeto. Buscar no código encontra um texto no script, e Copiar fica ao lado. Desfazer e Refazer voltam uma edição manual. O resultado fica embaixo, fechado, e abre quando a corrida começa. No rodapé dele ficam a frase das alterações, Ver tabela (com busca e ordenação crescente ou decrescente), Baixar XLS e Baixar IFC, quando a corrida produziu aquilo. Descartar limpa a corrida. Parar interrompe a IA ou o play. O painel de propriedades abre ao lado, sem fechar a bancada.


O ciclo

  1. A pessoa descreve o pedido. Se for uma pergunta, a IA lê o elemento aberto quando precisa, só comenta e oferece gerar o script. A leitura e a prévia têm limite: depois disso a IA responde sem olhar de novo. Se o pedido é alterar um texto, código ou nome, a IA testa o script no primeiro modelo e olha um recorte da tabela antes de entregar. A vista executa só a versão final. Desfazer naquela fala tira o trecho e os pedidos seguintes. Parar corta a resposta ou a corrida.
  2. O play lê o original, executa o script e mostra a tabela, os avisos e as mensagens. Dá para cancelar.
  3. Se o script pintou elementos, a cor entra na vista já carregada. Se gravou ou apagou propriedade, a janela de propriedades mostra essa camada. As duas somem ao Descartar a corrida. O arquivo do projeto continua o original.
  4. Se o script terminou numa tabela, Ver tabela abre a grade e Baixar XLS leva a planilha.
  5. Baixar IFC roda o script de novo a partir do original e grava o arquivo editado na máquina. O painel deixa isso escrito.

O que dá para pedir

O script usa a ponte bim. A pessoa não precisa escrever o método: pede em português. A lista abaixo é o que a ponte aceita neste painel.

Consultar e extrair

Não altera o modelo. A última expressão do script é a tabela { columns, rows }.

PedidoMétodo
Todos os elementos, ou só um tipo (IfcWall, IfcDoor…)all, byType
Um elemento pelo identificadorentity
Atributos de raiz (Name, Description, ObjectType, Tag)attributes
Psets e uma propriedadeproperties, property, typeProperties
Quantitativos e uma quantidadequantities, quantity
Classificação, material, documentosclassifications, materials, documents
Relações, contêiner, filhos, caminho até o projetorelationships, related, containedIn, contains, decomposedBy, decomposes, path
Pavimento do elemento, lista de pavimentosstorey, storeys

A seleção da vista e o filtro avançado do viewer não alimentam essa consulta.

Exemplos: listar quem ficou sem um pset, extrair quantitativo, auditar pendências, classificar e separar o que não entrou na regra.

Alterar propriedades

Entra no arquivo do botão Baixar IFC. A janela de propriedades já mostra a alteração durante o play.

PedidoMétodo
Preencher ou corrigir um pset ou quantidadesetProperty
Corrigir Name, Description, ObjectType ou TagsetAttribute
Apagar uma propriedadedeleteProperty
Desfazer ou refazer a última edição da corridaundo, redo

Exemplos: completar um pset a partir de outra propriedade, apagar psets de fabricante preservando os Qto_, normalizar o tipo do valor, anonimizar um campo.

Incluir, recortar e remover no modelo aberto

Também entra no arquivo do botão Baixar IFC. Medidas em metros, no pavimento indicado.

PedidoMétodo
Injetar ou remover uma entidadeaddEntity, removeEntity
Editar um argumento STEP por índicesetPositionalAttribute
Pilar, parede, laje, viga, porta, janela, espaço, cobertura, chapa, membroaddColumn, addWall, addSlab, addBeam, addDoor, addWindow, addSpace, addRoof, addPlate, addMember
Alinhar peças, unir paredesalignElements, joinWalls
Abrir vão, porta ou janela hospedada numa paredeaddOpening, addHostedDoor, addHostedWindow
Tipo IFC e associar tipo aos objetosaddElementType, assignType
Material, camadas e associar ao objetoaddMaterial, addMaterialLayerSet, addMaterialLayerSetUsage, assignMaterial
Orçamento no modelo (cronograma de custo, item, valor, quantidade e vínculos)addCostSchedule, addCostItem, addCostValue, addCostQuantity, nestCostItems, assignCostItemsToSchedule, assignToCostItem, setCostItemValues, removeCostEntity
Grupo e membrosreadGroup, addGroup, updateGroup, removeGroup

Criar um IFC do zero

bim.create monta outro arquivo dentro do script: projeto, pavimento, elementos, 4D e custo. O botão Baixar IFC não baixa esse arquivo. Ele baixa o modelo aberto, com as alterações de propriedade e de bim.store.

PedidoMétodo
Projeto e o texto STEP desse projetoproject, toIfc
Cor nomeada num elemento criado, antes de toIfcsetColor
PavimentoaddIfcBuildingStorey
Parede, laje, cobertura (plana ou duas águas), porta, janela, porta ou janela na paredeaddIfcWall, addIfcSlab, addIfcRoof, addIfcGableRoof, addIfcDoor, addIfcWindow, addIfcWallDoor, addIfcWallWindow
Pilar, pilar circular, pilar oco, viga, viga I, perfil retangular ocoaddIfcColumn, addIfcCircularColumn, addIfcHollowCircularColumn, addIfcBeam, addIfcIShapeBeam, addIfcRectangleHollowBeam
Fundação, estaca, escada, rampa, guarda-corpo, cortina, placa, mobiliário, proxy, membro e perfis L, T e UaddIfcFooting, addIfcPile, addIfcStair, addIfcRamp, addIfcRailing, addIfcCurtainWall, addIfcPlate, addIfcFurnishingElement, addIfcBuildingElementProxy, addIfcMember, addIfcLShapeMember, addIfcTShapeMember, addIfcUShapeMember
Qualquer tipo por eixo, por perfil, ou o posicionamento globaladdAxisElement, addElement, createProfile, getWorldPlacementId
EspaçoaddIfcSpace
Pset e quantitativo do elementoaddIfcPropertySet, addIfcElementQuantity
Material do elementoaddIfcMaterial
Cronograma 4D: plano, calendário, tarefa, sequência, produtos na tarefa, hierarquiaaddIfcWorkPlan, addIfcWorkSchedule, addIfcWorkCalendar, addIfcTask, addIfcRelSequence, assignTasksToWorkSchedule, assignSchedulesToWorkPlan, assignCalendarToTasks, assignProductsToTask, nestTasks
Custo (IFC4 / IFC4X3): cronograma, item, valor, unidade, quantidade e vínculosaddIfcCostSchedule, addIfcCostItem, addIfcCostValue, addIfcSIUnit, addIfcPhysicalQuantity, addIfcMonetaryUnit, addIfcMeasureWithUnit, assignCostItemsToSchedule, assignCostItemsToProduct, assignTasksToCostItem, nestCostItems

Pintar a vista

colorize e colorizeAll pintam os elementos na vista já carregada. resetColors limpa essa pintura. A cor não entra no arquivo. Some ao descartar a corrida.

Exemplo: pintar de vermelho o que for água quente.

hide, show, isolate e resetVisibility mudam a vista desta corrida e não gravam no arquivo. A câmera não se move: flyTo e setCamera não chegam ao viewer.


Referência do script

O script começa com um comentário que aponta para esta página. Quem copia o texto e leva para outra IA usa o bloco e esta seção como contrato. A linguagem é JavaScript, não TypeScript. Não há import. O runtime é QuickJS, pela ponte global bim do pacote @ifc-lite/sandbox (IFClite). A página que descreve o painel é docs.catena.build/script-ifc .

/* * Script IFC — Catena * Linguagem: JavaScript, não TypeScript. Roda no painel Script IFC com IA, * em QuickJS, pela ponte global bim do @ifc-lite/sandbox. * Referência: https://docs.catena.build/script-ifc * Modelo: não fixe modelId. Use entidade.ref.modelId. Cada play relê o IFC original. * Usa: bim.query, bim.mutate, bim.viewer * Tabela: a última expressão é ({ columns, rows }). Sem return. */

A linha Usa lista só o que o arquivo chama.

O modelo não fica no texto

Não existe const modelId = '...'. Um id preso ao arquivo impede o mesmo script em outro modelo. A entidade de bim.query traz ref, e ref é { modelId, expressId }. Quando entity, addMaterial ou outro método pede o id, a fonte é entidade.ref.modelId.

const paredes = bim.query.byType('IfcWall') const modelId = paredes[0] && paredes[0].ref.modelId const uma = modelId ? bim.query.entity(modelId, paredes[0].ref.expressId) : null

byType recebe cada tipo como argumento, não um array: bim.query.byType('IfcWall', 'IfcWallStandardCase').

O que a entidade e as leituras devolvem

LeituraForma
Entidaderef, globalId, name / Name, type / Type, description, objectType / ObjectType
properties(entidade)Lista de psets e também props.NomeDoPset.NomeDaPropriedade
typeProperties(entidade)O mesmo mapa de psets, mais typeName e typeId, ou null
attributes(entidade)Lista { name, value } e também attrs.Name, attrs.ObjectType
relationships(entidade).groups{ id, name, type } dos grupos, inclusive IfcSystem e IfcDistributionSystem

No play da Catena os dois acessos convivem: percorrer a lista ou ler pelo nome. Object.keys em properties devolve o nome do pset. Uma lista de ids, como RelatedObjects, vem em attributes. Em chave e valor, a chave não é variável: { pintar: true } está certo; { pintar } lê a variável pintar.

A família do elemento é ObjectType ou Name. O sistema ligado a ele está em relationships(entidade).groups, não nos attributes de IfcRelAssignsToGroup.

O que muda a vista e o que entra no arquivo

EfeitoOnde apareceEntra no Baixar IFC
setProperty, setAttribute, deletePropertyJanela de propriedades, nesta corridasim
bim.store (material, vão, entidade nova)Arquivo baixadosim
colorize, colorizeAllVista já carregada. Cor em '#rrggbb'não
hide, show, isolate, resetVisibilityVista desta corridanão
Última expressão ({ columns, rows })Tabela do resultado e o XLSnão

Sem os parênteses, o JavaScript lê um bloco e a tabela não volta. Não use return: o script não está dentro de uma função. Não chame bim.export. Não chame play nem download de dentro do script.

deleteProperty apaga um nome. Para o pset sumir da janela, apague cada nome dele. bim.create monta outro arquivo dentro do script; Baixar IFC não entrega esse arquivo.

O que outra IA precisa respeitar

  • JavaScript puro. Sem tipo, sem as, sem interface.
  • Só os métodos desta página. Não invente namespace nem ifcopenshell.
  • Não fixe modelId, expressId de um arquivo nem nome de pset que não esteja no modelo.
  • Cada play recomeça do original. Uma corrida não herda a anterior.
  • Comentários em português. O bloco do topo permanece, com a linha Usa atualizada.

O que este painel não faz

  • Não publica versão nova no CDE e não reprocessa a geometria do viewer.
  • Não chama bim.export de dentro do script. O download é o botão Baixar IFC.
  • Não move a câmera. flyTo e setCamera não chegam à vista.
  • Não acumula uma corrida na seguinte.
  • Não executa Python nem ifcopenshell.
  • Não substitui a checagem IDS: IDS valida a entrega; este painel edita ou lista o que está no arquivo.