- 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>
8.9 KiB
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_multilineeprim_multipoly(pts); - facce:
prim_tristripsetwithatt, circa una per faccia del modello.mv_p_NxNyNzxyzè una lista di vertici da 6float(normale, poi punto);p_accum_set_sizedà 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_dgbb7dà 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.prtWildfire +.stprisolve quelli che usa (fltfit.py).