Files
prep-step/docs/formato-prt-brep.md
T
davideandClaude Opus 5.5 3396df6be0 Leggi il solido dei .prt ed esportalo in STEP senza Creo
- scripts/psb/brep.py: B-rep esatto da VisibGeom/ActDatums riscritto in
  STEP; coincide faccia per faccia con lo STEP di Creo su due campioni.
- scripts/psb/mesh.py: STEP sfaccettato dalla mesh di SolidPrimdata, per
  i file Wildfire in cui VisibGeom e' cifrata.
- psb.py: tabella dei double corretta (modi a 3/6 byte, prefissi con
  buchi, costanti 04 e 0d, tag ee); tabella dei float a 81 voci, i tag
  ignoti non ricevono piu' un valore inventato; struct dichiarate sotto
  due id.
- tagfit.py, fltfit.py, stepread.py: verifica delle tabelle con vincoli
  geometrici e confronto con lo STEP di Creo.
- docs: nuovo formato-prt-brep.md e lettura-prt-asm.md; correzioni in
  formato-psb.md (3.4) e formato-prt-geometria.md (assi di local_sys =
  colonne); history.md con regressioni e punti aperti.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 09:00:51 +01:00

8.9 KiB
Raw Blame History

Il solido di un .prt: B-rep, mesh ed esportazione STEP senza Creo

Come si ricava la forma di una parte dal file, e come la si scrive in STEP per vederla. È reverse engineering (script Python in scripts/psb/, non fa parte dell'app), ma a differenza degli altri doc di formato qui quasi tutto è provato contro Creo: tre coppie .prt + .stp esportato da Creo dallo stesso modello hanno fatto da oracolo.

Il formato delle sezioni è in formato-psb.md; stato del lavoro e punti aperti in history.md.

1. Due strade, secondo chi ha salvato il file

File salvato da Creo (generazione ≥ 1632) File salvato da Wildfire (1322-1430)
VisibGeom (B-rep esatto) tipo 9, leggibile tipo b/11, cifrata
SolidPrimdata (mesh di visualizzazione) di solito senza mesh mesh presente, solo compressa
Strada brep.py: STEP con superfici vere mesh.py: STEP sfaccettato (triangoli piani)
Risultato identico allo STEP di Creo stessa forma entro la sfaccettatura (volume 0,05-0,2%)

Le due strade sono complementari: dove manca una c'è l'altra. La generazione è il secondo numero dopo PART nella prima riga del file.

python scripts/psb/brep.py <file.prt.N> --step out.stp     # B-rep esatto
python scripts/psb/brep.py <file.prt.N> --check rif.stp    # confronto faccia per faccia con lo STEP di Creo
python scripts/psb/mesh.py <file.prt.N> --step out.stp     # STEP sfaccettato dalla mesh

2. Il B-rep: VisibGeom

Radice Sld_VisGeom → active_geom, con tre array: srf_array (superfici), crv_array (spigoli), qlt_array (quilt).

2.1 Superfici

Campo Significato Prova
geom_id id della superficie
geom_type 34 piano, 36 cilindro, 37 cono, 38 toro, 40 superficie spline, 44 tab_cyl tipo uguale allo STEP su 246 facce
feat_id feature che l'ha generata
orient 1: il verso della faccia è la normale naturale (∂u × ∂v); -1: opposto. È il same_sense dello STEP 246 facce su 246
envlp inviluppo [[u_min, v_min], [u_max, v_max]] in coordinate parametriche
srf_prim_ptr(...) la primitiva: local_sys più i suoi parametri sotto
frst_cntr_ptr, next_cntr_ptr lista concatenata dei contorni 281 contorni = 281 loop dello STEP
topol_ref_data.list_type 98 = faccia del solido, 57 = faccia di una quilt (list_id = id della quilt) gusci chiusi/aperti uguali allo STEP

Le superfici senza contorno (frst_cntr_ptr nullo, boundary_type 6) non fanno parte del solido e si scartano.

Non tutte le superfici stanno in VisibGeom. Quelle a cui è agganciato un asse di riferimento stanno in ActDatums, stesso formato, stessa catena next_geom_ptr. Sintomo: spigoli che citano un geom_id inesistente e due contorni in meno rispetto allo STEP.

2.2 local_sys: gli assi sono le colonne

local_sys è 4×3: tre righe di una matrice R e l'origine o, con

mondo = o + R · locale

Gli assi locali sono quindi le colonne di R, non le righe. Leggerle per righe funziona solo sulle matrici simmetriche (l'identità) e sbaglia tutte le altre: era l'errore di formato-prt-geometria.md §6.1, e spiega l'"asse incerto" di Foro 3 lì descritto.

Parametrizzazioni (ex, ey, ez = colonne di R):

Tipo Punto a (u, v) Parametri
piano o + u·ex + v·ey
cilindro o + r·(cos u·ex + sin u·ey) + v·ez radius
cono o + v·tan(α)·(cos u·ex + sin u·ey) + v·ez (vertice in o) half_angle, può essere negativo
toro o + (R + r·cos v)·(cos u·ex + sin u·ey) + r·sin v·ez radius1 = R, radius2 = r
spline pezza di Hermite bicubica: i_points, end_u_tangts, end_v_tangts, end_uv_deriv; l'angolo (a, b) sta all'indice 2a + b solo una maglia (u_params = v_params = [0, 1])

Prova: il vincolo di §2.4 su 4472 spigoli di 22 file; il toro è provato solo così (nessuno STEP di riferimento con un toro).

2.3 Spigoli e contorni

Uno spigolo (crv_array) non ha una curva 3D. Ha i campioni della curva nelle coordinate parametriche delle due superfici che separa:

Campo Significato
crv_hdr_geom_ptr[0], [1] le due superfici (lato 0 e lato 1); 0 = nessuna, bordo libero di una quilt
crv_pnt_arr campioni [u0, v0, u1, v1]: lo stesso punto sulle due superfici
crv_pnt_dir[k] 1 se il contorno della superficie k percorre i campioni in avanti, -1 all'indietro
next_crv_hdr_ptr[k] lo spigolo successivo nel contorno della superficie k

Un contorno si percorre partendo da frst_cntr_crv_hdr_ptr e seguendo next_crv_hdr_ptr del lato che guarda la superficie, fino a tornare al primo. trv = 1 è un contorno esterno, trv = -1 un foro. Una superficie Creo può avere più contorni esterni (regioni staccate dello stesso piano): lo STEP di Creo ne fa una faccia per ciascuno, e un foro va al contorno esterno il cui inviluppo UV lo contiene.

La curva 3D si ricostruisce: i campioni si interpolano in UV sulla superficie curva (lì cerchi e generatrici sono rette), poi la polilinea si riconosce come retta, cerchio o altro. Su 357 spigoli il tipo coincide sempre con quello scelto da Creo. Limite: fra due superfici curve qualsiasi l'interpolazione fra i campioni è un'approssimazione, e nello STEP quelle curve sono polilinee.

2.4 Il vincolo che regge tutto

Lo stesso campione, calcolato sulle due superfici dello spigolo, deve dare lo stesso punto. Non richiede né Creo né uno STEP, e sbaglia in modo vistoso (millimetri) appena un numero è decodificato male. È il controllo di regressione di questa parte (brep.py lo stampa sempre) ed è ciò che ha corretto la tabella dei double (tagfit.py, formato-psb.md §3.4). Sugli spigoli analitici lo scarto è 1e-13 mm; sulle intersezioni non analitiche arriva a qualche millesimo, che è la precisione con cui Creo le salva.

3. La mesh: SolidPrimdata

Sezione compressa (unz.py), mai cifrata. Radice pgl_primdata_group_table → pgl_primdata_groups_arr: un gruppo per livello di dettaglio (lod_value; si usa quello con più triangoli). Dentro, primitive di due famiglie:

  • filo: prim_arc (center_d, radius_d, angoli, plane_orientation), prim_multiline e prim_multipoly (pts);
  • facce: prim_tristripsetwithatt, circa una per faccia del modello. mv_p_NxNyNzxyz è una lista di vertici da 6 float (normale, poi punto); p_accum_set_size dà la fine cumulata di ogni striscia di triangoli.

Il verso dei triangoli lo decide la normale del vertice. Sul campione con STEP: 1518 vertici tutti sulle superfici dello STEP, normali unitarie, mesh chiusa.

La mesh dipende dalla tabella dei float (formato-psb.md §3.4), nota per 81 tag su 144: mesh.py si ferma se la mesh usa un tag ignoto, non inventa il valore.

4. Prove

Campione Strada Esito
9245000212.prt.6 (Creo) B-rep 176 facce su 176 uguali allo STEP di Creo (contorni, tipo, verso, raggi, gusci 173 + 3); curve 582 rette, 270 cerchi, 162 spline tutte dello stesso tipo; volume 479071,6 contro 479069,2
9284212392.prt.14 (Creo) B-rep 70 facce su 70; 10 quilt da 2 facce come Creo; volume uguale a 9 cifre (259458,935)
9284212178.prt.2 (Wildfire) mesh 1116 triangoli, solido chiuso; volume 136320,9 contro 136251,1 (0,05%)
raw/ (76 .prt, senza STEP) B-rep 26 solidi validi in OpenCascade; in 20 il volume torna con quello di BasicText entro 3e-4

"Valido" e i volumi sono calcolati con OpenCascade (cadquery-ocp) sugli STEP prodotti, quindi con un kernel indipendente. I campioni con STEP non sono nel repo.

5. Cosa non regge ancora

  • Sei parti di raw/ (cuscinetti, viti, pezzi con tori) danno un solido valido ma un volume diverso dall'1 al 9% da quello scritto nel .prt; cusci_dgbb7 dà volume negativo. Non è deciso se sia un errore di orientamento o un volume non aggiornato nel file: serve una coppia con STEP di un pezzo tornito con raccordi.
  • tab_cyl (tipo 44, estrusione di una spline) e spline a più maglie: non gestite.
  • Foro senza contorno esterno (9251200244.prt.16): la regola dell'inviluppo non basta.
  • Cifratura dei file Wildfire: entropia 7,995 bit/byte, chiave diversa per sezione e per file (48 campioni con lo stesso testo in chiaro iniziale, nessuna relazione con lunghezza o checksum dell'indice). Non riprovare con XOR o chiavi derivate dall'indice. Rimedi: la mesh, oppure riaprire e risalvare il file in Creo.
  • STEP sfaccettato: un cilindro resta fatto di triangoli. Ricostruire piani, cilindri e coni dalla mesh è possibile (gli insiemi di strisce corrispondono quasi alle facce: 38 contro 46 sul campione) ma sarebbe una stima, non una lettura.
  • Tabella dei float: 63 tag ancora ignoti. Ogni coppia .prt Wildfire + .stp risolve quelli che usa (fltfit.py).