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ção | Proprietário e coordenador | Membro |
|---|---|---|
| Pedir script, editar, dar play, baixar IFC e planilha | sim | sim |
| Gravar, renomear e apagar na biblioteca do projeto | sim | nã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
- 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.
- O play lê o original, executa o script e mostra a tabela, os avisos e as mensagens. Dá para cancelar.
- 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.
- Se o script terminou numa tabela, Ver tabela abre a grade e Baixar XLS leva a planilha.
- 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 }.
| Pedido | Método |
|---|---|
Todos os elementos, ou só um tipo (IfcWall, IfcDoor…) | all, byType |
| Um elemento pelo identificador | entity |
| Atributos de raiz (Name, Description, ObjectType, Tag) | attributes |
| Psets e uma propriedade | properties, property, typeProperties |
| Quantitativos e uma quantidade | quantities, quantity |
| Classificação, material, documentos | classifications, materials, documents |
| Relações, contêiner, filhos, caminho até o projeto | relationships, related, containedIn, contains, decomposedBy, decomposes, path |
| Pavimento do elemento, lista de pavimentos | storey, 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.
| Pedido | Método |
|---|---|
| Preencher ou corrigir um pset ou quantidade | setProperty |
| Corrigir Name, Description, ObjectType ou Tag | setAttribute |
| Apagar uma propriedade | deleteProperty |
| Desfazer ou refazer a última edição da corrida | undo, 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.
| Pedido | Método |
|---|---|
| Injetar ou remover uma entidade | addEntity, removeEntity |
| Editar um argumento STEP por índice | setPositionalAttribute |
| Pilar, parede, laje, viga, porta, janela, espaço, cobertura, chapa, membro | addColumn, addWall, addSlab, addBeam, addDoor, addWindow, addSpace, addRoof, addPlate, addMember |
| Alinhar peças, unir paredes | alignElements, joinWalls |
| Abrir vão, porta ou janela hospedada numa parede | addOpening, addHostedDoor, addHostedWindow |
| Tipo IFC e associar tipo aos objetos | addElementType, assignType |
| Material, camadas e associar ao objeto | addMaterial, 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 membros | readGroup, 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.
| Pedido | Método |
|---|---|
| Projeto e o texto STEP desse projeto | project, toIfc |
Cor nomeada num elemento criado, antes de toIfc | setColor |
| Pavimento | addIfcBuildingStorey |
| Parede, laje, cobertura (plana ou duas águas), porta, janela, porta ou janela na parede | addIfcWall, addIfcSlab, addIfcRoof, addIfcGableRoof, addIfcDoor, addIfcWindow, addIfcWallDoor, addIfcWallWindow |
| Pilar, pilar circular, pilar oco, viga, viga I, perfil retangular oco | addIfcColumn, addIfcCircularColumn, addIfcHollowCircularColumn, addIfcBeam, addIfcIShapeBeam, addIfcRectangleHollowBeam |
| Fundação, estaca, escada, rampa, guarda-corpo, cortina, placa, mobiliário, proxy, membro e perfis L, T e U | addIfcFooting, addIfcPile, addIfcStair, addIfcRamp, addIfcRailing, addIfcCurtainWall, addIfcPlate, addIfcFurnishingElement, addIfcBuildingElementProxy, addIfcMember, addIfcLShapeMember, addIfcTShapeMember, addIfcUShapeMember |
| Qualquer tipo por eixo, por perfil, ou o posicionamento global | addAxisElement, addElement, createProfile, getWorldPlacementId |
| Espaço | addIfcSpace |
| Pset e quantitativo do elemento | addIfcPropertySet, addIfcElementQuantity |
| Material do elemento | addIfcMaterial |
| Cronograma 4D: plano, calendário, tarefa, sequência, produtos na tarefa, hierarquia | addIfcWorkPlan, addIfcWorkSchedule, addIfcWorkCalendar, addIfcTask, addIfcRelSequence, assignTasksToWorkSchedule, assignSchedulesToWorkPlan, assignCalendarToTasks, assignProductsToTask, nestTasks |
| Custo (IFC4 / IFC4X3): cronograma, item, valor, unidade, quantidade e vínculos | addIfcCostSchedule, 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) : nullbyType recebe cada tipo como argumento, não um array:
bim.query.byType('IfcWall', 'IfcWallStandardCase').
O que a entidade e as leituras devolvem
| Leitura | Forma |
|---|---|
| Entidade | ref, 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
| Efeito | Onde aparece | Entra no Baixar IFC |
|---|---|---|
setProperty, setAttribute, deleteProperty | Janela de propriedades, nesta corrida | sim |
bim.store (material, vão, entidade nova) | Arquivo baixado | sim |
colorize, colorizeAll | Vista já carregada. Cor em '#rrggbb' | não |
hide, show, isolate, resetVisibility | Vista desta corrida | não |
Última expressão ({ columns, rows }) | Tabela do resultado e o XLS | nã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,expressIdde 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
Usaatualizada.
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.exportde dentro do script. O download é o botão Baixar IFC. - Não move a câmera.
flyToesetCameranã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.