Famiglie native: sorgente, parametri e rigenerazione

1. Dove gira il motore

Il browser comunica con il worker di elaborazione del sito; l’app desktop usa il proprio servizio locale. Revit e Archicad devono essere sul computer che esegue il worker, con licenza valida e con lo stesso account e la stessa cartella di scambio. L’hosting PHP inoltra le richieste: non esegue Revit o Archicad. Archicad richiede Windows o macOS; questo percorso non rende disponibile Archicad su Linux.

Per il servizio remoto seguire attivazione server e impostare endpoint HTTPS e token in api/engineering.config.php. L’utente deve accedere al sito. Non pubblicare le credenziali nel codice del browser. Il worker aggiornato deve contenere l’intera cartella engineering e il registro assets/data dei cataloghi.

2. Revit / RFA

Usare Windows con Revit 2025 e .NET 8 SDK. Chiudere Revit ed eseguire PowerShell nella cartella native/revit:

./Install.ps1 -RevitDir "C:\Program Files\Autodesk\Revit 2025"

Riavviare Revit e autorizzare l’add-in. Il servizio Python e Revit usano per impostazione predefinita %USERPROFILE%/.nexsoon/native-families. Per un percorso diverso impostare NEXSOON_NATIVE_HOME uguale nei due processi prima di avviarli. Nel pannello Famiglie native verificare che Revit risulti collegato. I metadati RFA locali restano disponibili senza motore, ma non producono la geometria.

Caricare il file, selezionare il tipo, modificare i parametri scrivibili e premere Applica parametri e genera. La rigenerazione e i vincoli vengono risolti da Revit. I parametri bloccati o guidati da formule restano non modificabili. Importare il risultato nel catalogo BIM.

3. Archicad / GSM: predisposizione

  1. Installare Archicad 27 o successivo e l’add-on Tapir 1.7.2 compatibile con la propria versione. Il collegamento verifica i comandi necessari all’avvio.
  2. Scaricare il componente ufficiale con lo script seguente; scegliere Win o Mac e la versione effettivamente installata. Lo script verifica dimensione e SHA-256 del rilascio ufficiale.
  3. Su Mac estrarre lo ZIP. Aggiungere il componente nel gestore add-on di Archicad e riavviare.
  4. Creare un progetto PLN vuoto riservato al worker, salvarlo con un percorso assoluto e aprirlo in una sessione dedicata. Caricare le librerie da cui dipendono i GSM. Non usare un progetto di lavoro o Teamwork.
  5. Avviare il servizio di elaborazione e il processo Archicad riportato sotto con lo stesso utente e NEXSOON_NATIVE_HOME. La porta JSON API di Archicad deve essere locale, nell’intervallo 19723–19743.
python scripts/scarica-tapir-r49.py --archicad 28 --platform Win --output tapir-download
python engineering/archicad_family_worker.py --project-file "C:\NexsoonWorker\worker.pln" --port 19723

Su macOS sostituire il percorso con quello reale del PLN, /Users/nome/NexsoonWorker/worker.pln. Nei pacchetti desktop utilizzare il Python incorporato nel runtime; nei worker autonomi utilizzare il Python predisposto dall’installazione con le sue dipendenze. Il triangolatore richiede Shapely 2.1 o successivo; le dipendenze distribuite includono la versione 2.2.

4. Parametri, geometria e importazione GSM

  1. Aprire Famiglie native e premere Verifica motori. Archicad deve risultare collegato.
  2. Caricare il GSM. Il worker controlla l’impronta del file, aggiunge una copia con nome univoco alla libreria del PLN privato e legge i parametri di una sua istanza.
  3. Modificare valori scalari oppure matrici in sintassi JSON, mantenendone le dimensioni. Lunghezze GDL in metri e angoli in radianti. Parametri bloccati e tipi non modificabili sono protetti.
  4. Premere Applica parametri e genera. Archicad esegue gli script, valuta i parametri e restituisce i corpi 3D; il convertitore conserva facce concave, fori, colori degli attributi e trasparenza.
  5. Scaricare il catalogo o importarlo. Il BIM conserva GLB, dati dei parametri e sorgente GSM. L’importazione aggiorna il documento con una transazione.

Il percorso copre parti di libreria Object e Lamp. Porte, finestre ospitate, parti solo 2D o macro richiedono il proprio contesto Archicad: usare un’istanza correttamente ospitata esportata in IFC. Le texture e i materiali definiti nello script e non esposti da Tapir devono essere assegnati nel BIM. Non vengono generati ingombri fittizi quando manca la geometria.

5. Rigenerare un’istanza già inserita

  1. Selezionare una sola istanza RFA/GSM nel modello.
  2. Premere Rigenera famiglia nativa. Il BIM riapre il sorgente conservato e predispone i parametri precedenti.
  3. Caricare e leggere la famiglia sul motore, applicare le modifiche e generare.
  4. Importare il risultato: viene creata una variante distinta e la sola istanza selezionata cambia geometria. Identità e posizione rimangono; la casella dedicata decide se aggiornare le dimensioni.
  5. Annulla ripristina l’istanza precedente. Le altre istanze continuano a usare la propria definizione.

Le importazioni delle vecchie build potrebbero non contenere il sorgente: in quel caso reimportare una volta il file originale. Per trasferire il progetto usare il formato portatile con risorse esterne; per trasferire prodotti usare Esporta catalogo, che ora comprende anche i sorgenti originali descritti nell’indice.

6. Errori e ripristino

Il worker elimina l’istanza temporanea e la copia di libreria alla fine di ogni elaborazione. Se il progetto cambia o la pulizia fallisce, scrive un giornale e si arresta. Non rimuovere manualmente il giornale per aggirare l’errore. Chiudere senza salvare il PLN privato e riaprire la copia vuota, controllando che non contenga elementi né librerie temporanee; poi:

python engineering/archicad_family_worker.py --project-file "C:\NexsoonWorker\worker.pln" --reset-session

Il ripristino rifiuta un PLN che contiene elementi. Una famiglia priva di macro o dipendenze può non generare corpi: caricare le librerie necessarie nel progetto dedicato e ripetere. Se il programma perde il collegamento, la sola presenza del file sul server non rende disponibile il motore.

7. Riferimenti e perimetro verificato

Tapir ufficiale 1.7.2 · API Graphisoft · Procedure RFA e LP_XMLConverter. Il percorso LP_XMLConverter rimane disponibile quando Archicad non è collegato: conserva e modifica i parametri senza eseguire gli script e restituisce un GSM, non un catalogo 3D. I controlli locali di protocollo e geometria non sostituiscono l’esecuzione su una postazione con i software proprietari.