> For the complete documentation index, see [llms.txt](https://help.movin3d.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.movin3d.com/movin-tracin-stage-kr/setup/calibration.md).
# Stage 1 · Calibration
Calibration은 라이다 센서 여러 대가 본 장면을 하나의 3D 공간으로 합치는 과정입니다. 처음 설치한 뒤, 센서를 옮긴 뒤, 그리고 벽이나 바닥이 두 겹으로 보일 때 진행합니다.
시작하기 전에 무대를 비우고, 모든 센서의 전원과 네트워크를 연결하고, calibration wand를 준비해주세요.
{% hint style="info" %}
센서는 그대로인데 바닥 높이나 앞 방향만 어긋나 보이면 전체 과정을 반복할 필요가 없습니다. [무대 정렬만 조정하기](#무대-정렬만-조정하기)를 참고해주세요.
지난 공연 이후 바뀐 것이 없으면 이 스테이지의 \*\*Skip to Settings ›\*\*로 Stage 2로 바로 넘어갈 수 있습니다. 이 버튼은 저장된 캘리브레이션이 있을 때만 활성화됩니다.
{% endhint %}
## 센서 연결
1. 왼쪽에서 **Calibration → Connect sensors**를 선택하면 센서를 찾습니다.
2. 설치한 센서가 모두 목록에 보이는지 확인해주세요. 빠진 센서가 있으면 전원과 케이블을 확인한 뒤 **Detect again**을 선택합니다.
3. 왼쪽 **Calibrate sensors**를 선택하고 오른쪽 패널의 **Calibrate**를 누릅니다.
Calibrate를 누르면 아래 여섯 단계가 시작됩니다.
{% hint style="info" %}
파이프라인이 실행 중이면 Calibration이 잠깁니다. 수정하려면 상단 **Stop pipeline**을 선택해주세요. 송출 중이었다면 송출이 끊기고, 다시 **GO LIVE** 해야 재개됩니다.
{% endhint %}
## 1 · Setup
1. 모든 센서의 **PTP sync**, **Connected**, **Live data**가 초록색인지 확인해주세요. **Reference** 센서는 자동으로 정해집니다.
2. Wand를 선택합니다. **Regular**(공 지름 15 cm) 또는 **Big**(공 지름 20 cm).
{% hint style="warning" %}
스트림이 시작되지 않으면 전원과 케이블을 확인하고 **Try again**을 선택해주세요. **PTP sync**가 계속 초록색이 되지 않으면 MOVIN 지원 팀에 문의해주세요.
{% endhint %}
## 2 · First calibration
1. **Start collection**을 선택합니다. Wand 안내가 나오면 다시 **Start collection**을 눌러 시작합니다.
2. Wand를 들고 무대 전체를 천천히 걸어주세요.
3. 걷는 동안 wand 높이를 바닥 가까이부터 머리 위까지 바꿔주세요.
센서마다 추정값이 안정되면 수집이 자동으로 끝납니다. 중지 버튼은 없습니다.
1. **Collection progress**에서 센서가 모두 ready인지 확인해주세요.
2. **Result review**를 확인합니다. **Pass**면 충분합니다. 실패한 센서가 있을 때만 다시 수집합니다.
3. **Confirm first calibration**을 선택하면 Refine calibration으로 넘어갑니다. Next를 따로 누를 필요는 없습니다.
### 수집이 끝나지 않을 때
센서별 진행 상태와 **Live data / PTP sync**를 확인해주세요. Wand를 이웃한 센서 두 대 이상이 함께 보는 구간으로 가져가고 높이도 바꿔봅니다. 특정 센서만 진행되지 않으면 그 센서의 시야, 가림, 케이블을 확인합니다. 계속 멈춰 있으면 화면과 센서 상태를 [지원 요청 시 준비할 정보](https://help.movin3d.com/movin-tracin-stage-kr/setup/pages/FomWo6uasyNhLQ9NO7rT#지원-요청-시-준비할-정보)와 함께 보내주세요. Wizard를 닫으면 저장하지 않은 수집 내용은 사라집니다.
## 3 · Refine calibration
First calibration과 달리 이 단계는 직접 중지해야 끝납니다.
1. **Start capture**를 선택합니다. Wand 안내가 나오면 다시 **Start capture**를 눌러 시작합니다.
2. Wand를 좌우, 앞뒤, 아래위로 고르게 움직여주세요.
3. 뷰포트에서 wand 궤적이 한곳에 몰리지 않고 작업 공간 전체를 덮는지 확인합니다.
4. **Enough data — press Stop when ready**가 표시되면 **Stop capture**를 선택합니다.
5. **Refine calibration**을 선택해야 보정값이 계산됩니다. Stop capture만으로는 계산되지 않습니다.
Refinement 완료 화면.
**Refinement**가 **Complete**이면 **Next · Select axis**를 선택합니다.
데이터가 더 필요하면 **Capture more**로 추가 수집한 뒤 **Stop capture**, **Refine again** 순서로 진행합니다. **Reset all**은 이 단계의 수집과 결과를 모두 지우고 처음부터 다시 시작합니다.
## 4 · Select axis
**Origin**, **Right**, **Forward** 세 지점을 순서대로 지정합니다. **Origin**은 캡처 공간의 중앙에 두고, 그 자리에서 객석을 바라보세요. **Right**는 그 상태에서 본인의 오른쪽, **Forward**는 객석 방향입니다.
세 축 지점의 wand 배치.
1. **Start origin capture**를 선택합니다.
2. 원점에 wand를 놓고 물러납니다.
3. **Placed — start capture**를 선택하고, 후보 목록이 나타날 때까지 wand를 움직이지 마세요.
원점 수집 후 나타나는 후보 목록.
4. 선택된 마커가 실제 wand 위치와 맞는지 확인합니다. 다르면 맞는 후보를 고릅니다.
5. **Next: right**를 누르고 wand를 오른쪽 지점으로 옮긴 뒤 **Start right capture**로 같은 절차를 반복합니다.
6. **Next: forward**를 누르고 앞쪽 지점에서 **Start forward capture**를 진행합니다.
7. 세 지점이 모두 정해지면 **Next · World alignment**를 선택합니다.
다시 측정하려면 해당 지점의 **Resample**을 누릅니다.
## 5 · World alignment
네 뷰의 World alignment.
이 단계에 들어오면 **Auto align**이 자동으로 실행됩니다.
1. **World solve**가 **Complete**가 되면 Top, Front, Side, 3D 뷰를 확인합니다.
2. 바닥이 기울어 보이거나 높이가 어긋나면 바닥을 비운 상태에서 **Fast refine**을 선택합니다.
3. 결과가 맞으면 **Confirm**을 선택합니다. 몇 초간 비활성일 수 있으니 잠시 기다려주세요.
### 저장 전 확인
왼쪽은 정렬된 표면, 오른쪽은 다시 확인해야 하는 표면.
| 확인할 것 | 정상 | 다시 확인해야 하는 경우 |
| -------------------- | ------------------ | --------------------------------------- |
| 같은 바닥·벽의 센서별 점군 | 하나의 표면으로 겹침 | 두 겹으로 벌어짐: 센서 이동 여부 확인 후 재캘리브레이션 |
| Front·Side 뷰의 무대 바닥 | 수평이고 원점의 바닥 높이와 맞음 | 기울거나 높이가 어긋남: 바닥을 비우고 Fast refine 후 재확인 |
| Origin·Right·Forward | 실제 O/R/F 배치와 일치 | 방향이 다름: Select axis에서 지점 선택 재확인 |
Complete 표시만 믿지 말고 실제 무대와 맞는지 확인한 뒤 **Next · Save**를 선택합니다.
## 6 · Save
제안된 파일명을 그대로 쓰거나 새 이름을 입력하고 **Save**를 선택합니다. 저장한 결과는 다음 파이프라인 시작부터 기본값으로 쓰입니다.
{% hint style="warning" %}
**Discard & exit**는 이번 세션의 작업(wand 궤적, 축 지점, Refine 결과)을 모두 지웁니다. \*\*×\*\*로 닫아도 같습니다. 남기려면 먼저 저장해주세요.
{% endhint %}
## 무대 정렬만 조정하기
센서는 그대로인데 바닥 높이가 다르거나, 장면이 기울었거나, 앞 방향이 틀렸을 때는 wand 수집을 반복하지 않아도 됩니다.
1. 파이프라인이 멈춘 상태에서 **Calibration → Align world**를 선택합니다. 저장된 센서 정렬은 그대로 두고 World alignment 단계로 바로 이동합니다.
2. 바닥과 앞 방향을 조정하고 저장합니다.
**Align world**는 저장된 캘리브레이션이 있고 파이프라인이 멈춰 있을 때만 나타납니다. 센서를 옮겼거나, 추가·제거했거나, 표면이 두 겹으로 보이면 **Re-calibrate**로 전체 과정을 진행해주세요.
다음은 [Stage 2 · Settings](/movin-tracin-stage-kr/setup/live-settings.md)입니다.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.movin3d.com/movin-tracin-stage-kr/setup/calibration.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
