ATLAS Revit 연결 가이드

1. pyRevit 설치

1. pyRevit 릴리스 페이지에서 최신 설치 파일을 받아 설치합니다. (Revit 2025–2027 지원, 무료)
2. Revit LT에는 API가 없어 연결할 수 없습니다. Revit 정식 버전이 필요합니다.

2. ATLAS 확장 등록

1. ATLAS 저장소의 apps/portal/pyrevit 폴더를 이 PC에 둡니다.
2. PowerShell에서 등록 스크립트를 실행합니다. pyRevit 설정에 확장 경로를 추가하고 routes 서버를 켭니다. 여러 번 실행해도 안전합니다. powershell -ExecutionPolicy Bypass -File .\install_pyrevit_extension.ps1
3. Revit을 다시 시작합니다. 리본에 ATLAS 탭이 생깁니다.

3. 연결 확인

1. Revit에서 프로젝트를 엽니다. 새 프로젝트는 ATLAS 템플릿(.rte)으로 시작하면 ATLAS 타이틀블록과 스타일이 그대로 적용됩니다.
2. 포털 상단의 센서가 🟢 LOCAL REVIT CONNECTED로 바뀌면 연결된 것입니다. 포털은 48884–48888 포트를 자동으로 찾습니다.
3. 직접 확인: 브라우저에서 http://localhost:48884/atlas/status 를 열어 "status": "connected" 가 보이면 정상입니다.

4. 도면 생성

1. 포털에서 설계를 실행한 뒤 ⚡ Send to Revit Live를 누릅니다.
2. Revit에 층별 벽·바닥·문·창·계단·지붕이 그려지고, ATLAS 번호 체계(A0.0 표지, A1.0 배치도, A3.x 평면, A5.x 입면·단면, A6.0 OBC)로 시트가 만들어집니다.
3. 결과는 개략(SCHEMATIC)이며 허가 제출 전 BCIN 설계자의 검토·날인이 필요합니다.

문제 해결

• 센서가 빨간색: Revit이 열려 있는지, pyRevit 설정에서 Routes 서버가 켜져 있는지 확인하세요. Chrome이 "로컬 네트워크 접근" 허용을 물으면 허용해야 합니다.
• 포트가 바뀜: 이전 Revit 프로세스가 48884를 잡고 있으면 pyRevit이 다음 포트를 씁니다. 포털이 자동으로 찾으니 그대로 두면 됩니다.
• 오류 메시지: 포털 알림에 표시되는 traceback을 개발자에게 전달하세요.

ATLAS 엔진 코드는 매 요청마다 디스크에서 새로 읽히므로, 업데이트 후 Revit을 재시작할 필요가 없습니다. (단, 새 기능 경로가 추가된 업데이트는 1회 재시작 필요)