# 반복 구조: 공정 사이클과 마스크 배열 선택하기 [공정 필드](/docs/agents/processes.md) · [마스크](/docs/agents/masks.md) · [IMPLANT 비교](/docs/agents/tasks/implant.md) · [공개 API](/docs/agents/api.md) 같은 막 적층을 여러 번 실행하려면 **공정 그룹의 사이클**을 사용합니다. 같은 평면 패턴을 여러 위치에 만들려면 **마스크 도형 배열**을 사용합니다. 시각화 패널의 구조 배열은 현재 계산된 구조를 반복해서 보여주는 별도 기능입니다. | 목적 | 화면에서 찾을 위치 | 문서에 저장되는 핵심 설정 | 계산 의미 | | --- | --- | --- | --- | | 산화막·질화막 순서를 여러 번 적층 | 공정 플로우 → 그룹 → 그룹 반복 실행 켜기 → 사이클 수 | `GROUPSTART.cycleCount` | 그룹 안의 공정을 순서대로 다시 실행 | | 여러 구멍·창·주입 영역 배치 | 마스크 편집 → 도형 하나 선택 → 배열 설정 | 도형의 `array` | 반복 도형을 같은 마스크 안에 배치 | | 완성 구조가 여러 셀로 이어진 모습 보기 | 시각화 패널 → 배열 설정 | 시각화 설정 | 현재 그리드의 반복 렌더링. 새 공정이나 새 계산 영역을 생성하지 않음 | ## 그룹으로 적층 반복하기 공정 플로우에서 **새 그룹**을 만들고 공정을 그룹 안에 배치합니다. 그룹의 **그룹 반복 실행 켜기** 버튼을 누르면 **사이클 수** 입력·슬라이더가 나타납니다. 공정 플로우가 **썸네일** 보기(공식 예제의 기본)이면 이 버튼은 그룹 위에 포인터를 올리거나 포커스했을 때만 보이므로, 패널 머리의 **목록**으로 바꾼 뒤 누르세요. 반복 설정 변경은 스플릿의 **기준선**에서 가능합니다. 빈 그룹이나 유효한 실행 공정이 없는 그룹은 반복을 켤 수 없습니다. 기본 사이클은 1입니다. 반복 켜기만으로 공정이 두 번 실행되는 것은 아니므로 원하는 수를 입력하세요. 반복을 끄면 사이클 수는 1로 돌아갑니다. 접기/펼치기는 화면 표시이며 반복 수를 바꾸지 않습니다. Flow 1.0은 서로 맞는 `GROUPSTART`·`GROUPEND` 사이의 공정을 반복합니다. 예제의 시작 마커는 다음과 같습니다. ```json { "id": "bilayer", "kind": "GROUPSTART", "name": "Oxide / nitride", "isModule": false, "unfolded": true, "cycleCount": 3 } ``` 그 뒤에 산화막 DEPO, 질화막 DEPO, `{"id":"bilayer-end","kind":"GROUPEND","isModule":false}`가 이어집니다. 공개 문서에서는 `cycleCount`를 사용하세요. 별도의 `iterationEnabled:true`는 반복 수를 대신하지 않습니다. 현재 Flow API는 중첩·빈 그룹을 지원하지 않습니다. 사이클은 양의 정수이고 상한은 100입니다. 자식 공정 수가 N일 때 실제 상한은 `max(1, min(100, floor(500 / N)))`이므로 큰 그룹에서는 더 작습니다. 예를 들어 자식 6개이면 최대 83사이클입니다. 공개 Flow 입력은 초과 값·소수·숫자 문자열을 오류로 반환하며 임의로 줄여 실행하지 않습니다. 이는 저장된 과거 프로젝트를 읽을 때의 호환용 정규화와 구분됩니다. ### 적층 비교 파일 모든 예제는 도메인 **20×16 nm**, 입력·실제 XY 격자 **1 nm**(`gridResolution:1`), 중성 Si 기판 **10 nm**입니다. ID 5는 Si, 18은 SiO₂, 19는 Si₃N₄입니다. | 파일 | 설정·실행 내용 | 최종 높이 | 재료 부피 (nm³) | | --- | --- | ---: | --- | | [01 · 1사이클](/docs/agents/examples/comparisons/repetition/01-group-one-cycle.flow.json) | 산화막 2 nm → 질화막 1 nm, 한 번 | 13 nm | Si 3200, SiO₂ 640, Si₃N₄ 320 | | [02 · 3사이클](/docs/agents/examples/comparisons/repetition/02-group-three-cycles.flow.json) | 01의 `cycleCount`만 3으로 변경 | 19 nm | Si 3200, SiO₂ 1920, Si₃N₄ 960 | | [03 · 직접 풀어 쓴 3사이클](/docs/agents/examples/comparisons/repetition/03-expanded-three-cycles.flow.json) | 그룹 없이 DEPO 6개를 직접 나열 | 19 nm | 02와 동일 | 02의 순서는 **산화막→질화막→산화막→질화막→산화막→질화막**입니다. 산화막만 세 번 쌓은 뒤 질화막을 세 번 쌓는 구조가 아닙니다. 기판을 포함한 실행 공정 수는 01에서 3개, 02·03에서 7개입니다. 그룹 마커는 실행 공정 수에 포함하지 않습니다. 02의 단면에서 x=9.5, y=7.5 nm를 보면 z=10.5·11.5는 18, z=12.5는 19이고, 같은 패턴이 z=13~16과 16~19 nm에 반복됩니다. 02·03의 전체 단면 재료 ID가 일치하는지 테스트합니다. **그룹 안의 원본 공정 ID를 선택하면 마지막 사이클의 해당 공정까지 계산합니다.** 02에서 `computeTo("oxide")`는 세 번째 산화막 직후, 높이 18 nm까지입니다. 첫 사이클의 산화막 직후인 12 nm가 아닙니다. 중간 사이클을 별도로 비교하려면 사이클 수를 줄인 복사본이나 03처럼 명시적으로 펼친 문서를 사용하세요. 내부 가상 공정 ID를 새 문서의 ID로 작성하지 마세요. ## 마스크 도형 배열로 평면 반복하기 마스크를 편집하고 **도형 하나를 선택**하면 **배열 설정**에서 다음 항목을 바꿀 수 있습니다. 아무것도 선택하지 않았거나 여러 도형을 동시에 선택하면 이 설정은 숨겨집니다. | 화면 항목 | JSON 필드 | 의미 | | --- | --- | --- | | 가로 개수 (X) | `array.columns` | 도형의 로컬 X 방향 개수, 기본 1 | | 세로 개수 (Y) | `array.rows` | 도형의 로컬 Y 방향 개수, 기본 1 | | 가로 간격 | `array.columnSpacing` | 이웃한 도형 경계 사이 빈틈, 기본 0 nm | | 세로 간격 | `array.rowSpacing` | 이웃한 도형 경계 사이 빈틈, 기본 0 nm | 개수가 1인 축은 간격 입력이 비활성화됩니다. JSON 길이 값은 화면의 표시 단위와 관계없이 nm입니다. 개수는 양의 정수, 간격은 0 이상이어야 합니다. **간격은 피치가 아닙니다.** 회전하지 않은 사각형에서 유효 폭 W=`width × scaleX`, 유효 높이 H=`height × scaleY`라면 피치는 `W + columnSpacing`, `H + rowSpacing`입니다. 원은 지름, 다각형은 유효 경계 크기를 기준으로 합니다. 배열은 기존 도형을 기준으로 양쪽에 배치됩니다. C열·R행에서 각 인스턴스의 로컬 이동량은 다음과 같습니다. ```text X 이동 = (열 번호 - (C - 1) / 2) × X 피치 Y 이동 = (행 번호 - (R - 1) / 2) × Y 피치 열·행 번호는 0부터 시작 ``` 따라서 3열이면 원래 도형과 좌우 도형이 생기고, 2행이면 원래 위치에서 위아래로 반 피치씩 이동합니다. 원래 도형을 좌상단의 첫 인스턴스로 간주하면 위치가 틀어집니다. `angle`은 도형과 배열의 로컬 축을 함께 회전시키며, 저장된 `left`·`top` 앵커를 기준으로 변환합니다. 아래 09는 JSON의 `scaleX` 하나만 바꾸므로 저장된 간격 2 nm가 유지됩니다. 화면에서 배열 전체 크기를 드래그하는 변환은 간격도 함께 조정할 수 있으므로, 다른 조작의 결과가 같다고 단정하지 말고 저장값을 확인하세요. ### 마스크 비교 파일 04~09는 같은 기판에 같은 IMPLANT(`nHeavy`, 시드 두께 2 nm, 분산·확산 0)를 수행하며 **마스크 도형 설정만** 바꿉니다. PHOTO를 추가하지 않고 직접 마스크를 사용합니다. 마스크의 `negpol:true`, 양의 도형, 공정의 `maskPolarityInverted:true` 조합에서 아래 사각 영역이 주입 대상입니다. 극성이나 공정을 바꾸면 같은 도형도 다른 의미가 될 수 있습니다. 기준 도형은 `left:9, top:7, width:2, height:2, scaleX:1, scaleY:1, angle:0`입니다. 기본 비교 간격은 X/Y 모두 2 nm입니다. 아래 구간은 프로젝트 XY 좌표이며, 각 X 구간과 각 Y 구간의 조합이 사각 주입 영역입니다. | 파일 | 기준에서 바뀐 값 | X 구간 (nm) | Y 구간 (nm) | ID 7 부피 (nm³) | | --- | --- | --- | --- | ---: | | [04 · 도형 하나](/docs/agents/examples/comparisons/repetition/04-mask-one-shape.flow.json) | 1열×1행 | 9~11 | 7~9 | 8 | | [05 · 3열](/docs/agents/examples/comparisons/repetition/05-mask-three-columns.flow.json) | 04의 `columns:3` | 5~7, 9~11, 13~15 | 7~9 | 24 | | [06 · 3열×2행](/docs/agents/examples/comparisons/repetition/06-mask-three-by-two.flow.json) | 05의 `rows:2` | 5~7, 9~11, 13~15 | 5~7, 9~11 | 48 | | [07 · 빈틈 0](/docs/agents/examples/comparisons/repetition/07-mask-zero-gap.flow.json) | 05의 `columnSpacing:0` | 7~13, 서로 닿아 연속 | 7~9 | 24 | | [08 · 90° 회전](/docs/agents/examples/comparisons/repetition/08-mask-rotated.flow.json) | 05의 `angle:90` | 7~9 | 3~5, 7~9, 11~13 | 24 | | [09 · 폭 배율 2](/docs/agents/examples/comparisons/repetition/09-mask-scaled.flow.json) | 05의 `scaleX:2` | 3~7, 9~13, 15~19 | 7~9 | 48 | z=9.5 nm의 XY 단면에서 위 사각형 내부의 ID는 **7=Si(n+)**, 바깥은 **5=중성 Si**입니다. z=7.5 nm에서는 전 영역이 ID 5로 남습니다. ID 5의 부피는 각 파일에서 `3200 - ID 7 부피`이고 다른 재료는 없습니다. 05와 07은 부피가 같아도 위치가 다르므로 부피만 확인하면 간격 오류를 놓칠 수 있습니다. ## 브라우저 API로 비교하기 **버려도 되는 새 프로젝트나 복사본을 먼저 여세요.** `setFlow`는 현재 공정·재료·마스크·도메인을 예제로 교체합니다. 실행 취소는 가능하지만 작업 원본에서 실험하지 마세요. 아래 코드는 계정에 저장하지 않습니다. 아펠리에 페이지의 브라우저 콘솔에서 실행합니다. ```js const A = window.arpelier; if (A?.version !== "1.0") throw new Error("Flow API 1.0이 필요합니다."); async function loadComparison(filename) { const response = await fetch(`/docs/agents/examples/comparisons/repetition/${filename}.flow.json`); if (!response.ok) throw new Error(`예제 읽기 실패: ${response.status}`); const flow = await response.json(); const validation = await A.validate(flow); if (!validation.valid) throw new Error(JSON.stringify(validation.issues)); await A.setFlow(flow); } await loadComparison("02-group-three-cycles"); await A.computeTo("nitride"); const stack = await A.getCrossSection({ axis: "y", at: 7.5, dz: 1 }); console.assert(stack.height === 19); console.assert(stack.materials[17][9] === 18 && stack.materials[18][9] === 19); await loadComparison("06-mask-three-by-two"); await A.computeTo("implant", { inspectOutcomeSteps: ["implant"] }); const footprint = await A.getCrossSection({ axis: "z", at: 9.5 }); console.assert(footprint.materials[5][5] === 7, "(5.5,5.5) nm: 주입"); console.assert(footprint.materials[7][9] === 5, "(9.5,7.5) nm: 행 사이 빈틈"); console.assert(footprint.materials.flat().filter(id => id === 7).length === 24); console.log(await A.status()); ``` 첫 단면은 행=Z·열=X, 두 번째는 행=Y·열=X입니다. 이 예제는 모든 간격이 1 nm라서 배열 인덱스에 0.5를 더한 값이 셀 중심 좌표입니다. `setFlow` 뒤에는 새 계산을 완료한 다음 단면을 요청하세요. ## 저장소에서 전체 비교 검증 의존성이 설치된 **저장소 루트(`grida`)**에서 실행합니다. ```sh node --test dev/src/features/automation/__tests__/agent-repetition-examples.verify.mjs ``` 테스트는 공개 Flow 검증·내보내기와 `replayProjectToStep`의 실제 엔진을 사용합니다. 9개 문서 실행, 한 변수 비교, 그룹과 직접 나열한 적층의 일치, 마지막 사이클의 자식 선택, 각 마스크의 전체 XY 재료 ID·부피를 확인합니다. 계정·브라우저 없이 실행합니다. ## 사용 범위와 비용 그룹은 문서를 간결하게 만들지만 실제 실행 횟수는 증가합니다. 마스크 배열도 반복 인스턴스와 래스터 처리 비용이 증가합니다. 큰 개수로 시작하지 말고 1·2·3처럼 작은 비교부터 확인하세요. 이 예제는 도메인 안에 들어오는 사각형과 1 nm 격자를 검증하며, 도메인 밖 부분이나 격자보다 작은 빈틈의 보존을 보장하지 않습니다. 반복 렌더링으로 화면이 넓어져도 계산 도메인의 경계 조건이 새로 계산되지는 않습니다. 근거: `ProcessGroupIteration`의 실행 확장·상한·자식 선택, `ProcessflowViewCore`·`ProcessflowController`의 반복 UI, `MaskSceneMath`의 배열 피치·오프셋·회전, `MaskEditorView`·`MaskEditorCanvasManager`의 단일 선택·변환, 위 비교 예제 테스트. 엔진이나 직렬화 규칙이 바뀌면 숫자와 테스트를 함께 검토하세요.