Eve library

ISIS v2 Terrain Heightmap Pack Side-by-Side Comparison Tools

Guide

Revision 1

On this page

Generated: 2026-08-02T18:14:05.464Z Checklist: MXA-0372 (ISIS2-00570) Asset Family: terrain-heightmap-pack Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to 2026-10-30)

Objective#

Deliver side-by-side comparison tools specialized for terrain-heightmap-pack outputs with profile-aware workflow filtering, recommended dimension presets, and terrain theme/biome/landform/scope/tileable/seam/ridge/resolution/density/erosion/hydrology/output-mode/elevation/profile/control/reference/lock/lens/focal-length/sampler/seed scoring layered over generic style/identity consistency checks.

Comparison Profile Modes#

  • auto
  • general
  • architecture-kitbash-pack
  • interior-scene-pack
  • prop-pack-general
  • environment-tileset-pack
  • environment-matte-painting
  • environment-concept-art
  • creature-concept-art
  • character-concept-art
  • character-turnaround-sheet
  • character-expression-sheet
  • character-costume-variant-pack
  • character-prop-interaction-sheet
  • npc-crowd-variation-pack
  • weapon-pack
  • vehicle-exterior-pack
  • vehicle-interior-pack
  • ui-icon-pack
  • hud-element-pack
  • material-pbr-pack
  • decal-pack
  • terrain-heightmap-pack

Terrain Side-by-Side Metrics#

  • Terrain Heightmap Pack Family Match: present
  • Workflow Variant Alignment: present
  • Terrain Theme Match: present
  • Biome Context Match: present
  • Macro Landform Profile Match: present
  • Terrain Scope Match: present
  • Tileable Axes Match: present
  • Seam Blend Strategy Match: present
  • Ridge Transition Profile Match: present
  • Heightmap Resolution Class Match: present
  • Heightfield Density Class Match: present
  • Erosion Material Profile Match: present
  • Hydrology Profile Match: present
  • Color Palette Profile Match: present
  • Height Output Mode Match: present
  • Elevation Range Profile Match: present
  • Prompt Template Match: present
  • Style Profile Match: present
  • Color Script Match: present
  • Lens Profile Match: present
  • Scene Profile Match: present
  • Continuity Profile Match: present
  • Continuity Revision Match: present
  • Continuity Dimensions Match: present
  • Control Toggle Alignment: present
  • Control Strength Alignment: present
  • Reference Toggle Alignment: present
  • Reference Strength Alignment: present
  • Style Lock Alignment: present
  • Lock Strength Alignment: present
  • Focal Length Alignment: present
  • Resolution Alignment: present
  • Sampler Alignment: present
  • Seed Alignment: present

Implementation Surface#

Group Method/Signal Present
output-consistency-utils readComparisonWorkspaceStateFromSearch yes
output-consistency-utils buildComparisonWorkspacePath yes
output-consistency-utils calculateAverageConsistencyScore yes
terrain-heightmap-pack-comparison-utils isTerrainHeightmapPackOutput yes
terrain-heightmap-pack-comparison-utils buildTerrainHeightmapPackComparisonContext yes
terrain-heightmap-pack-comparison-utils resolveTerrainHeightmapPackComparisonProfileFromOutputs yes
terrain-heightmap-pack-comparison-utils buildTerrainHeightmapPackConsistencyReport yes
OutputComparisonWorkspacePage comparisonProfileState yes
OutputComparisonWorkspacePage profileSelectorRendered yes
OutputComparisonWorkspacePage profileOptionRendered yes
OutputComparisonWorkspacePage profilePresetActionRendered yes
OutputComparisonWorkspacePage profileMismatchGuard yes
OutputComparisonWorkspacePage profileAwareMetrics yes

Verification Commands#

  • pnpm --filter @isis/web exec vitest run src/pages/terrain-heightmap-pack-comparison-utils.spec.ts src/pages/output-consistency-utils.spec.ts
  • pnpm --filter @isis/web exec vitest run src/pages/OutputComparisonWorkspacePage.spec.tsx -t "terrain-heightmap-pack"

Acceptance Criteria#

  • Comparison workspace supports explicit terrain-heightmap-pack profile selection with query-string persistence and auto-detect fallback.
  • Terrain-heightmap-pack profile exposes recommended comparison dimensions and narrows selectable outputs to terrain-heightmap-pack candidates.
  • Terrain side-by-side report adds terrain family and terrain metadata/control/reference/continuity/lock/focal-length/resolution/sampler/seed alignment metrics in addition to base consistency metrics.
  • Web tests validate terrain profile URL state, specialized metric rendering, mismatch guarding, and preset dimension behavior.

Traceability#

  • Checklist item: MXA-0372
  • Ticket key: ISIS2-00570
  • Workspace route: /outputs/consistency-workspace
  • Primary artifact: docs/domains/isis/remediation-v2/ISIS_V2_TERRAIN_HEIGHTMAP_PACK_SIDE_BY_SIDE_COMPARISON_TOOLS.json
  • Supporting runbook: docs/domains/isis/runbooks/terrain-heightmap-pack-side-by-side-comparison-tools.md