Unbatch 🎥🅥🅗🅢 (Unbatch) - ComfyUI-VideoHelperSuite

Unbatch 노드는 Video Helper Suite의 유틸리티 도구로, 핵심 기능은 배치(batched)된 입력 데이터를 분해하거나 병합하여 단일 데이터 스트림으로 복원하는 것입니다. 주로 비디오 또는 이미지 시퀀스 처리 과정에서 배치로 패키징된 데이터를 처리하여, 후속의 프레임별 또는 독립적인 작업을 용이하게 하는 데 사용됩니다.

노드 기능

이 노드는 기술적으로 PyTorch 텐서(torch.Tensor), 특정 키(예: 'samples' 또는 'waveform')를 포함하는 딕셔너리, 그리고 기타 반복 가능한 객체를 포함한 다양한 데이터 유형을 지원합니다. 핵심 메커니즘은 입력 데이터의 첫 번째 요소 유형을 확인하여 어떤 병합 전략을 사용할지 결정합니다: 텐서의 경우 torch.cat을 사용하여 연결하고, 특정 딕셔너리의 경우 내부 텐서 데이터를 병합하며, 다른 유형의 경우 누적 연산을 사용하여 병합합니다.

노드 매개변수 설명 - Unbatch 🎥🅥🅗🅢

연결 입력 (Inputs)

매개변수 이름	데이터 유형	필수	기본값	값 범위/옵션	설명
`batched`	*	예	-	-	입력 매개변수 batched: 배치 처리된 데이터 목록을 받아, 노드가 이를 연속적인 데이터 스트림으로 병합하거나 분해합니다. 입력은 특정 값 범위 제한 없이 모든 유형의 목록이 될 수 있습니다.

사용 시나리오

일반적인 비디오 프레임 후처리 워크플로에서는 먼저 Batch 노드를 사용하여 여러 프레임 이미지를 패키징한 후, 일괄 업스케일링 또는 필터 처리를 수행할 수 있습니다. 처리가 완료되면 Unbatch 노드를 사용하여 이 배치 처리된 이미지 프레임을 분리하여, 프레임별로 저장하거나 독립적인 프레임 간 합성 작업을 수행할 수 있습니다.

주의사항

이 노드는 입력이 목록 형태의 데이터여야 합니다(INPUT_IS_LIST = True로 제어됨). 이는 일반적으로 Batch 노드와 같이 목록을 출력하는 노드를 입력으로 연결해야 함을 의미합니다. 딕셔너리 유형의 입력에 대해서는 노드가 'batch_index' 키가 존재할 경우 이를 제거합니다.

Unbatch 🎥🅥🅗🅢 노드 소스 코드 링크

Unbatch 🎥🅥🅗🅢 노드는 ComfyUI-VideoHelperSuite 노드 패키지에서 가져왔습니다.

Unbatch 🎥🅥🅗🅢(Unbatch)

Unbatch