flow.connect
flow.connect(...)는 flow = px.Flow(...)로 만든 Flow 객체의 메서드입니다. 이 한 줄이 PXFLOW Studio의 port 연결선 하나와 대응합니다.
무엇을 만드나요?
Flow input이나 앞 Node의 result를 다음 Node의 input에 전달하는 관계 하나를 만듭니다.
Studio에서는 어디에 보이나요?
Canvas에서 source port와 destination port 사이의 연결선으로 보입니다.
문법
python
flow.connect(source, destination)최소 예제
아래 코드는 Flow API의 전체 최소 예제에 있는 flow, demand와 check를 이어서 사용합니다.
python
flow.connect(demand, check.inputs.demand)Node result를 연결할 때도 같은 문법을 사용합니다.
python
flow.connect(
first_check.results.utilization,
summary.inputs.utilization,
)두 번째 예제의 first_check와 summary는 앞서 flow.node(...)로 배치해 얻은 Node 객체입니다.
매개변수
| 이름 | 설명 |
|---|---|
source | Flow input 또는 배치된 Node·Subflow의 이름 있는 result handle |
destination | 배치된 Node·Subflow의 정확한 input handle |
반환값과 handle
연결 관계를 현재 Flow에 추가합니다. 이후 연결을 가리키는 별도 사용자 handle은 필요하지 않습니다.
규칙과 진단
- source와 destination의 타입, 단위와 null 허용 여부가 호환되어야 합니다.
- destination은
node.inputs.<port_key>, Node source는node.results.<port_key>까지 정확히 선택합니다. - Python 변수 대입이나
flow.node(...)keyword로 숨은 연결을 만들지 않습니다. - Report 값 → Flow input, Flow result → Report 위치의 연결은 Report가 저장합니다.
flow.connect(...)는 현재 Flow Canvas 내부 연결에만 사용합니다. - 존재하지 않는 port, 반대 방향 연결 또는 호환되지 않는 타입·단위는 validation에서 해당 연결을 가리켜 표시합니다.