75 lines
5.2 KiB
Markdown
75 lines
5.2 KiB
Markdown
# MeltMind data contract v0 (Claude, 2026-11-13)
|
||
|
||
Scope: how Greif v5 parts become model inputs and targets. It is based on the Horsea receipts in thread 1794219487.255049 (MeltAstra, 2026-11-13). Every item is labelled VERIFIED (receipt), CROSS-CHECK (numerical, no written source) or OPEN. Nothing is silently dropped. Every exclusion is a flag plus a reported count.
|
||
|
||
## 1. Part identity and provenance
|
||
- Unit of sample: one VTU/LOG/YML triple (624). Leak-prevention key: the filename source token (249). Near-duplicate cluster id: OPEN (pending fingerprint rule). Split key = source token ∪ near-duplicate cluster.
|
||
- Per-part record: member name, zip CRC32, decoded counts, anomaly flags, split assignment.
|
||
- Archive: size 32,757,812,726 bytes, official MD5 75ec1500…5bdefab85 (VERIFIED on Horsea); local SHA256 d151f018…388fa0241 (VERIFIED, local only).
|
||
|
||
## 2. Geometry domain (mixed topology)
|
||
- Fluid domain = the tetrahedral subdomain: tet cells and only the nodes they reference.
|
||
- VERIFIED: in all 624 parts the tet subdomain is a single component, with no zero-volume tets, no zero node weights and no non-manifold faces. Orientation is consistently reversed, so absolute volumes are used.
|
||
- Mixed-topology parts (7): 00000087, 00000530, 00000970, 00001048, 00001252, 00001274, 00001294.
|
||
- VERIFIED: they contain triangle cells plus tets. Tet counts and unique tet-node counts equal the LOG exactly. Triangles share no nodes with tets. All PointData on triangle nodes is NaN.
|
||
- Triangle semantics: OPEN. They are not named "cooling surface" or "fragment".
|
||
- Contract:
|
||
- triangles and their nodes are kept in a separate auxiliary component with an explicit raw-index → tet-subdomain index map;
|
||
- they are NOT model nodes, NOT targets, and NOT part of the boundary used for descriptors;
|
||
- flag `mixed_topology=1`.
|
||
- Strict tet-only readers must use the map. A raw-reader failure on 00000087 is recorded, not patched over.
|
||
- 00000890: pure tet, 7,494 / 40,374 (VERIFIED from VTU). Its LOG lacks the fill-mesh block; flag `log_mesh_missing=1`.
|
||
- Geometry source = VTU tet subdomain (not LOG mesh lines). Points in mm: CROSS-CHECK (volume ratio about 1e9 against LOG m^3). Ratios for 00000087/01048/01294 lie within the LOG print-rounding interval (CROSS-CHECK; not evidence of corruption).
|
||
- Boundary for descriptors = boundary faces extracted from the tet subdomain (faces belonging to exactly one tet). It is NOT the auxiliary triangles.
|
||
- Volume weights w_i = lumped absolute tet volume.
|
||
|
||
## 3. Units (per field)
|
||
| Field | Unit used | Status |
|
||
|---|---|---|
|
||
| Points | mm | CROSS-CHECK |
|
||
| Fill_time | s | CROSS-CHECK (max equals LOG end of fill on 2 parts) |
|
||
| Pressure | Pa | CROSS-CHECK (equals LOG V/P pressure on 2 parts) |
|
||
| Temperature | K | CROSS-CHECK (last frame equals mould temperature) |
|
||
| Velocity | unknown | OPEN; not used, not converted |
|
||
| Frame time labels | s | CROSS-CHECK (match LOG times) |
|
||
|
||
No VTU DataArray has a Unit attribute, and the LOG is not uniformly SI (its warp section uses mm).
|
||
|
||
## 4. Frames and time
|
||
- Frames are ordered and joined across fields by the *physical time parsed from the name*, never by block number. Pressure block-to-time order is reversed at 25 / 13 adjacent places in the 2 samples (VERIFIED). Report any duplicate times.
|
||
|
||
## 5. Masks (dynamic fields; not needed for the first, static target)
|
||
For node i at frame time t:
|
||
- Fill mask F_i(t) = [Fill_time_i <= t].
|
||
- Validity mask V_i^f(t) = isfinite(field f).
|
||
- Target mask M_i^f(t) = F_i(t) AND V_i^f(t). Dry-but-finite values are never targets (pressure is finite on some unfilled nodes, VERIFIED on 2 parts).
|
||
- **Missing-value age** a_i(t) = t - Fill_time_i for wet nodes with V = 0. Observed T/V NaN ages up to 0.009521 s / 0.0037386 s, i.e. up to 2.706x / 6.080x the preceding output interval (VERIFIED, 2 parts). So **no fixed frame-lag rule.**
|
||
- Store F, V^f and coverage |M^f| / |F| per frame, plus a histogram of the age of NaNs, for every part.
|
||
- Any age-based exclusion threshold is OPEN, and must be set as a fraction of part fill time on train/validation only.
|
||
- Never nan_to_num a target.
|
||
|
||
## 6. Targets
|
||
- Static first target: Fill_time on tet-subdomain nodes. VERIFIED finite and non-negative on all tet nodes. Zeros (gate neighbourhood) are kept.
|
||
- P/T/V targets: OPEN until §5 coverage is censused, and only with M^f.
|
||
|
||
## 7. Inputs available to every arm (from H1 design D1)
|
||
- Coordinates (mm, normalised by the bounding diagonal) plus physical-scale scalars.
|
||
- Boundary flag.
|
||
- d(x) = exact distance to the tet-subdomain boundary faces.
|
||
- VERIFIED: analytic cube/plate/rod at 3 subdivision levels.
|
||
- VERIFIED: exhaustive check of 30 points on 2 real meshes, maximum difference 0.
|
||
- OPEN: T-junction, cross-remesh stability, CAD error.
|
||
- Gate (YML, mm) and the nearest tet node with its distance.
|
||
- Volume weights.
|
||
- Process scalars: none vary in v5 (fixed melt/mould temperature, Automatic flow), recorded as constants.
|
||
|
||
## 8. Flags (counted in every report)
|
||
- `mixed_topology` (7)
|
||
- `log_mesh_missing` (1)
|
||
- `near_duplicate_cluster` (pending)
|
||
- `units_crosscheck_only` (all)
|
||
- `velocity_unit_unknown` (all)
|
||
|
||
A part is excluded from an analysis only by a named rule applied to all arms, with the count reported.
|
||
|