Eve library

ISIS v2 Terrain Heightmap Pack Control-Conditioned Workflow Graph

Guide

Revision 1

On this page

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

Objective#

Define a control-conditioned workflow graph for terrain-heightmap-pack that supports pose-landmark/depth/segmentation/normal/canny/lineart guidance while preserving deterministic terrain elevation topology and reconstruction-anchor defaults.

Deterministic Defaults#

Setting Value
checkpointModel sd_xl_base_1.0.safetensors
promptTemplateId terrain-heightmap-pack-control-conditioned-v1
styleProfileId terrain-heightmap-style-anchor-v1
colorScript granite gray, alpine moss green, glacial blue accents, muted earth browns
lensProfile terrain-map-topdown-orthographic
seed 2026110405
width 2048
height 2048
steps 38
cfgScale 6.1
samplerName dpmpp_2m_sde
scheduler karras
denoise 1
poseControlModel control_v11p_sd15_openpose.safetensors
depthControlModel control_v11f1p_sd15_depth.safetensors
segmentationControlModel control_v11p_sd15_seg.safetensors
normalControlModel control_v11p_sd15_normalbae.safetensors
cannyControlModel control_v11p_sd15_canny.safetensors
lineartControlModel control_v11p_sd15_lineart.safetensors
poseStrength 0.72
depthStrength 0.76
segmentationStrength 0.64
normalStrength 0.7
cannyStrength 0.58
lineartStrength 0.64
batchSize 1
outputFormat png
outputChannels 4

Input Contract#

Input Type Required Default
pose_map image no n/a
depth_map image no n/a
segmentation_map image no n/a
normal_map image no n/a
canny_map image no n/a
lineart_map image no n/a
use_pose_control boolean yes true
use_depth_control boolean yes true
use_segmentation_control boolean yes true
use_normal_control boolean yes false
use_canny_control boolean yes false
use_lineart_control boolean yes false
pose_strength float yes 0.72
depth_strength float yes 0.76
segmentation_strength float yes 0.64
normal_strength float yes 0.7
canny_strength float yes 0.58
lineart_strength float yes 0.64
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
height_output_mode enum yes height-only-grayscale
elevation_range_profile enum yes balanced-relief
color_palette_profile string yes granite gray, alpine moss green, glacial blue accents, muted earth browns
prompt_template_id string yes terrain-heightmap-pack-control-conditioned-v1
style_profile_id string yes terrain-heightmap-style-anchor-v1
color_script string yes granite gray, alpine moss green, glacial blue accents, muted earth browns
lens_profile string yes terrain-map-topdown-orthographic
negative_prompt string no flat terrain, staircase banding, terracing artifacts, broken ridgelines, drainage inversions, seam discontinuities, tiling repetition, implausible erosion, blurry elevation detail, text, watermark, jpeg artifacts
seed integer yes 2026110405
width integer yes 2048
height integer yes 2048
steps integer yes 38
cfg_scale float yes 6.1

Graph Nodes#

Node ID Class Role Output Count
n1 LoadImage depth-control-input 2
n2 LoadImage segmentation-control-input 2
n3 LoadImage canny-control-input 2
n4 CheckpointLoaderSimple model-load 3
n5 ControlNetLoader depth-control-load 1
n6 ControlNetLoader segmentation-control-load 1
n7 ControlNetLoader canny-control-load 1
n8 CLIPTextEncode positive-conditioning 1
n9 CLIPTextEncode negative-conditioning 1
n10 ControlNetApply depth-control-apply 1
n11 ControlNetApply segmentation-control-apply 1
n12 ControlNetApply canny-control-apply 1
n13 EmptyLatentImage latent-init 1
n14 KSampler latent-sample 1
n15 VAEDecode image-decode 1
n16 SaveImage artifact-output 0
n17 LoadImage pose-control-input 2
n18 ControlNetLoader pose-control-load 1
n19 ControlNetApply pose-control-apply 1
n20 LoadImage normal-control-input 2
n21 ControlNetLoader normal-control-load 1
n22 ControlNetApply normal-control-apply 1
n23 LoadImage lineart-control-input 2
n24 ControlNetLoader lineart-control-load 1
n25 ControlNetApply lineart-control-apply 1

Graph Edges#

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

Topological Node Order#

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

Research Alignment#

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

Acceptance Criteria#

  • Graph is acyclic and topologically sortable.
  • Pose/depth/segmentation/normal/canny/lineart control paths are explicitly represented through ControlNet loaders and apply nodes.
  • At least one control mode can be enabled per run without breaking deterministic sampler/model defaults.
  • Pose control is scoped to sparse reconstruction landmarks and structural anchors rather than character anatomy.
  • Output contract aligns to MXA-0361 required output classes.
  • Terrain seam, hydrology, and elevation controls are first-class required inputs for controlled generation.

Traceability#

  • Checklist item: MXA-0364
  • Ticket key: ISIS2-00562
  • 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
    • libs/isis/workflows/src/workflows/video/animatediff-controlnet.json
    • libs/isis/workflows/src/workflows/texture/environment-map.json
    • libs/isis/workflows/src/workflows/texture/3d-texture.json
    • docs/domains/isis/remediation-v2/ISIS_V2_CONTROL_TAXONOMY.json
    • docs/domains/isis/remediation-v2/ISIS_V2_OUTPUT_PACKAGE_TAXONOMY.json
    • ISIS_TODOS_2.md