Eve library

ISIS v2 Terrain Heightmap Pack Consistency-Locked Workflow Graph

Guide

Revision 1

On this page

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

Objective#

Define a consistency-locked terrain-heightmap-pack workflow graph that enforces continuity profile state across terrain layout, hydrology, lens, and color-script dimensions while retaining deterministic generation defaults.

Continuity Profile#

Profile ID Minimum Passing Dimensions Locked Dimensions
scene-continuity-profile 4 environment, lighting, lens, color-script, motion

Deterministic Defaults#

Setting Value
checkpointModel sd_xl_base_1.0.safetensors
sceneAnchorAdapterModel ip-adapter-plus_sdxl_vit-h.safetensors
styleAdapterModel ip-adapter_sdxl.safetensors
segmentationControlModel control_v11p_sd15_seg.safetensors
depthControlModel control_v11f1p_sd15_depth.safetensors
seed 2026110406
width 2048
height 2048
steps 40
cfgScale 6.2
samplerName dpmpp_2m_sde
scheduler karras
denoise 1
sceneAnchorLockStrength 0.86
layoutLockStrength 0.76
hydrologyLockStrength 0.74
lensLockStrength 0.68
styleLockStrength 0.8
continuityProfileId scene-continuity-profile
continuityProfileRevision 1
consistencyWindowSize 5
focalLengthMm 28
outputFormat png
outputChannels 4

Input Contract#

Input Type Required Default
continuity_profile_id string yes scene-continuity-profile
continuity_profile_revision integer yes 1
continuity_locked_dimensions string[] yes environment,lighting,lens,color-script,motion
scene_profile_id string yes terrain-scene-profile
style_profile_id string yes terrain-style-profile
scene_anchor_reference_image image yes n/a
layout_reference_map image no n/a
hydrology_reference_map image no n/a
lens_reference_frame image no n/a
use_scene_anchor_reference boolean yes true
use_layout_reference boolean yes true
use_hydrology_reference boolean yes true
use_lens_reference boolean yes false
use_style_lock boolean yes true
terrain_theme enum yes alpine-ridge
biome_context enum yes temperate-forest
macro_landform_profile enum yes rolling-hills
terrain_scope enum yes open-world-sector
tileable_axes enum yes xy
seam_blend_strategy enum yes hybrid-stitch
ridge_transition_profile enum yes soft-ridge
heightmap_resolution_class enum yes 4k-square
heightfield_density_class enum yes balanced
erosion_material_profile enum yes sedimentary
hydrology_profile enum yes seasonal-streams
elevation_range_profile enum yes balanced-relief
height_output_mode enum yes height-only-grayscale
focal_length_mm integer yes 28
color_palette_profile string yes granite gray, alpine moss green, glacial blue accents, muted earth browns
negative_prompt string no heightfield drift, ridge discontinuity, seam continuity drift, hydrology basin mismatch, lens distortion mismatch, perspective warping, blurry elevation detail, text, watermark, jpeg artifacts
seed integer yes 2026110406
width integer yes 2048
height integer yes 2048
steps integer yes 40
cfg_scale float yes 6.2
scene_anchor_lock_strength float yes 0.86
layout_lock_strength float yes 0.76
hydrology_lock_strength float yes 0.74
lens_lock_strength float yes 0.68
style_lock_strength float yes 0.8

Graph Nodes#

Node ID Class Role Output Count
n1 LoadImage scene-anchor-reference-load 2
n2 LoadImage layout-reference-load 2
n3 LoadImage hydrology-reference-load 2
n4 LoadImage lens-reference-load 2
n5 ConsistencyProfileLoader continuity-profile-load 1
n6 CheckpointLoaderSimple model-load 3
n7 IPAdapterLoader scene-anchor-adapter-load 1
n8 IPAdapterLoader style-adapter-load 1
n9 IPAdapterApply scene-anchor-lock-apply 1
n10 IPAdapterApply style-lock-apply 1
n11 ControlNetLoader layout-control-load 1
n12 ControlNetLoader hydrology-control-load 1
n13 CLIPTextEncode positive-conditioning 1
n14 CLIPTextEncode negative-conditioning 1
n15 ControlNetApply layout-lock-apply 1
n16 ControlNetApply hydrology-lock-apply 1
n17 ProfileLockMerge lens-lock-merge 1
n18 ProfileLockMerge continuity-lock-merge 1
n19 EmptyLatentImage latent-init 1
n20 KSampler latent-sample 1
n21 VAEDecode image-decode 1
n22 MetadataManifestBuilder metadata-build 1
n23 SaveImage artifact-output 0
n24 SaveJSON manifest-output 0

Graph Edges#

Edge ID From To
e1 n6:0 n9.model
e2 n7:0 n9.ipadapter
e3 n1:0 n9.image
e4 n9:0 n10.model
e5 n8:0 n10.ipadapter
e6 n6:1 n13.clip
e7 n6:1 n14.clip
e8 n13:0 n15.conditioning
e9 n11:0 n15.control_net
e10 n2:0 n15.image
e11 n15:0 n16.conditioning
e12 n12:0 n16.control_net
e13 n3:0 n16.image
e14 n16:0 n17.conditioning
e15 n5:0 n17.profile
e16 n4:0 n17.lens_reference
e17 n17:0 n18.conditioning
e18 n5:0 n18.profile
e19 n10:0 n20.model
e20 n18:0 n20.positive
e21 n14:0 n20.negative
e22 n19:0 n20.latent_image
e23 n20:0 n21.samples
e24 n6:2 n21.vae
e25 n21:0 n23.images
e26 n5:0 n22.continuity_profile
e27 n20:0 n22.sampling_trace
e28 n22:0 n24.payload

Topological Node Order#

n1 -> n11 -> n12 -> n19 -> n2 -> n3 -> n4 -> n5 -> n6 -> n13 -> n14 -> n15 -> n16 -> n17 -> n18 -> n7 -> n8 -> n9 -> n10 -> n20 -> n21 -> n22 -> n23 -> n24

Continuity Metric Thresholds#

Dimension Metric Operator Threshold
environment scene_layout_iou >= 0.76
environment depth_structure_mse <= 0.09
lighting key_light_angle_delta_deg <= 10
lighting cct_delta_kelvin <= 450
lens focal_length_delta_mm <= 2
lens distortion_profile_delta <= 0.03
color-script palette_emd <= 0.12
color-script mean_luma_delta_pct <= 6
motion optical_flow_drift_score <= 0.18
motion temporal_flicker_index <= 0.12

Research Alignment#

Workflow Path IPAdapter Nodes ControlNet Nodes
HDRI Environment Map Generator libs/isis/workflows/src/workflows/texture/environment-map.json 0 0
AnimateDiff with ControlNet libs/isis/workflows/src/workflows/video/animatediff-controlnet.json 0 2
3D Texture Generator libs/isis/workflows/src/workflows/texture/3d-texture.json 0 0

Acceptance Criteria#

  • Graph is acyclic and topologically sortable.
  • Continuity profile support is explicit through profile loader and profile-lock merge nodes.
  • Scene anchor, layout, hydrology, and lens continuity paths are represented with deterministic lock strengths and optional fallbacks.
  • Output contract aligns to required preview/source/metadata classes and includes continuity manifest output.
  • Terrain-specific continuity controls preserve ridge, seam, and drainage profile stability across locked generations.

Traceability#

  • Checklist item: MXA-0365
  • Ticket key: ISIS2-00563
  • Source references:
    • docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json
    • docs/domains/isis/remediation-v2/ISIS_V2_TERRAIN_HEIGHTMAP_PACK_REQUIREMENTS_BRIEF.json
    • docs/domains/isis/remediation-v2/ISIS_V2_TERRAIN_HEIGHTMAP_PACK_BASELINE_WORKFLOW_GRAPH.json
    • docs/domains/isis/remediation-v2/ISIS_V2_TERRAIN_HEIGHTMAP_PACK_IMAGE_CONDITIONED_WORKFLOW_GRAPH.json
    • docs/domains/isis/remediation-v2/ISIS_V2_TERRAIN_HEIGHTMAP_PACK_CONTROL_CONDITIONED_WORKFLOW_GRAPH.json
    • docs/domains/isis/remediation-v2/ISIS_V2_CONSISTENCY_TAXONOMY.json
    • libs/isis/workflows/src/workflows/texture/environment-map.json
    • libs/isis/workflows/src/workflows/video/animatediff-controlnet.json
    • libs/isis/workflows/src/workflows/texture/3d-texture.json
    • libs/isis/workflows/src/consistency/orchestration.ts
    • docs/domains/isis/remediation-v2/ISIS_V2_CONTROL_TAXONOMY.json
    • ISIS_TODOS_2.md