NEXSOON BIM · R50 · GUIDA OPERATIVA

Famiglie parametriche aperte
e riuso dei prodotti IFC

Build 6.18.0-bim-r50-openbim-gdl-20261024-rev1 · desktop 6.18.50 · 24 ottobre 2026

Generazione locale, tipi e istanze modificabili, sorgenti conservati e cataloghi trasferibili.

1. Scegliere il percorso

Materiale disponibileOperazioneCosa rimane modificabile
Famiglia NXFAMILYFamiglie aperte → Importa sorgentiScript, formule, parametri, tipi, istanze, superfici e macro incluse.
Codice GDL leggibile, XML o HSF ZIPLeggi sorgente → controlla schema e unità → Verifica e anteprimaLa logica compresa nel profilo R50; le dipendenze devono essere incluse.
IFC di un edificioIFC aperto · prodotti → Collega IFC completoIl modello di riferimento, con le funzioni IFC esistenti per ispezione e acquisizione degli elementi. Non diventa automaticamente una famiglia nativa.
IFC di un prodottoIndicizza → seleziona prodotto → Acquisisci nel catalogoGeometria, proprietà originali e sorgente. La famiglia dimensionale ridimensiona la mesh; non recupera formule proprietarie.
Solo RFALettore RFA locale per i metadati; collegamento Revit per la geometria parametricaI metadati coperti dal lettore. Facoltativamente si può associare un IFC fornito separatamente, con corrispondenza scelta dall’operatore.
Solo GSM binarioCollegamento Archicad/Tapir oppure richiesta XML/HSF/GDL al produttoreIl percorso Archicad già presente resta disponibile. Non viene generata una forma sostitutiva.

2. Creare e usare una famiglia aperta

Aprire Architettura → Involucro → Famiglie aperte. Il comando è disponibile anche dalla ricerca comandi con identificativo openFamilyR50 e dal pannello Proprietà di una sua istanza. Nello stesso gruppo Involucro si trova IFC aperto · prodotti.

2.1 Le sei famiglie iniziali

La selezione comprende Tavolo operativo, Scaffalatura a ripiani, Armadio modulare, Panchina a doghe, Telaio prefabbricato modulare e Profilo cavo estruso. Sono definizioni originali riutilizzabili, con script e parametri consultabili. Il telaio genera una geometria parametrica: non crea automaticamente una verifica strutturale o un progetto di prefabbricazione.

  1. Scegliere la famiglia e il tipo. Le unità sono indicate accanto a ogni parametro.
  2. Impostare le misure, gli interi, gli angoli o i valori booleani. I campi determinati da formula sono disabilitati.
  3. Premere Verifica e anteprima. La generazione avviene in un worker separato; il pannello mostra triangoli, volume del solido unito e superficie esterna.
  4. Premere Salva e inserisci. L’istanza viene collocata all’origine del livello attivo e selezionata; usare Sposta, posizione X/Y, quota base e rotazione per collocarla.
  5. Controllare il risultato in pianta e 3D, quindi salvare il progetto. Un parametro non valido lascia invariato il documento.

2.2 Tipi, istanze e sorgenti

Salva famiglia e aggiorna istanze aggiorna la definizione e rigenera tutte le istanze che la usano, mantenendo identità, posizione, livello e valori specifici. Il sorgente geometrico è condiviso fra tutti i tipi della definizione. Una modifica del codice o dello schema può quindi interessare l’intera famiglia.

Per una variante, scegliere un nome nel campo Nome nuovo tipo e premere Crea nuovo tipo. Il tipo precedente conserva i propri valori. Non eliminare dallo schema un tipo ancora usato. Le combinazioni dei tipi e delle istanze vengono verificate prima dell’aggiornamento.

Per cambiare solo un oggetto, selezionare una sola istanza, aprire la sua famiglia, modificare i valori e premere Applica solo alla selezione. Il comando applica valori specifici all’istanza. Per cambiare codice, schema, macro o superfici usare il salvataggio della famiglia: il pulsante dell’istanza rifiuta queste modifiche.

Annulla/Ripristina ripristinano i dati del documento. Le operazioni in preparazione possono essere fermate con Interrompi; chiudere il pannello interrompe il worker. I file temporanei già preparati possono rimanere nell’archivio locale senza entrare nel progetto.

2.3 Posizionamento e prestazioni

L’origine del codice GDL viene conservata: BLOCK A,B,H parte da 0,0,0 e non dal centro della scatola. Selezione in pianta, spostamento, rotazione e specchio rispettano quest’origine. Le dimensioni del pannello Proprietà sono di sola lettura: modificarle mediante i parametri della famiglia. Il comando Scala indirizza al pannello parametrico per evitare che le misure dichiarate divergano dalla geometria.

Le istanze con gli stessi valori condividono una sola geometria salvata nella definizione. In pianta si usa il simbolo 2D se disponibile; in sua assenza si proietta la mesh fino a 4.000 triangoli. Oltre questa soglia viene mostrato un ingombro tratteggiato. È una rappresentazione semplificata della pianta, mentre il 3D e le quantità mantengono il modello completo. L’anteprima del pannello mostra fino a 12.000 triangoli e segnala la riduzione.

2.4 Materiali e quantità

Le superfici dichiarano colore RGB 0–1, opacità, rugosità e componente metallica. I materiali generati sono collegati alla famiglia. Per usare il materiale generale dell’istanza, applicarlo dal pannello Proprietà; per mantenere i colori dei componenti conservare l’impostazione dei materiali originali.

Le unioni solide eliminano il doppio conteggio delle sovrapposizioni; la prima superficie occupante mantiene il materiale nella zona comune. Il volume totale e la superficie esterna vengono letti dalla geometria unita. La superficie esterna totale non è una distinta delle superfici dei singoli materiali e viene assegnata al primo componente nei riepiloghi per parte. Le quantità geometriche non creano automaticamente voci di prezzo, sfridi o regole di misurazione contrattuali.

3. Importare, modificare ed esportare i sorgenti

3.1 NXFAMILY

È il formato aperto JSON NEXSOON-OPEN-FAMILY, versione 1. Conserva nome, categoria, classe IFC, schema dei parametri, tipi, quattro script, superfici, macro e provenienza. Non contiene codice JavaScript da eseguire. Lo schema dei parametri accetta length, real, number, integer, angle, boolean, text e matrici numeriche array.

Le lunghezze possono dichiarare m, cm o mm; gli angoli degree, deg o rad. Prima dell’esecuzione sono convertiti in metri e gradi. Minimo, massimo e integrità degli interi sono verificati. Le formule usano i valori numerici nelle unità dichiarate dai parametri, con controllo delle dipendenze e rifiuto delle formule circolari. Nelle formule usare unità coerenti oppure fattori di conversione espliciti: non viene eseguita algebra dimensionale automatica fra metri, centimetri e millimetri.

{
  "format": "NEXSOON-OPEN-FAMILY", "version": 1,
  "name": "Elemento parametrico", "category": "Furniture",
  "ifcClass": "IfcFurniture",
  "parameters": [
    {"name":"A", "type":"length", "unit":"m", "default":2, "min":0.1},
    {"name":"B", "type":"length", "unit":"m", "default":1},
    {"name":"H", "type":"length", "unit":"m", "default":0.5}
  ],
  "types":[{"id":"standard","name":"Standard","values":{}}],
  "scripts":{"model3d":"BLOCK A,B,H", "symbol2d":"RECT2 0,0,A,B"}
}

L’editor avanzato permette di modificare schema, script master, parametri, 3D, simbolo 2D, superfici e macro. Prima di salvare un cambiamento dello schema verificare anche i valori dei tipi e quelli specifici delle istanze già collocate.

3.2 File GDL, XML e pacchetti HSF

  1. Espandere Importa sorgenti, scegliere il file e, per uno ZIP con più oggetti, scegliere il sorgente principale.
  2. Per un XML con parametri angolari privi di attributo Unit, confermare Gradi o Radianti in base al formato del produttore. Il lettore non presume l’unità.
  3. Premere Leggi sorgente. Il file originale viene conservato separatamente dal contenuto normalizzato; SHA-256 e provenienza sono registrati.
  4. Controllare lo schema e premere Verifica e anteprima. Un GDL semplice non include uno schema: dichiarare nell’editor i parametri usati dal suo codice.
  5. Salvare la famiglia solo dopo la generazione valida.

I file .nxfamily e .gdl trascinati nell’area di lavoro aprono il pannello con il sorgente selezionato. Per XML e ZIP usare il selettore del pannello, evitando di confonderli con altri formati XML o pacchetti del programma.

Il lettore XML riconosce ParamSection/Parameters, Script_1D, Script_PR, Script_3D e Script_2D, i parametri scalari e le matrici numeriche del profilo. L’interfaccia GDL originale non è eseguita; il pannello Nexsoon usa lo schema dei parametri e conserva il sorgente originale.

Negli HSF ZIP il lettore riconosce scripts/script_3d.gdl, script_1d.gdl, script_pr.gdl, script_2d.gdl e il paramlist.xml dell’oggetto. Sono ammesse anche le varianti 3d.gdl, master.gdl, parameters.gdl e symbol2d.gdl. Le macro devono essere presenti con script e parametri nel pacchetto; i nomi di cartella o dei file XML identificano le macro. Una dipendenza mancante, ambigua o circolare interrompe l’importazione. Le sezioni 3D binarie, le texture esterne e gli oggetti dipendenti dal contesto Archicad non vengono ricostruiti.

3.3 Quattro esportazioni distinte

PulsanteContenuto
Esporta sorgente apertoNXFAMILY con codice, schema, tipi, superfici e macro. È il file da usare per continuare la modifica parametrica.
Esporta GLBGeometria della variante corrente, con materiali e misure reali. Non include la logica parametrica.
Esporta catalogo con sorgenteZIP portatile con GLB, ricetta NXFAMILY, valori della variante e sorgente originale quando disponibile.
Esporta simbolo SVGDisegno 2D supportato, nelle unità numeriche del sorgente, con asse verticale adattato a SVG. Richiede un simbolo 2D.

4. Profilo GDL effettivamente implementato

Il motore interpreta le espressioni mediante un parser dedicato; non usa eval, accesso a proprietà JavaScript, rete o file esterni. Le istruzioni sconosciute restituiscono errore con sorgente e riga. Nessun solido parziale viene accettato se il sorgente non è completabile.

AreaSupporto R50
SolidiBLOCK/BRICK, CYLIND con altezza positiva o negativa, SPHERE, ELLIPS semielissoide, CONE con basi perpendicolari e angoli di taglio 90°, PRISM e PRISM_ con profili rettilinei chiusi e fori.
TrasformazioniADD, ADDX/Y/Z, ADD2; MUL, MULX/Y/Z, MUL2; ROT con asse, ROTX/Y/Z, ROT2; DEL con numero esplicito; RESOL da 8 a 128.
Controllo e datiAssegnazioni, DIM, PARAMETERS, FOR/TO/STEP/NEXT, IF/THEN/ELSE/ENDIF, WHILE/ENDWHILE, END/EXIT, CALL con parametri espliciti o ALL e macro incluse.
EspressioniOperazioni aritmetiche, potenze, confronti, AND/OR/XOR/NOT, funzioni matematiche e trigonometriche in gradi; indici di matrici da 1, VARDIM1/2. Nessun accesso all’ambiente JavaScript.
PresentazioneMATERIAL riferito a superfici dichiarate, PEN, HOTSPOT/HOTSPOT2. I punti sono conservati come dati; non ricreano gli hotspot di editing Archicad.
Simboli 2DLINE2, RECT2, CIRCLE2, ARC2 con intervallo crescente fino a 360°, POLY2 con frame_fill=1 senza campitura. Le macro eseguono lo script coerente con la fase 2D o 3D.

Esclusioni: decodifica dei contenitori GSM binari o protetti; BINARY; REQUEST e variabili globali dipendenti dal progetto ospite; CUTPLANE e gruppi di operazioni solide GDL; GOTO/GOSUB; codici arco dei PRISM_; basi CONE inclinate arbitrariamente; lettura/scrittura esterna, add-on, interfacce e dipendenze non incluse. La sezione master deve restare nel profilo e viene valutata anche nel contesto 2D quando è richiesto un simbolo.

Limiti di elaborazione dichiarati

Sorgente2 MiB complessivi di script; definizione NXFAMILY entro 3 MiB; 256 parametri; 128 tipi; 64 macro; 12 livelli di richiamo.
Esecuzione20.000 istruzioni per programma, 1.000.000 passi, 10.000 iterazioni per ciclo, stack trasformazioni entro 512. Generazione nel pannello interrotta oltre 30 secondi.
Geometria2.000 solidi, 256 vertici per profilo, 200.000 triangoli per variante, 256 parti, 2.048 hotspot, 200.000 punti per simbolo. Salvataggio simultaneo: 500.000 triangoli fra le varianti distinte preparate.
Pacchetto sorgenti64 MiB compressi, 128 MiB espansi, 2.048 file; percorsi sospetti ed entità XML esterne rifiutati.
MatriciUna o due dimensioni, valori numerici finiti, massimo 16.384 valori. Matrici XML incomplete rifiutate.

Queste soglie limitano le singole operazioni: non costituiscono una garanzia di fluidità di ogni scena o di ogni dispositivo. Più varianti geometriche richiedono più memoria; i valori di dettaglio elevati aumentano tempi e triangoli.

5. Dal modello IFC al catalogo

Aprire IFC aperto · prodotti (openIfcR50) e scegliere un file .ifc entro 128 MiB. Il worker web-ifc legge e indicizza i prodotti con geometria. L’indice ammette fino a 10.000 prodotti, escludendo spazi, aperture, sito e piani dalla selezione di oggetti del catalogo.

  1. Filtrare per nome, classe, GlobalId o ID numerico; la tabella mostra 100 righe per pagina.
  2. Selezionare uno o più prodotti, fino a 128. Seleziona pagina interessa la sola pagina corrente.
  3. Per leggere proprietà dettagliate selezionare un solo prodotto e premere Leggi proprietà. Il riquadro distingue identità, property set, tipi, origine e avvisi di lettura.
  4. Premere Acquisisci selezionati nel catalogo. Vengono preparate tutte le geometrie e conservato il sorgente; le definizioni entrano nel documento con una sola transazione solo quando l’insieme è pronto.
  5. Scegliere un prodotto acquisito e premere Inserisci prodotto, oppure aprire Content Center. L’istanza inserita ha una nuova identità BIM e conserva il riferimento all’identità IFC originale.
  6. Per variare larghezza, profondità e altezza della mesh usare Crea famiglia dimensionale e inserisci. Il pannello dimensionale esistente si apre sulla nuova istanza.

La geometria normalizza le unità IFC in metri e poi nelle unità del modello. Le proprietà e le quantità grezze vengono conservate con l’indicazione delle unità originarie: un valore QTO espresso nel file in millimetri non viene etichettato come metri. I limiti di profondità e dimensione dei metadati producono avvisi espliciti se la lettura non è completa; consultare tali avvisi e il sorgente.

I prodotti del catalogo vengono ricentrati in pianta e appoggiati alla base; l’origine originale in metri rimane nei metadati. Per mantenere il posizionamento globale e la semantica completa dell’edificio usare Collega IFC completo al progetto. Il collegamento completo conserva il file nel progetto e segue il flusso IFC già disponibile.

Classi IFC e riuso

Il catalogo mantiene le classi supportate degli arredi e dei componenti impiantistici; le classi non coperte vengono mappate a IfcBuildingElementProxy, mantenendo la classe sorgente nei metadati con la spiegazione della mappatura. Una trave acquisita come oggetto di catalogo non diventa automaticamente una trave strutturale analitica. Collegare il modello completo e usare gli strumenti nativi appropriati per lavorare sugli elementi dell’edificio.

Ogni prodotto ammette fino a 256 parti e 200.000 triangoli; la lettura del singolo comando scade oltre 120 secondi. Un prodotto già acquisito dallo stesso IFC viene segnalato, evitando duplicazioni involontarie. Per un IFC aggiornato verificare le nuove geometrie e la corrispondenza con gli oggetti precedenti prima di sostituire un catalogo.

6. RFA, RVT e GSM: che cosa è gratuito

Il lettore locale rvt-rs già incluso fornisce i metadati dei formati Revit coperti e la geometria parziale degli RVT supportati. Non fornisce la geometria delle famiglie RFA. Il pannello IFC permette di leggere i metadati di un RFA e associarli a un solo prodotto IFC selezionato esplicitamente, fornito separatamente.

  1. Caricare e indicizzare il file IFC.
  2. Selezionare il prodotto che corrisponde al RFA.
  3. Aprire Associa metadati RFA e scegliere il RFA; attendere la lettura.
  4. Acquisire il prodotto. Il catalogo conserva i metadati RFA e lo ZIP con entrambi i sorgenti.
  5. Controllare visivamente e dimensionalmente la corrispondenza: l’associazione non è una decodifica della geometria RFA.

Non sono recuperati automaticamente vincoli, formule o funzionalità dei connettori della famiglia Revit. Per elaborarli rimane il connettore Revit 2025 già predisposto, che richiede un’installazione e una licenza Revit.

Per GSM, il percorso libero R50 interpreta sorgenti leggibili nel profilo dichiarato. Il connettore Tapir è libero, ma esegue la generazione attraverso Archicad e richiede Archicad. La R49 conserva le procedure per Object/Lamp, i sorgenti e la rigenerazione della singola istanza. LP_XMLConverter resta un percorso distinto per conversione e parametri, non un motore libero autonomo di rendering GSM.

7. Conservazione e trasferimento

Salvare il progetto con le funzioni di salvataggio già disponibili. Le definizioni aperte, i parametri, i valori specifici, le geometrie condivise e i riferimenti ai sorgenti fanno parte del documento. Per trasferire il lavoro fra dispositivi usare il bundle portatile con allegati; il solo JSON può contenere riferimenti a file dell’archivio locale e non trasferire i relativi byte.

Per i cataloghi usare Esporta acquisiti con sorgenti oppure Esporta catalogo con sorgente. Importare lo ZIP dal Content Center: geometrie e sorgenti vengono verificati tramite dimensioni e SHA-256 prima dell’inserimento. Un unico sorgente IFC condiviso fra più prodotti viene memorizzato una sola volta nello ZIP. Il limite dell’archivio catalogo è 256 MiB: suddividere le raccolte più grandi.

Un prodotto di catalogo con ricetta NXFAMILY può tornare una famiglia nativa: inserirlo, selezionarlo, aprire Famiglie aperte → Apri famiglia della selezione, verificare e salvare. I valori usati per esportare l’oggetto sono conservati. Un prodotto GLB senza ricetta resta una mesh.

Le librerie e i modelli preesistenti sono conservati. Le nuove sei famiglie sono definizioni di pochi kilobyte che generano la geometria: la dimensione ridotta del loro codice non rappresenta la rimozione degli asset precedenti. La release include un manifesto con dimensione e hash di ogni file e un controllo di conservazione separato.

8. Installare R50 sul sito o sul desktop

8.1 Sito e aggiornamento leggero

  1. Conservare una copia dell’installazione corrente, dei progetti, dei dati cloud, del database e delle configurazioni private.
  2. Con il pacchetto completo estrarre tutti i file nella radice dell’applicazione, rispettando la collocazione privata del worker indicata nelle guide di installazione. Il completo contiene già la base: non richiede un altro archivio.
  3. L’aggiornamento leggero R50 è cumulativo e si applica esclusivamente a una base completa R48 o R49. Estrarre nella stessa radice sovrascrivendo i file applicativi. Non cancellare i dati e non sostituire le proprie configurazioni con configurazioni predefinite.
  4. Aggiornare anche il worker privato se applicabile. I percorsi GDL/IFC locali non richiedono un nuovo servizio a pagamento, ma l’installazione deve servire tutti i nuovi moduli e il WASM web-ifc.
  5. Chiudere le schede del BIM dopo aver salvato. Aprire aggiornamento-r50.html nel sito e premere Verifica e attiva R50.
  6. Aprire l’app e verificare il build R50, i due nuovi comandi, il salvataggio e un proprio file. Per le installazioni precedenti alla R48 usare il completo.

Sono necessari HTTPS o localhost, Worker ES modules, WebAssembly, spazio locale per gli allegati e WebGL per il collegamento IFC completo e il 3D. Il server deve restituire JavaScript e WASM con i MIME corretti; CSP e proxy devono consentire le risorse locali necessarie. La guida Server e attivazione e il PDF server/installer nel pacchetto conservano le procedure per PHP/Aruba, SMTP, cloud, OAuth e IA.

8.2 Installer e Blender

Il completo conserva i generatori per Windows x64, macOS Intel, macOS Apple Silicon e Linux x64. I generatori richiedono i prerequisiti e gli strumenti della piattaforma descritti in Installazione desktop. Il pacchetto sorgente non equivale a quattro installer già compilati e firmati.

L’integrazione Blender resta disponibile per i lavori di rendering e i processi previsti dal worker. Il nuovo interprete GDL e l’estrazione IFC funzionano senza Blender. Gli script dell’adattatore sono condivisi; il programma Blender eseguibile deve corrispondere al sistema e all’architettura. L’opzione --with-blender dei generatori incorpora il runtime previsto dalla guida. Anche Unreal e il relativo viewer rimangono componenti esterni da compilare e collegare secondo la guida dedicata.

I progetti avanzati e il pacchetto progetti restano separati e compatibili; non sono incorporati nel completo R50. Non occorre scaricarli di nuovo se già conservati.

9. Individuare un problema

Messaggio o comportamentoIntervento
Comando GDL non supportatoConsultare sorgente e riga. Adattare il codice al profilo oppure usare il motore originale. Non viene inserita geometria parziale.
Macro mancante o sorgente ambiguoIncludere le dipendenze nello ZIP e selezionare il sorgente principale corretto.
Confermare l’unità XMLControllare la documentazione del sorgente e scegliere degree oppure rad. Non scegliere l’unità in base a un’anteprima presunta.
Parametro fuori intervallo, formula circolare o matrice incompletaCorreggere schema, valori e dipendenze. Verificare anche i tipi e le istanze esistenti.
Documento cambiato durante l’elaborazioneRipetere sul documento corrente. I risultati della preparazione precedente vengono rifiutati.
Geometria condivisa assenteAprire la famiglia del progetto e rigenerare dal sorgente. Per trasferire il progetto usare il bundle con allegati.
Tempi lunghiRidurre RESOL, numero di solidi, varianti e dettaglio; suddividere IFC e cataloghi. Le soglie non rendono illimitata la memoria del dispositivo.
Collegamento IFC richiede il motore GPUUsare Ripristina 3D e controllare WebGL/driver. L’indice nel worker e la vista 3D sono passaggi distinti.
Build vecchio o moduli non trovatiCaricare tutto l’aggiornamento nella radice corretta, chiudere le schede del BIM e attivare aggiornamento-r50.html. Non cancellare i dati locali per cambiare la cache.

10. Evidenze e limiti

11. Componenti e riferimenti

Il profilo Nexsoon GDL R50 è un’implementazione dedicata. Riusa Manifold 3.5.4 per i solidi (Apache-2.0), web-ifc 0.0.78 per IFC locale (MPL-2.0) ed earcut 3.2.4 (ISC), oltre ai componenti esistenti. Le licenze e le impronte dei byte confrontati con i pacchetti upstream sono in vendor/licenses-r50. IfcOpenShell del worker rimane un componente distinto; le sue istruzioni e dipendenze esistenti sono conservate.

Documentazione GDL Graphisoft · web-ifc · Manifold · IfcOpenShell · rvt-rs · Tapir

Le licenze dei motori non assegnano diritti sui prodotti importati. Conservare la provenienza e le condizioni del produttore insieme ai sorgenti del proprio catalogo.

Guida completa · Manuale dei comandi · Funzioni e conservazione R49