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

5.2 KiB
Raw Blame History

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.