Arpelier: agent guide in one page

Arpelier 에이전트 안내 전체본: Flow 문서를 쓰는 데 필요한 문서를 한 주소에 모았습니다.

This one page holds everything an AI needs to write an Arpelier Flow (JSON) document; no other page needs to be opened.

결과물: 사용자가 Arpelier 앱(https://arpelier.com)에서 "Flow JSON 열기"로 여는 Flow JSON 문서. 도구가 없으면 완성된 JSON 하나를 파일이나 코드 블록으로 줍니다.

Arpelier MCP 커넥터(https://arpelier.com/mcp)가 있으면 그 도구로 검증·계산한 뒤 arpelier_open_in_app 링크를 줍니다.

같은 내용의 HTML판: https://arpelier.com/docs/agents/full · 텍스트판: https://arpelier.com/llms-full.txt

목차 / Contents

  1. 색인과 먼저 확인할 규칙 · https://arpelier.com/llms.txt
  2. 결과를 사용자에게 넘기기 · https://arpelier.com/docs/agents/delivery.md
  3. 핵심 개념과 Flow 형식 · https://arpelier.com/docs/agents/concepts.md
  4. 공정 종류와 필드 · https://arpelier.com/docs/agents/processes.md
  5. 재료 ID · https://arpelier.com/docs/agents/materials.md
  6. 마스크 극성 · https://arpelier.com/docs/agents/masks.md
  7. 그룹 반복과 마스크 배열 · https://arpelier.com/docs/agents/tasks/repetition.md
  8. 실제 소자 구조를 재현할 때 · https://arpelier.com/docs/agents/tasks/real-structures.md
  9. 예제 Flow (oxide window) · https://arpelier.com/docs/agents/examples/oxide-window.flow.json
  10. Flow 1.1 JSON Schema · https://arpelier.com/schema/flow-1.1.json

1. 색인과 먼저 확인할 규칙

원본 / Source: https://arpelier.com/llms.txt

# Arpelier

> 반도체 공정 플로우, 마스크와 재료를 편집하고 계산된 3D 구조를 탐색하는 웹 앱. 길이의 저장 단위는 nm입니다. 기하학적 공정 모델이며 실제 제조 레시피나 전기적 성능의 검증을 대신하지 않습니다.

**아래 링크를 따라갈 수 없으면 이 주소 하나만 읽으세요:** https://arpelier.com/llms-full.txt (HTML: https://arpelier.com/docs/agents/full). Flow를 쓰는 데 필요한 문서(넘기는 방법, 형식, 공정 필드, 재료 ID, 마스크 극성, 반복, 실제 소자, 예제, Flow 1.1 스키마)를 한 파일에 모았습니다. If you cannot open the links below, read only https://arpelier.com/llms-full.txt: it holds every document needed to write a Flow.

## 결과를 사용자에게 넘기기

- 결과물은 사용자가 Arpelier 앱에서 여는 Flow 문서입니다(보여 주는 방법 `view`를 담으면 Flow 1.1). 넘기는 방법은 지금 쓸 수 있는 도구에 따라 다릅니다: [결과를 사용자에게 넘기기](https://arpelier.com/docs/agents/delivery.md).
- Arpelier 커넥터(MCP 도구 `arpelier_*`)가 있으면 검증·계산한 Flow로 `arpelier_open_in_app` 링크를 줍니다.
- 열린 Arpelier 탭에서 JavaScript를 실행할 수 있으면 `window.arpelier`로 그 탭에 만듭니다([브라우저에서 모듈별로 만들기](https://arpelier.com/docs/agents/api.md#브라우저에서-모듈별로-만들기)).
- 클릭과 입력만 할 수 있으면 앱의 "Flow JSON 열기" 창에 붙여 넣고, 브라우저를 조작할 수 없으면 Flow JSON 파일과 여는 방법을 줍니다. 계산하지 않은 수치를 Arpelier 결과처럼 쓰거나 사용자에게 개발자 도구 콘솔에 코드를 붙여 넣게 하지 마세요.

## 에이전트 시작하기

- [핵심 개념과 문서 구조](https://arpelier.com/docs/agents/concepts.md): 도메인, 재료, 마스크, 공정, 그룹, 메모와 저장.
- [공정 종류와 필드](https://arpelier.com/docs/agents/processes.md): 정확한 kind 이름, 입력 필드, 단위, 기본값, 마스크 적용 방식.
- [공정 기본값 JSON](https://arpelier.com/docs/agents/process-defaults.json): 현재 공정 레지스트리에서 추출한 기본값. 완성된 레시피나 JSON Schema가 아닙니다.
- [Flow 1.0 JSON Schema](https://arpelier.com/schema/flow-1.0.json): 자동화 입력 형식. 구조 검사 뒤 앱의 의미 검증도 필요합니다.
- [Flow 1.1 JSON Schema](https://arpelier.com/schema/flow-1.1.json): 1.0에 선택 필드 `view`(투명·숨김 재료, 잘라내기, 카메라, 화풍: `setView`와 같은 필드)를 더한 형식. 링크·"Flow JSON 열기"·미리보기가 이 보기로 엽니다.
- [Oxide window 예제](https://arpelier.com/docs/agents/examples/oxide-window.flow.json): 작은 기판·산화막·PHOTO·ETCH·STRIP 흐름. 보정된 소자 모델이 아닙니다.
- [재료 ID와 선택 규칙](https://arpelier.com/docs/agents/materials.md): 기본 재료 전체, 도핑 계열, 정확한 ID 선택과 사용자 재료.
- [마스크 극성](https://arpelier.com/docs/agents/masks.md): negpol, 도형 polarity, 공정 반전의 관계와 PHOTO 결과표.
- [격자·메모리·계산 복구](https://arpelier.com/docs/agents/performance.md): 실제 계산 간격, 열 개수, 메모리 추정의 범위, 캐시와 저장의 차이.
- [자동화 경로와 완료 확인](https://arpelier.com/docs/agents/api.md): 현재 지원 경로, 임시 프로젝트와 저장된 프로젝트, 성공 판정, 3D 구조 파일(GLB·3MF·STL)과 재료 정보 내보내기(exportStructure).
- [실제 소자 구조를 재현할 때](https://arpelier.com/docs/agents/tasks/real-structures.md): 실제 소자·기술 이름을 요청받으면 먼저 읽을 순서. 어레이 범위와 인출부, 1차 자료(학회 논문·회사 기술 발표)부터 찾기와 근거 기록, 공정 현실성, 격자 선택, 빈 공간 확인, 큰 구조의 계산 경로, 완성 후 장면과 화풍(smooth·voxel × 사실적·카툰)을 골라 조명·재료 색으로 마감하기(setView·setAppearance, 그리기 비용은 getView().render, Flow로 넘길 때는 같은 규칙을 Flow 1.1의 `view`에).

## 목적별 설정과 실행 가능한 비교

- [목적별 안내 전체 색인](https://arpelier.com/docs/agents/tasks/index.md): 이미 있는 기능과 모델 한계, 55개 실제 비교 Flow를 한 번에 검증하는 명령.

- [IMPLANT: 표면 아래 도핑층](https://arpelier.com/docs/agents/tasks/implant.md): 시드 두께·주입 깊이·분산·확산의 차이, 산화막을 유지하는 비교와 단면·부피 기준값.

- [PHOTO 광학 효과](https://arpelier.com/docs/agents/tasks/photo.md): 한 변수 비교 Flow와 실제 엔진의 수치 확인 기준, 광학 효과를 언제 켜는가(기본 광학에서 사라지는 개구 폭).

- [ALD 표면 거칠기와 3D 등방성 해석](https://arpelier.com/docs/agents/tasks/ald.md): 한 변수 비교 Flow와 실제 엔진의 수치 확인 기준, 처마 아래·좁은 입구에서 등방성 해석을 켜는 기준.

- [WET ETCH 언더컷](https://arpelier.com/docs/agents/tasks/wet-etch.md): 한 변수 비교 Flow와 실제 엔진의 수치 확인 기준, 3D 등방성 해석을 켜는 기준, Seam(nm)과 보호막 비율.

- [ETCH 측벽 형상](https://arpelier.com/docs/agents/tasks/etch-profile.md): 테이퍼(positive profile)와 보잉 값에 따른 깊이별 폭, 바닥이 닫히는 조건, 보잉 뒤 채움의 void.

- [DEPO 옆벽 피복과 바닥 성장](https://arpelier.com/docs/agents/tasks/depo.md): 기본값은 옆벽 막이 없음, 옆벽·바닥 두께 식과 bottom-up 채움, 처마 밑면.

- [리프트오프](https://arpelier.com/docs/agents/tasks/lift-off.md): PHOTO → DEPO → STRIP 순서, 옆벽 피복과 liftOff 설정에 따른 성공·실패 형태.

- [MODIFICATION 방향성과 부피비](https://arpelier.com/docs/agents/tasks/modification.md): 소비 두께와 생성물 두께, 반응 방향성에 따른 옆벽 변환.

- [CMP 선택 재료 Dishing](https://arpelier.com/docs/agents/tasks/cmp.md): 한 변수 비교 Flow와 실제 엔진의 수치 확인 기준.

- [구조 검사와 전후 비교](https://arpelier.com/docs/agents/tasks/inspection.md): 숫자 단면·접촉·연결·검사 범위와 실제 실패/수정 예제.

- [그룹 반복과 마스크 배열](https://arpelier.com/docs/agents/tasks/repetition.md): 사이클·간격·피치·회전의 차이와 9개 실제 비교.

- [근거 기반 작성과 최소 수정](https://arpelier.com/docs/agents/tasks/research-repair.md): 지원 경로·권한과 저장소에서 실행하는 검증 예제.

- [본딩 원본 고정·갱신](https://arpelier.com/docs/agents/tasks/bonding.md): UI·전용 브라우저 API의 준비·검토·적용(본딩 메모와 모듈 그룹, 본딩 뒤 appendFlow), 권한과 실행 검증.

- [Motion·내보내기](https://arpelier.com/docs/agents/tasks/motion-export.md): 지원 경로·권한과 저장소에서 실행하는 검증 예제.

## 먼저 확인할 규칙

- 기판 공정 kind는 `SUBSTR`입니다. `SUBSTRATE`는 지원되는 별칭이 아닙니다.
- 도메인 크기는 `LX`, `LY`, 격자 간격은 `dx`, `dy`입니다. 실제 계산 간격 `dxn`, `dyn`은 해상도 설정에 따라 달라집니다.
- 새 사용자 재료 ID는 100–239 범위입니다. 예전 문서의 25번을 그대로 복사하지 마세요.
- 식각 대상 `materialetch`는 ID를 키로 하는 비율 객체입니다. 예: `{ "18": 1 }`. 배열 `[18]`이 아닙니다.
- `negpol`은 배경의 극성입니다. 도형의 `data.polarity`와 공정의 `maskPolarityInverted`까지 확인해야 PR이 남는 위치를 알 수 있습니다.
- 공정 계산 완료, 로컬 복구본 생성, 계정 프로젝트 저장, 공개 링크 생성은 각각 다른 상태입니다. 저장 성공을 확인한 뒤에만 저장했다고 보고하세요.
- 새로 쓰는 공정마다(`GROUPEND` 제외) 사용자 언어로 `name`과 `note`를 씁니다. 제목은 그 단계의 역할만 짧게(예: `패드 산화막`, `STI 트렌치 식각`), 메모에는 공정 설명·치수와 출처·엔지니어 코멘트를 씁니다. 사용자가 쓴 이름·메모는 그대로 둡니다([이름과 메모](https://arpelier.com/docs/agents/concepts.md#이름과-메모)).
- 실제 소자를 재현할 때는 단위 셀이 아니라 여러 셀과 배선·인출부까지 만들고, 치수는 외부 공개 자료에서 찾아 근거를 공정 메모에 남기세요. 계산 한도 때문에 설계를 줄이지 마세요.
- `arpelierApps`는 앱 내부 객체입니다. 문서화된 계약 없이 내부 상태를 직접 바꾸거나 UI 클래스 이름에 의존하지 마세요.

## 앱

- [Arpelier](https://arpelier.com/): 앱 진입점.

2. 결과를 사용자에게 넘기기

원본 / Source: https://arpelier.com/docs/agents/delivery.md

# 결과를 사용자에게 넘기기

[색인](https://arpelier.com/llms.txt) · [자동화 경로](https://arpelier.com/docs/agents/api.md) · [Flow 1.1 스키마](https://arpelier.com/schema/flow-1.1.json)

Arpelier 구조를 만들어 달라는 요청의 결과물은 사용자가 Arpelier 앱에서 여는 Flow 문서입니다(보여 주는 방법 `view`를 담으면 Flow 1.1, 없으면 1.0). 넘기는 방법은 지금 쓸 수 있는 도구에 따라 다릅니다. 표의 위에서부터 확인해 쓸 수 있는 첫 경로를 고르세요.

| 지금 쓸 수 있는 도구 | 넘기는 방법 | 수치를 읽는 곳 |
| --- | --- | --- |
| 1. Arpelier 커넥터(MCP 도구 `arpelier_*`) | 검증·계산한 Flow로 `arpelier_open_in_app` 링크 | 서버 엔진(검증·계산·단면·측정·검사 도구) |
| 2. 열린 Arpelier 탭에서 JavaScript를 실행하는 브라우저 도구 | `window.arpelier`로 그 탭에 직접 만들기 | 브라우저 엔진(`computeTo`·`getCrossSection`·`inspectStructure`) |
| 3. 클릭과 입력만 하는 브라우저 조작 | 앱의 "Flow JSON 열기" 창에 붙여 넣기 | 앱이 열면서 계산합니다. 수치는 화면으로만 확인합니다 |
| 4. 브라우저 조작 없음 | Flow JSON 파일(또는 JSON 코드 블록 하나)과 여는 방법 | 없음. 사용자가 앱에서 열어 계산합니다 |

구조를 어떻게 보여 줄지(투명·숨김 재료, 잘라내기, 카메라, 화풍)는 Flow의 `view`에 적으면 1·3·4번 경로가 프로젝트에 함께 넣고 미리보기도 따릅니다([Flow로 넘길 때](https://arpelier.com/docs/agents/tasks/real-structures.md#flow로-넘길-때)). 2번은 계산 뒤 `setView`로 정합니다. `setFlow`는 공정만 바꾸고 보기는 그대로 둡니다.

Arpelier 링크는 `arpelier_open_in_app`이 만듭니다. 커넥터 미리보기(`arpelier_preview_structure`)의 "Arpelier에서 열기" 버튼은 이 도구를 쓸 수 없을 때 Flow를 주소에 담은 링크(`#flow=d1.…`)를 코드로 만들어 엽니다. 이 링크는 한 글자만 바뀌어도 열리지 않고 실제 Flow는 수천~수만 자가 되므로, AI가 대화에 옮겨 적거나 직접 지어 주지 마세요. `.apl` 파일은 사용자 계정의 키로 암호화되므로 AI가 만들 수 없습니다.

## 1. 커넥터가 있을 때

[MCP 결과와 계정 프로젝트 구분](https://arpelier.com/docs/agents/api.md#mcp-결과와-계정-프로젝트-구분)을 따릅니다. 링크(`url`)는 보통 Markdown 링크로 넘깁니다. MCP Apps를 표시하는 클라이언트에서는 `arpelier_preview_structure` 미리보기의 "Arpelier에서 열기" 버튼으로도 열 수 있습니다. MCP Apps를 표시하지 않는 클라이언트에서는 미리보기가 아무것도 보이지 않으므로 `arpelier_render_structure`의 PNG로 구조를 보여 줍니다. 링크 도구가 없거나 오류(`OPEN_IN_APP_*`)를 돌려주면 미리보기 버튼을 안내하고, 미리보기도 표시되지 않으면 4번처럼 Flow JSON을 넘깁니다.

## 2. 탭에서 JavaScript를 실행할 수 있을 때

브라우저 도구에 페이지에서 스크립트를 실행하는 기능(evaluate, JavaScript 실행 등)이 있고 열린 탭에서 `window.arpelier?.version === "1.0"`이면 [브라우저에서 모듈별로 만들기](https://arpelier.com/docs/agents/api.md#브라우저에서-모듈별로-만들기)를 따릅니다. API는 프로젝트를 만들거나 열지 않으므로 사용자가 새 프로젝트나 빈 프로젝트를 열어 두어야 합니다. 클릭과 입력만 할 수 있으면 3번입니다.

## 3. 클릭과 입력만 할 수 있을 때

API를 부를 수 없습니다. 개발자 도구 콘솔이나 주소창에 코드를 입력해 우회하지 마세요.

1. 완전한 Flow를 만들고 [엔진 없이 점검할 것](https://arpelier.com/docs/agents/delivery.md#엔진-없이-점검할-것)을 확인합니다.
2. Arpelier 대시보드에서 새 프로젝트 옆 폴더 아이콘(파일 열기)을 누르고 "Flow JSON 붙여넣기…"(Paste Flow JSON…)를 고릅니다. 프로젝트 편집기에서는 상단 AI로 작업(로봇 아이콘) 패널의 "Flow JSON 열기"(Open Flow JSON)를 누릅니다.
3. "Flow JSON 내용" 상자에 문서 전체를 넣습니다. 앱이 바로 검사해 상자 아래에 결과를 보입니다.
   - "열 수 있어요"(Ready to open)와 단계 수·크기가 보이면 "새 프로젝트로 열기"(Open as new project)를 누릅니다.
   - 고칠 곳이 보이면 그 JSON 경로와 이유대로 고친 문서 전체를 다시 넣습니다.
4. 앱이 저장 전 새 프로젝트로 열고 마지막 단계를 계산합니다. 계산이 끝난 화면에서 구조를 확인하고, 사용자에게 무엇을 보면 되는지 알립니다.
5. 저장은 사용자가 원할 때 사용자가 합니다.

## 4. 브라우저를 조작할 수 없을 때

1. 완전한 Flow를 만들고 [엔진 없이 점검할 것](https://arpelier.com/docs/agents/delivery.md#엔진-없이-점검할-것)을 확인합니다.
2. 파일을 만들 수 있으면 `<이름>.flow.json` 파일 하나로 줍니다. 아니면 문서 전체를 `json` 코드 블록 하나에 넣습니다. 생략(`...`), 주석, 끝 쉼표, 여러 조각으로 나누기가 있으면 앱이 열지 않습니다. 16 MB를 넘는 문서도 열 수 없습니다(마스크 도형이 많을 때 커집니다).
3. 여는 방법을 사용자의 언어로 알립니다. 예:
   > arpelier.com 대시보드에서 새 프로젝트 옆 폴더 아이콘을 누르고 이 파일을 고르거나 화면에 끌어다 놓으세요. 내용을 복사했다면 같은 메뉴의 "Flow JSON 붙여넣기"에 붙여 넣으세요. 앱이 검사한 뒤 저장 전 새 프로젝트로 열고 계산합니다. 저장해야 계정에 남습니다.
4. 앱이 고칠 곳을 보이면 사용자가 "고칠 곳 복사"(Copy problems)로 목록을 보내 줄 수 있습니다. 각 줄은 `JSON 경로: 이유`입니다. 그 경로를 고친 문서 전체를 다시 줍니다. 바뀐 부분만 주지 마세요.
5. 계산하지 않았다는 것을 밝힙니다. 두께·부피·빈 공간·접촉 같은 숫자는 설계 의도이며 Arpelier가 계산한 결과가 아닙니다.
6. 사용자가 링크와 계산된 수치를 원하면 MCP 커넥터를 추가할 수 있는 앱에서 `https://arpelier.com/mcp`를 연결하도록 안내합니다([AI 커넥터 안내](https://arpelier.com/reference/ai-connector)).

"Flow JSON 열기"로 연 프로젝트에는 누가 만들었는지 알 수 없어 AI 생성 기록이 남지 않습니다. 기록은 링크(1번)나 브라우저 API(2번)로 만든 새 프로젝트를 처음 저장할 때만 남습니다.

## 엔진 없이 점검할 것

3·4번은 사용자가 열기 전까지 앱 검사를 받지 못합니다. 넘기기 전에 다음을 확인하세요. 코드를 실행할 수 있으면 JSON Schema([1.1](https://arpelier.com/schema/flow-1.1.json), `view`가 없으면 [1.0](https://arpelier.com/schema/flow-1.0.json))로 구조를 검사합니다. 이것은 구조 검사일 뿐이고 최종 판정은 앱의 검사입니다.

- 하나의 JSON 객체이고 최상위 필드는 `schema`, `name`, `note`, `domain`, `gridResolution`, `displayUnits`, `materials`, `masks`, `processes`, `view`뿐입니다. `schema`는 `view`가 있으면 `https://arpelier.com/schema/flow-1.1.json`, 없으면 `https://arpelier.com/schema/flow-1.0.json`이고 `name`은 비어 있지 않습니다.
- `view`가 있으면 필드가 `setView`와 같고([보기 설정](https://arpelier.com/docs/agents/api.md#보기-설정-보여주기)) `highlightMaterialIds`는 없습니다. 재료 ID는 이 Flow의 재료입니다.
- `domain`에 양수 `LX`, `LY`, `dx`, `dy`(nm)가 있습니다.
- 모든 공정에 서로 다른 `id`(영문·숫자·`_`·`.`·`-`, 160자 이내)와 [공정 목록](https://arpelier.com/docs/agents/processes.md)의 `kind`가 있습니다. 기판은 `SUBSTR`입니다.
- 재료 ID가 [재료 목록](https://arpelier.com/docs/agents/materials.md)에 있고, 새 재료는 100–239로 `materials`에 정의했습니다. 식각 대상 `materialetch`는 `{ "18": 1 }` 같은 객체입니다.
- PHOTO의 마스크 ID가 `masks`에 있고, PR이 남는 위치를 [마스크 극성](https://arpelier.com/docs/agents/masks.md) 표로 확인했습니다.
- `GROUPSTART`와 `GROUPEND`가 짝을 이룹니다.
- `GROUPEND`를 뺀 모든 공정에 사용자 언어로 쓴 `name`(그 단계의 역할만)과 `note`(공정 설명·치수와 출처·엔지니어 코멘트)가 있습니다([이름과 메모](https://arpelier.com/docs/agents/concepts.md#이름과-메모)).
- 필드 이름과 형식이 [작은 예제](https://arpelier.com/docs/agents/examples/oxide-window.flow.json)나 [목적별 비교 Flow](https://arpelier.com/docs/agents/tasks/index.md)와 같습니다.

## 하지 말 것

- 사용자에게 개발자 도구 콘솔에 코드를 붙여 넣게 하지 마세요. "Flow JSON 열기"가 같은 일을 검사와 함께 합니다.
- 직접 만든 GLB·STL·그림이나 손으로 어림한 수치를 Arpelier 결과로 내놓지 마세요. 3D 파일은 앱에서 연 뒤 내보내기로 만듭니다.
- 사용자가 열거나 저장한 것을 확인하기 전에는 열었다거나 저장했다고 말하지 마세요.

3. 핵심 개념과 Flow 형식

원본 / Source: https://arpelier.com/docs/agents/concepts.md

# Arpelier 핵심 개념

[색인](https://arpelier.com/llms.txt) · [공정](https://arpelier.com/docs/agents/processes.md) · [자동화](https://arpelier.com/docs/agents/api.md)

Arpelier는 공정을 순서대로 계산해 재료별 3D 구조를 만듭니다. 화면에서 보이는 그럴듯한 모양만으로 전기적 연결이나 실제 제조 가능성을 확정하지 마세요. 목적에 맞는 중간 단계와 단면을 함께 확인해야 합니다.

## 도메인과 단위

`domain.LX`, `domain.LY`는 X/Y 크기, `domain.dx`, `domain.dy`는 입력 격자 간격입니다. 모두 nm입니다. `x`, `y`를 도메인 크기의 별칭으로 사용하지 마세요. 화면의 표시 단위가 바뀌어도 저장된 길이는 nm입니다.

`dxn`, `dyn`은 해상도를 반영한 계산 간격입니다. X/Y 크기는 대응하는 입력 격자로 나누어떨어져야 합니다. 앱의 도메인 정규화가 유효한 간격을 만들 수 있으므로 정규화된 결과를 다시 읽으세요. Z는 공정에 따라 생기는 재료 구간으로 표현됩니다. [메모리 설명](https://arpelier.com/docs/agents/performance.md)을 참고하세요.

## 프로젝트 문서, 공정, 마스크

프로젝트 문서의 주요 데이터는 `domain`, `processes`, `mask`, `matset`, `visualSetting`, `snapshot`입니다. 저장용 코덱은 `schemaVersion: 3`과 압축된 재료·마스크 표현을 사용합니다. 저장 JSON, 편집 중 문서, 실행 취소 스냅샷은 같은 객체 형식이 아닙니다. 서로의 필드를 임의로 섞지 말고 지원되는 읽기·수정 경로를 사용하세요.

- `processes`: 순서가 있는 공정 배열. 각 공정은 고유 `id`와 정확한 `kind`를 가집니다.
- `mask`: 마스크 배열. 공정의 `mask` 값은 마스크 이름이 아니라 마스크 ID를 참조합니다. `"-"`는 직접 선택한 마스크가 없다는 뜻입니다.
- `matset`: 재료 정의. 저장 코덱에서는 기본 카탈로그와 `materialOverrides`, `customMaterials`로 압축될 수 있습니다.
- `visualSetting`: 카메라·단면·표현·해상도. 해상도는 실제 계산 격자에도 영향을 줍니다.
- `snapshot`: 선택 단계와 편집 상태를 복원하는 보조 데이터. 계산된 모든 단계의 영구 보관을 뜻하지 않습니다.

공정 기본값은 빈 편집 초안입니다. 예를 들어 `DEPO`의 `material: "-"`는 사용자가 재료를 선택해야 한다는 뜻이고, `CMP`의 기본 두께 0은 유효한 제거 작업이 아닙니다. 기본값만 복사한 뒤 성공한 레시피라고 간주하지 마세요.

## 자동화용 Flow 1.0

[Flow 1.0 스키마](https://arpelier.com/schema/flow-1.0.json)는 저장 코덱과 별도의 작성 입력 계약입니다. 최상위 `schema` 값은 `https://arpelier.com/schema/flow-1.0.json`이며, `domain`, `processes`, 선택적인 `materials`, `masks`, `gridResolution`, `displayUnits`, `name`, `note`를 사용합니다. 여기서는 마스크 배열이 `masks`, 재료 배열이 `materials`입니다. 원시 저장 문서의 `mask`, `matset`, `snapshot`을 그대로 넣지 마세요. `gridResolution` 기본값은 2이며 저장 길이는 nm입니다.

JSON Schema는 데이터 모양을 설명합니다. 실제 입력은 `FlowDocument.validateFlowDocument`의 정준 검증을 통과해야 합니다. 이 검증은 도메인 격자, 지원 공정과 필드, 고유 ID, 마스크·재료 참조, 그룹 구조와 현재 모델 제약을 함께 확인합니다. 스키마 검사 성공만으로 공정 실행 성공이나 원하는 구조를 보장하지 않습니다. 성공 결과의 정규화된 `flow`를 다음 작업에 사용하세요.

v1은 BONDING, PARTICLE, 호환용 ALD_NEW를 지원하지 않습니다. 앱 전체 공정 목록과 자동화 계약의 지원 범위는 다릅니다. 미지원 공정을 삭제해 입력을 억지로 통과시키지 마세요. [Oxide window 예제](https://arpelier.com/docs/agents/examples/oxide-window.flow.json)는 80 × 80 nm의 작은 기하학 예제이며, 프로젝트명·메모를 보존하는 작성 시작점으로 사용할 수 있습니다.

### Flow 1.1의 `view`

[Flow 1.1](https://arpelier.com/schema/flow-1.1.json)은 1.0에 선택 필드 `view` 하나를 더한 형식입니다. `view`는 구조를 어떻게 보여 줄지(투명·숨김 재료와 불투명도, 잘라 낼 상자 `cutaway`, 카메라, 표면, 조명, 바닥 그리드·좌표축·눈금자)를 `setView`와 같은 필드로 적습니다. `highlightMaterialIds`는 프로젝트에 저장되지 않으므로 받지 않습니다. 계산·측정과 계산 상태 재사용은 `view`를 읽지 않습니다.

- `view`가 있으면 `schema`는 `https://arpelier.com/schema/flow-1.1.json`입니다. 1.0 문서에 `view`가 있으면 `$.view` 오류입니다. 검사 도구는 두 버전을 모두 읽습니다.
- 정규화된 `flow`는 `view`를 적은 그대로 담고, `view`가 없으면 1.0으로 씁니다.
- 저장된 프로젝트를 Flow로 읽으면(`arpelier_open_my_project`) 보기 설정 중 기본값과 다른 것이 `view`로 따라옵니다. 카메라는 방향과 시야각만 담습니다. 브라우저 API의 `getFlow()`는 공정만 돌려주고 보기는 `getView()`가 돌려줍니다.
- 어디에 어떻게 쓰이는지는 [Flow로 넘길 때](https://arpelier.com/docs/agents/tasks/real-structures.md#flow로-넘길-때)에 있습니다.

## 그룹과 반복

그룹은 같은 `processes` 배열 안의 `GROUPSTART`와 `GROUPEND` 쌍으로 나타납니다. 두 마커도 서로 다른 고유 ID를 가져야 하며, 중첩 순서가 올바르게 닫혀야 합니다. `GROUPSTART`의 `cycleCount`는 반복 수이고 기본값은 1입니다. 마커를 실제 증착·식각 단계로 세지 마세요. 접힌 그룹의 화면 번호와 내부 공정 배열의 인덱스도 다를 수 있습니다.

임의로 `isModule`을 켜거나 마커 ID를 재사용하지 마세요. 그룹/반복 편집은 구조 검증과 선택 단계 복원까지 함께 처리하는 경로를 사용해야 합니다.

## 이름과 메모

AI가 새로 쓰는 공정에는 `GROUPEND`를 뺀 모든 단계에 `name`(제목)과 `note`(메모)를 사용자 언어로 씁니다. 앱은 `name`을 공정 카드의 제목으로 보여 주고(없으면 공정 종류가 대신 보입니다), `note`는 사용자가 공정을 펼쳤을 때 보여 줍니다.

- 제목은 그 단계가 하는 일의 핵심만 씁니다. 예: `패드 산화막`, `활성 영역 패턴`, `STI 트렌치 식각`, `PR 제거`. 공정 종류·재료·두께는 카드에 이미 보이므로 되풀이하지 않고, 수치·출처·설명은 메모에 씁니다. `GROUPSTART`의 제목은 모듈이 하는 일입니다.
- 메모에는 공정 설명(왜 이 자리에 있는지, 끝나면 구조가 어떻게 되는지), 치수와 출처(찾은 자료는 링크, 정한 값은 이유, 자료가 없으면 가정이라고), 엔지니어 코멘트(이 구조에서 어려운 점, 잘못되면 생기는 불량, 모델이 실제와 다르게 표현한 부분)를 이어지는 문장으로 씁니다. 길이는 공정의 무게에 맞춥니다. 자세한 기준과 예는 [공정 메모](https://arpelier.com/docs/agents/tasks/real-structures.md#공정-메모)에 있습니다.
- `validate`(커넥터의 `arpelier_validate_flow`)는 제목이나 메모가 없는 단계를 `namesAndNotes`로 알려 줍니다. 오류가 아니라 안내입니다.

공정의 `name`, `note`와 프로젝트 제목·설명은 사용자가 작성한 내용입니다. 자동 수정 중에도 그대로 보존하세요. 프로젝트 저장 레코드의 `note`/설명과 실행 취소 스냅샷의 `flow.prjnote`, `projectMeta.projectNote`는 서로 다른 계층의 표현입니다. 스냅샷 필드 한 곳만 수정하면 화면·저장본이 어긋날 수 있습니다. 프로젝트 정보 편집과 저장을 함께 지원하는 경로를 사용하세요.

## 계산과 저장

계산은 공정에서 구조를 만드는 작업이고 저장은 프로젝트 문서를 보존하는 작업입니다. 정보 창을 닫거나 계산이 끝나는 것만으로 계정 저장을 확인할 수 없습니다. 저장 버튼 또는 Ctrl+S를 사용하고 성공/실패 표시를 확인하세요. 로그인 여부, 소유권, 네트워크와 프로젝트 종류에 따라 저장 경로가 다릅니다.

게스트 데이터는 해당 브라우저 프로필의 로컬 저장소에 의존합니다. `/p/...` 주소만 전달한다고 다른 브라우저에서 같은 로컬 문서를 열 수 있는 것은 아닙니다. 공유가 목적이면 계정에 저장하고 실제 공유 권한을 확인하세요. 자동 복구본과 계산 캐시도 공유 링크를 대신하지 않습니다.

현재 웹앱의 `body[data-save-state]`는 `empty`, `saving`, `saved`, `unsaved`를, `data-save-scope`는 `none`, `account`, `local`을 표시합니다. 계정 프로젝트도 수정 후에는 account 범위의 unsaved 상태일 수 있습니다. API의 `status()`에서도 같은 저장 상태를 관측할 수 있습니다. 프로젝트 정보의 확인은 현재 이름·메모에 적용하며, 계정 저장을 별도로 실행해야 합니다.

저장 요청 후 추가로 편집한 내용은 현재 작업에 남고 `unsaved`로 표시됩니다. 저장이 끝나기 전에 다른 프로젝트로 이동한 경우 늦은 응답으로 현재 프로젝트를 바꾸지 않습니다. 저장된 버전과 현재 작업이 같은지까지 확인하세요.

## 안정된 단계 선택과 링크

타임닷에는 authored ID인 `data-step-id`, `data-process-kind`, 실제 실행 대상인 `data-compute-target-id`와 접근 가능한 이름이 있습니다. 실행 가능한 타임닷은 Enter 또는 Space로 선택할 수 있습니다. 화면 순번이나 CSS 클래스만으로 단계를 추정하지 마세요. 그룹의 authored ID와 펼쳐진 실행 대상 ID도 구분해야 합니다.

`/p/<project-id>?step=<authored-id>` 링크는 숫자가 아닌 정확한 authored ID를 지원합니다. 숫자 step 값은 기존 인덱스 의미를 유지하므로 새 단계 ID에는 의미 있는 문자열을 사용하세요. 없는 ID를 다른 단계 인덱스로 대신 열지 않습니다. 프로젝트를 열 수 없으면 해당 주소를 유지한 채 다시 시도·홈 이동과 오류 안내를 제공합니다. 링크가 열리지 않는 사실만으로 게스트 로컬 프로젝트인지 확정할 수 없습니다.

숫자로만 된 기존 authored ID를 직접 지정할 때는 `?embedStep=<id>`를 사용합니다. 단계 링크는 해당 프로젝트에만 적용되며 같은 프로젝트의 단계 간 뒤로 가기에서도 ID를 유지합니다.

## 문서 근거와 변경 관리

이 안내서는 현재 코드의 `ProjectDocumentCodec`, `ProjectGridDomain`, `ProcessflowModel`, `ProcessflowBlockUtils`, `ProjectHistoryManager`를 기준으로 작성했습니다. 관찰로 발견한 내부 변수 이름을 공개 API로 승격하지 않습니다. 공개 자동화 계약의 버전·지원 기능은 [자동화 안내](https://arpelier.com/docs/agents/api.md)에서 확인하세요.

4. 공정 종류와 필드

원본 / Source: https://arpelier.com/docs/agents/processes.md

# 공정 종류와 필드

[색인](https://arpelier.com/llms.txt) · [목적별 안내와 실행 비교](https://arpelier.com/docs/agents/tasks/index.md) · [기본값 JSON](https://arpelier.com/docs/agents/process-defaults.json) · [마스크](https://arpelier.com/docs/agents/masks.md) · [재료](https://arpelier.com/docs/agents/materials.md)

아래는 현재 `processSet.js`와 실행 엔진의 저장 필드입니다. 대소문자와 공백을 보존하세요. `SUBSTRATE`, `WET_ETCH`, `SPIN_COATING` 같은 추측 이름은 지원하지 않습니다. 이전 `SPIN COAT`만 `SPIN COATING`으로 정규화합니다.

## 공통 필드

| 필드 | 기본값 | 의미 |
| --- | --- | --- |
| `id` | 생성된 고유 문자열 | 공정 참조. 배열 인덱스나 화면 번호와 다름 |
| `name` | `""` | 공정 카드의 제목. 비어 있으면 카드에 공정 종류가 대신 보임. 새로 쓰는 공정은 사용자 언어로 그 단계의 역할만 짧게([이름과 메모](https://arpelier.com/docs/agents/concepts.md#이름과-메모)). 사용자가 정한 이름은 그대로 보존 |
| `note` | 선택 사항 | 공정을 펼치면 보이는 메모. 새로 쓰는 공정은 사용자 언어로 공정 설명·치수와 출처·엔지니어 코멘트([이름과 메모](https://arpelier.com/docs/agents/concepts.md#이름과-메모)). 사용자가 쓴 메모는 그대로 보존 |
| `kind` | 종류별 | 아래의 정확한 문자열 |
| `isignore` | false | true이면 계산에서 무시 |
| `mask` | `"-"` | 직접 마스크 ID. 지원 종류에서만 활성 |
| `maskPolarityInverted` | false | 직접 마스크 적용 영역 반전 |
| `material` | `"-"` | 재료 또는 CMP 정지막. 종류별 의미 확인 |
| `materialetch` | `{}` | 재료 ID → 제거 비율 객체. 배열 아님 |
| `thickness` | 보통 10 | nm. 아래 종류별 의미·기본값 우선 |
| `seed` | `""` | ALD 시드 재료 선택. 난수 시드와 다름 |
| `conformality`, `bowing` | 0 | 종류별 0–1 형상 제어 값(nm 아님). `conformality`는 DEPO에서 옆벽 피복, ETCH에서 테이퍼(UI 이름 positive profile)로 뜻이 다름 |
| `seam` | 0 | WET ETCH의 Seam 임계 크기(nm, 0–10). 이 값보다 높은 틈으로만 옆으로 식각이 들어감 |

종류를 전환한 오래된 문서에는 비활성 필드가 남아 있을 수 있습니다. 존재하는 필드가 모두 해당 공정에서 작동하는 것은 아닙니다. [기본값 JSON](https://arpelier.com/docs/agents/process-defaults.json)의 `selectable`은 일반 작성 UI에서의 종류 선택 가능 여부입니다. `defaults`는 초기 초안이며 완성된 공정의 유효성 보장이 아닙니다.

## 일반 작성 공정

| kind | 주요 저장 필드와 기본값 | 직접 마스크 | 계산 의미 |
| --- | --- | --- | --- |
| `SUBSTR` | `material:5`, `substrateDoping:"-"`, `thickness:10` | 없음 | 기판 생성. 도핑 `"p"`, `"n"`, `"-"`가 실제 기판 ID를 결정 |
| `PHOTO` | `thickness:10`, `photoOpticalEnabled:false` | 지원 | PR(24) 도포와 노광/현상을 한 단계로 표현. PR 잔류 위치는 극성표 확인. 광학 효과는 기본 끔([언제 켜는가](https://arpelier.com/docs/agents/tasks/photo.md#언제-광학-효과를-켜는가)) |
| `DEPO` | `material:"-"`, `thickness:10`, `conformality:0`, `bottomGrowthRatio:1` | 지원 | 위에서 보이는 면에 선택 재료 성장. 기본 `conformality:0`은 옆벽에 막을 만들지 않음([DEPO](https://arpelier.com/docs/agents/tasks/depo.md)) |
| `PARTICLE` | `particleMaterials:{"240":1}`, `particleCount:10`, `particleDiameter:1` | 없음 | 재료·입경·난수 시드에 따른 입자 생성 |
| `ALD` | `material:"-"`, `seed:""`, `thickness:10`, `aldGrowthModel:"uniform"`, `aldIsotropicAnalysis:false` | 없음 | 접근 가능한 표면 성장. 시드와 성장 모델에 따라 달라짐 |
| `SPIN COATING` | `material:"-"`, `thickness:0` | 없음 | 액체가 접근 가능한 공간을 채워 평탄화. 두께는 전체 고체 최고점 위의 추가 높이 |
| `ETCH` | `materialetch:{}`, `thickness:10`, `conformality:0`, `bowing:0` | 지원 | 대상 재료의 방향성 제거. PR 등 비대상 재료가 차단할 수 있음. 테이퍼·보잉은 [ETCH 측벽 형상](https://arpelier.com/docs/agents/tasks/etch-profile.md) |
| `WET ETCH` | `materialetch:{}`, `thickness:10`, `seam:0`, `wetIsotropicAnalysis:false` | 없음 | 접근 가능한 대상 재료의 등방성 제거. 옆 방향 제거·언더컷 가능([해석 모드·Seam·보호막 비율](https://arpelier.com/docs/agents/tasks/wet-etch.md)) |
| `CMP` | `material:"-"`, `thickness:0`, `dishing:0`, `dishingMaterials:{}` | 없음 | 전체 최고점에서 두께만큼 내려간 평면까지 제거하되 선택한 정지막의 상단으로 제한 |
| `STRIP` | `stripMaterials` 명시 권장, 레거시 `material:"-"`, `liftOff:false` | 없음 | 선택한 재료 제거. PR 제거라면 `stripMaterials:{"24":1}`로 지정. 리프트오프는 [리프트오프](https://arpelier.com/docs/agents/tasks/lift-off.md) |
| `IMPLANT` | `dopingtype:""`, `thickness:10`, `implantDepth:0`, `depthStraggle:0`, `diffusionLength:0`, `diffuseExistingDopants:false` | 지원 | 반도체 계열의 도핑 변경. 깊이·분산·확산 모델은 옵션별로 다름 |
| `OXIDATION` | `thickness:0`, `enhancedIsotropyEnabled:false` | 없음 | 내장 산화 모델. 양의 두께가 필요. `thickness`는 최종 SiO2 두께로, Si를 그 0.44배만큼 소모하고 나머지만큼 바깥으로 자란다. 평면·바닥은 정확히 `thickness`, 측벽은 격자 단위로 반올림돼 셀 하나 정도 두꺼울 수 있다 |
| `MODIFICATION` | `sourceMaterials` 명시 권장, 레거시 `sourceMaterial:"-"`, `targetMaterial:"-"`, `thickness:10`, `volumeRatio:2.27`, `reactionDirectionality:0` | 없음 | 소스 재료를 대상 재료로 바꾸며 부피비·방향성을 적용. `thickness`는 소비 두께([MODIFICATION](https://arpelier.com/docs/agents/tasks/modification.md)) |
| `BONDING` | `bondingVersion:2`, 소스 프로젝트·단계·digest·자산 필요 | 없음 | 고정된 소스 구조를 배치·결합. 프로젝트 ID 하나만으로는 실행할 수 없음 |

호환용 `ALD_NEW`는 레지스트리에 존재하지만 일반 작성 목록에 없습니다. 새 문서는 `ALD`와 노출된 옵션을 사용하세요. `GROUPSTART`/`GROUPEND`는 공정 종류 표의 실행 공정이 아닌 그룹 구조 마커입니다.

## 추가 필드와 단위

| 종류 | 저장 필드 | 단위·기본값 |
| --- | --- | --- |
| PHOTO | `photoOpticalWavelength`, `photoOpticalNA`, `photoExposureThreshold`, `photoOpcCornerSerifEnabled` | 각각 nm 193, 무차원 1.35, 비율 0.5, false |
| DEPO | `conformality` | 0–1, 기본 0. 옆벽 두께 = `conformality × thickness` |
| DEPO | `bottomGrowthRatio` | 무차원, 기본 1, 허용 0–8. 바닥 두께 = `bottomGrowthRatio × thickness` |
| ETCH | `conformality`(UI positive profile), `bowing` | 0–0.5(UI), 0–1; 기본 0 |
| WET ETCH | `seam` | nm, 0–10, 기본 0 |
| ALD | `aldGrowthModel` | `uniform`, `surface_postprocess`, `stochastic_nucleation`; 기본 uniform |
| ALD | `aldSurfaceRoughness`, `aldRoughnessSeed` | 막 두께 대비 % 0, 허용 0–50; 재현용 난수 시드 문자열(초안 생성 시 새로 할당) |
| ALD | `aldInitialNucleationCoverage`, `aldNucleationRatePerCycle` | % 20, 사이클당 % 5 |
| ALD | `aldNucleusDiameter`, `aldCycleThickness` | nm 1, nm 2 |
| PARTICLE | `particleDiameterVariation`, `particleContactAngle`, `particleAngularSpread`, `particleAngularExponent` | % 0, 도 90, 도 30, 무차원 12 |
| PARTICLE | `particleSeedMaterials`, `randomSeed`, `showParticleTrajectory` | 시드 재료 객체 `{}`, 새 난수 시드 문자열, false |
| CMP | `dishing`, `dishingMaterials` | 0–1 비율 0, 재료별 비율 객체 `{}` |
| IMPLANT | `implantDepth`, `depthStraggle`, `diffusionLength` | 모두 nm, 기본 0 |
| IMPLANT | `dopingtype` | `nHeavy`, `nLight`, `pHeavy`, `pLight`. 기존 도핑 확산 전용 모드와 구분 |
| MODIFICATION | `volumeRatio`, `reactionDirectionality` | 무차원 2.27, 0–1 비율 0 |
| BONDING | `bondingOffsetX`, `bondingOffsetY`, `bondingOffsetEnabled` | nm 0, nm 0, false |
| BONDING | `bondingFlipSource`, `bondingFlipAxis` | true, `"x"`; 축 `x`, `y`, `xy` |

ETCH 화면의 “positive profile” 제어는 저장 필드 `conformality`를 사용합니다. UI의 `materialEtch`, `stopper`, `doping` 같은 필드 표시용 키를 그대로 JSON 필드 이름으로 사용하지 마세요. 각각 `materialetch`, `material`, `dopingtype`입니다.

ALD 거칠기는 절대 길이가 아닙니다. `aldGrowthModel:"surface_postprocess"`에서 두께 20 nm에 `aldSurfaceRoughness:10`이면 기준 진폭은 2 nm입니다(격자 양자화와 표면 형상에 따라 실제 결과는 달라짐). 명시적인 `uniform` 모델에서는 양의 거칠기 값을 넣어도 적용되지 않습니다. 성장 모델이 없는 레거시 입력만 양의 거칠기 값으로 `surface_postprocess`를 추론합니다.

ALD의 `seed`는 시작 표면의 정확한 단일 재료 ID이며 비우면 전체 접근 가능한 고체 표면을 사용합니다. 연속 선택률 필드가 아니고 균일 성장의 기존 성장막도 후속 성장 표면이므로 비선택면 침범을 따로 확인합니다. DEPO에는 시드 선택이 없고 독립 `EPI` 종류도 없습니다. [시드 선택·일반 성장 비교](https://arpelier.com/docs/agents/tasks/ald.md#선택한-재료에서-성장을-시작하기)로 실제 효과와 한계를 확인하세요.

ALD의 `aldIsotropicAnalysis`(3D 등방성 해석, 기본 false)는 노출 표면의 성장과 좁은 공간의 폐쇄를 3D 거리 전파로 계산합니다. 평평한 면과 위가 열린 수직 트렌치·구멍에서는 표준 근사와 결과가 같지만, 처마(습식 언더컷, inner spacer recess) 아래 코팅과 입구가 먼저 닫히는 형상에서는 표준 근사가 안쪽을 더 채워 막 두께·void·윗면이 달라집니다. 이런 형상의 ALD는 켜고 이유를 적습니다. `aldGrowthModel:"stochastic_nucleation"`을 고르면 UI가 이 값을 켭니다. 측정과 비용은 [처마 아래와 좁은 입구](https://arpelier.com/docs/agents/tasks/ald.md#처마-아래와-좁은-입구-3d-등방성-해석)에 있습니다.

**상세 설정을 쓸 때.** 값을 바꾸기 전에 해당 안내의 측정 표를 확인하고, 바꾼 이유를 공정 `note`나 보고에 적습니다.

- DEPO 기본값은 옆벽에 막이 없습니다. 옆벽까지 덮는 라이너·스페이서는 ALD로 만들거나 DEPO `conformality`를 0보다 크게 줍니다. 처마 밑면은 DEPO가 덮지 않습니다([DEPO](https://arpelier.com/docs/agents/tasks/depo.md)).
- ETCH 테이퍼(`conformality`)는 일정한 각도가 아니고, 값이 크거나 깊으면 바닥이 닫혀 목표 깊이에 못 미칩니다. 보잉 뒤 void는 ALD 채움으로 확인합니다([ETCH 측벽 형상](https://arpelier.com/docs/agents/tasks/etch-profile.md)).
- WET ETCH는 개구 아래로 퍼지는 언더컷 모양이 중요할 때 3D 등방성 해석을 켭니다. 보호막에는 0 대신 작은 비율을 주고 남은 두께를 확인합니다([WET ETCH](https://arpelier.com/docs/agents/tasks/wet-etch.md)).
- 리프트오프는 금속 DEPO `conformality: 0`과 STRIP `liftOff: true`를 함께 씁니다([리프트오프](https://arpelier.com/docs/agents/tasks/lift-off.md)).
- MODIFICATION의 `thickness`는 소비 두께이고 생성물은 `thickness × volumeRatio`입니다. 2.27은 Si → SiO2 값입니다([MODIFICATION](https://arpelier.com/docs/agents/tasks/modification.md)).
- PHOTO 광학 효과는 기본으로 끕니다. 켜면 폭이 대략 `2 × 0.21 × 파장 / NA`보다 작은 개구가 사라집니다([PHOTO](https://arpelier.com/docs/agents/tasks/photo.md#언제-광학-효과를-켜는가)).

`wetAdvancedEnabled`, `wetReactionModel`, `wetCycleCount`, `wetReactionDepth`는 이전 문서 실행을 위한 값이 남아 있지만 현재 UI에 잠정 모델 제어가 숨겨져 있습니다. 공개 기본 레시피에서 활성화하지 마세요. 지원 여부와 현재 기능 노출은 별개입니다.

## 실행 전에 확인할 함정

1. **0 두께**: 대부분의 실행 공정은 0 이하에서 변화가 없습니다. `SPIN COATING`은 0에서도 평탄화할 수 있고, PARTICLE/BONDING/기존 도핑 확산 전용 모드는 별도 규칙입니다.
2. **CMP 정지막**: 정지막을 지정해도 양의 제거 두께가 필요합니다. 정지막 재료가 구조에 없으면 기대한 위치에 멈추지 않습니다. 두께는 목표 절대 Z가 아니라 제거 깊이입니다. 큰 값은 구조 전체를 없앨 수 있습니다.
3. **식각 대상**: `{"5":1}` exact 선택은 Si(p) 4가 아닙니다. 선택 대상, 노출면, 직접 마스크, 남은 PR을 함께 확인하세요.
4. **주입 깊이**: `thickness`만 에너지로 해석하지 마세요. 이 모델은 기하학적 도핑 구간과 옵션에 따른 분산·확산을 다룹니다. 상부막과 깊이 구간에 따라 Si에 닿지 않을 수 있습니다.
5. **STRIP**: 기본 재료 `"-"`가 자동으로 PR을 뜻하지 않습니다. 제거 대상을 명시하세요. 리프트오프 순서와 실패 형태는 [리프트오프](https://arpelier.com/docs/agents/tasks/lift-off.md)에 있습니다. `liftOff:true`에서 `liftOffRemoveAtSides:true`는 XY 측면에 닿은 고체도 지지 연결성에 따라 제거하며, `false`는 측면을 지지로 보존합니다. 바닥은 항상 지지면입니다. 새 STRIP의 측면 제거 기본값은 `true`지만, 기존 문서의 누락 값은 `false`로 유지되므로 기존 의도를 확인한 뒤 명시적으로 바꾸세요.
6. **완료와 품질**: 계산 성공은 원하는 재료가 실제로 제거되거나 연결되었다는 뜻이 아닙니다. 전후 구조·재료·단면을 비교하세요.

근거: `processSet.js`, `AldProcessDefaults.js`, `DepositionBottomGrowth.js`, `DopingType.js`, `GridEngine.runProcess` 및 각 공정 커널. 모델의 상세 동작을 변경할 때 이 표와 기본값 JSON도 함께 갱신해야 합니다.

5. 재료 ID

원본 / Source: https://arpelier.com/docs/agents/materials.md

# 재료 ID와 선택 규칙

[색인](https://arpelier.com/llms.txt) · [공정](https://arpelier.com/docs/agents/processes.md)

재료 이름과 색상은 프로젝트마다 바뀔 수 있습니다. 계산용 참조에는 이름을 추측하는 대신 해당 문서의 ID를 사용하세요. 아래는 기본 카탈로그입니다.

| ID | 기본 이름 | 분류 |
| --- | --- | --- |
| 3 | Si (p+) | Semiconductor |
| 4 | Si (p) | Semiconductor |
| 5 | Si | Semiconductor |
| 6 | Si (n) | Semiconductor |
| 7 | Si (n+) | Semiconductor |
| 8 | Poly-Si (p+) | Semiconductor |
| 9 | Poly-Si (p) | Semiconductor |
| 10 | Poly-Si | Semiconductor |
| 11 | Poly-Si (n) | Semiconductor |
| 12 | Poly-Si (n+) | Semiconductor |
| 13 | SiGe (p+) | Semiconductor |
| 14 | SiGe (p) | Semiconductor |
| 15 | SiGe | Semiconductor |
| 16 | SiGe (n) | Semiconductor |
| 17 | SiGe (n+) | Semiconductor |
| 18 | SiO2 | Insulator |
| 19 | Si3N4 | Insulator |
| 20 | W | Metal |
| 21 | Cu | Metal |
| 22 | TiN | Metal |
| 23 | Al | Metal |
| 24 | PR | Others |
| 240 | Particle | Others, 시스템 재료 |

0은 미사용 토큰, 1은 공기, 2는 공동, 255는 ALL 센티널입니다. 이를 일반 사용자 재료 ID로 쓰지 마세요.

## 증착 재료 지정

`DEPO`·`ALD`에는 문서에 존재하는 재료 ID를 `material`로 지정하세요. 생략·`null`·빈 문자열·`"-"`는 선택한 증착 재료가 아니므로 검증에서 거부되며 `$.processes[i].material` 경로를 안내합니다. 재료를 생략해 기본 재료나 공기층이 만들어진다고 가정하지 마세요. `SUBSTR`의 기존 기본 재료와 STRIP의 다중 대상 선택은 각 공정 계약을 따릅니다.

## 사용자 재료

새 사용자 재료 ID의 할당 범위는 **100–239**입니다. 이미 사용 중인 ID를 피하고, 앱 또는 지원되는 작성 도구가 할당한 ID를 사용하세요. 예전 데이터의 ID는 로드 호환 규칙에 따라 유지되거나 변경될 수 있으며, 모든 사용자 ID 25–99를 자동으로 100번대로 옮기는 계약은 아닙니다. 과거 Particle 25처럼 별도 규칙이 적용되는 경우도 있습니다. 가져온 뒤의 ID를 다시 읽고 공정 참조도 함께 보존해야 합니다. 공개 Flow를 작성할 때는 허용 범위를 지키고, 기존 문서의 ID·참조를 검증 통과만을 위해 임의로 바꾸지 마세요.

`type: "Semiconductor"`라고 지정한 사용자 재료가 자동으로 Si의 도핑·산화 동작을 얻는 것은 아닙니다. 이름만 `Si`로 바꾸어도 ID 기반의 공정 의미는 바뀌지 않습니다. 기본 재료와 의미상 대응시키는 별도 계약이 있는 경우 그 계약을 따르세요.

## 도핑과 식각 선택

기본 Si 계열은 3–7, Poly-Si 계열은 8–12, SiGe 계열은 13–17입니다. 가운데 중성 ID는 각각 5, 10, 15입니다.

`ETCH`와 `WET ETCH`는 `materialetch` 객체에 0–1 범위의 재료별 제거 비율을 저장합니다. 0은 제거하지 않음을 뜻하며 UI·Flow·네이티브 작성 경로에서 허용됩니다. `materialetchSelectionMode: "exact"`이면 명시한 ID만 대상입니다. `{"5": 1}`에 exact를 지정하면 Si(p) 4를 포함하지 않습니다. 이전 형식에서 exact 모드가 없는 경우 중성 부모 ID 5/10/15는 해당 도핑 계열로 확장됩니다. 새 문서는 명시적 ID 목록과 exact 모드로 의도를 표현하세요.

```json
{
  "kind": "ETCH",
  "thickness": 30,
  "materialetch": { "3": 1, "4": 1, "5": 1, "6": 1, "7": 1 },
  "materialetchSelectionMode": "exact"
}
```

이 예는 Si 계열을 모두 선택한 공정 조각입니다. 완전한 프로젝트 문서가 아닙니다. 재료별 비율은 공정 모델의 기하학적 입력이며 실제 화학 선택비의 검증값으로 간주하지 마세요.

SiGe만 습식 식각하고 SiGe(p+)를 보존하려면 `WET ETCH`에 `materialetch: {"13": 0, "15": 1}`과 `materialetchSelectionMode: "exact"`를 함께 지정하세요. 0인 항목을 생략할 수 있지만 exact를 지우면 중성 ID 15가 계열 전체로 확장되어 의미가 달라집니다. 대상 배포가 이 설정을 지원하는지는 적용 전에 `validate()`로 확인하세요.

`STRIP.stripMaterials`와 `MODIFICATION.sourceMaterials`는 ID를 키로 하고 값이 1인 명시적 선택 객체입니다. 레거시 스칼라 필드 `material`/`sourceMaterial`의 계열 확장과 구분하세요.

## 기판과 이온주입

표준 기판은 `kind: "SUBSTR"`, `material: 5`와 `substrateDoping: "p" | "n" | "-"`로 표현합니다. 이 도핑 선택은 실제 기판 ID를 4/6/5로 결정합니다. 따라서 뒤의 exact 식각 대상도 실제 도핑된 ID를 포함해야 합니다. "기판 재료 4는 항상 식각 불가능"이라는 규칙은 없습니다.

`IMPLANT.dopingtype`은 `pHeavy`, `pLight`, `nLight`, `nHeavy` 중 하나입니다. 엔진은 기본 반도체 계열의 도핑 상태를 바꾸며 중첩 주입은 기존 상태와 상호작용합니다. 깊이·확산 옵션에 따라 결과가 달라집니다. 산화막이나 PR, 잘못된 마스크, 깊이 구간, 이미 포화된 도핑 상태 때문에 예상한 변화가 없을 수 있으므로 공정 전후를 확인하세요. 모든 모델에 "산화막이 조금이라도 있으면 무조건 주입 불가"를 적용하지 마세요.

연결 탐색기의 단순화된 전도 모델은 실제 소자 시뮬레이터가 아닙니다. 중성 기본 재료 5/10/15는 기본 연결 추출에서 전도 노드로 취급하지 않는 등, 공정상의 반도체 분류와 연결 표시 범위는 다릅니다.

근거: `MaterialModel.js`, `MaterialTargetSelection.js`, `DopingType.js`, `GridEngine.js`.

6. 마스크 극성

원본 / Source: https://arpelier.com/docs/agents/masks.md

# 마스크 극성과 PHOTO 결과

[색인](https://arpelier.com/llms.txt) · [공정](https://arpelier.com/docs/agents/processes.md)

극성은 두 값을 XOR하는 규칙이 아닙니다. **마스크 배경**, **각 도형**, **공정의 반전**을 따로 읽어야 합니다.

- `mask.negpol`: 도형이 없는 배경의 값. 일반 실행 경로에서 생략하면 true로 해석합니다. 재현 가능한 문서는 명시하세요.
- 도형의 `data.polarity`: `"positive"` 또는 `"negative"`. 생략 시 positive입니다.
- 공정의 `maskPolarityInverted`: 기본 false. true이면 아래 표에서 적용 위치가 뒤집힙니다.
- 겹친 도형은 배열의 뒤쪽에 있는, 그 점을 포함하는 가장 위의 visible 도형이 우선합니다. `visible: true`도 명시하세요.

## PHOTO: PR이 남는 위치

아래 표는 **마스크가 실제로 선택되어 있고**, 도형 하나, `maskPolarityInverted: false`, 광학 보정 비활성, 양의 PHOTO 두께인 경우입니다. `R`은 PR이 남는 영역, `.`은 이 PHOTO가 PR을 추가하지 않는 영역입니다. 기존 PR 제거까지 의미하지는 않습니다.

| negpol | 도형 data.polarity | 도형 안 | 도형 밖 | 간단한 단면 그림 (밖 / 안 / 밖) |
| --- | --- | --- | --- | --- |
| true | positive | PR 없음 | PR 남음 | `RRR ... RRR` |
| true | negative | PR 남음 | PR 남음 | `RRR RRR RRR` |
| false | positive | PR 없음 | PR 없음 | `... ... ...` |
| false | negative | PR 남음 | PR 없음 | `... RRR ...` |

구멍을 내기 위한 PR 패턴은 보통 `negpol: true`와 positive 도형을 사용합니다. 도형 위에만 PR을 남기려면 `negpol: false`와 negative 도형을 사용합니다. 공정 반전 true는 이 결과를 뒤집습니다. 마스크가 `"-"`인 PHOTO는 이 네 칸 표가 아니라 blanket PR 코팅입니다.

## 도형 예시

아래는 이름이 아닌 `ACT` ID를 참조하는 마스크 객체입니다. 80 × 80 nm 프로젝트에 맞는 `domain`을 포함하며, 다른 프로젝트에서는 그 프로젝트의 LX/LY와 일치시켜야 합니다. X/Y 길이와 위치는 nm입니다. 문서 코덱은 이를 다른 압축 표현으로 저장할 수 있습니다.

```json
{
  "id": "ACT",
  "name": "Active opening",
  "negpol": true,
  "domain": { "LX": 80, "LY": 80 },
  "data": {
    "version": "5.0.0",
    "objects": [
      {
        "type": "rect",
        "left": 20,
        "top": 20,
        "width": 40,
        "height": 20,
        "scaleX": 1,
        "scaleY": 1,
        "angle": 0,
        "visible": true,
        "data": { "polarity": "positive" }
      }
    ]
  }
}
```

## 직접 마스크와 PR 마스크 구분

`ETCH`에 마스크 ID를 직접 지정하면 해당 공정에 선택된 마스크 영역이 적용됩니다. PHOTO의 PR 잔류 영역과 ETCH에서 제거할 영역을 같다고 가정하지 마세요. 공정 반전이 필요한지 확인해야 합니다.

PHOTO → ETCH 방식에서는 PHOTO로 PR을 만든 뒤 ETCH의 직접 마스크를 `"-"`로 두고 실제 남은 재료가 차단하는 것을 이용할 수 있습니다. 이때 식각 대상 목록에 PR을 포함하면 PR까지 제거할 수 있으므로 목적에 맞게 선택하세요. `WET ETCH`, `STRIP`, `ALD` 등 직접 마스크 선택을 지원하지 않는 공정은 실제 형성된 구조·노출면을 따라 동작합니다.

광학 PHOTO 옵션은 파장·NA·문턱값에 따라 이상적 도형 경계를 바꿉니다. 이 경우 위의 이진 표만으로 미세한 최종 경계를 예측하지 말고 결과를 확인하세요. 격자보다 작은 도형도 사라지거나 치수가 달라질 수 있습니다.

근거: `GridEngine._isPointBlocked`, `_getMaskFun`, `photo`, `spinCoat`, `PhotoOpticalPreview`.

7. 그룹 반복과 마스크 배열

원본 / Source: https://arpelier.com/docs/agents/tasks/repetition.md

# 반복 구조: 공정 사이클과 마스크 배열 선택하기

[공정 필드](https://arpelier.com/docs/agents/processes.md) · [마스크](https://arpelier.com/docs/agents/masks.md) · [IMPLANT 비교](https://arpelier.com/docs/agents/tasks/implant.md) · [공개 API](https://arpelier.com/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사이클](https://arpelier.com/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사이클](https://arpelier.com/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사이클](https://arpelier.com/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 · 도형 하나](https://arpelier.com/docs/agents/examples/comparisons/repetition/04-mask-one-shape.flow.json) | 1열×1행 | 9~11 | 7~9 | 8 |
| [05 · 3열](https://arpelier.com/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행](https://arpelier.com/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](https://arpelier.com/docs/agents/examples/comparisons/repetition/07-mask-zero-gap.flow.json) | 05의 `columnSpacing:0` | 7~13, 서로 닿아 연속 | 7~9 | 24 |
| [08 · 90° 회전](https://arpelier.com/docs/agents/examples/comparisons/repetition/08-mask-rotated.flow.json) | 05의 `angle:90` | 7~9 | 3~5, 7~9, 11~13 | 24 |
| [09 · 폭 배율 2](https://arpelier.com/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`의 단일 선택·변환, 위 비교 예제 테스트. 엔진이나 직렬화 규칙이 바뀌면 숫자와 테스트를 함께 검토하세요.

8. 실제 소자 구조를 재현할 때

원본 / Source: https://arpelier.com/docs/agents/tasks/real-structures.md

# 실제 소자 구조를 재현할 때

[색인](https://arpelier.com/llms.txt) · [공정 종류와 필드](https://arpelier.com/docs/agents/processes.md) · [격자·계산 범위](https://arpelier.com/docs/agents/performance.md) · [구조 검사](https://arpelier.com/docs/agents/tasks/inspection.md)

사용자가 실제 소자나 기술 이름(예: 특정 세대의 메모리, 로직 트랜지스터, 패키징 구조)을 말하거나 "실제와 닮게"를 요청하면 이 순서를 따르세요. 아펠리에는 정답 구조를 제공하지 않습니다. 공개된 외부 자료를 찾아 근거로 삼고, 근거와 가정을 구분해 남기는 것이 핵심입니다.

## 1. 범위: 단위 셀이 아니라 보여줄 수 있는 구조

특별한 요청이 없으면 소자의 특징이 드러나는 범위까지 만듭니다.

- 반복 단위가 보이도록 여러 셀. 셀이 반복되는 **두 방향 모두** 2개 이상이고, 각 배선 종류도 2줄 이상이어야 합니다(예: 워드라인 여러 개 × 비트라인 여러 줄). 한 줄만 있으면 줄과 줄 사이의 분리 구조를 보여줄 수 없습니다. 배열의 적어도 한쪽 끝은 셀 → 인출부 → 콘택 → 금속층 순서로 실제로 끝나야 합니다. 영역 경계를 거울 대칭면이나 주기 경계라고 가정해 끝 마감을 대신하지 마세요.
- 로직 표준 셀처럼 셀 하나가 단위인 구조는 셀을 2개 이상 이어 붙여 셀 경계(확산 끊김, 게이트 끝, 전원 레일 공유)까지 보여줍니다.
- 셀을 구동하는 주요 배선(예: 워드라인·비트라인·게이트·소스 라인 등 해당 소자에 있는 것)과 그 **인출부**(계단, 콘택, 첫 금속층 등 바깥과 연결되는 부분).
- 셀 사이 분리 구조와 공통 전극처럼 실제 구조에서 함께 보이는 부분.
- **배선 마감(BEOL 연결):** 각 배선 종류(예: 워드라인, 비트라인, 공통 전극)마다 인출부의 콘택이 금속 배선층까지 이어져야 합니다. 셀 배열만 만들고 배선이 허공이나 영역 끝에서 끊긴 채 끝나면 미완성입니다. 금속층의 수와 배치는 자료에 나온 대로 정하고, 자료가 없으면 배선 종류마다 최소 콘택 + 첫 금속층까지 만듭니다.

범위를 줄여야 한다면(사용자 요청, 계산 한도, 시간) 무엇을 뺐는지 보고하세요. 계산 한도 때문에 설계를 줄이지는 마세요. [7. 큰 구조의 계산 경로](https://arpelier.com/docs/agents/tasks/real-structures.md#7-큰-구조의-계산-경로)를 따르세요.

## 2. 외부 자료 찾기

검색할 수 있다면 만들기 전에 먼저 찾습니다. 자료의 신뢰도는 대체로 다음 순서입니다.

1. 학회 발표·논문: IEDM, VLSI Symposium, ISSCC, IMW, IITC 등과 IEEE·APS 등 학술지. 초록과 발표 요약 기사도 유용합니다.
2. 제조사·연구소의 공식 발표, 기술 블로그, 보도자료.
3. 공개된 단면 분석 요약과 전문 매체 기사(분석 업체의 공개 글, 반도체 전문 매체).
4. 특허: 구조와 공정 순서를 이해하는 데 유용합니다. 특허의 치수는 예시값일 수 있으니 다른 자료와 함께 쓰세요.

출처가 없는 요약이나 생성된 글은 근거로 쓰지 마세요.

**1차 자료를 먼저 찾습니다.** 기사와 분석 글은 대개 학회 발표나 회사 기술 발표를 요약한 2차 자료입니다. 기사를 읽었다면 그 기사가 인용한 원래 발표(학회 이름·연도·논문 제목)를 찾아, 거기 나온 수치를 우선 씁니다. 예: Intel PowerVia → VLSI Symposium 2023 PowerVia 발표, imec 후면 전력 → IEDM·VLSI 논문, 3D NAND 세대 → ISSCC·IMW 발표.

- 검색어 예: `<기술 이름> <학회> <연도>`, `<회사> <기술 이름> paper`, `<기술 이름> IEDM pdf`, `site:ieeexplore.ieee.org <기술 이름>`.
- 원문을 읽을 수 없으면 초록, 발표 슬라이드, 학회 프로그램, 같은 발표를 다룬 기사에서 그 발표의 수치를 찾습니다. 이때도 출처에는 원래 발표를 적고, 수치를 옮긴 글을 함께 링크합니다.
- 끝까지 2차 자료뿐이면 공정 `note`에 `1차 자료 없음(검색어: …)`을 적습니다.

검색 요령: 영어 검색어를 함께 쓰고, 소자 이름에 학회 이름·연도·`cross-section`·`TEM`·`process flow`·`integration` 같은 말을 붙입니다.

찾아야 할 것:

- **구조 방식:** 셀 구성, 배선의 방향, 적층 방식, 희생층과 교체 공정.
- **공정 순서:** 무엇을 쌓고, 어떤 순서로 패터닝하고, 무엇을 나중에 바꾸는지.
- **핵심 치수:** 피치, 층 두께, CD, 깊이, 막 두께, 적층 수.

자료끼리 값이 다르면 하나를 고르고 범위를 함께 적습니다. 검색할 수 없다면 알고 있는 공개 지식을 쓰되 그렇다고 밝히세요.

치수 근거의 기준:

- **핵심 치수**(층 피치와 층 두께, 채널 폭, 배선 피치, 주요 CD와 깊이, 적층 수)는 서로 다른 출처 2개 이상에서 찾습니다. 특허 하나만으로 정하지 마세요. 특허의 수치는 대개 예시 범위입니다.
- 학회 논문 원문을 읽을 수 없으면 초록, 발표 요약 기사, 제조사 발표 자료, 공개 분석 글에서 같은 발표의 수치를 찾습니다.
- 자료에 값이 있으면 그 값을 씁니다. 바꿔야 한다면(모델 한계, 격자) 바꾼 이유를 공정 `note`에 적습니다. 이유 없이 문헌값과 다른 값을 쓰지 마세요.
- `가정`은 찾아봤는데 없을 때만 씁니다. 무엇을 검색했는지 함께 적으세요.
- 최종 보고의 치수 표 끝에 `핵심 치수 N개 중 출처 있음 M개, 그중 1차 자료 K개`를 적습니다.

## 3. 모듈로 묶고 근거를 기록하기

### 모듈별 그룹

공정을 평평하게 늘어놓지 말고, 기능 단위 모듈마다 `GROUPSTART`·`GROUPEND`로 묶습니다([그룹과 반복](https://arpelier.com/docs/agents/concepts.md#그룹과-반복)). 사용자가 공정 목록을 접어 보며 전체 흐름을 한눈에 이해할 수 있어야 합니다.

- 모듈은 소자 제조의 실제 단계 구분을 따릅니다. 예: 기판·적층막 → 활성 영역 패터닝·분리 → 배선 인출부(계단 등) → 셀 소자(게이트·커패시터 등) → 콘택 → 금속 배선. 모듈 이름과 수는 자료에 나온 통합 방식에 맞춥니다.
- 한 모듈은 보통 3–20개 공정입니다. 같은 막을 반복해 쌓는 부분은 `cycleCount`로 반복 그룹을 씁니다.
- `GROUPSTART`의 `name`은 모듈이 하는 일을 짧게 적습니다(예: `Bit line staircase`). `note`에는 모듈의 목적, 끝났을 때 구조, 핵심 치수와 출처를 적습니다.
- 브라우저에서 모듈별로 넣을 때는 그룹 하나를 `appendFlow` 한 번으로 넣습니다([브라우저에서 모듈별로 만들기](https://arpelier.com/docs/agents/api.md#브라우저에서-모듈별로-만들기)).

### 프로젝트 메모

따른 구조 방식, 모듈 구성 요약, 참고 자료 목록(제목 또는 발표명, 기관, 연도, 링크), 단순화와 가정.

### 공정 제목

모든 실행 공정의 `name`을 채웁니다. 사용자와 같은 언어로, 그 단계가 하는 일의 핵심만 씁니다(예: `패드 산화막`, `활성 영역 패턴`, `STI 트렌치 식각`, `WL 금속 매립`, `PR 제거`). 공정 종류·재료·두께는 카드에 이미 보이므로 되풀이하지 않고, 치수·출처·설명은 메모로 보냅니다.

### 공정 메모

모든 실행 공정의 `note`를 채웁니다. 사용자가 공정을 펼쳤을 때, 그 공정을 맡은 엔지니어가 옆에서 설명해 주는 글처럼 읽혀야 합니다. 사용자와 같은 언어로, 이어지는 문장으로 씁니다. `엔지니어 코멘트:`·`목적:`·`근거:` 같은 항목 이름을 붙이지 마세요.

담을 내용:

- 이 단계가 왜 이 자리에 있는지, 끝나면 구조가 어떻게 되는지.
- 치수와 그 출처. 찾은 자료는 `[자료명, 연도](https://arpelier.com/docs/agents/tasks/URL)` 형식으로 링크하고, 정한 값은 정한 이유를 함께 적습니다.
- 실제 라인에서 이 단계를 맡으면 신경 쓰는 것: 이 구조에서 무엇이 어려운지(종횡비, 선택비, 정지막, 막 응력, 열 예산 등), 무엇이 잘못되면 어떤 불량으로 나타나는지, 그 불량이 다음 어느 공정에서 문제가 되는지. 일반론이 아니라 이 구조의 숫자로 말합니다(예: "깊이 2.4 µm, 폭 60 nm라 종횡비가 40을 넘는다").
- 아펠리에 모델에서 실제와 다르게 표현한 부분이 있으면 그 사실.

길이는 공정의 무게에 맞춥니다. 고종횡비 식각, 갭필, 희생층 교체, 계단 형성처럼 구조를 좌우하는 공정은 4–8문장, PR 제거·단순 증착처럼 가벼운 공정은 한두 문장이면 됩니다. 모든 공정을 같은 틀에 맞추지 마세요.

나쁜 예: `80 nm 트렌치 식각, 콘택 상단 노출. 엔지니어 코멘트: 트렌치 깊이 균일도와 저유전막 손상.`

좋은 예: `M1 배선이 들어갈 80 nm 깊이의 트렌치를 산화막에 판다. 바닥에서 아래 콘택 윗면이 드러나야 하므로 시간 식각이 아니라 콘택 위 식각 정지막에서 멈추는 조건이 안전하다. 덜 파면 M1과 콘택 사이가 끊기고, 더 파서 정지막을 뚫으면 이웃 콘택 사이 절연막이 얇아져 누설이 생긴다. 32단 계단 위와 셀 위의 패턴 밀도가 달라 식각 속도 차이(로딩)가 생기는 자리라 양쪽 깊이를 따로 확인해야 한다. 깊이 80 nm는 M1 선폭 40 nm에 종횡비 2를 맞춘 가정값이다.`

출처 링크는 실제로 찾아 읽은 자료만 답니다. 찾지 못한 링크를 지어내지 마세요.

### 최종 보고

항목·목표값·실측·출처(또는 가정) 표.

## 4. 공정의 현실성

- 웨이퍼 접합이 들어가는 구조(후면 전력 공급, CMOS를 접합한 3D NAND, 하이브리드 본딩 적층)는 접합할 웨이퍼를 별도 프로젝트로 만들어 계산한 뒤 저장합니다. 대상 프로젝트에서 `prepareBonding`(메모 `note`와 모듈 그룹 `group` 포함) → `applyBonding` → `computeBonding`으로 붙이고, 그 뒤 모듈(박막화, 후면 배선 등)은 `appendFlow`로 이어 갑니다. 화면 메뉴로 접합하지 마세요. 자세한 순서는 [본딩](https://arpelier.com/docs/agents/tasks/bonding.md)을 보세요.
- 업계에서 실제로 쓰는 통합 방식을 우선합니다. 물리적으로 불가능한 순서(예: 결정질 반도체가 필요한 층을 절연막 위에 증착으로 만드는 것)는 피하고, 모델 한계 때문에 단순화했다면 밝힙니다.
- 사용자가 공정을 직접 준 경우에는 그 단계를 바꾸거나 넣고 빼기 전에 먼저 묻습니다.

## 5. 격자와 영역

- **높이(z) 방향 두께는 격자와 무관합니다.** 엔진은 각 XY 열에 막을 높이 구간으로 0.1 nm 단위까지 저장합니다. 층 두께, 적층 막, 수평으로 쌓인 얇은 막은 격자를 촘촘히 하지 않아도 그대로 표현됩니다.
- 격자(`dx`, `dy`)는 **가로 방향 치수**에만 영향을 줍니다. 옆벽에 붙는 막(ALD 라이너, 게이트 산화막, 옆벽 금속)과 좁은 선폭·간격이 기준입니다. `dx`와 `dy`는 서로 달라도 됩니다. 얇은 옆벽 막이 한 방향에만 있으면 그 방향만 촘촘히 하세요.
- **우선순위는 범위가 먼저입니다.** 1번의 범위(배열 끝 마감, 인출부 전체, 콘택과 금속층)를 담을 영역을 먼저 정하고, 그 영역에서 감당할 수 있는 격자를 고릅니다. 수 nm 옆벽 막을 보이게 하려고 격자를 줄이고 그만큼 영역을 줄이지 마세요.
- 옆벽 막이 격자 한 칸보다 얇으면 격자에 맞는 두께로 그리고, 실제 값과 바꾼 이유를 공정 `note`에 적습니다. 그 막이 남았는지는 단면 `stacks`에서 확인합니다.
- 선폭·간격·피치는 격자의 정수배가 되게 맞추면 반복 셀이 모두 같은 모양이 됩니다.
- XY 열 수(`LX/dx × LY/dy`, 실제 계산 간격 기준)로 계산 부담을 미리 확인하세요. 브라우저 앱은 서버보다 큰 구조를 계산합니다. 측정 예(헤드리스 Chrome, 32단 적층, 2026-11): 16만 열 약 17초·탭 최고 약 0.9 GB, 41만 열 약 33초·약 1.5 GB, 64만 열 약 55초·약 1.8 GB. 사용자 기기에 따라 다르므로 수십만 열이면 사용자에게 계산 시간을 미리 알리세요. [격자·계산 범위](https://arpelier.com/docs/agents/performance.md)를 참고하세요.

## 6. 만든 뒤 확인

- 막을 채우는 공정(DEPO·ALD·SPIN COATING) 뒤에는 단면 `stacks`에서 `void`(빈 공간)를 확인합니다. 커넥터의 `arpelier_compute_flow` 결과에 있는 `voids`(떨어진 빈 공간의 개수, 부피, 가장 큰 영역의 범위)로 구조 전체를 한 번에 볼 수 있고, 위치는 단면으로 확인합니다. 의도하지 않은 빈 공간이면 원인을 찾아 고칩니다. 흔한 원인은 입구가 안쪽보다 좁아 먼저 막히는 것(pinch-off)입니다. 예: 구멍 벽과 구조 사이 틈이 안쪽의 층 사이 틈보다 좁으면, 틈이 먼저 닫혀 안쪽을 가둡니다. 이때는 막을 두껍게 해도 남으므로, 입구 쪽 간격을 안쪽보다 넓게 바꾸세요.
- 처마 아래를 덮거나 입구가 먼저 닫히는 ALD(inner spacer, 습식 언더컷 뒤 라이너, 좁은 recess 채우기)는 `aldIsotropicAnalysis: true`로 계산합니다. 기본값(false)의 표준 근사는 이런 곳을 더 채워 void를 작게 계산합니다. 위가 열린 수직 트렌치·구멍과 평평한 면은 두 모드가 같습니다([ALD 처마 비교](https://arpelier.com/docs/agents/tasks/ald.md#처마-아래와-좁은-입구-3d-등방성-해석)).
- 옆벽에 붙는 막(라이너·배리어·스페이서)은 ALD로 만들거나 DEPO `conformality`를 0보다 크게 줍니다. DEPO 기본값(0)은 옆벽에 막을 만들지 않고, 처마 밑면은 값과 상관없이 덮지 않습니다([DEPO](https://arpelier.com/docs/agents/tasks/depo.md)). 만든 뒤 단면에서 옆벽 두께를 확인합니다.
- [구조 검사](https://arpelier.com/docs/agents/tasks/inspection.md)로 배선끼리의 분리, 배선과 채널의 연결, 전극 단락 여부를 확인합니다.
- 영역 경계에 걸친 마스크 도형이 경계에 얇은 조각을 남기지 않았는지 확인합니다.
- **끝 마감 확인:** 셀 배열 바깥쪽(계단·인출부·영역 가장자리)을 따로 살펴봅니다.
  - 배선의 끝이 의도한 위치에서 끝나는지: 영역 경계에서 잘려 나가지 않도록 마스크와 영역에 여유를 둡니다.
  - 배선 종류마다 콘택이 실제로 닿았는지([구조 검사](https://arpelier.com/docs/agents/tasks/inspection.md)의 연결 검사), 다른 배선과 단락되지 않았는지.
  - 금속층을 올리기 전에 아래 표면이 평탄화(CMP)됐고, 식각으로 판 구멍과 홈이 메워졌는지(단면 `stacks`의 `void`).
  - 사용하지 않는 희생층·하드마스크가 마감 영역에 남아 있지 않은지.
- 보고에는 근거·가정·단순화를 구분해 적습니다.

## 7. 큰 구조의 계산 경로

- 사용자의 브라우저에서 아펠리에 탭을 조작할 수 있으면 전체 구조는 앱에서 모듈별로 넣고 계산합니다([브라우저에서 모듈별로 만들기](https://arpelier.com/docs/agents/api.md#브라우저에서-모듈별로-만들기)).
- 연결된 MCP 서버는 열·단계 한도가 있습니다([서버 계산의 범위](https://arpelier.com/docs/agents/performance.md#서버-계산의-범위)). 한도 안이면 오래 걸려도 `IN_PROGRESS`를 받을 때마다 같은 호출을 다시 해 끝까지 계산합니다. 전체가 한도를 넘으면 같은 공정으로 영역만 잘라낸 대표 부분(셀 몇 개)을 서버에서 검증하고, 전체 Flow는 따로 유지하세요.
- 브라우저가 없으면 전체 Flow와 함께, 서버에서 검증한 범위가 어디까지인지 밝혀 전달합니다.

## 8. 완성 후 보여주기

계산이 끝나면 사용자가 구조를 이해하고 보기 좋게 느끼도록 장면과 겉모습을 마감합니다. 브라우저 앱에서 `window.arpelier.setView`와 `setAppearance`로 하고([보기 설정](https://arpelier.com/docs/agents/api.md#보기-설정-보여주기)), 화면 클릭으로 흉내 내지 마세요. 커넥터나 Flow 파일로 넘길 때는 같은 규칙을 Flow의 `view`에 적습니다([Flow로 넘길 때](https://arpelier.com/docs/agents/tasks/real-structures.md#flow로-넘길-때)). 겉모습은 구조를 다 만든 뒤 마지막에 정합니다.

### 장면

1. **투명화:** 부피의 대부분을 차지하는 메움·절연 재료(예: 층간 산화막, 매립막, 식각 정지막)와 바깥을 덮는 공통 전극을 정리합니다. 여러 겹으로 쌓인 메움 재료는 숨기는 것(`transparentOpacity: 0`)이 기본입니다. 투명한 층이 겹치면 색이 탁해져 안쪽이 흐려 보입니다. 바깥 윤곽 하나만 남기고 싶을 때만 0.03–0.05로 둡니다. 재료마다 다르게 하려면 `setAppearance`의 `transparentOpacity`를 씁니다. 채널·게이트·배선·전극·커패시터처럼 소자의 기능을 보여주는 재료는 불투명하게 둡니다. 재료 비율은 `getAppearance()`의 `volumeFraction`으로 확인하세요.
2. **잘라내기:** 반복되는 셀 한 줄을 지나도록 `cutaway`로 앞쪽 절반이나 한 모서리를 잘라 내부 단면을 보여줍니다. 잘라낸 면이 카메라 쪽을 향하게 하세요.
3. **카메라:** 기본은 `iso`처럼 위에서 비스듬히 내려다보는 각도로, 계단·배선 인출부와 셀 반복이 함께 보이게 합니다. 배선이 많은 구조는 고도각을 35–40°로 높여 배선 윗면이 보이게 합니다. 시야각 `fovDeg` 30–35°는 원근 왜곡을 줄여 줍니다. 단면을 보여줄 때는 잘린 면 쪽에서 바라봅니다.
4. **장면 3개:** ① 전체 모습 ② 내부 단면(투명화 + 잘라내기) ③ 핵심 부분 확대(`zoom`, `target`). 장면마다 무엇을 보면 되는지 한 줄씩 알려줍니다.
5. **마무리:** 사용자가 가장 이해하기 좋은 장면으로 끝냅니다. 프로젝트를 저장하면 보기와 겉모습도 함께 저장됩니다.

### 화풍 고르기

표면(`surface`: `voxel`·`smooth`)과 조명 방식(`lighting.style`: `standard`·`toon`)은 서로 독립된 선택이고, 조합마다 매력이 다릅니다. 보여주려는 목적에 맞게 고르세요.

| 조합 | 느낌 | 어울리는 때 |
|---|---|---|
| smooth + standard | 재료 질감·빛·그림자가 있는 사진 같은 모습 | 완성 구조의 대표 장면, 금속과 막의 질감 |
| smooth + toon | 윤곽선과 면 단위 음영의 깔끔한 일러스트 | 구조 설명, 층이 많은 적층, 작은 부품 구분, 문서·발표 그림 |
| voxel + toon | 격자 계단이 그대로 보이는 또렷한 기술 도식 | 직각으로 이루어진 구조(GAA·FinFET·배선), 가장 가벼움 |
| voxel + standard | 계산 격자 그대로 | 치수·얇은 막 확인, 만드는 도중 점검 |

- 사용자가 원하는 느낌을 말했으면 그대로 따릅니다. 말하지 않았으면 목적에 맞는 조합 하나를 고르고, 무엇을 왜 골랐는지 한 줄로 알립니다.
- 다른 화풍이 이해를 도우면 장면을 한 장 더 보여줍니다. 예: 대표 장면은 smooth + standard, 내부 설명은 toon.
- 곡면(구멍, 원통, 둥근 모서리)이 많으면 smooth가 자연스럽습니다. 직각 구조는 voxel도 깔끔합니다.
- 계산과 검사는 voxel로 하고, 화풍은 구조를 다 만든 뒤 마지막에 정합니다. 색과 질감(`setAppearance`)은 이미 만든 표면을 다시 만들지 않으므로 smooth를 켠 뒤에 바꿔도 됩니다. 비싼 것은 smooth 표면을 만드는 일이고, **단면(`cutaway`)을 바꿀 때마다 다시 만듭니다**(`getView().render.smoothBuildMs`, 툰이면 윤곽선 `featureLinesMs`가 더해짐). 그래서 단면 범위와 카메라는 voxel에서 정한 뒤 마지막에 smooth로 바꿉니다.

### 사실적 마감 (standard)

- **조명:** `style: "standard"`, 밝기 1.1–1.2, 그림자를 켜고(`softness` 약 0.7) 빛은 카메라보다 30–40° 오른쪽, 고도각 50–55°에서 오게 합니다(예: 카메라 방위각 −60°이면 빛 −25°). 보이는 면이 밝고 그림자가 구조 뒤로 떨어져 입체감이 생깁니다.
- **재료 색과 질감** (`setAppearance`):
  - 기본 금속 색은 어둡습니다. 실제 재료처럼 보이도록 밝히세요. 예: Cu는 구리색(`#d9824e` 근처), W은 밝은 강철 회색(`#7f8b99` 근처).
  - 금속에는 먼저 `surfacePreset: "film"`(브러시드 막)을 쓰세요. 어느 각도에서도 재료 색이 살아 있는 금속 질감이 납니다. `"microstructure"`(다결정 금속)는 결정립과 강한 금속 반사를 보여주지만, 카메라를 향한 넓은 면이 검게 보일 수 있습니다. 확대 장면에서 써 보고 `captureView()`로 확인하세요.
  - 배선을 감싸는 얇은 라이너·배리어(TiN, TaN 등)는 바깥을 거의 다 덮어 배선 색처럼 보입니다. 밝고 차분한 금속색(`film`, 예: `#c2b8a3`)으로 두어 본체 금속이 윗면과 잘린 면에서 드러나게 하세요.

### 카툰 마감 (toon)

- **음영:** `lighting: { style: "toon", toonShade: "dark" }`를 기본으로 씁니다. 윗면과 옆면의 밝기 차가 커서 입체가 잘 보입니다. `"normal"`은 더 부드럽고, `"bright"`는 면이 하얗게 바래 구분이 약해집니다. `"none"`은 음영 없이 재료 색과 윤곽선만 남겨 평면 도식처럼 보이게 합니다. 색끼리 분명히 다를 때 씁니다.
- **윤곽선과 빛:** 윤곽선은 자동으로 그려집니다. 빛 방향은 사실적 마감과 같은 규칙을 따릅니다. 툰에서는 그림자가 거의 보이지 않으니 켜도 되고 꺼도 됩니다.
- **색:** 툰은 색을 밝고 흐리게 만듭니다. 사실적 마감용 밝은 금속색을 그대로 쓰면 바랜 그림이 되니, 한 단계 진한 중간 밝기 색을 씁니다. 예: Cu `#c8642d`, W `#5f6b7a`, TiN `#a08f6c`, 고유전막 `#6a4bc4`, n+ 에피 `#6f8fd8`, SiGe `#d98b4f`, Si 기판 `#b9b2c4`.
  - 이 색을 standard에서 쓰면 너무 어둡습니다. 화풍을 바꾸면 색도 함께 바꾸세요.
  - `"none"`은 색이 그대로 나오므로 사실적 마감용 색도 잘 어울립니다.
  - 흰색에 가까운 옅은 색은 배경과 윤곽선에 묻힙니다.

### 공통 마무리

- **재료 구분:** 맞닿은 재료는 색상이나 밝기가 분명히 달라야 합니다. 같은 계열의 비슷한 색 두 개가 붙어 있으면 구분되지 않습니다. 불투명하게 보이는 색은 대략 6개 이하로 줄이고, 핵심 기능막 하나(예: 고유전막, 커패시터 유전막)에 채도 높은 강조색을 씁니다. 색은 재료를 구분하는 수단입니다. 서로 다른 재료를 같은 색으로 만들거나, 재료의 종류(`type`)를 겉모습 때문에 바꾸지 마세요.
- **캔버스 표시:** 마지막 장면에서는 바닥 그리드와 좌표축을 끄고(`overlays: { floorGrid: false, axes: false }`) 눈금자(축척)는 남깁니다.
- **표면 비용:** smooth는 불투명한 재료끼리 맞닿은 면을 그리지 않아 그리는 양은 voxel과 비슷하지만, 표면을 만드는 시간과 메모리는 voxel보다 훨씬 큽니다. 예: 32만 열 3D NAND에서 표면 삼각형이 voxel 33만 개, smooth 720만 개이고, 단면을 한 번 바꾸는 데 voxel은 약 0.3초, smooth + 툰은 약 3.5–4.5초입니다(10코어 M4 기준. 큰 표면은 여러 워커가 나눠 만들므로 코어가 적은 컴퓨터에서는 더 걸립니다). smooth 표면은 단면을 바꿀 때마다, 그리고 캐시 없이 프로젝트를 열 때마다 다시 만들어집니다. 불투명도 0으로 숨긴 재료도 표면은 만들어지므로 큰 메움 산화막을 숨겨도 이 시간은 거의 그대로입니다. smooth를 켠 뒤 `getView().render`로 확인하세요([보기 설정](https://arpelier.com/docs/agents/api.md#보기-설정-보여주기)).
  - `triangles.drawn`이 300만을 넘으면: 반투명 층을 숨김(0)으로 바꾸거나 반투명 재료 수를 줄입니다.
  - 단면 비용(`smoothBuildMs` + `featureLinesMs`)이 3초 이하면 그대로 둡니다.
  - 3–8초면 smooth로 저장해도 되지만, 사용자에게 "단면 손잡이를 끄는 동안은 voxel로 바로 따라오고, 놓은 뒤 약 N초 뒤 smooth로 바뀐다"고 한 줄로 알립니다(smooth 생성이 1.5초 이상인 구조에서 앱이 자동으로 이렇게 보여 줌).
  - 8초를 넘거나 `geometryMB`가 300을 넘으면: 저장할 보기는 voxel로 두고(깔끔한 도식이면 voxel + toon) smooth는 캡처할 때만 켰다 끄며, 사용자에게 한 줄로 알립니다.
- **스스로 확인:** `captureView()`로 화면을 받아 직접 봅니다. ① 투명한 층이 겹쳐 탁하지 않은지 ② 금속 면이 검게 뭉개지지 않는지(standard) ③ 색이 바래 면 구분이 약하지 않은지(toon) ④ 맞닿은 재료가 구분되는지 ⑤ 구조가 화면을 충분히 채우는지(빈 여백이 크면 `zoom`) ⑥ 핵심 재료가 가려지지 않았는지. 고친 뒤 다시 찍어 확인합니다. `captureView()`는 기본으로 화면의 2배 밀도로 그린 뒤 줄인 고품질 이미지라, 얇은 막과 가장자리가 화면보다 깨끗합니다. 사용자에게 보여줄 최종 이미지도 이것으로 찍으세요.
- **보고:** 고른 화풍과 이유, 숨긴 재료, 바꾼 색과 질감을 한 줄씩 알립니다.

### Flow로 넘길 때

브라우저 API 없이 넘길 때(커넥터 링크·미리보기, "Flow JSON 열기", Flow 파일)는 위 장면 규칙을 Flow의 `view`에 적습니다. `view`가 있는 문서는 Flow 1.1이므로 `schema`를 `https://arpelier.com/schema/flow-1.1.json`으로 씁니다([Flow 1.1 스키마](https://arpelier.com/schema/flow-1.1.json)). 필드는 `setView`와 같고 `highlightMaterialIds`만 없습니다. 계산·측정 결과는 `view`와 무관합니다.

```json
"view": {
  "transparentMaterialIds": [18],
  "transparentOpacity": 0,
  "cutaway": { "y": [0, 120] },
  "camera": { "preset": "iso", "elevationDeg": 35, "fovDeg": 32 },
  "surface": "smooth",
  "lighting": { "style": "toon", "toonShade": "dark" },
  "overlays": { "floorGrid": false, "axes": false }
}
```

- 투명화할 재료는 `arpelier_compute_flow` 결과의 `materials[].volumeFraction`으로 비율을 보고 고릅니다.
- 미리보기(`arpelier_preview_structure`, `preview_show_flow`)와 그 그룹 썸네일은 투명·숨김 재료, 표면, 조명, 바닥 격자, 카메라 방향을 따릅니다. `cutaway`는 한 축의 한쪽 끝을 자를 때만(위의 y처럼) 미리보기에서 단면으로 보입니다.
- 서버 그림(`arpelier_render_structure`, 큰 구조의 미리보기 그림)은 불투명도 0.5 이하인 투명 재료를 빼고 그립니다.
- 앱 링크(`arpelier_open_in_app`)와 "Flow JSON 열기"는 `view`를 프로젝트의 보기 설정으로 넣습니다. 카메라와 z 범위 잘라내기는 구조 높이가 있어야 해서, 링크는 서버가 계산을 마쳤을 때만 넣고(빠지면 결과의 `view.skipped`), "Flow JSON 열기"는 카메라 방향만 도메인 크기에 맞춰 넣고 z 범위는 뺍니다.
- 색은 `materials`의 `color`로 정합니다. 금속성·거칠기·표면 프리셋은 Flow 형식에 없으니 앱에서 연 뒤 `setAppearance`(또는 재료 패널)로 정합니다.

9. 예제 Flow (oxide window)

원본 / Source: https://arpelier.com/docs/agents/examples/oxide-window.flow.json

{
  "schema": "https://arpelier.com/schema/flow-1.0.json";,
  "name": "Oxide window",
  "note": "Small geometry example: substrate, oxide, photoresist opening, oxide etch, resist strip. This is not a calibrated device model.",
  "domain": { "LX": 80, "LY": 80, "dx": 5, "dy": 5 },
  "gridResolution": 1,
  "masks": [
    {
      "id": "window", "name": "Oxide opening", "negpol": true,
      "domain": { "LX": 80, "LY": 80 },
      "data": { "objects": [
        { "type": "rect", "left": 20, "top": 20, "width": 40, "height": 40, "data": { "polarity": "positive" } }
      ] }
    }
  ],
  "processes": [
    {
      "id": "substrate", "kind": "SUBSTR", "material": 5, "substrateDoping": "p", "thickness": 30,
      "name": "p-Si substrate",
      "note": "Starts from p-type silicon, 30 nm of it under this small 80 × 80 nm window of the wafer. Every dimension in this example is a round illustrative value, not one taken from a source."
    },
    {
      "id": "oxide", "kind": "DEPO", "material": 18, "thickness": 20,
      "name": "Oxide film",
      "note": "Covers the whole surface with 20 nm of SiO2, the film the window is opened in. On a real line the film's thickness uniformity decides how evenly the later etch clears it across the wafer."
    },
    {
      "id": "photo", "kind": "PHOTO", "mask": "window", "thickness": 10,
      "name": "Window resist pattern",
      "note": "Coats 10 nm of photoresist and exposes the window mask, so the resist stays everywhere except the 40 × 40 nm square in the middle. The resist only has to outlast the oxide etch; a real resist would be far thicker than this geometric example needs."
    },
    {
      "id": "etch", "kind": "ETCH", "materialetch": { "18": 1 }, "materialetchSelectionMode": "exact", "thickness": 20,
      "name": "Oxide window etch",
      "note": "Removes the 20 nm of SiO2 left open in the window and stops on the silicon, since this etch removes only SiO2. On a real line a short over-etch makes sure the oxide clears everywhere while attacking the silicon below as little as possible; this model removes exactly the 20 nm."
    },
    {
      "id": "strip", "kind": "STRIP", "material": 24,
      "name": "Resist strip",
      "note": "Strips the remaining photoresist, leaving the 20 nm oxide with a 40 × 40 nm opening down to the silicon."
    }
  ]
}

10. Flow 1.1 JSON Schema

원본 / Source: https://arpelier.com/schema/flow-1.1.json

{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://arpelier.com/schema/flow-1.1.json","title":"Arpelier flow API 1.1","type":"object","additionalProperties":false,"description":"Native authoring fields in nm. JSON Schema checks shape; validate() also checks domain tiling, process references, groups and current supported models. BONDING and PARTICLE require separate contracts and are not supported in v1. Version 1.1 is 1.0 plus view: how the structure is shown.","required":["schema","domain","processes"],"properties":{"schema":{"const":"https://arpelier.com/schema/flow-1.1.json"},"name":{"type":"string"},"note":{"type":"string"},"domain":{"type":"object","required":["LX","LY","dx","dy";],"additionalProperties":false,"properties":{"LX":{"type":"number","exclusiveMinimum":0},"LY":{"type":"number","exclusiveMinimum":0},"dx":{"type":"number","exclusiveMinimum":0},"dy":{"type":"number","exclusiveMinimum":0}}},"gridResolution":{"type":"integer","enum":[1,2,3],"default":2,"description":"XY spacing divisor: 1, 2 and 4 respectively."},"displayUnits":{"type":"object","required":["length"],"additionalProperties":false,"properties":{"length":{"enum":["nm","um","mm"]}},"description":"Display preferences only; persisted geometric values remain nm."},"materials":{"type":"array","items":{"type":"object","required":["id","name","color","type"],"properties":{"id":{"type":"integer","anyOf":[{"minimum":3,"maximum":24},{"minimum":100,"maximum":240}]},"name":{"type":"string"},"color":{"type":"string"},"type":{"type":"string"}}}},"masks":{"type":"array","items":{"type":"object","required":["id","negpol","domain","data"],"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,160}$"},"name":{"type":"string"},"note":{"type":"string"},"negpol":{"type":"boolean"},"domain":{"type":"object","required":["LX","LY"],"properties":{"LX":{"type":"number","exclusiveMinimum":0},"LY":{"type":"number","exclusiveMinimum":0}}},"data":{"type":"object","required":["objects"],"properties":{"objects":{"type":"array","items":{"type":"object","required":["type"],"properties":{"type":{"enum":["rect","circle","polygon"]},"data":{"type":"object","properties":{"polarity":{"enum":["positive","negative"]}}}}}}}}}}},"processes":{"type":"array","minItems":1,"items":{"oneOf":[{"type":"object","required":["id","kind"],"additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,160}$"},"kind":{"const":"GROUPSTART"},"name":{"type":"string"},"note":{"type":"string"},"displayName":{"type":"string"},"isignore":{"type":"boolean"},"unfolded":{"type":"boolean"},"isModule":{"type":"boolean"},"cycleCount":{"type":"integer","minimum":1},"iterationEnabled":{}}},{"type":"object","required":["id","kind"],"additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,160}$"},"kind":{"const":"GROUPEND"},"name":{"type":"string"},"note":{"type":"string"},"displayName":{"type":"string"},"isignore":{"type":"boolean"},"unfolded":{"type":"boolean"},"isModule":{"type":"boolean"},"cycleCount":{"type":"integer","minimum":1},"iterationEnabled":{}}},{"type":"object","required":["id","kind"],"additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,160}$"},"kind":{"const":"SUBSTR"},"name":{"type":"string"},"displayName":{"type":"string"},"note":{"type":"string"},"isignore":{"type":"boolean"},"mask":{},"maskPolarityInverted":{},"material":{"anyOf":[{"type":"integer","minimum":3,"maximum":255},{"type":"string"}]},"materialetch":{"type":"object","additionalProperties":{"type":"number","minimum":0}},"thickness":{"type":"number","minimum":0,"exclusiveMinimum":0},"generatedStepMeta":{},"implantAdvancedEnabled":{},"substrateDoping":{"type":"string","default":"-"}}},{"type":"object","required":["id","kind","material"],"additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,160}$"},"kind":{"const":"DEPO"},"name":{"type":"string"},"displayName":{"type":"string"},"note":{"type":"string"},"isignore":{"type":"boolean"},"mask":{},"maskPolarityInverted":{},"material":{"anyOf":[{"type":"integer","minimum":3,"maximum":255},{"type":"string"}],"not":{"enum":["","-"]}},"materialetch":{"type":"object","additionalProperties":{"type":"number","minimum":0}},"thickness":{"type":"number","minimum":0},"generatedStepMeta":{},"implantAdvancedEnabled":{},"conformality":{"type":"number","minimum":0,"maximum":1},"bottomGrowthRatio":{"type":"number","default":1}}},{"type":"object","required":["id","kind","material"],"additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,160}$"},"kind":{"const":"ALD"},"name":{"type":"string"},"displayName":{"type":"string"},"note":{"type":"string"},"isignore":{"type":"boolean"},"mask":{},"maskPolarityInverted":{},"material":{"anyOf":[{"type":"integer","minimum":3,"maximum":255},{"type":"string"}],"not":{"enum":["","-"]}},"materialetch":{"type":"object","additionalProperties":{"type":"number","minimum":0}},"thickness":{"type":"number","minimum":0},"generatedStepMeta":{},"implantAdvancedEnabled":{},"seed":{},"aldIsotropicAnalysis":{"type":"boolean","default":false},"aldGrowthModel":{"type":"string","default":"uniform"},"aldSurfaceRoughness":{"type":"number","default":0},"aldRoughnessSeed":{},"aldInitialNucleationCoverage":{"type":"number","default":20},"aldNucleationRatePerCycle":{"type":"number","default":5},"aldNucleusDiameter":{"type":"number","default":1},"aldCycleThickness":{"type":"number","default":2}}},{"type":"object","required":["id","kind","material"],"additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,160}$"},"kind":{"const":"SPIN COATING"},"name":{"type":"string"},"displayName":{"type":"string"},"note":{"type":"string"},"isignore":{"type":"boolean"},"mask":{},"maskPolarityInverted":{},"material":{"anyOf":[{"type":"integer","minimum":3,"maximum":255},{"type":"string"}],"not":{"enum":["","-"]}},"materialetch":{"type":"object","additionalProperties":{"type":"number","minimum":0}},"thickness":{"type":"number","minimum":0},"generatedStepMeta":{},"implantAdvancedEnabled":{}}},{"type":"object","required":["id","kind","materialetch"],"additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,160}$"},"kind":{"const":"ETCH"},"name":{"type":"string"},"displayName":{"type":"string"},"note":{"type":"string"},"isignore":{"type":"boolean"},"mask":{},"maskPolarityInverted":{},"material":{"anyOf":[{"type":"integer","minimum":3,"maximum":255},{"type":"string"}]},"materialetch":{"type":"object","minProperties":1,"additionalProperties":{"type":"number","minimum":0,"maximum":1}},"thickness":{"type":"number","minimum":0},"generatedStepMeta":{},"implantAdvancedEnabled":{},"conformality":{"type":"number","minimum":0,"maximum":1},"bowing":{"type":"number","minimum":0,"maximum":1},"materialetchSelectionMode":{"enum":["exact"]}}},{"type":"object","required":["id","kind","materialetch"],"additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,160}$"},"kind":{"const":"WET ETCH"},"name":{"type":"string"},"displayName":{"type":"string"},"note":{"type":"string"},"isignore":{"type":"boolean"},"mask":{},"maskPolarityInverted":{},"material":{"anyOf":[{"type":"integer","minimum":3,"maximum":255},{"type":"string"}]},"materialetch":{"type":"object","minProperties":1,"additionalProperties":{"type":"number","minimum":0,"maximum":1}},"thickness":{"type":"number","minimum":0},"generatedStepMeta":{},"implantAdvancedEnabled":{},"wetIsotropicAnalysis":{"type":"boolean","default":false},"seam":{"type":"number","minimum":0,"maximum":10,"description":"Gap height in nm: lateral WET access needs an open gap strictly taller than this."},"materialetchSelectionMode":{"enum":["exact"]},"wetAdvancedEnabled":{"type":"boolean","default":false},"wetReactionModel":{"type":"string","default":"cyclic_self_limited"},"wetCycleCount":{"type":"number","default":10},"wetReactionDepth":{"type":"number","default":1},"wetSurfaceSaturation":{},"wetRemovalEfficiency":{}}},{"type":"object","required":["id","kind"],"additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,160}$"},"kind":{"const":"CMP"},"name":{"type":"string"},"displayName":{"type":"string"},"note":{"type":"string"},"isignore":{"type":"boolean"},"mask":{},"maskPolarityInverted":{},"material":{"anyOf":[{"type":"integer","minimum":3,"maximum":255},{"type":"string"}]},"materialetch":{"type":"object","additionalProperties":{"type":"number","minimum":0}},"thickness":{"type":"number","minimum":0},"generatedStepMeta":{},"implantAdvancedEnabled":{},"stopper":{},"dishingMaterials":{"type":"object","additionalProperties":{"type":"number","minimum":0}},"dishing":{"type":"number","minimum":0,"maximum":1},"materialSelectionMode":{},"dishingMaterialsSelectionMode":{}}},{"type":"object","required":["id","kind"],"additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,160}$"},"kind":{"const":"STRIP"},"name":{"type":"string"},"displayName":{"type":"string"},"note":{"type":"string"},"isignore":{"type":"boolean"},"mask":{},"maskPolarityInverted":{},"material":{"anyOf":[{"type":"integer","minimum":3,"maximum":255},{"type":"string"}]},"materialetch":{"type":"object","additionalProperties":{"type":"number","minimum":0}},"thickness":{"type":"number","minimum":0},"generatedStepMeta":{},"implantAdvancedEnabled":{},"liftOff":{"type":"boolean","default":false},"liftOffRemoveAtSides":{"type":"boolean","default":true},"stripMaterials":{"type":"object","additionalProperties":{"type":"number","minimum":0}},"materialSelectionMode":{}}},{"type":"object","required":["id","kind"],"additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,160}$"},"kind":{"const":"PHOTO"},"name":{"type":"string"},"displayName":{"type":"string"},"note":{"type":"string"},"isignore":{"type":"boolean"},"mask":{},"maskPolarityInverted":{},"material":{"anyOf":[{"type":"integer","minimum":3,"maximum":255},{"type":"string"}]},"materialetch":{"type":"object","additionalProperties":{"type":"number","minimum":0}},"thickness":{"type":"number","minimum":0},"generatedStepMeta":{},"implantAdvancedEnabled":{},"photoOpticalEnabled":{"type":"boolean","default":false},"photoOpticalWavelength":{"type":"number","default":193},"photoOpticalNA":{"type":"number","default":1.35},"photoExposureThreshold":{"type":"number","default":0.5},"photoOpcCornerSerifEnabled":{"type":"boolean","default":false}}},{"type":"object","required":["id","kind"],"additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,160}$"},"kind":{"const":"IMPLANT"},"name":{"type":"string"},"displayName":{"type":"string"},"note":{"type":"string"},"isignore":{"type":"boolean"},"mask":{},"maskPolarityInverted":{},"material":{"anyOf":[{"type":"integer","minimum":3,"maximum":255},{"type":"string"}]},"materialetch":{"type":"object","additionalProperties":{"type":"number","minimum":0}},"thickness":{"type":"number","minimum":0},"generatedStepMeta":{},"implantAdvancedEnabled":{},"dopingtype":{},"implantDepth":{"type":"number","default":0},"depthStraggle":{"type":"number","default":0},"diffusionLength":{"type":"number","default":0},"diffuseExistingDopants":{"type":"boolean","default":false}}},{"type":"object","required":["id","kind"],"additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,160}$"},"kind":{"const":"OXIDATION"},"name":{"type":"string"},"displayName":{"type":"string"},"note":{"type":"string"},"isignore":{"type":"boolean"},"mask":{},"maskPolarityInverted":{},"material":{"anyOf":[{"type":"integer","minimum":3,"maximum":255},{"type":"string"}]},"materialetch":{"type":"object","additionalProperties":{"type":"number","minimum":0}},"thickness":{"type":"number","minimum":0},"generatedStepMeta":{},"implantAdvancedEnabled":{},"enhancedIsotropyEnabled":{"type":"boolean","default":false}}},{"type":"object","required":["id","kind"],"additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,160}$"},"kind":{"const":"MODIFICATION"},"name":{"type":"string"},"displayName":{"type":"string"},"note":{"type":"string"},"isignore":{"type":"boolean"},"mask":{},"maskPolarityInverted":{},"material":{"anyOf":[{"type":"integer","minimum":3,"maximum":255},{"type":"string"}]},"materialetch":{"type":"object","additionalProperties":{"type":"number","minimum":0}},"thickness":{"type":"number","minimum":0},"generatedStepMeta":{},"implantAdvancedEnabled":{},"sourceMaterial":{"type":"string","default":"-"},"targetMaterial":{"type":"string","default":"-"},"volumeRatio":{"type":"number","default":2.27},"reactionDirectionality":{"type":"number","default":0},"enhancedIsotropyEnabled":{"type":"boolean","default":false},"sourceMaterials":{"type":"object","additionalProperties":{"type":"number","minimum":0}},"sourceMaterialSelectionMode":{}}}]}},"view":{"type":"object","additionalProperties":false,"description":"How the structure is shown: the fields of window.arpelier.setView without highlightMaterialIds. Opening the Flow in the web app, through a link or Open Flow JSON, saves it with the project; the conversation preview, its group pictures and server pictures show it. Presentation only: computing and measuring never read it.","properties":{"transparentMaterialIds":{"type":"array","items":{"type":"integer","minimum":1},"description":"Materials drawn see-through, or hidden with transparentOpacity 0: usually the fill and insulating films that cover the device."},"transparentOpacity":{"type":"number","minimum":0,"maximum":1,"default":0.08,"description":"Opacity of the see-through materials; 0 hides them."},"cutaway":{"anyOf":[{"type":"null"},{"type":"object","additionalProperties":false,"properties":{"x":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"number","minimum":0},"description":"[minNm, maxNm], min < max."},"y":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"number","minimum":0},"description":"[minNm, maxNm], min < max."},"z":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"number","minimum":0},"description":"[minNm, maxNm], min < max."}}}],"description":"The box removed to show the inside, per axis in nm; an axis left out is removed over its whole length. z needs the computed height."},"camera":{"type":"object","additionalProperties":false,"properties":{"preset":{"enum":["iso","front","back","left","right","top"]},"azimuthDeg":{"type":"number"},"elevationDeg":{"type":"number","minimum":-89,"maximum":89},"zoom":{"type":"number","minimum":0.2,"maximum":20,"default":1},"target":{"type":"object","required":["xNm","yNm","zNm"],"additionalProperties":false,"properties":{"xNm":{"type":"number"},"yNm":{"type":"number"},"zNm":{"type":"number"}}},"fovDeg":{"type":"number","minimum":15,"maximum":75}}},"surface":{"enum":["voxel","smooth"]},"lighting":{"type":"object","additionalProperties":false,"properties":{"style":{"enum":["standard","toon"]},"intensity":{"type":"number","minimum":0,"maximum":2},"mainLight":{"type":"boolean"},"toonShade":{"enum":["dark","normal","bright","none"]},"shadow":{"anyOf":[{"type":"boolean"},{"type":"object","additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"softness":{"type":"number","minimum":0,"maximum":1},"reach":{"type":"number","minimum":0,"maximum":1}}}]},"direction":{"type":"object","required":["azimuthDeg","elevationDeg"],"additionalProperties":false,"properties":{"azimuthDeg":{"type":"number"},"elevationDeg":{"type":"number","minimum":22,"maximum":84}}}}},"overlays":{"type":"object","additionalProperties":false,"properties":{"floorGrid":{"type":"boolean"},"axes":{"type":"boolean"},"ruler":{"type":"boolean"}}}}}}}