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>
This commit is contained in:
davideandClaude Opus 5.5 committed 2026-11-17 09:00:51 +01:00
1 parent 7754bea9d4
commit 3396df6be0
16 files changed
+1584 -15

No files matched your search

+157
View File
@@ -0,0 +1,157 @@
# 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`](formato-psb.md); stato del lavoro e punti aperti
in [`history.md`](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.
```powershell
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
```text
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`](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`](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`).