GCP 관리 (지상기준점)
프로젝트의 지상기준점(GCP)을 등록, 가져오기, 내보내기합니다.
GCP 페이지 접근
- 네비게이션 → "GCP" 클릭
- 대시보드 → GCP 카드 클릭
네비게이션의 그룹(파일) 목록
네비게이션 GCP 항목을 펼치면 개별 점이 아니라 그룹(가져온 파일) 단위로
표시됩니다 — 예: 현장A_기준점 (12점). 그룹을 클릭하면 GCP 관리 페이지가
해당 그룹만 필터해 보여줍니다.
- 그룹 이름 = 가져온 파일 이름 (확장자 제외)
- 파일 없이 직접 추가한 GCP는 미분류 그룹으로 묶입니다
화면 구성
전체 폭 데이터 테이블로 GCP 목록을 표시합니다.
테이블 컬럼
| 컬럼 | 설명 | 편집 방식 |
|---|---|---|
| 이름 | GCP 포인트 이름 | 텍스트 입력 |
| X | Easting 좌표 | 텍스트 입력 |
| Y | Northing 좌표 | 텍스트 입력 |
| Z | 높이/표고 | 텍스트 입력 |
| 타입 | 기준점 유형 | 콤보박스 (자동 펼침) |
| 가중치 | 번들 조정 가중치 | 텍스트 입력 |
| 활성 | 사용 여부 | 콤보박스 (활성/비활성) |
| 설명 | 메모/설명 | 텍스트 입력 |
인라인 편집
셀을 더블클릭하면 바로 편집할 수 있습니다. 타입과 활성 컬럼은 콤보박스가 자동으로 펼쳐집니다.
그룹(파일) 필터
부제목 우측의 그룹 콤보로 테이블을 그룹 단위로 필터할 수 있습니다.
- 전체 (N점) — 모든 GCP 표시 (기본)
- 그룹명 (N점) — 해당 파일에서 가져온 GCP만 표시
그룹이 하나도 없으면(전부 미분류) 콤보는 자동으로 숨겨집니다. 필터 중에 [+ 추가]를 누르면 새 GCP가 현재 보고 있는 그룹 소속으로 생성됩니다.
헤더 버튼
| 버튼 | 기능 |
|---|---|
| 가져오기 | 외부 GCP 파일 가져오기 (CSV/TXT/XML) |
| 내보내기 | GCP를 파일로 내보내기 (5가지 포맷) |
| + 추가 | 빈 GCP 행 추가 (이름 자동 편집) |
| - 삭제 | 선택된 GCP 삭제 |
GCP 타입
| 타입 | 설명 | 번들 조정 역할 |
|---|---|---|
| Full | 완전기준점 (X, Y, Z 모두 활용) | 3D 위치 구속 |
| Horizontal | 수평기준점 (X, Y만 활용) | 수평 위치 구속 |
| Vertical | 수직기준점 (Z만 활용) | 높이 구속 |
| CheckPoint | 검사점 (정확도 검증용, 조정에 미사용) | 잔차 검증 |
가져오기
[가져오기] 버튼 클릭 시 대화상자가 열립니다.
지원 형식
| 형식 | 확장자 | 특징 |
|---|---|---|
| CSV | .csv |
쉼표/탭/세미콜론 구분, 헤더 자동 감지 |
| TXT | .txt |
공백/탭 구분, 구분자 선택 가능 |
| XML | .xml |
Agisoft GCP_List, Pix4D GCPs, 범용 형식 자동 감지 |
그룹 자동 기록
가져온 GCP에는 파일 이름이 그룹으로 자동 기록됩니다. 여러 파일을 "기존에 추가" 모드로 가져오면 파일별 그룹이 유지되어 네비게이션과 그룹 필터에서 구분됩니다.
3단계 탭 구성
| 탭 | 기능 |
|---|---|
| 원본 데이터 | 파일의 원본 내용 미리보기 (최대 100행) |
| 매핑 설정 | 컬럼 매핑 + 타입 값 매핑 |
| 파싱 결과 | 변환된 GCP 데이터 미리보기 |
컬럼 매핑
파일의 헤더 행에서 자동 감지됩니다. 수동 변경도 가능합니다.
| 파일 헤더 패턴 | GCP 필드 |
|---|---|
| id, pointid, gcp_id | 이름 |
| x, easting, lon, longitude | X |
| y, northing, lat, latitude | Y |
| z, height, elevation, alt | Z |
| type, gcptype, pointtype | 타입 |
| weight, sigma, accuracy | 가중치 |
타입 값 정규화
파일의 타입 값이 다양한 형식으로 제공되면 자동으로 정규화됩니다.
| 표준 타입 | 인식되는 값 |
|---|---|
| Full | full, control, gcp, ctrl, 3d, f, 기준점, 0, 1 |
| Horizontal | horizontal, h, xy, 2d_h, 수평, 2 |
| Vertical | vertical, v, 1d, 수직, 수준점, 3 |
| CheckPoint | checkpoint, check, cp, chk, verify, 검사점, 4 |
미인식 타입
알려지지 않은 타입 값은 노란색으로 강조 표시됩니다. 콤보박스로 수동 매핑을 변경할 수 있습니다.
필수값 검증
파싱 결과 테이블에서:
- 빨간 배경: 필수값 누락 (이름 없음, X/Y/Z 모두 0)
- 주황 배경: 자동 생성된 이름 (GCP_N 형식)
내보내기
[내보내기] 버튼으로 5가지 형식을 지원합니다.
| 형식 | 설명 |
|---|---|
| CSV | 쉼마 구분, 헤더 포함 |
| TXT | CSV와 동일 |
| XML | Agisoft <GCP_List> 호환 형식 |
| JSON | 구조화된 배열, 전체 필드 포함 |
| HTML | 통계 카드 + GCP 테이블 보고서 |
MCP 명령
| 명령 | 설명 |
|---|---|
control.addGCP |
GCP 추가 (group 파라미터 지원) |
control.updateGCP |
GCP 수정 |
control.removeGCP |
GCP 삭제 |
control.getGCPList |
목록 조회 (typeFilter, enabledOnly, groupFilter — 응답에 group 포함) |
control.setGCPWeight |
가중치 설정 |
control.setGCPEnabled |
활성화 토글 |
control.importGCP |
파일 가져오기 (헤더 자동 매핑, 파일명 = 그룹 기록) |
control.exportGCP |
파일 내보내기 (CSV/JSON) |
control.selectGcp |
GCP 행 선택 |
control.reloadGcp |
테이블 새로고침 |
control.listGcpGroups |
그룹(파일) 목록 + 그룹별 GCP 수 조회 |
control.setGcpGroupFilter |
그룹 필터 설정 (group 생략 시 전체 보기) |
control.getGcpGroupFilter |
현재 그룹 필터 상태 조회 |