데이터베이스: ~/PaleoBytes/Modan2/Modan2.db
이미지와 3D 모델: ~/PaleoBytes/Modan2/data/
로그 파일: ~/PaleoBytes/Modan2/logs/
백업: ~/PaleoBytes/Modan2/backups/
설정: 운영체제의 설정 폴더 — Windows는 %LOCALAPPDATA%\PaleoBytes\Modan2, macOS는 ~/Library/Application Support/PaleoBytes/Modan2, Linux는 ~/.config/PaleoBytes/Modan2. 데이터가 아니라 설정입니다.

참고: 이미지나 3D 모델을 첨부하면 Modan2가 자체 data/ 폴더로 복사하므로 원본은 원래 자리에 그대로 남습니다. 지나치게 큰 사진(긴 변이 2560 px 초과)은 더 작은 작업본으로 저장되고, 원본 해상도 파일은 그 옆에 따로 보관됩니다.

Can I keep my data somewhere else?

Yes. Open Preferences and change Data folder — useful when your 3D models outgrow the drive Modan2 was installed on. The database, images, 3D models, backups and logs all move together; they are one library, and either half is useless without the other.

Three things to know:

Your existing files are not moved. The setting tells Modan2 where to look from now on; everything already stored stays where it is until you move it yourself. Modan2 tells you this before you confirm.
It takes effect the next time you start Modan2, because the database is already open by the time you can change the setting.
Avoid folders managed by OneDrive, Dropbox or a similar service, and network drives. The database is not safe to synchronise while it is open — if you use Modan2 on two computers, the service will not merge the two copies, it will silently keep both. To get your data into the cloud, put an exported package there instead of the live folder.

So to move an existing library: quit Modan2, copy the folder to its new home, start Modan2, set Data folder to the new location, and restart. Keep the old copy until you have confirmed everything is there.

If the folder is missing when Modan2 starts — an external drive that is not plugged in, a share that is down — Modan2 says so and asks what to do rather than starting an empty library.

데이터를 백업할 수 있나요?

네! 여러 가지 백업 방법이 있습니다:

데이터 폴더 복사
- 데이터 폴더를 복사하세요 — 데이터베이스와 미디어 파일이 모두 들어 있습니다
- 되돌릴 때는 다시 제자리에 놓으면 됩니다
- 데이터베이스가 기록 중이지 않도록 Modan2를 먼저 종료하세요
데이터셋 내보내기
- JSON+ZIP 패키지로 내보내기 (모든 데이터와 파일 포함)
- TPS, Morphologika 등 다른 형식으로 내보내기
수동 백업
- 원본 이미지/모델 파일을 보관
- 랜드마크 데이터를 정기적으로 내보내기
- 분석 결과 내보내기

데이터 관리 

Modan2에서 데이터셋이란 무엇인가요?

데이터셋 은 다음을 공유하는 객체(표본)들의 모음입니다:

랜드마크 개수
차원 (2D 또는 3D)
변수 정의 (측정값, 범주)
와이어프레임/베이스라인/폴리곤 정의
분석 설정

데이터셋은 계층적 구성을 위해 상위-하위 관계 를 가질 수 있습니다.

상위-하위 데이터셋은 어떻게 동작하나요?

상위 데이터셋:

원본 랜드마크 데이터를 담습니다
기본 구조(랜드마크 개수, 차원)를 정의합니다

하위 데이터셋:

상위 아래에 중첩되는 새 빈 데이터셋입니다
객체가 복사되어 들어오지는 않으며, 직접 채워 넣습니다
자체 랜드마크 개수, 차원, 변수를 가집니다

활용 사례:

연구를 하위 그룹으로 나누어 구성
관련 데이터셋을 트리에서 함께 묶어 관리

객체와 데이터셋의 차이는 무엇인가요?

데이터셋:

여러 객체를 담는 컨테이너
구조(랜드마크 개수, 차원, 변수)를 정의
시각화와 분석 설정

객체:

개별 표본
랜드마크 좌표를 가짐
이미지나 3D 모델을 첨부할 수 있음
변수 값(측정값, 범주)을 가짐

관계: 데이터셋은 여러 객체를 포함합니다

랜드마크는 몇 개까지 쓸 수 있나요?

실용적 한계:

2D: 객체당 최대 1000개 (검증됨)
3D: 객체당 최대 1000개 (검증됨)
객체: 2,000개까지 정상 동작 확인

성능:

랜드마크 100개, 객체 1000개: 우수한 성능
메모리 사용량은 선형으로 증가 (객체당 약 4KB)
분석 시간은 랜드마크 개수와 알고리즘에 따라 달라짐

결측 랜드마크가 있어도 되나요?

네! Modan2는 결측 랜드마크를 지원합니다:

객체 대화상자에서 “결측 추가”(Add Missing) / “결측 삽입”(Insert Missing)으로 표시하거나, 좌표 셀에 MISSING 을 입력하세요(빈 셀도 결측으로 간주)
“추정값 보기”(Show Estimated)가 켜져 있으면 뷰어가 각 결측 랜드마크의 추정 위치에 빈 원을 그립니다
랜드마크를 결측으로 표시하면 데이터셋 전체에서 랜드마크 개수가 일관되게 유지되며, 이는 분석에 필요한 조건입니다

추정 방식: Modan2는 데이터셋의 평균 형상을 해당 표본이 실제로 가진 랜드마크에 맞춰 정합하고 — 회전, 크기, 위치를 맞춥니다 — 정합된 평균 형상에서 결측 위치를 읽어옵니다. 분석 중에는 정렬이 수렴하는 동안 이 과정을 반복하며(EM 방식 루프), 대치된 값은 분석용 작업 사본에서만 쓰이고 사용자 데이터에 기록되지 않습니다.

권장 사항: 결측 데이터는 전체 랜드마크의 약 10% 미만으로 유지하고, 완전한 표본을 충분히 확보하세요.

개별 점 대신 곡선을 기록할 수 있나요?

네 — 준랜드마크 곡선 을 쓰면 됩니다(현재는 2D 전용).

곡선은 데이터셋 수준에서 이름과 점 개수 N 을 지정해 한 번만 정의한 뒤, 표본마다 추적합니다. Modan2는 추적선을 길이를 따라 균등한 간격의 N 개 점으로 재표본화하며, 분석에서는 이 점들을 일반 랜드마크처럼 다루어 고정(해부학적) 랜드마크 뒤에 이어 붙입니다.

객체 대화상자의 Curve 모드에서 추적합니다
“Snap to curve”(기본 켜짐)가 클릭 사이에서 이미지의 가장 강한 경계를 따라가므로, 깔끔한 윤곽선을 점 몇 개로 얻을 수 있습니다
나중에 N 을 수정하면 저장된 추적선을 다시 재표본화하므로 다시 추적할 필요가 없습니다
곡선은 TPS(CURVES= 블록)와 JSON+ZIP 패키지를 통해 왕복 변환됩니다
고정 랜드마크 없이 준랜드마크만으로 데이터셋을 분석할 수도 있습니다

랜드마크 디지타이징 

2D 이미지에서 랜드마크는 어떻게 찍나요?

단계:

데이터셋 생성 → 차원을 2D로 설정
객체 생성 → 이미지 첨부
객체 대화상자 열기
이미지를 클릭해 랜드마크 배치
랜드마크는 순서대로 번호가 매겨집니다
오른쪽 클릭으로 마지막 랜드마크 삭제
완료되면 저장

팁:

정밀도를 위해 확대하세요 (마우스 휠)
가운데 버튼으로 드래그해 화면을 이동하세요
와이어프레임으로 랜드마크 배치를 확인하세요
필요하면 결측 랜드마크를 표시하세요

3D 모델에서 랜드마크는 어떻게 찍나요?

단계:

데이터셋 생성 → 차원을 3D로 설정
객체 생성 → 3D 모델 첨부
객체 대화상자 열기
랜드마크 위치가 보이도록 모델 회전
클릭해 랜드마크 배치
랜드마크가 구체로 표시됩니다
모든 랜드마크에 대해 반복
완료되면 저장

3D 조작:

왼쪽 버튼 드래그: 회전
가운데 버튼 드래그: 이동
오른쪽 버튼 드래그 또는 스크롤: 확대/축소

기존 랜드마크를 편집할 수 있나요?

네! 여러 가지 편집 방법이 있습니다:

시각적 편집:
- 객체 대화상자 열기
- 랜드마크를 클릭한 뒤 드래그
- 실시간으로 반영됨
표에서 편집:
- 표에서 X, Y, Z 좌표를 직접 편집
- 미세 조정을 위한 정밀 편집
일괄 편집:
- 여러 객체 선택
- 변환 적용
- 프로그램으로 랜드마크 갱신

통계 분석 

Modan2는 어떤 분석을 지원하나요?

다변량 분석:

PCA (주성분 분석): 변이의 주요 패턴을 탐색
CVA (정준변량 분석): 그룹 간 차이를 분석
MANOVA (다변량 분산 분석): 그룹 간 차이를 검정

중첩정렬 방식:

프로크루스테스: 이동, 회전, 크기 조정 (기본값)
북스틴: 베이스라인 정합. 데이터셋에 베이스라인이 필요합니다
강건적합: 이상치 랜드마크에 강한 정렬

세 방식 모두 결측 랜드마크를 먼저 대치합니다.

형상 분석:

평균 형상 계산
플롯 전반에서 형상이 어떻게 변하는지 보여 주는 형상 격자
산점도 위의 회귀선 오버레이

분석은 어떻게 실행하나요?

한 번의 실행이 PCA, CVA, MANOVA를 함께 계산합니다 — 분석 종류를 고르는 것이 아닙니다.

단계:

트리 뷰에서 데이터셋을 선택합니다
분석(Analyze, Ctrl+G)을 클릭하거나 Data 메뉴를 사용합니다
분석 제목, 중첩정렬 방식, CVA와 MANOVA의 그룹화 변수를 지정합니다
OK 를 클릭합니다
완료된 분석을 데이터 탐색(Data Exploration) 대화상자에서 엽니다

결과에 포함되는 것:

점수 플롯 (PC1 대 PC2 및 다른 축 조합)
성분별 설명 분산
선택한 그룹화 변수에 대한 CVA 및 MANOVA 결과
내보내기 옵션

프로크루스테스 중첩정렬이란 무엇인가요?

프로크루스테스 중첩정렬 은 형상과 무관한 변이를 제거합니다:

이동: 배열의 중심을 맞춤
회전: 거리가 최소가 되도록 정렬
크기 조정: 중심 크기를 표준화

목적: 다음과 무관하게 형상을 비교:

위치 (이동)
방향 (회전)
크기 (크기 조정)

결과: 프로크루스테스 좌표는 순수한 형상을 나타냅니다

분석에는 객체가 몇 개나 필요한가요?

최소 요구 조건:

PCA: 최소 3개 (더 많을수록 좋음)
CVA: 각각 3개 이상의 객체를 가진 그룹이 최소 2개
MANOVA: 각각 3개 이상의 객체를 가진 그룹이 최소 2개

권장 표본 크기:

탐색적 PCA: 최소 20~30개
그룹 비교 (CVA): 그룹당 최소 10~15개
논문 수준: 그룹당 30개 이상 권장

일반 원칙: 안정적인 결과를 위해서는 많을수록 좋습니다

파일 가져오기와 내보내기 

랜드마크 데이터는 어떻게 가져오나요?

단계:

File → Import → [형식]
파일 선택 (TPS, NTS, Morphologika 등)
대상 데이터셋을 선택하거나 새로 만들기
필요하면 변수 매핑
Import 클릭

지원 형식:

TPS (가장 일반적)
NTS
X1Y1
Morphologika
JSON+ZIP (전체 백업)

다른 소프트웨어에서 가져올 수 있나요?

네! Modan2는 표준 형식을 지원합니다:

MorphoJ에서: TPS 또는 Morphologika로 내보내기
tpsUtil/tpsDig에서: TPS 파일을 바로 사용
Landmark Editor에서: NTS로 내보내기
R 패키지에서: TPS 또는 Morphologika로 저장

형식 호환성:

TPS: 호환성이 가장 좋은 형식
Morphologika: 복잡한 데이터셋에 적합
NTS: 단순한 형식

데이터는 어떻게 내보내나요?

내보내기 옵션:

데이터셋 내보내기:
- File → Export → Dataset
- 형식 선택 (TPS, Morphologika, JSON+ZIP)
- 내보낼 객체 선택
분석 결과:
- 분석 오른쪽 클릭 → Export
- Excel 또는 CSV로 저장
- 점수, 적재량, 통계량 포함
전체 백업:
- JSON+ZIP으로 내보내기
- 모든 데이터, 이미지, 모델 포함
- 공유나 보관에 적합

JSON+ZIP 내보내기란 무엇인가요?

JSON+ZIP 은 Modan2의 종합 백업 형식입니다:

포함 내용:

랜드마크 좌표
객체 메타데이터와 변수
데이터셋 설정 (와이어프레임, 베이스라인, 폴리곤)
첨부된 이미지와 3D 모델 (선택)
분석 결과

활용 사례:

전체 데이터셋 백업
공동 연구자와 데이터 공유
컴퓨터 간 데이터 이동
장기 보관

형식: 표준 JSON + ZIP 압축

성능과 최적화 

Modan2는 큰 데이터셋을 얼마나 빠르게 처리하나요?

검증된 성능 (Phase 7 검증):

객체 1000개 로드: 277ms (목표 대비 18배 빠름)
객체 1000개 PCA: 60ms (목표 대비 33배 빠름)
메모리 사용량: 객체당 4KB (목표 대비 125배 우수)
UI 반응성: 1000행 표에서 12.63ms

확장성:

선형 O(n) 확장 확인
객체 100,000개 이상도 실사용 가능
객체 2,000개까지 검증

성능을 개선할 수 있나요?

성능을 높이는 팁:

데이터베이스 저장에 SSD 사용
트리 뷰에서 사용하지 않는 객체 닫기
3D 모델의 폴리곤 수 줄이기
일괄 편집 중에는 3D 미리보기 끄기
큰 분석은 하위 집합으로 내보내기

시스템 최적화:

충분한 RAM 확보 (8GB 이상 권장)
3D 성능을 위해 그래픽 드라이버 업데이트

분석이 너무 오래 걸리면 어떻게 하나요?

큰 데이터셋의 경우:

진행 표시줄 확인 - 아직 실행 중일 수 있습니다
객체 수 줄이기 - 먼저 하위 집합으로 분석
분석 단순화 - 변수 수 줄이기
메모리 확인 - RAM이 충분한지 확인

일반적인 분석 시간:

객체 100개: 1초 미만
객체 1000개: 1~5초
객체 2000개: 5~15초

이보다 훨씬 느리다면: 문제 해결 안내서를 확인하세요

문제 해결 

어디에서 도움을 받을 수 있나요?

참고 자료 (순서대로):

이 FAQ - 자주 묻는 질문에 대한 간단한 답
사용자 안내서 - 종합 문서
문제 해결 안내서 - 자세한 문제 해결
GitHub Issues - 기존 문제/해결책 검색

https://github.com/jikhanjung/Modan2/issues
GitHub Discussions - 질문하고 작업 방식 공유

https://github.com/jikhanjung/Modan2/discussions
이메일 문의 - jikhanjung@gmail.com

(위의 자료를 먼저 확인해 주세요)

버그는 어떻게 신고하나요?

GitHub Issues: https://github.com/jikhanjung/Modan2/issues/new

다음 정보를 포함해 주세요:

시스템 정보:
- 운영체제와 버전
- Modan2 버전과 빌드 번호 (Help → About)
문제 설명:
- 무엇을 하려고 했는지
- 실제로 어떤 일이 일어났는지
- 오류 메시지 (있는 경우)
재현 단계:
1. 데이터셋 열기…
2. 버튼 클릭…
3. 오류 발생…
로그 파일:
- ~/PaleoBytes/Modan2/logs/ 에서 가장 최근 파일을 첨부해 주세요
스크린샷 (UI 관련인 경우)

좋은 버그 신고가 빠른 수정으로 이어집니다!

Modan2가 왜 비정상 종료되나요?

흔한 원인:

데이터베이스 손상 → 백업에서 복원
메모리 부족 → 다른 애플리케이션 닫기
그래픽 드라이버 문제 → GPU 드라이버 업데이트
그래픽/OpenGL 문제 → 문제 해결 안내서 참조

디버깅 단계:

로그 파일에서 오류 메시지 확인
샘플 데이터로 시도 (문제 범위 좁히기)
터미널에서 --debug 옵션으로 실행해 오류 확인
로그 파일을 첨부해 크래시 신고

자세한 해결책은 문제 해결 안내서를 참조하세요.

3D 뷰어가 동작하지 않습니다 

흔한 문제:

OpenGL을 사용할 수 없음:
- 그래픽 드라이버 업데이트
- OpenGL 라이브러리 설치 (Linux)
- GPU 호환성 확인
모델이 로드되지 않음:
- 파일 형식 확인 (OBJ, PLY, STL)
- 파일이 손상되지 않았는지 확인
- 다른 모델로 시도
검은 화면:
- 객체에 3D 모델이 첨부되어 있는지 확인
- 축소해 보세요 — 모델이 화면 밖에 있을 수 있습니다
- 다른 모델로 시도

문제 해결 안내서 → 3D 시각화 문제 참조

고급 주제 

논문에 Modan2를 사용해도 되나요?

네! 얼마든지 사용하세요.

인용 방법:

@software{modan2_2025,
  author = {Jung, Jikhan},
  title = {Modan2: Geometric Morphometrics Analysis Software},
  year = {2025},
  publisher = {GitHub},
  url = {https://github.com/jikhanjung/Modan2},
  version = {0.1.5-beta.1}
}

본문 예시:

“Geometric morphometric analyses were performed using Modan2 v0.1.5 (Jung, 2025), an open-source desktop application for landmark-based shape analysis.”