Eve library

ISIS v2 Weapon Pack Control-Conditioned Workflow Graph

Guide

Revision 1

On this page

Generated: 2026-02-28T22:33:40.032Z Checklist: MXA-0238 (ISIS2-00436) Asset Family: weapon-pack Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to 2026-10-30)

Objective#

Define a control-conditioned workflow graph for weapon-pack that supports depth/segmentation/canny constraints while preserving deterministic weapon-generation defaults.

Deterministic Defaults#

Setting Value
checkpointModel sd_xl_base_1.0.safetensors
seed 2026112504
width 1792
height 1024
steps 34
cfgScale 6.1
samplerName dpmpp_2m_sde
scheduler karras
denoise 1
depthControlModel control_v11f1p_sd15_depth.safetensors
segmentationControlModel control_v11p_sd15_seg.safetensors
cannyControlModel control_v11p_sd15_canny.safetensors
depthStrength 0.74
segmentationStrength 0.62
cannyStrength 0.68
batchSize 1
outputFormat png
outputChannels 4

Input Contract#

Input Type Required Default
depth_map image no n/a
segmentation_map image no n/a
canny_map image no n/a
use_depth_control boolean yes true
use_segmentation_control boolean yes false
use_canny_control boolean yes true
depth_strength float yes 0.74
segmentation_strength float yes 0.62
canny_strength float yes 0.68
weapon_class enum yes assault-rifle
manufacturer_style enum yes military-industrial
era_technology enum yes modern
faction_alignment enum yes allied-regiment
intended_use enum yes mid-range
scale_class enum yes standard
material_stack enum yes blued-steel-polymer
silhouette_profile enum yes balanced
grip_configuration enum yes stocked
attachment_profile enum yes optic-and-light
condition_grade enum yes field-worn
safety_state enum yes safe
render_view_set enum yes hero-3q-front
lighting_setup enum yes neutral-studio
color_palette_profile string yes graphite black, brushed steel, olive drab polymer, brass accent wear
emblem_policy enum yes faction-insignia-subtle
style_preset enum yes stylized
negative_prompt string no blurry, low resolution, malformed weapon geometry, impossible mechanics, mirrored trigger guards, clipped muzzles, floating components, text, watermark, jpeg artifacts
seed integer yes 2026112504
width integer yes 1792
height integer yes 1024
steps integer yes 34
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

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 n12:0 n14.positive
e15 n9:0 n14.negative
e16 n13:0 n14.latent_image
e17 n14:0 n15.samples
e18 n15:0 n16.images

Topological Node Order#

n1 -> n13 -> n2 -> n3 -> n4 -> n5 -> n6 -> n7 -> n8 -> n10 -> n11 -> n12 -> n9 -> n14 -> n15 -> n16

Research Alignment#

Workflow Path Control Nodes
AnimateDiff with ControlNet libs/isis/workflows/src/workflows/video/animatediff-controlnet.json 3
Sacred Artifact 3D Reconstruction libs/isis/workflows/src/workflows/3d/artifact-reconstruction.json 0
3D Texture Generator libs/isis/workflows/src/workflows/texture/3d-texture.json 0

Acceptance Criteria#

  • Graph is acyclic and topologically sortable.
  • Depth/segmentation/canny 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-0235 required output classes.
  • Weapon class, attachment profile, safety state, and silhouette controls are first-class required inputs for controlled generation.

Traceability#

  • Checklist item: MXA-0238
  • Ticket key: ISIS2-00436
  • Source references:
    • docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json
    • docs/domains/isis/remediation-v2/ISIS_V2_WEAPON_PACK_REQUIREMENTS_BRIEF.json
    • docs/domains/isis/remediation-v2/ISIS_V2_WEAPON_PACK_BASELINE_WORKFLOW_GRAPH.json
    • docs/domains/isis/remediation-v2/ISIS_V2_WEAPON_PACK_IMAGE_CONDITIONED_WORKFLOW_GRAPH.json
    • libs/isis/workflows/src/workflows/video/animatediff-controlnet.json
    • libs/isis/workflows/src/workflows/3d/artifact-reconstruction.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