Eve library

ISIS v2 Material PBR Pack Control-Conditioned Workflow Graph

Guide

Revision 1

On this page

Generated: 2026-08-02T16:03:34.421Z Checklist: MXA-0328 (ISIS2-00526) Asset Family: material-pbr-pack Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to 2026-10-30)

Objective#

Define a control-conditioned material-pbr-pack workflow graph that applies pose/depth/segmentation/normal/canny/lineart constraints where applicable while preserving deterministic, shader-ready material continuity for production review.

Deterministic Defaults#

Setting Value
checkpointModel sd_xl_base_1.0.safetensors
checkpointId sdxl-base-material-pbr-v1
promptTemplateId material-pbr-pack-control-conditioned-v1
styleProfileId material-pbr-photoreal-v1
colorScript material-neutral-energy-conserving
lensProfile material-lookdev-neutral-50mm
seed 2026121603
width 1024
height 1024
steps 38
cfgScale 6.2
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.24
depthStrength 0.78
segmentationStrength 0.62
normalStrength 0.72
cannyStrength 0.66
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 false
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.24
depth_strength float yes 0.78
segmentation_strength float yes 0.62
normal_strength float yes 0.72
canny_strength float yes 0.66
lineart_strength float yes 0.64
material_category enum yes metal
material_subtype string yes brushed_aluminum
surface_age_profile enum yes light-wear
albedo_palette_profile string yes neutral-steel-gray with subtle cool tint
roughness_profile enum yes satin
metallic_profile enum yes metallic
normal_intensity_profile enum yes medium
microdetail_profile enum yes subtle-noise
macro_pattern_scale float yes 1
tileability_mode enum yes strict-seamless
uv_repeat_target integer yes 4
displacement_intent enum yes height-lite
render_lighting_context enum yes studio-neutral
platform_target enum yes desktop
render_intent enum yes final
checkpoint_id string yes sdxl-base-material-pbr-v1
prompt_template_id string yes material-pbr-pack-control-conditioned-v1
style_profile_id string yes material-pbr-photoreal-v1
color_script string yes material-neutral-energy-conserving
lens_profile string no material-lookdev-neutral-50mm
negative_prompt string no blurry texture, seam artifacts, warped depth cues, segmentation bleed, non-pbr stylization, over-smoothed details, watermark, jpeg artifacts
material_control_preset enum yes hard-surface-precision
seed integer yes 2026121603
width integer yes 1024
height integer yes 1024
steps integer yes 38
cfg_scale float yes 6.2

Graph Nodes#

Node ID Class Role Output Count
n1 LoadImage pose-control-input 2
n2 LoadImage depth-control-input 2
n3 LoadImage segmentation-control-input 2
n4 CheckpointLoaderSimple model-load 3
n5 ControlNetLoader pose-control-load 1
n6 ControlNetLoader depth-control-load 1
n7 ControlNetLoader segmentation-control-load 1
n8 CLIPTextEncode positive-conditioning 1
n9 CLIPTextEncode negative-conditioning 1
n10 ControlNetApply pose-control-apply 1
n11 ControlNetApply depth-control-apply 1
n12 ControlNetApply segmentation-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 normal-control-input 2
n18 ControlNetLoader normal-control-load 1
n19 ControlNetApply normal-control-apply 1
n20 LoadImage canny-control-input 2
n21 ControlNetLoader canny-control-load 1
n22 ControlNetApply canny-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
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.
  • 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.
  • Output contract aligns to MXA-0325 required output classes.

Traceability#

  • Checklist item: MXA-0328
  • Ticket key: ISIS2-00526
  • Source references:
    • docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json
    • docs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_PACK_REQUIREMENTS_BRIEF.json
    • docs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_PACK_BASELINE_WORKFLOW_GRAPH.json
    • docs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_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
    • ISIS_TODOS_2.md