Skip to content

Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel

19.7 KB
Raw Blame

HUMANOID-X0 — Canonical adult humanoid foundation

Date: 2026-09-16
Verdict: Meaningful progression

X1 status correction: The procedural body below is now explicitly NONCANONICAL-SyntheticRegressionFixture; historical identity and test APIs remain for replay only. The earlier proposed follow-up of improving its Antonia fit is superseded by HUMANOID-X1, which adopts original Antonia topology as an unpromoted candidate. Historical descriptions of the X0 surface as canonical are not a current usability or production-admission claim.

Did Aetheris successfully create and validate an independently authored canonical adult humanoid topology that can be deterministically fitted to a screened licensed reference and used as a stable semantic humanoid substrate?

Partly. Aetheris now owns and validates a real canonical adult domain: independently generated topology, stable identity, semantic regions, skeleton, skin weights, typed landmarks, measurement protocols, morphs, attachment frames, display export, diagnostics, and provenance. Deterministic Antonia registration runs and preserves connectivity, but it does not meet X0 fit budgets. The pose sweep also reports orientation-reversal proxies at the major joints. In addition, the recon review does not clear the converted char.blend component as canonical output. The authored neutral template therefore remains canonical; fitted positions are local research evidence only.

The next blocker is narrow and measured: replace the current coarse same-region nearest-surface correspondence with reviewed source landmarks and a deformation graph or cage that can reduce the 74.58 mm bidirectional RMS without violating the 3.0 edge-stretch bound, then requalify shoulder/hand, crotch, knee, and foot regions. Pose weights at shoulders, elbows, hips, and knees also need refinement before the deformation witness can pass.

Canonical authority

Aetheris.Humanoid is a domain module beside the existing engineering domains. ImportedHumanoid retains external topology, source pose, and provenance. CanonicalHumanoid requires the stricter Aetheris identity and validation laws. No Firmament syntax is frozen.

The canonical frame is millimetres, right-handed, +X anatomical right, +Y forward, +Z up. The origin is the mid-sagittal pelvis projection on the common sole plane. The authored neutral is normalized to exactly 1750 mm; this is an engineering normalization, not a population mean.

The canonical artifact is generated by repository code from explicit anatomical SDF primitives on a fixed 24 mm lattice, split into six deterministic tetrahedra per cell and polygonized at the zero isovalue. Faces below 0.0001 mm2 are deterministically rejected. Antonia coordinates and connectivity do not participate in generation.

Property X0 result
Topology ID aetheris.humanoid.adult.standard.v1
Binding triangulation aetheris.humanoid.adult.standard.v1.binding-triangles.v1
Vertices 16,868
Triangles 33,716
Semantic regions represented 31
Outer-skin triangles 33,268
Eye triangles 224 left + 224 right
Connectivity SHA-256 1d4828e1966c6be96409b1bc9f285ae8a5b1f6ded2ba0c523da61d71bc51e2eb

The surface has stable vertex and face IDs, binding triangles, explicit region symmetry, vertex symmetry involution, component declarations, and semantic material regions. The outer skin, left eye, and right eye are separate components. The mouth seam is surface-only; a mouth interior, teeth, and tongue are deferred. Connectivity is triangle-based and generated from a tetrahedral lattice. It is not quad-dominant and does not yet provide artist-authored deformation loops. Hands have separated authored finger primitives and semantic chains, but the lattice resolution limits finger and facial detail.

The full JSON/OBJ artifacts and before-fit renders are generated under artifacts/local/humanoid-x0/. The compact tracked fixture is fixtures/Canonical/Humanoid/adult-standard-v1.fixture.json.

Antonia reference and admission

The only X0 geometric reference is Antonia Polygon from https://github.com/Upliner/CharMorph-db at revision a8512ac299c0cb1724c7b5417267c94bef024d64:

  • file: characters/antonia/char.blend
  • object: cm_antonia
  • SHA-256: 4bc468c44c8ca7c6971cac3692c5d670b09f6723687e89cd49f258c2a8251c69
  • license evidence: character config.yaml and license.txt, CC-BY 3.0
  • attribution: based on Antonia Polygon by Olaf Delgado-Friedrichs, with phantom3D, MikeJ, DieTrying, Fenrissa, and the other contributors credited in the source package; no endorsement implied

The research fit reads only outer-skin polygons using material indices 5, 6, 9, 10, 11, and 12. It does not execute CharMorph code and does not ingest source connectivity, texture images, morph arrays, source rigs, source weights, scripts, shared libraries, clothes, or hair. Blender is launched with --factory-startup --disable-autoexec.

The mission authorizes this bounded local study with attribution. The earlier recon found no separate grant for the converted char.blend component. The tracked sidecar therefore says canonicalOutputAdmission = blocked-pending-review-of-char-blend-conversion-component-scope. No Antonia geometry or fitted coordinates are packaged as Aetheris canonical source.

Registration evidence

The frozen config is aetheris.humanoid.registration.antonia-x0.v1, seed 0. It verifies the source hash and admission sidecar, normalizes admitted Antonia outer skin to a common 1750 mm sole frame, evaluates the canonical LBS A-pose in the source study pose, builds same-region BVHs, and runs five bounded projection/smoothing passes. Correspondence is gated by semantic region, side, distance, and surface-normal compatibility. Paired displacements enforce symmetry. Pair-local backtracking prevents newly inverted or collapsed faces. Tie-breaking and every weight, cutoff, iteration count, projection bound, and validation budget are tracked in fixtures/Canonical/Humanoid/x0-registration-config.json.

The template connectivity hash before and after fitting is identical. The pipeline copied no source connectivity. A separate same-topology synthetic test recovers a known smooth displacement to below 0.001 mm while preserving faces and connectivity identity.

Metric Result X0 budget Pass
Same-region landmark proxy RMS 110.84 mm 5 mm No
Same-region landmark proxy max 257.73 mm 15 mm No
Bidirectional area-weighted surface RMS 74.58 mm 5 mm No
Bidirectional area-weighted surface p95 180.85 mm 10 mm No
Surface max 325.84 mm reported —
Canonical vertex correspondence coverage 98.65% reported —
Newly inverted faces 0 0 Yes
Collapsed faces 0 0 Yes
Edge-stretch p95 2.74× reported —
Edge-stretch max 51.47× 3.0× No
Symmetry residual RMS 0.0000046 mm reported —
Self-intersections not implemented 0 if detector qualified Not qualified

The “landmark” values above are explicitly nearest same-region surface proxies. There is no reviewed Antonia landmark sidecar, so they cannot satisfy the landmark-correspondence acceptance gate. They are retained to expose the failure rather than invent source anatomy.

The five projection passes reduce accepted-vertex preprojection RMS from 70.87 to 43.52 mm. The face region is close by this proxy (4.40 mm RMS, 7.57 mm p95), but its maximum is 44.25 mm and visual review remains mandatory. Shoulders/armpits/hands are the dominant failure at 154.10 mm RMS. The combined crotch proxy is 41.84 mm RMS; knee/foot proxies are 52.97 mm RMS. Ears currently share the coarse head region statistic and need their own correspondence class.

On the recorded Blender 5.2.2 run, input admission, loading, pose alignment, fitting, metrics, and evidence assembly took 2.13 seconds before rendering. Canonical template generation took 2.08 seconds on the same machine. These are reproducibility observations, not performance budgets.

Matched front, back, side, and iso renders, a fitted wire overlay, landmark overlay, and error heatmap are emitted locally. The three bodies in matched renders are Antonia admitted outer skin, the independently authored pre-fit template, and the local fitted canonical topology. Visual evidence does not override the numerical failure.

Skeleton, bind, and pose

The canonical skeleton has 55 semantic joints: root/pelvis/spine/chest/neck/head; bilateral clavicle, shoulder, elbow, wrist, hip, knee, ankle, and toe base; three-joint thumb chains; three-joint index/middle/ring/little chains. Eye and jaw kinds are declared optional but are not required by the X0 skeleton. External rig names are never canonical authority.

Rest and bind are the shaped instance's canonical A-pose. Local transforms map child-local coordinates into the parent. Runtime math uses System.Numerics row-vector matrices: pWorld = pModel * InverseBind * GlobalPose. Bind reconstruction is validated to 0.001 mm. Procedural region-based weights are finite, nonnegative, bounded, and normalized per vertex. X0 uses linear blend skinning.

The bounded sweep evaluates shoulder 35°/70°, elbow 45°/90°, hip 35°/70°, and knee 45°/90°. All eight cases are finite, preserve face identity, have zero collapsed triangles, and move surface-bound attachment points with their semantic follow joints. Surface-area ratios range from 1.003 to 1.119 and absolute-volume ratios from 0.985 to 1.006. The current orientation-reversal proxy reports 48–203 affected triangles depending on pose, so the sweep is not accepted as stable deformation. This isolates procedural joint weights and coarse joint-region topology as a remaining foundation blocker; no cinematic-quality claim is made.

Landmarks, measurements, and attachments

Landmark types remain separate: SurfaceLandmark, JointLandmark, MeasurementLandmark, and AttachmentLandmark. Surface landmarks bind by topology ID, stable face ID, binding triangle, and barycentric coordinates. X0 contains 33 surface and 55 joint landmarks. Placement protocol, confidence, symmetry partner, provenance, and review status are explicit. Authored surface points are marked unreviewed pending human anatomical review.

Measurement protocols name their version, measurement pose, operands, units, evaluator, and validity. Neutral engineering values are:

Measurement Value
Height 1750.00 mm
Shoulder width 467.60 mm
Hip-width proxy 222.11 mm
Arm link-chain length 584.19 mm
Leg link-chain length 842.06 mm
Foot-length proxy 309.26 mm
Hand-length proxy 168.11 mm
Chest-depth region extent 249.99 mm

These are reproducible engineering proxies, not certified anthropometry. Waist and chest circumference remain unsupported rather than estimated from arbitrary bounds.

Nineteen attachment sites cover head, face, chest, upper back, waist, bilateral upper arm, wrist, hand, thigh, shin, ankle, and foot. Each stores a surface binding, neutral tangent/normal/binormal frame, semantic follow joint, and offset policy. The pose evidence serializes all neutral/posed positions. For example, left-wrist position moves from approximately (-528, -48.83, 877.97) mm to (-600.32, -48.83, 1276.29) mm under 90° elbow flexion; chest and waist remain on their unchanged follow joints. Foot sites move with hip/knee poses. Orientation follows the same skeleton transform as position.

Morph system

Four bounded MeasuredDimension channels are implemented without ML:

Channel Min Default Max Method
Height 1650 mm 1750 mm 1850 mm piecewise leg/torso stature distribution
Arm length -50 mm 0 +50 mm bilateral weighted shoulder-elbow-wrist extension
Leg length -60 mm 0 +60 mm bilateral hip-knee-ankle extension with sole fixed
Shoulder width -40 mm 0 +40 mm symmetric transverse shift with torso blend

Every endpoint is tested for unchanged topology and canonical validation. Shape-dependent joint positions, local rest transforms, inverse binds, landmarks, measurements, and attachment positions are recomputed from the shaped surface/skeleton. Out-of-range controls fail with HUM013_MorphOutOfBounds.

A combined Height=1800 mm, LegLength=+35 mm variant measures 1800.00 mm tall and 882.78 mm in the leg link-chain, while retaining the same topology hash. Shoulder width stays within 0.002 mm of neutral. Arm and hand proxy values also change slightly because stature is distributed semantically through the torso; that cross-effect is recorded rather than described as independent anthropometric solving.

Provenance and replay

Tracked authority and local evidence form this chain:

  1. adult-standard-v1.fixture.json identifies the Aetheris generator and expected topology.
  2. antonia-reference.sidecar.json pins Antonia source, hash, attribution, component scope, exclusions, and the unresolved output-admission gate.
  3. x0-registration-config.json freezes the deterministic fit.
  4. Generated canonical-adult-standard-v1.json contains surface, semantics, skeleton, weights, landmarks, measurements, morphs, sites, and authored-template provenance.
  5. Local fit-provenance.json hashes canonical input, reference, sidecar, config, fitted positions, and connectivity.
  6. Local fit-evidence.json records screening metrics and failure reasons; pose-sweep-evidence.json records pose behavior.

From the repository root:

pwsh -File scripts/qualify-humanoid-x0.ps1
# Cached reference and focused development replay:
pwsh -File scripts/qualify-humanoid-x0.ps1 -SkipFetch -SkipFullTests

The script fetches/verifies pinned research inputs, generates and inspects the canonical artifact, runs Blender with source scripts disabled, renders evidence, emits fit and pose evidence, runs focused tests, builds the solution serially, and runs the full solution tests. -SkipFetch is available for a verified local cache and -SkipFullTests for a focused iteration. Generated and third-party data remain under ignored artifacts/local/.

Hash mismatch, missing admission, invalid topology, missing bindings, non-finite coordinates, invalid skin sums, and out-of-range morphs fail closed with structured HUM diagnostics. The fit itself emits evidence with screeningVerdict: fail; it is never promoted to the canonical artifact.

Fresh-agent handoff results

Three agents began from this guide and the named compact fixtures without reading implementation source:

  • Domain use: PASS. The agent generated and inspected the fixture, reported height 1750 mm and shoulder width 467.60 mm, posed the left elbow to 45°, and retrieved the complete left-wrist attachment frame. The posed wrist position was (-646.65, -48.83, 1062.15) mm with tangent/normal/binormal present.
  • Morph use: PASS. The agent created the documented 1800 mm, leg +35 mm variant, independently inspected it as valid, measured 882.78 mm leg link-chain length, and verified the same topology ID, connectivity hash, 16,868 vertices, and 33,716 faces.
  • Fit handoff: PASS for reproducibility. Using pwsh -File scripts/qualify-humanoid-x0.ps1 -SkipFetch -SkipFullTests, the agent regenerated the evidence without CharMorph internals. The run preserved the connectivity hash, reproduced the failing 74.58 mm/180.85 mm surface RMS/p95 and 51.47× maximum edge stretch, emitted the blocked output-admission status, and passed 25/25 focused tests.

The first two agents needed --help because the initial guide named commands without copyable argument forms; the exact forms and joint/frame conventions below were added in response. The fit agent noted a Blender 6.0 deprecation warning for Material.use_nodes; Blender 5.2.2 replay remains successful.

Validation record

  • dotnet build Aetheris.slnx -m:1: passed with 0 errors and seven existing WebAssembly/analyzer warnings.
  • Aetheris.Humanoid.Tests: 25/25 passed, including deterministic template generation, invariants, synthetic registration/replay, fit rejection diagnostics, all morph endpoints, measurements, bind reconstruction, attachments, and pose evidence.
  • Built-in module and CLI module-list checks pass with Aetheris.Humanoid and Humanoid.CanonicalSurface visible through the real aetheris modules --json path.
  • The full solution test run completed. Its concurrent pass exposed the just-added CLI expected-module-list fixture and one timing-sensitive server tessellation assertion. The fixture was updated and its exact test passed; the unchanged server test passed on immediate isolated rerun. All other reported test projects passed, including 977 Kernel Core, 1,550 Firmament, 148 Continuum, 103 Modules, 99 Sheet Metal, and 43 FEA tests.

Intended API use

var humanoid = CanonicalAdultTemplate.Create();
var measurements = HumanoidMeasurements.Evaluate(humanoid);
var pose = new HumanoidPoseState(
    "elbow-45",
    [new(HumanoidJointKind.LeftElbow,
        Quaternion.CreateFromAxisAngle(Vector3.UnitY, MathF.PI / 4))],
    HumanoidTransform.Identity);
var wrist = HumanoidPosing.EvaluateAttachment(humanoid, "site:Wrist.Left", pose);

var tall = HumanoidMorphing.Apply(humanoid, new Dictionary<HumanoidMorphId,double>
{
    [HumanoidMorphId.Height] = 1800,
    [HumanoidMorphId.LegLength] = 35
});

The CLI artifact path supports the same operations through generate, inspect, morph, pose, and sweep commands. The fit handoff requires only this guide, the sidecar, template artifact/ID, frozen config, Blender, and the hash-pinned blend; it does not require CharMorph internals.

dotnet run --project tools/Aetheris.Humanoid.X0 -- generate --out-dir artifacts/local/humanoid-x0
dotnet run --project tools/Aetheris.Humanoid.X0 -- inspect --input artifacts/local/humanoid-x0/canonical-adult-standard-v1.json
dotnet run --project tools/Aetheris.Humanoid.X0 -- morph --input artifacts/local/humanoid-x0/canonical-adult-standard-v1.json --output artifacts/local/humanoid-x0/adult-1800.json --height 1800 --leg-length 35
dotnet run --project tools/Aetheris.Humanoid.X0 -- pose --input artifacts/local/humanoid-x0/canonical-adult-standard-v1.json --output artifacts/local/humanoid-x0/elbow-45.obj --left-elbow-deg 45
dotnet run --project tools/Aetheris.Humanoid.X0 -- sweep --input artifacts/local/humanoid-x0/canonical-adult-standard-v1.json --output artifacts/local/humanoid-x0/pose-sweep-evidence.json

CLI joint-degree controls use the same right-handed local rotation axes as the C# API: shoulder/elbow use +Y and hip/knee use +X. left-elbow-deg 45 therefore matches the C# example. Attachment JSON orders its orthonormal basis as tangent, normal, binormal, followed by its posed position. A height morph updates both the evaluated Height protocol and Frame.NormalizedHeightMm; the unchanged 1750 mm value identifies only the neutral authored template.

Boundaries

This is one adult reference and one authored neutral. Diversity and cross-body qualification are deferred. There is no mean-body, PCA, broad-population, medical, child, or elderly claim. There is no second admitted reference. Reom remains excluded.

The face is neutral and coarse, without expression basis, FACS, lip sync, or a qualified mouth interior. Shoulder and hip skinning fail the current pose-orientation screen. Hands and feet are semantic but low-detail. There is no qualified self-intersection detector, garment or hair system, gait or grasp solver, ML model, VRoid parser, runtime dependency on CharMorph, or manufacturing-BRep representation of skin.

The completed substrate removes the need to rediscover IDs, frame, region vocabulary, skeleton, binding convention, typed landmarks, measurements, attachments, morph boundaries, diagnostics, and provenance. Acceptance now depends on improving registration correspondence/deformation and joint-region skinning, not on inventing another humanoid architecture.