Shuffle Image Batch (ShuffleImageBatch) - ComfyUI-KJNodes

Shuffle Image Batch 노드는 기술적으로 (B, H, W, C) 형태의 4차원 텐서를 입력으로 받습니다. 여기서 각각은 배치 크기, 이미지 높이, 너비 및 채널 수를 나타냅니다.

Shuffle Image Batch 노드는 이미지 배치의 순서를 무작위로 섞는 도구입니다. 핵심 기능은 여러 이미지를 포함하는 배치를 받아서 무작위 순서로 이미지를 재배열하는 것입니다. 이는 이미지 처리 워크플로우에 무작위성을 도입하여 고정된 순서로 인해 발생할 수 있는 잠재적인 패턴을 방지하는 데 도움이 됩니다.

노드 기능

이 노드는 기술적으로 (B, H, W, C) 형태의 4차원 텐서를 입력으로 받습니다. 여기서 각각은 배치 크기, 이미지 높이, 너비 및 채널 수를 나타냅니다. 노드 내부에서는 사용자가 제공한 시드(seed)를 기반으로 PyTorch의 torch.randperm 함수를 사용하여 무작위 순열 인덱스를 생성한 후, 이 인덱스에 따라 배치 차원의 이미지를 재정렬합니다. 최종적으로 형태는 동일하지만 이미지 순서가 섞인 새로운 배치를 출력합니다.

노드 파라미터 설명 - Shuffle Image Batch

연결 입력 (Inputs)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`images`	IMAGE	예	-	-	images (입력 파라미터): 순서를 섞을 이미지 배치를 입력합니다. 파라미터 타입은 IMAGE이며, 기본값은 없고 반드시 연결해야 합니다.

컨트롤 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`seed`	INT	예	123	0 - 18446744073709552000 (단계: 1)	seed (입력 파라미터): 무작위 섞기 순서를 제어하는 시드(seed) 값입니다. 파라미터 타입은 INT이며, 기본값은 123입니다. 범위는 0부터 18446744073709552000까지이며, 단계는 1입니다.

출력

파라미터 이름	데이터 타입	설명
IMAGE	IMAGE	IMAGE (출력 파라미터): 순서가 무작위로 섞인 이미지 배치를 출력합니다.

사용 시나리오

실제 응용에서 이 노드는 데이터 증강(data augmentation)이나 다양한 미리보기 갤러리 생성에 자주 사용됩니다. 예를 들어, 이미지를 일괄 생성하는 워크플로우에서 여러 생성기의 출력을 병합한 후, 이 노드를 통해 순서를 섞어서 후속 미리보기 또는 필터링 노드로 보내면, 서로 다른 생성 조건에서의 결과를 더 공정하게 비교하거나 훈련 세트를 위한 무작위화된 샘플을 준비할 수 있습니다.

주의사항

이 노드는 배치 내 이미지의 순서만 변경할 뿐, 개별 이미지의 픽셀 내용은 수정하지 않습니다. 무작위성은 완전히 시드(seed) 파라미터에 의해 제어되며, 동일한 시드를 사용하면 항상 동일한 섞기 순서를 얻습니다.

Shuffle Image Batch 노드 소스 코드 링크

Shuffle Image Batch 노드는 ComfyUI-KJNodes 노드 패키지에서 제공됩니다.

Shuffle Image Batch(ShuffleImageBatch)