flow.group
flow.group(...)은 flow = px.Flow(...)로 만든 Flow 객체의 메서드입니다. 같은 Flow에 이미 놓인 Node들을 하나의 편집 가능한 묶음으로 정리합니다.
무엇을 만드나요?
기존 Node들의 시각적 membership을 만듭니다. Node, 연결, 계산 순서와 공개 input/result는 그대로 유지됩니다.
Studio에서는 어디에 보이나요?
Canvas에서 Subflow · Group으로 보입니다. 더블클릭하면 내부 Canvas가 열리고 member Node를 직접 편집할 수 있습니다. 화면에서는 Node들을 드래그 선택한 뒤 Group selection으로 같은 결과를 만들 수 있습니다.
문법
python
flow.group(group_key, *, members, label=None)최소 예제
아래 코드는 Flow API의 전체 최소 예제에 정의한 flow와 @px.function target인 calculate_utilization을 이어서 사용합니다.
python
service_check = flow.node("service_check", calculate_utilization)
ultimate_check = flow.node("ultimate_check", calculate_utilization)
flow.group(
"strength_checks",
members=[service_check, ultimate_check],
label="Strength checks",
)매개변수
| 이름 | 설명 |
|---|---|
group_key | 현재 Flow에서 Group을 구분하는 lower_snake_case 고유 이름 |
members | 같은 Flow에 이미 배치한 Node handle 목록 |
label | Canvas에 표시할 선택적인 이름 |
반환값과 handle
Group membership을 현재 Flow에 추가합니다. 계산 연결에는 Group handle을 사용하지 않고 기존 member Node handle을 계속 사용합니다.
규칙과 진단
- member는 모두 같은 Flow에 있어야 합니다.
- Group은 새 실행 단계나 데이터 의존성을 만들지 않습니다.
- Group을 풀어도 member Node와 연결은 유지됩니다.
- 별도 Flow를 가져오는 기능은 Group이 아니라
flow.subflow(...)입니다. - 중복 key나 다른 Flow의 member는 validation에서 오류로 표시합니다.