Eve library

ISIS v2 Foliage Pack Control-Conditioned Workflow Graph

Guide

Revision 1

On this page

Generated: 2026-03-02T04:39:57.614Z Checklist: MXA-0382 (ISIS2-00580) Asset Family: foliage-pack Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to 2026-10-30)

Objective#

Define a control-conditioned workflow graph for foliage-pack that supports depth/segmentation/normal/canny/lineart guidance while preserving deterministic canopy topology defaults, with pose control explicitly marked not applicable for static foliage tiles.

Deterministic Defaults#

Setting Value
checkpointModel sd_xl_base_1.0.safetensors
promptTemplateId foliage-pack-control-conditioned-v1
styleProfileId foliage-pack-style-anchor-v1
colorScript evergreen deep green, fern olive, bark umber, moss highlights
lensProfile foliage-tile-orthographic
seed 2026110405
width 2048
height 2048
steps 38
cfgScale 6.1
samplerName dpmpp_2m_sde
scheduler karras
denoise 1
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_sd15s2_lineart_anime.safetensors
depthStrength 0.76
segmentationStrength 0.66
normalStrength 0.62
cannyStrength 0.54
lineartStrength 0.5
batchSize 1
outputFormat png
outputChannels 4

Input Contract#

Input Type Required Default
depth_map image no n/a
segmentation_map image no n/a
normal_map image no n/a
edge_map image no n/a
lineart_map image no n/a
use_depth_control boolean yes true
use_segmentation_control boolean yes true
use_normal_control boolean yes true
use_canny_control boolean yes false
use_lineart_control boolean yes false
depth_strength float yes 0.76
segmentation_strength float yes 0.66
normal_strength float yes 0.62
canny_strength float yes 0.54
lineart_strength float yes 0.5
foliage_theme enum yes temperate-understory
biome_context enum yes temperate-forest
canopy_structure_profile enum yes layered-canopy
species_mix_profile enum yes mixed-forest
ground_cover_density_class enum yes balanced
leaf_cluster_scale_profile enum yes medium-leaf
stem_branch_complexity_profile enum yes balanced
wind_response_profile enum yes gentle-breeze
seasonality_profile enum yes summer-peak
tiling_mode enum yes xy
seam_blend_strategy enum yes hybrid-stitch
foliage_resolution_class enum yes 4k-square
leaf_specular_profile enum yes matte-natural
branch_bark_profile enum yes rough-ridged
color_palette_profile string yes evergreen deep green, fern olive, bark umber, moss highlights
prompt_template_id string yes foliage-pack-control-conditioned-v1
style_profile_id string yes foliage-pack-style-anchor-v1
color_script string yes evergreen deep green, fern olive, bark umber, moss highlights
lens_profile string yes foliage-tile-orthographic
negative_prompt string no blurry foliage, muddy leaf clusters, branch silhouette collapse, seam repeats, segmentation bleed, warped depth cues, noisy edge halos, 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 normal-control-input 2
n4 LoadImage canny-control-input 2
n5 LoadImage lineart-control-input 2
n6 CheckpointLoaderSimple model-load 3
n7 ControlNetLoader depth-control-load 1
n8 ControlNetLoader segmentation-control-load 1
n9 ControlNetLoader normal-control-load 1
n10 ControlNetLoader canny-control-load 1
n11 ControlNetLoader lineart-control-load 1
n12 CLIPTextEncode positive-conditioning 1
n13 CLIPTextEncode negative-conditioning 1
n14 ControlNetApply depth-control-apply 1
n15 ControlNetApply segmentation-control-apply 1
n16 ControlNetApply normal-control-apply 1
n17 ControlNetApply canny-control-apply 1
n18 ControlNetApply lineart-control-apply 1
n19 EmptyLatentImage latent-init 1
n20 KSampler latent-sample 1
n21 VAEDecode image-decode 1
n22 SaveImage artifact-output 0

Graph Edges#

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

Topological Node Order#

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

Research Alignment#

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

Acceptance Criteria#

  • Graph is acyclic and topologically sortable.
  • 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 explicitly marked not applicable for static foliage tile generation.
  • Output contract aligns to MXA-0379 required output classes.
  • Canopy silhouette, branch continuity, and seam-safe tiling controls remain first-class required inputs for controlled generation.

Traceability#

  • Checklist item: MXA-0382
  • Ticket key: ISIS2-00580
  • Source references:
    • docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json
    • docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_REQUIREMENTS_BRIEF.json
    • docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_BASELINE_WORKFLOW_GRAPH.json
    • docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_IMAGE_CONDITIONED_WORKFLOW_GRAPH.json
    • libs/isis/workflows/src/workflows/video/animatediff-controlnet.json
    • libs/isis/workflows/src/workflows/texture/3d-texture.json
    • libs/isis/workflows/src/workflows/texture/environment-map.json
    • docs/domains/isis/remediation-v2/ISIS_V2_CONTROL_TAXONOMY.json
    • docs/domains/isis/remediation-v2/ISIS_V2_WORKFLOW_AUTHORING_GUIDE.json
    • docs/domains/isis/remediation-v2/ISIS_V2_OUTPUT_PACKAGE_TAXONOMY.json
    • ISIS_TODOS_2.md