Files
MeltMind/references/2026-11-14/s2-design/claude-data-contract-v0.md
T

75 lines
5.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.