Eve library

ISIS v2 Terrain Heightmap Pack Image-Conditioned Workflow Graph

Guide

Revision 1

On this page

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

Objective#

Define an image-conditioned terrain-heightmap-pack workflow graph that applies style/composition references through IPAdapter while preserving deterministic terrain elevation topology defaults.

Deterministic Defaults#

Setting Value
checkpointModel sd_xl_base_1.0.safetensors
adapterModel ip-adapter_sdxl.safetensors
promptTemplateId terrain-heightmap-pack-image-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 2026110402
width 2048
height 2048
steps 36
cfgScale 6
samplerName dpmpp_2m_sde
scheduler karras
denoise 1
referenceStrength 0.72
compositionStrength 0.58
batchSize 1
outputFormat png
outputChannels 4

Input Contract#

Input Type Required Default
style_reference_image image yes n/a
composition_reference_image image no n/a
use_composition_reference boolean yes false
reference_strength float yes 0.72
composition_strength float yes 0.58
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-image-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, text, watermark, jpeg artifacts
seed integer yes 2026110402
width integer yes 2048
height integer yes 2048
steps integer yes 36
cfg_scale float yes 6

Graph Nodes#

Node ID Class Role Output Count
n1 LoadImage style-reference-load 2
n2 LoadImage composition-reference-load 2
n3 CheckpointLoaderSimple model-load 3
n4 IPAdapterLoader adapter-load 1
n5 IPAdapterApply style-condition 1
n6 IPAdapterApply composition-condition 1
n7 CLIPTextEncode positive-conditioning 1
n8 CLIPTextEncode negative-conditioning 1
n9 EmptyLatentImage latent-init 1
n10 KSampler latent-sample 1
n11 VAEDecode image-decode 1
n12 SaveImage artifact-output 0

Graph Edges#

Edge ID From To
e1 n3:0 n5.model
e2 n4:0 n5.ipadapter
e3 n1:0 n5.image
e4 n5:0 n6.model
e5 n4:0 n6.ipadapter
e6 n2:0 n6.image
e7 n3:1 n7.clip
e8 n3:1 n8.clip
e9 n6:0 n10.model
e10 n7:0 n10.positive
e11 n8:0 n10.negative
e12 n9:0 n10.latent_image
e13 n10:0 n11.samples
e14 n3:2 n11.vae
e15 n11:0 n12.images

Topological Node Order#

n1 -> n2 -> n3 -> n4 -> n5 -> n6 -> n7 -> n8 -> n9 -> n10 -> n11 -> n12

Research Alignment#

Workflow Path LoadImage Nodes IPAdapter Nodes
HDRI Environment Map Generator libs/isis/workflows/src/workflows/texture/environment-map.json 0 0
AI Style Transfer libs/isis/workflows/src/workflows/utility/style-transfer.json 2 0
3D Texture Generator libs/isis/workflows/src/workflows/texture/3d-texture.json 0 0

Acceptance Criteria#

  • Graph is acyclic and topologically sortable.
  • Image conditioning path is explicit and includes style + optional composition references.
  • All deterministic defaults are explicitly set (seed, sampler, scheduler, checkpoint, adapter).
  • Output contract aligns to MXA-0361 required output classes.

Traceability#

  • Checklist item: MXA-0363
  • Ticket key: ISIS2-00561
  • 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
    • libs/isis/workflows/src/workflows/texture/environment-map.json
    • libs/isis/workflows/src/workflows/utility/style-transfer.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_WORKFLOW_AUTHORING_GUIDE.json
    • ISIS_TODOS_2.md