역지사지(歷地思之) - 역사지리정보(HGIS) 위키 - 사용자 기여 [ko]

양정현

2026-06-19T11:16:50Z

Yachagye: /* 학술논문 */

==개요==
*이름 : 양정현
*소속 : 순천대학교 지리산권문화연구원 학술연구교수
*이메일 : yachagye@naver.com

== 학술논문 ==
[학위논문]
*조선 초기의 驛道 편제와 그 성격, 고려대학교 석사학위논문, 2014[https://dcollection.korea.ac.kr/srch/srchDetail/000000049241]
*조선 전기 驛道制 연구, 고려대학교 박사학위논문, 2021[https://dcollection.korea.ac.kr/srch/srchDetail/000000251662]

[학술논문]
*조선 초기 원경왕후 喪葬禮 의식과 그 특징, 역사민속학 45, 2014[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART001898736]
*조선 초기 驛道制의 정비 과정과 그 성격, 한국사연구 174, 2016[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART002155158]
*조선 『璿源錄』 중종 공주·옹주 계열 후손의 연혼 양상과 그 성격, 고문서연구 52, 2018[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART002323447]
*조선 『璿源錄』을 통해 본 성종 공주·옹주 후손의 혼인 양상과 그 성격, 고문서연구 60, 2022[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART002816615]
*『조선왕조실록』의 차(茶) 관련 정보 열람을 위한 문헌 DB 구축, 2022 한국스마트미디어학회 종합학술대회 논문집 11-1, 2022 (공저)
*공간의 연결 - 15~16세기 조선의 역제(驛制)를 통한 도로 체계의 실현 구조, 한국사연구 198, 2022[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART002886474]
*한국 역사문화 문헌 DB의 구축과 시공간적 통합 모색 - 연대기·지리지 문헌 속 전통 茶 관련 기록을 중심으로, 사총 110, 2023[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003001140]
*한국 차-연대기 문헌 DB 구축 및 웹서비스 구현, 스마트미디어저널 12-9, 2023 (공저)[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003011384]
*HGIS를 통해 본 조선 전기 양주의 도로 체계와 역사적 경로 재현 - 양주 회암사의 사례를 중심으로, 남도문화연구 50, 2023[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003041719]
*재편된 공간 - 조선시대 驛 분포 양상의 추이와 특징, 사학연구 155, 2024[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003128029]
*조선시대 도로 네트워크 분석 방법론과 사례 연구 - 양주의 사례를 중심으로, 문화역사지리 36-3, 2024[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003161965]
*'신출귀몰'의 재구성 - 역사 연구와 GIS가 연결되는 한 방식, 역사비평 153, 2025[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003271672]
*딥러닝 기반 한국 고전한문 표점 추론 자동화 모델의 구축과 활용, 역사학연구 100, 2025[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003273177]
*해석의 관습 - 한국 고전한문 전용 표점 추론 모델의 개선, 민족문화연구 111, 2026[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003345441]
*역사 GIS를 위한 목표값 근접 경로 분석 모델의 설계와 적용 - 조선시대 경기 광주의 사례를 중심으로, 조선시대사학보 117, 2026[]

==저서==
*조선 전기의 국가 의례와 의주, 민속원, 2015 (공저)
*회암사와 중세사회, 양주시립회암사지박물관, 2023 (공저)
*조선시대 서울의 유교 의례와 음악, 서울역사편찬원, 2024 (공저)
*하남 역사 총서 6, 하남역사박물관, 2024 (공저)
*K-인문 2.0 디지털 인문학의 새로운 주제들, 국립경국대학교 글로컬대학추진단, 2025 (공저)

==코드 및 데이터 공개 저장소==
*https://github.com/yachagye/korean-classical-chinese-punctuation
*https://huggingface.co/yachagye/korean-classical-chinese-punctuation
*https://github.com/yachagye/target-approximating-path-analysis

양정현

2026-06-09T09:01:45Z

Yachagye: /* 코드 및 데이터 공개 저장소 */

==개요==
*이름 : 양정현
*소속 : 순천대학교 지리산권문화연구원 학술연구교수
*이메일 : yachagye@naver.com

== 학술논문 ==
[학위논문]
*조선 초기의 驛道 편제와 그 성격, 고려대학교 석사학위논문, 2014[https://dcollection.korea.ac.kr/srch/srchDetail/000000049241]
*조선 전기 驛道制 연구, 고려대학교 박사학위논문, 2021[https://dcollection.korea.ac.kr/srch/srchDetail/000000251662]

[학술논문]
*조선 초기 원경왕후 喪葬禮 의식과 그 특징, 역사민속학 45, 2014[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART001898736]
*조선 초기 驛道制의 정비 과정과 그 성격, 한국사연구 174, 2016[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART002155158]
*조선 『璿源錄』 중종 공주·옹주 계열 후손의 연혼 양상과 그 성격, 고문서연구 52, 2018[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART002323447]
*조선 『璿源錄』을 통해 본 성종 공주·옹주 후손의 혼인 양상과 그 성격, 고문서연구 60, 2022[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART002816615]
*『조선왕조실록』의 차(茶) 관련 정보 열람을 위한 문헌 DB 구축, 2022 한국스마트미디어학회 종합학술대회 논문집 11-1, 2022 (공저)
*공간의 연결 - 15~16세기 조선의 역제(驛制)를 통한 도로 체계의 실현 구조, 한국사연구 198, 2022[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART002886474]
*한국 역사문화 문헌 DB의 구축과 시공간적 통합 모색 - 연대기·지리지 문헌 속 전통 茶 관련 기록을 중심으로, 사총 110, 2023[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003001140]
*한국 차-연대기 문헌 DB 구축 및 웹서비스 구현, 스마트미디어저널 12-9, 2023 (공저)[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003011384]
*HGIS를 통해 본 조선 전기 양주의 도로 체계와 역사적 경로 재현 - 양주 회암사의 사례를 중심으로, 남도문화연구 50, 2023[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003041719]
*재편된 공간 - 조선시대 驛 분포 양상의 추이와 특징, 사학연구 155, 2024[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003128029]
*조선시대 도로 네트워크 분석 방법론과 사례 연구 - 양주의 사례를 중심으로, 문화역사지리 36-3, 2024[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003161965]
*'신출귀몰'의 재구성 - 역사 연구와 GIS가 연결되는 한 방식, 역사비평 153, 2025[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003271672]
*딥러닝 기반 한국 고전한문 표점 추론 자동화 모델의 구축과 활용, 역사학연구 100, 2025[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003273177]
*해석의 관습 - 한국 고전한문 전용 표점 추론 모델의 개선, 민족문화연구 111, 2026[]
*역사 GIS를 위한 목표값 근접 경로 분석 모델의 설계와 적용 - 조선시대 경기 광주의 사례를 중심으로, 조선시대사학보 117, 2026[]

==저서==
*조선 전기의 국가 의례와 의주, 민속원, 2015 (공저)
*회암사와 중세사회, 양주시립회암사지박물관, 2023 (공저)
*조선시대 서울의 유교 의례와 음악, 서울역사편찬원, 2024 (공저)
*하남 역사 총서 6, 하남역사박물관, 2024 (공저)
*K-인문 2.0 디지털 인문학의 새로운 주제들, 국립경국대학교 글로컬대학추진단, 2025 (공저)

==코드 및 데이터 공개 저장소==
*https://github.com/yachagye/korean-classical-chinese-punctuation
*https://huggingface.co/yachagye/korean-classical-chinese-punctuation
*https://github.com/yachagye/target-approximating-path-analysis

경기 광주 군현도로 GIS

2026-06-09T08:54:54Z

Yachagye: /* 1626년 이후 */

[[파일:경기 광주_1626년 이전과 이후의 도로 체계 비교.png|섬네일|1626년 이전과 이후의 도로 체계 비교]]

경기 광주 군현도로 GIS는 [[조선_군현도로_GIS|조선 군현도로 GIS]] 모델을 조선시대 경기 광주(廣州)에 적용하여 산출한 GIS 데이터이다. 1626년(인조 4) 읍치(邑治) 이전 전후 두 시기의 도로 체계와 역사적 경로를 재현한다. 분석 모델·필드 설계·스크립트에 대한 설명은 상위 문서 [[조선_군현도로_GIS|조선 군현도로 GIS]]를 참조한다.

== 구축자 ==
* DB 설계·구축 : 양정현
* 데이터 검수 : 양정현

== 공간 데이터 ==
본 군현의 공간 데이터는 분석에 입력한 데이터(기반 네트워크·보조 레이어)와, 이 입력에 목표값 근접 경로 분석을 수행하여 산출한 결과물(경로 레이어)로 구성된다. [[조선_군현도로_GIS#분석 스크립트|GitHub에 공개된 스크립트]]로 동일한 입력을 다시 분석하면 결과물을 그대로 재현할 수 있다.

=== 기반 네트워크 데이터셋 ===
* 도로_1914_광주_nd.gpkg : 경기 광주 일대의 도로 네트워크 데이터셋. 1:5만 지형도에서 소로까지 디지타이징한 도로 라인에 비용 필드를 부여한 것이다.
** 다운로드:[[미디어:도로 1914 경기 광주 nd.zip|【네트워크 데이터셋】]](2026년06월)
* graph_cache.pkl : 위 네트워크 데이터셋을 NetworkX DiGraph로 변환하고 degree-2 체인 축약을 적용한 그래프 캐시. 경로 분석 및 경로 간 유사도 분석의 직접 입력으로 사용한다.
** 다운로드:[[미디어:도로 1914 경기 광주 pkl.zip|【그래프 캐시】]](2026년06월)

=== 분석 보조 레이어 ===
* 장애물.gpkg : 군현 영역 제한(경계 밖 이동 차단) 등에 사용하는 장애물 레이어. 장애물과 교차하는 간선을 그래프에서 제거하여 경로 탐색에서 배제한다.
* 전1626_폴리곤.gpkg / 후1626_폴리곤.gpkg : 1626년 읍치 이전 '이전'·'이후' 시기의 읍치 사방경계 폴리곤. 포인트-폴리곤 분석의 목적 폴리곤으로 사용한다. 본 페이지에서 제공하는 것은 광주 분석을 위해 편집한 편집본이며, 원본 경계 데이터는 [[조선_행정구역_DB|조선 행정구역 DB]]를 참조한다.
** 다운로드: [[미디어:경기 광주 보조 레이어.zip|【보조 레이어】]](2026년06월)

=== 경로 분석 결과 레이어 ===
아래 레이어들은 위 입력 데이터에 목표값 근접 경로 분석을 수행하여 산출한 재현 결과물이다. 1626년 읍치 이전을 기준으로 '이전'과 '이후' 두 시기로 구분하여 폴더로 제공한다. 레이어 명명 규칙은 다음과 같다.

{| class="wikitable"
! 명칭 요소 !! 의미
|-
| 경로_point_point || 포인트-포인트 분석. 기점·종점이 모두 점으로 지정된 경로.
|-
| 경로_point_polygon || 포인트-폴리곤 분석. 출발점에서 읍치 사방경계(폴리곤)에 도달하는 경로.
|-
| _순위 || 순위 분석. 목표값 근접도 상위 N개 경로를 단일 레이어로 산출.
|-
| _제한 || 장애물(군현 영역 제한)을 적용한 분석.
|-
| _편차범위 || 목표값 ±margin(거리 ±2.25 km = 5리) 범위 내 후보만 산출.
|-
| 최종 재현 경로 || 위 분석 결과를 종합하여 확정한 대표 재현 경로.
|}

각 레이어는 목표값 근접 경로(route_target)와 임피던스별 최소 비용 경로(route_min_km, route_min_hr_ks, route_min_hr_tob, route_min_kcal_ks, route_min_kcal_tob)를 포함한다(순위·편차범위 레이어는 route_target 단일 레이어).

'''1626년 이전''' :[[미디어:경기 광주 1626년 이전.zip|【다운로드】]](2026년06월)
* 경로_point_point.gpkg
* 경로_point_point_순위.gpkg
* 경로_point_point_제한.gpkg
* 경로_point_polygon.gpkg
* 경로_point_polygon_순위.gpkg
* 경로_point_polygon_제한.gpkg
* 경로_point_polygon_편차범위.gpkg
* 최종 재현 경로.gpkg

'''1626년 이후''' :[[미디어:경기 광주 1626년 이후.zip|【다운로드】]](2026년06월)
* 경로_point_point.gpkg
* 경로_point_point_순위.gpkg
* 경로_point_point_제한.gpkg
* 경로_point_point_편차범위.gpkg
* 경로_point_polygon.gpkg
* 경로_point_polygon_순위.gpkg
* 경로_point_polygon_제한.gpkg
* 경로_point_polygon_편차범위.gpkg
* 최종 재현 경로.gpkg

== 사례: 1626년 읍치 이전 ==
조선 초기 광주 읍치는 현 경기도 하남시 교산동에 있었으나, 1626년(인조 4) 남한산성(현 광주시 남한산성면 산성리)으로 이전하였다. 읍치의 위치 변화는 군현 도로망의 중심 노드를 재편하므로, 동일 군현 내에서 읍치 이전 전후의 도로 체계와 이동 경로를 비교할 수 있는 사례가 된다. 1846년 간행된 중정남한지(重訂南漢志) 강역조에는 1626년 이전과 이후의 사방경계 구성 변화가 모두 수록되어 있다. 본 데이터는 이전 전후 두 시기에 대해 각각 경로 분석을 수행하고 결과를 구분하여 제공한다.

=== 1626년 이전 ===
신증동국여지승람(新增東國輿地勝覽) 단계의 거리·방향 기록을 목표값으로 하여, 한성을 포함한 인접 9개 군현 경계로 가는 9개 경로를 재현한다.

=== 1626년 이후 ===
해동지도(海東地圖)·여지도서(輿地圖書)·중정남한지(重訂南漢志) 등의 거리·방향 기록을 목표값으로 하여 24개 경로를 재현한다. 예를 들어 도로 관련 기록이 "읍치에서 ○○군현 경계까지 ○○리"와 같이 도착 지점이 경계를 가리키는 경우는 지점-경계 분석으로, 출발 지점과 도착 종점이 흥인지문, 양재역과 같은 특정 지점으로 비정되는 경로는 지점 간 분석으로 수행한다.

== 자료 공개 ==
라이선스 및 이용 조건은 [[조선_군현도로_GIS#자료 공개|조선 군현도로 GIS]]의 자료 공개 항목을 따른다.
* 인용 표기 : 조선 군현도로 GIS(경기 광주), 202X년 X월 기준, 양정현, 역지사지(https://www.hisgeo.info).

== 참고 문헌 ==
* 양정현, 2026, 역사 GIS를 위한 목표값 근접 경로 분석 모델의 설계와 적용 - 조선시대 경기 광주의 사례를 중심으로, 조선시대사학보 117.

== 변화 이력 ==
* 2026년 6월 9일 : 최초 공개.

[[분류:조선 군현도로 GIS 경기]]

경기 광주 군현도로 GIS

2026-06-09T08:52:01Z

Yachagye:

[[파일:경기 광주_1626년 이전과 이후의 도로 체계 비교.png|섬네일|1626년 이전과 이후의 도로 체계 비교]]

경기 광주 군현도로 GIS는 [[조선_군현도로_GIS|조선 군현도로 GIS]] 모델을 조선시대 경기 광주(廣州)에 적용하여 산출한 GIS 데이터이다. 1626년(인조 4) 읍치(邑治) 이전 전후 두 시기의 도로 체계와 역사적 경로를 재현한다. 분석 모델·필드 설계·스크립트에 대한 설명은 상위 문서 [[조선_군현도로_GIS|조선 군현도로 GIS]]를 참조한다.

== 구축자 ==
* DB 설계·구축 : 양정현
* 데이터 검수 : 양정현

== 공간 데이터 ==
본 군현의 공간 데이터는 분석에 입력한 데이터(기반 네트워크·보조 레이어)와, 이 입력에 목표값 근접 경로 분석을 수행하여 산출한 결과물(경로 레이어)로 구성된다. [[조선_군현도로_GIS#분석 스크립트|GitHub에 공개된 스크립트]]로 동일한 입력을 다시 분석하면 결과물을 그대로 재현할 수 있다.

=== 기반 네트워크 데이터셋 ===
* 도로_1914_광주_nd.gpkg : 경기 광주 일대의 도로 네트워크 데이터셋. 1:5만 지형도에서 소로까지 디지타이징한 도로 라인에 비용 필드를 부여한 것이다.
** 다운로드:[[미디어:도로 1914 경기 광주 nd.zip|【네트워크 데이터셋】]](2026년06월)
* graph_cache.pkl : 위 네트워크 데이터셋을 NetworkX DiGraph로 변환하고 degree-2 체인 축약을 적용한 그래프 캐시. 경로 분석 및 경로 간 유사도 분석의 직접 입력으로 사용한다.
** 다운로드:[[미디어:도로 1914 경기 광주 pkl.zip|【그래프 캐시】]](2026년06월)

=== 분석 보조 레이어 ===
* 장애물.gpkg : 군현 영역 제한(경계 밖 이동 차단) 등에 사용하는 장애물 레이어. 장애물과 교차하는 간선을 그래프에서 제거하여 경로 탐색에서 배제한다.
* 전1626_폴리곤.gpkg / 후1626_폴리곤.gpkg : 1626년 읍치 이전 '이전'·'이후' 시기의 읍치 사방경계 폴리곤. 포인트-폴리곤 분석의 목적 폴리곤으로 사용한다. 본 페이지에서 제공하는 것은 광주 분석을 위해 편집한 편집본이며, 원본 경계 데이터는 [[조선_행정구역_DB|조선 행정구역 DB]]를 참조한다.
** 다운로드: [[미디어:경기 광주 보조 레이어.zip|【보조 레이어】]](2026년06월)

=== 경로 분석 결과 레이어 ===
아래 레이어들은 위 입력 데이터에 목표값 근접 경로 분석을 수행하여 산출한 재현 결과물이다. 1626년 읍치 이전을 기준으로 '이전'과 '이후' 두 시기로 구분하여 폴더로 제공한다. 레이어 명명 규칙은 다음과 같다.

{| class="wikitable"
! 명칭 요소 !! 의미
|-
| 경로_point_point || 포인트-포인트 분석. 기점·종점이 모두 점으로 지정된 경로.
|-
| 경로_point_polygon || 포인트-폴리곤 분석. 출발점에서 읍치 사방경계(폴리곤)에 도달하는 경로.
|-
| _순위 || 순위 분석. 목표값 근접도 상위 N개 경로를 단일 레이어로 산출.
|-
| _제한 || 장애물(군현 영역 제한)을 적용한 분석.
|-
| _편차범위 || 목표값 ±margin(거리 ±2.25 km = 5리) 범위 내 후보만 산출.
|-
| 최종 재현 경로 || 위 분석 결과를 종합하여 확정한 대표 재현 경로.
|}

각 레이어는 목표값 근접 경로(route_target)와 임피던스별 최소 비용 경로(route_min_km, route_min_hr_ks, route_min_hr_tob, route_min_kcal_ks, route_min_kcal_tob)를 포함한다(순위·편차범위 레이어는 route_target 단일 레이어).

'''1626년 이전''' :[[미디어:경기 광주 1626년 이전.zip|【다운로드】]](2026년06월)
* 경로_point_point.gpkg
* 경로_point_point_순위.gpkg
* 경로_point_point_제한.gpkg
* 경로_point_polygon.gpkg
* 경로_point_polygon_순위.gpkg
* 경로_point_polygon_제한.gpkg
* 경로_point_polygon_편차범위.gpkg
* 최종 재현 경로.gpkg

'''1626년 이후''' :[[미디어:경기 광주 1626년 이후.zip|【다운로드】]](2026년06월)
* 경로_point_point.gpkg
* 경로_point_point_순위.gpkg
* 경로_point_point_제한.gpkg
* 경로_point_point_편차범위.gpkg
* 경로_point_polygon.gpkg
* 경로_point_polygon_순위.gpkg
* 경로_point_polygon_제한.gpkg
* 경로_point_polygon_편차범위.gpkg
* 최종 재현 경로.gpkg

== 사례: 1626년 읍치 이전 ==
조선 초기 광주 읍치는 현 경기도 하남시 교산동에 있었으나, 1626년(인조 4) 남한산성(현 광주시 남한산성면 산성리)으로 이전하였다. 읍치의 위치 변화는 군현 도로망의 중심 노드를 재편하므로, 동일 군현 내에서 읍치 이전 전후의 도로 체계와 이동 경로를 비교할 수 있는 사례가 된다. 1846년 간행된 중정남한지(重訂南漢志) 강역조에는 1626년 이전과 이후의 사방경계 구성 변화가 모두 수록되어 있다. 본 데이터는 이전 전후 두 시기에 대해 각각 경로 분석을 수행하고 결과를 구분하여 제공한다.

=== 1626년 이전 ===
신증동국여지승람(新增東國輿地勝覽) 단계의 거리·방향 기록을 목표값으로 하여, 한성을 포함한 인접 9개 군현 경계로 가는 9개 경로를 재현한다.

=== 1626년 이후 ===
해동지도(海東地圖)·여지도서(輿地圖書) 등의 거리·방향 기록을 목표값으로 하여 24개 경로를 재현한다. 예를 들어 도로 관련 기록이 "읍치에서 ○○군현 경계까지 ○○리"와 같이 도착 지점이 경계를 가리키는 경우는 지점-경계 분석으로, 출발 지점과 도착 종점이 흥인지문, 양재역과 같은 특정 지점으로 비정되는 경로는 지점 간 분석으로 수행한다.

== 자료 공개 ==
라이선스 및 이용 조건은 [[조선_군현도로_GIS#자료 공개|조선 군현도로 GIS]]의 자료 공개 항목을 따른다.
* 인용 표기 : 조선 군현도로 GIS(경기 광주), 202X년 X월 기준, 양정현, 역지사지(https://www.hisgeo.info).

== 참고 문헌 ==
* 양정현, 2026, 역사 GIS를 위한 목표값 근접 경로 분석 모델의 설계와 적용 - 조선시대 경기 광주의 사례를 중심으로, 조선시대사학보 117.

== 변화 이력 ==
* 2026년 6월 9일 : 최초 공개.

[[분류:조선 군현도로 GIS 경기]]

파일:경기 광주 1626년 이전과 이후의 도로 체계 비교.png

2026-06-09T08:48:55Z

Yachagye:

경기 광주 군현도로 GIS

2026-06-09T08:45:16Z

Yachagye: /* 기반 네트워크 데이터셋 (입력) */

경기 광주 군현도로 GIS는 [[조선_군현도로_GIS|조선 군현도로 GIS]] 모델을 조선시대 경기 광주(廣州)에 적용하여 산출한 GIS 데이터이다. 1626년(인조 4) 읍치(邑治) 이전 전후 두 시기의 도로 체계와 역사적 경로를 재현한다. 분석 모델·필드 설계·스크립트에 대한 설명은 상위 문서 [[조선_군현도로_GIS|조선 군현도로 GIS]]를 참조한다.

== 구축자 ==
* DB 설계·구축 : 양정현
* 데이터 검수 : 양정현

== 공간 데이터 ==
본 군현의 공간 데이터는 분석에 입력한 데이터(기반 네트워크·보조 레이어)와, 이 입력에 목표값 근접 경로 분석을 수행하여 산출한 결과물(경로 레이어)로 구성된다. [[조선_군현도로_GIS#분석 스크립트|GitHub에 공개된 스크립트]]로 동일한 입력을 다시 분석하면 결과물을 그대로 재현할 수 있다.

=== 기반 네트워크 데이터셋 ===
* 도로_1914_광주_nd.gpkg : 경기 광주 일대의 도로 네트워크 데이터셋. 1:5만 지형도에서 소로까지 디지타이징한 도로 라인에 비용 필드를 부여한 것이다.
** 다운로드:[[미디어:도로 1914 경기 광주 nd.zip|【네트워크 데이터셋】]](2026년06월)
* graph_cache.pkl : 위 네트워크 데이터셋을 NetworkX DiGraph로 변환하고 degree-2 체인 축약을 적용한 그래프 캐시. 경로 분석 및 경로 간 유사도 분석의 직접 입력으로 사용한다.
** 다운로드:[[미디어:도로 1914 경기 광주 pkl.zip|【그래프 캐시】]](2026년06월)

=== 분석 보조 레이어 ===
* 장애물.gpkg : 군현 영역 제한(경계 밖 이동 차단) 등에 사용하는 장애물 레이어. 장애물과 교차하는 간선을 그래프에서 제거하여 경로 탐색에서 배제한다.
* 전1626_폴리곤.gpkg / 후1626_폴리곤.gpkg : 1626년 읍치 이전 '이전'·'이후' 시기의 읍치 사방경계 폴리곤. 포인트-폴리곤 분석의 목적 폴리곤으로 사용한다. 본 페이지에서 제공하는 것은 광주 분석을 위해 편집한 편집본이며, 원본 경계 데이터는 [[조선_행정구역_DB|조선 행정구역 DB]]를 참조한다.
** 다운로드: [[미디어:경기 광주 보조 레이어.zip|【보조 레이어】]](2026년06월)

=== 경로 분석 결과 레이어 ===
아래 레이어들은 위 입력 데이터에 목표값 근접 경로 분석을 수행하여 산출한 재현 결과물이다. 1626년 읍치 이전을 기준으로 '이전'과 '이후' 두 시기로 구분하여 폴더로 제공한다. 레이어 명명 규칙은 다음과 같다.

{| class="wikitable"
! 명칭 요소 !! 의미
|-
| 경로_point_point || 포인트-포인트 분석. 기점·종점이 모두 점으로 지정된 경로.
|-
| 경로_point_polygon || 포인트-폴리곤 분석. 출발점에서 읍치 사방경계(폴리곤)에 도달하는 경로.
|-
| _순위 || 순위 분석. 목표값 근접도 상위 N개 경로를 단일 레이어로 산출.
|-
| _제한 || 장애물(군현 영역 제한)을 적용한 분석.
|-
| _편차범위 || 목표값 ±margin(거리 ±2.25 km = 5리) 범위 내 후보만 산출.
|-
| 최종 재현 경로 || 위 분석 결과를 종합하여 확정한 대표 재현 경로.
|}

각 레이어는 목표값 근접 경로(route_target)와 임피던스별 최소 비용 경로(route_min_km, route_min_hr_ks, route_min_hr_tob, route_min_kcal_ks, route_min_kcal_tob)를 포함한다(순위·편차범위 레이어는 route_target 단일 레이어).

'''1626년 이전''' :[[미디어:경기 광주 1626년 이전.zip|【다운로드】]](2026년06월)
* 경로_point_point.gpkg
* 경로_point_point_순위.gpkg
* 경로_point_point_제한.gpkg
* 경로_point_polygon.gpkg
* 경로_point_polygon_순위.gpkg
* 경로_point_polygon_제한.gpkg
* 경로_point_polygon_편차범위.gpkg
* 최종 재현 경로.gpkg

'''1626년 이후''' :[[미디어:경기 광주 1626년 이후.zip|【다운로드】]](2026년06월)
* 경로_point_point.gpkg
* 경로_point_point_순위.gpkg
* 경로_point_point_제한.gpkg
* 경로_point_point_편차범위.gpkg
* 경로_point_polygon.gpkg
* 경로_point_polygon_순위.gpkg
* 경로_point_polygon_제한.gpkg
* 경로_point_polygon_편차범위.gpkg
* 최종 재현 경로.gpkg

== 사례: 1626년 읍치 이전 ==
조선 초기 광주 읍치는 현 경기도 하남시 교산동에 있었으나, 1626년(인조 4) 남한산성(현 광주시 남한산성면 산성리)으로 이전하였다. 읍치의 위치 변화는 군현 도로망의 중심 노드를 재편하므로, 동일 군현 내에서 읍치 이전 전후의 도로 체계와 이동 경로를 비교할 수 있는 사례가 된다. 1846년 간행된 중정남한지(重訂南漢志) 강역조에는 1626년 이전과 이후의 사방경계 구성 변화가 모두 수록되어 있다. 본 데이터는 이전 전후 두 시기에 대해 각각 경로 분석을 수행하고 결과를 구분하여 제공한다.

=== 1626년 이전 ===
신증동국여지승람(新增東國輿地勝覽) 단계의 거리·방향 기록을 목표값으로 하여, 한성을 포함한 인접 9개 군현 경계로 가는 9개 경로를 재현한다.

=== 1626년 이후 ===
해동지도(海東地圖)·여지도서(輿地圖書) 등의 거리·방향 기록을 목표값으로 하여 24개 경로를 재현한다. 예를 들어 도로 관련 기록이 "읍치에서 ○○군현 경계까지 ○○리"와 같이 도착 지점이 경계를 가리키는 경우는 지점-경계 분석으로, 출발 지점과 도착 종점이 흥인지문, 양재역과 같은 특정 지점으로 비정되는 경로는 지점 간 분석으로 수행한다.

== 자료 공개 ==
라이선스 및 이용 조건은 [[조선_군현도로_GIS#자료 공개|조선 군현도로 GIS]]의 자료 공개 항목을 따른다.
* 인용 표기 : 조선 군현도로 GIS(경기 광주), 202X년 X월 기준, 양정현, 역지사지(https://www.hisgeo.info).

== 참고 문헌 ==
* 양정현, 2026, 역사 GIS를 위한 목표값 근접 경로 분석 모델의 설계와 적용 - 조선시대 경기 광주의 사례를 중심으로, 조선시대사학보 117.

== 변화 이력 ==
* 2026년 6월 9일 : 최초 공개.

[[분류:조선 군현도로 GIS 경기]]

파일:도로 1914 경기 광주 pkl.zip

2026-06-09T08:43:17Z

Yachagye:

경기 광주 군현도로 GIS

2026-06-09T08:43:00Z

Yachagye: /* 기반 네트워크 데이터셋 (입력) */

경기 광주 군현도로 GIS는 [[조선_군현도로_GIS|조선 군현도로 GIS]] 모델을 조선시대 경기 광주(廣州)에 적용하여 산출한 GIS 데이터이다. 1626년(인조 4) 읍치(邑治) 이전 전후 두 시기의 도로 체계와 역사적 경로를 재현한다. 분석 모델·필드 설계·스크립트에 대한 설명은 상위 문서 [[조선_군현도로_GIS|조선 군현도로 GIS]]를 참조한다.

== 구축자 ==
* DB 설계·구축 : 양정현
* 데이터 검수 : 양정현

== 공간 데이터 ==
본 군현의 공간 데이터는 분석에 입력한 데이터(기반 네트워크·보조 레이어)와, 이 입력에 목표값 근접 경로 분석을 수행하여 산출한 결과물(경로 레이어)로 구성된다. [[조선_군현도로_GIS#분석 스크립트|GitHub에 공개된 스크립트]]로 동일한 입력을 다시 분석하면 결과물을 그대로 재현할 수 있다.

=== 기반 네트워크 데이터셋 (입력) ===
* 도로_1914_광주_nd.gpkg : 경기 광주 일대의 도로 네트워크 데이터셋. 1:5만 지형도에서 소로까지 디지타이징한 도로 라인에 비용 필드를 부여한 것이다.
** 다운로드:[[Media:도로_1914_경기_광주_nd.zip|【네트워크 데이터셋】]](2026년06월)
* graph_cache.pkl : 위 네트워크 데이터셋을 NetworkX DiGraph로 변환하고 degree-2 체인 축약을 적용한 그래프 캐시. 경로 분석 및 경로 간 유사도 분석의 직접 입력으로 사용한다.
** 다운로드:[[Media:도로_1914_경기_광주_pkl.zip|【그래프 캐시】]](2026년06월)

=== 분석 보조 레이어 (입력) ===
* 장애물.gpkg : 군현 영역 제한(경계 밖 이동 차단) 등에 사용하는 장애물 레이어. 장애물과 교차하는 간선을 그래프에서 제거하여 경로 탐색에서 배제한다.
* 전1626_폴리곤.gpkg / 후1626_폴리곤.gpkg : 1626년 읍치 이전 '이전'·'이후' 시기의 읍치 사방경계 폴리곤. 포인트-폴리곤 분석의 목적 폴리곤으로 사용한다. 본 페이지에서 제공하는 것은 광주 분석을 위해 편집한 편집본이며, 원본 경계 데이터는 [[조선_행정구역_DB|조선 행정구역 DB]]를 참조한다.
** 다운로드: [[Media:경기_광주_보조 레이어.zip|【보조 레이어】]](2026년06월)

=== 경로 분석 결과 레이어 (재현 결과물) ===
아래 레이어들은 위 입력 데이터에 목표값 근접 경로 분석을 수행하여 산출한 재현 결과물이다. 1626년 읍치 이전을 기준으로 '이전'과 '이후' 두 시기로 구분하여 폴더로 제공한다. 레이어 명명 규칙은 다음과 같다.

{| class="wikitable"
! 명칭 요소 !! 의미
|-
| 경로_point_point || 포인트-포인트 분석. 기점·종점이 모두 점으로 지정된 경로.
|-
| 경로_point_polygon || 포인트-폴리곤 분석. 출발점에서 읍치 사방경계(폴리곤)에 도달하는 경로.
|-
| _순위 || 순위 분석. 목표값 근접도 상위 N개 경로를 단일 레이어로 산출.
|-
| _제한 || 장애물(군현 영역 제한)을 적용한 분석.
|-
| _편차범위 || 목표값 ±margin(거리 ±2.25 km = 5리) 범위 내 후보만 산출.
|-
| 최종 재현 경로 || 위 분석 결과를 종합하여 확정한 대표 재현 경로.
|}

각 레이어는 목표값 근접 경로(route_target)와 임피던스별 최소 비용 경로(route_min_km, route_min_hr_ks, route_min_hr_tob, route_min_kcal_ks, route_min_kcal_tob)를 포함한다(순위·편차범위 레이어는 route_target 단일 레이어).

'''1626년 이전''' :[[Media:경기_광주_1626년 이전.zip|【다운로드】]](2026년06월)
* 경로_point_point.gpkg
* 경로_point_point_순위.gpkg
* 경로_point_point_제한.gpkg
* 경로_point_polygon.gpkg
* 경로_point_polygon_순위.gpkg
* 경로_point_polygon_제한.gpkg
* 경로_point_polygon_편차범위.gpkg
* 최종 재현 경로.gpkg

'''1626년 이후''' :[[Media:경기_광주_1626년 이후.zip|【다운로드】]](2026년06월)
* 경로_point_point.gpkg
* 경로_point_point_순위.gpkg
* 경로_point_point_제한.gpkg
* 경로_point_point_편차범위.gpkg
* 경로_point_polygon.gpkg
* 경로_point_polygon_순위.gpkg
* 경로_point_polygon_제한.gpkg
* 경로_point_polygon_편차범위.gpkg
* 최종 재현 경로.gpkg

== 사례: 1626년 읍치 이전 ==
조선 초기 광주 읍치는 현 경기도 하남시 교산동에 있었으나, 1626년(인조 4) 남한산성(현 광주시 남한산성면 산성리)으로 이전하였다. 읍치의 위치 변화는 군현 도로망의 중심 노드를 재편하므로, 동일 군현 내에서 읍치 이전 전후의 도로 체계와 이동 경로를 비교할 수 있는 사례가 된다. 1846년 간행된 중정남한지(重訂南漢志) 강역조에는 1626년 이전과 이후의 사방경계 구성 변화가 모두 수록되어 있다. 본 데이터는 이전 전후 두 시기에 대해 각각 경로 분석을 수행하고 결과를 구분하여 제공한다.

=== 1626년 이전 ===
신증동국여지승람(新增東國輿地勝覽) 단계의 거리·방향 기록을 목표값으로 하여, 한성을 포함한 인접 9개 군현 경계로 가는 9개 경로를 재현한다.

=== 1626년 이후 ===
해동지도(海東地圖)·여지도서(輿地圖書) 등의 거리·방향 기록을 목표값으로 하여 24개 경로를 재현한다. 예를 들어 도로 관련 기록이 "읍치에서 ○○군현 경계까지 ○○리"와 같이 도착 지점이 경계를 가리키는 경우는 지점-경계 분석으로, 출발 지점과 도착 종점이 흥인지문, 양재역과 같은 특정 지점으로 비정되는 경로는 지점 간 분석으로 수행한다.

== 자료 공개 ==
라이선스 및 이용 조건은 [[조선_군현도로_GIS#자료 공개|조선 군현도로 GIS]]의 자료 공개 항목을 따른다.
* 인용 표기 : 조선 군현도로 GIS(경기 광주), 202X년 X월 기준, 양정현, 역지사지(https://www.hisgeo.info).

== 참고 문헌 ==
* 양정현, 2026, 역사 GIS를 위한 목표값 근접 경로 분석 모델의 설계와 적용 - 조선시대 경기 광주의 사례를 중심으로, 조선시대사학보 117.

== 변화 이력 ==
* 2026년 6월 9일 : 최초 공개.

[[분류:조선 군현도로 GIS 경기]]

조선 군현도로 GIS

2026-06-09T08:38:40Z

Yachagye: /* 참고 문헌 */

조선 군현도로 GIS는 1910년대 한반도 1:5만 지형도(3차지형도)에서 직접 디지타이징한 군현 단위 도로 네트워크를 기반으로, 사료에 기록된 거리 정보에 부합하는 조선시대 역사적 경로를 재현·복원하는 GIS 데이터 시리즈이다. 도로 네트워크에 NetworkX 기반 '목표값 근접 경로 분석' 모델을 적용하여 산출한 결과물을 군현 단위로 배포한다. 분석 스크립트는 GitHub 저장소에, GIS 데이터는 본 위키에 함께 공개되어, 상용 GIS 소프트웨어 없이 Python 오픈소스 환경만으로 분석을 그대로 재현할 수 있다. 군현별 데이터와 사례는 하위 문서에서 다룬다.

== DB 설명 ==
* 1910년대 한반도 1:5만 지형도(3차지형도)의 도로 정보를 직접 디지타이징하여 구축한 군현 단위 도로 네트워크를 기반으로, 조선시대 개별 군현의 도로 체계와 역사적 이동 경로를 재현하기 위해 산출한 분석 결과 데이터이다.
* 도로 데이터의 범위는 3차지형도의 1·2등 도로, 달로, 간로, 연로 및 소로까지 포함하여, 군현 내부의 세부 이동 경로를 재현할 수 있도록 구성하였다.
* 도로 라인에는 Tobler(1993)·Kondo–Seino(2010) 보행 속도 함수와 ACSM 에너지 소비 공식을 적용하여, 세그먼트마다 표면거리·보행시간·보행 중 에너지 소비량의 방향 비대칭 비용을 부여하였다.
* 활용 모델은 경로 분석의 목적함수를 '비용 최소화(min f)'에서 '목표값 근접(min|f − T|)'으로 전환한 모델이다. 이는 조선시대 사료에 기재된 거리(예: "○○까지 ○○리")에 부합하는 경로를 직접 탐색하기 위한 것으로, 최단·최소 비용 경로만으로는 포착되지 않는 역사적 경로를 복원하는 데 목적이 있다.
* 분석 그래프는 NetworkX 방향 그래프(DiGraph)로 변환되며, 좌표계는 EPSG:5179, degree-2 체인 축약을 적용한다.

== 구축 군현 ==
{| class="wikitable"
! 도 !! 군현 !! 시기 구분 !! 문서
|-
| 경기 || 광주(廣州) || 1626년 읍치 이동 전후 || [[경기_광주_군현도로_GIS|경기 광주 군현도로 GIS]]
|}

이후 군현을 추가할 때마다 위 표에 행을 추가하고, 해당 군현 문서에 분류:(도명)을 부여한다.

== 활용 모델: 목표값 근접 경로 분석 ==
모델의 구체적인 작동 방식과 실행 절차(그래프 변환, 입력 형식, 단계별 파라미터, 분석 파이프라인 등)는 [https://github.com/yachagye/target-approximating-path-analysis GitHub 저장소]의 스크립트 운영 지침에 상세히 정리되어 있다. 아래에서는 배포 데이터를 이해하는 데 필요한 개요만 기술한다.

=== 개요 ===
도로 네트워크를 방향 그래프로 변환한 뒤, 사료에 기록된 거리·시간 정보를 목표값(T)으로 설정하여 그에 가장 가까운 경로를 탐색하는 분석 모델이다. 일반적인 최단·최소 비용 경로 분석이 목적함수를 비용 최소화(min f)로 두는 데 비해, 본 모델은 목적함수를 목표값 근접(min|f − T|)으로 전환한다.

비용 속성은 표면거리(length_3dkm), 보행시간(Kondo–Seino, Tobler), 에너지 소비량(Kondo–Seino, Tobler)의 5종 임피던스를 사용하며, 정방향·역방향을 구분한 방향 비대칭 비용을 반영한다.

=== 분석 그래프 구축 ===
* GeoPackage 도로 라인을 NetworkX 방향 그래프(DiGraph)로 변환한다. 좌표계는 EPSG:5179.
* degree-2 체인 축약(contract_degree2)을 적용하여, 분기점이 아닌 중간 노드를 제거하고 인접 간선을 병합한다. 비용은 합산, geometry는 연결되며, 축약 전후의 경로 비용은 수학적으로 동일하다.
* 축약 간선에는 원본 노드 순서열(chain_nodes)과 구간별 비용(chain_costs)을 저장하여, 좌표 스냅 시 정확한 선형 보간과 분할이 가능하도록 한다.
* 입력 좌표(EPSG:4326)는 최근접 간선에 투영하여 그래프에 스냅하며, 분석 완료 후 임시 노드를 복원하여 동일 그래프를 여러 분석에 재사용한다.

=== 분석 유형 ===
* '''포인트-포인트 분석''' : 기점·종점(및 경유지)이 모두 점으로 지정된 경로를 산출한다. 각 임피던스별 최소 비용 경로와 목표값 근접 경로를 함께 출력한다.
* '''포인트-폴리곤 분석''' : 출발점에서 목적 폴리곤(읍치 사방경계 등)에 도달하는 경로를 산출한다. 폴리곤 경계와 교차하는 간선의 진입 지점을 목적지 후보 노드로 설정하고, 그중 목표값에 근접하는 경로를 선택한다. 읍치의 사방경계 기록("동으로 ○○ 경계까지 ○○리")을 반영하기 위한 분석이다.

=== 입력 형식 ===
* '''지점 간 분석''' : 경로별 기점·경유지·종점 좌표와 목표값을 CSV로 입력한다. 좌표는 경위도(EPSG:4326)이며, 첫 좌표쌍이 기점, 마지막 좌표쌍이 종점, 중간 좌표쌍은 경유지이다. 목표값은 마지막 두 컬럼(거리는 km_beg·km_end, 시간은 hr_beg·hr_end)에 입력하며, 끝값을 비우면 단일 목표값으로, 두 값을 모두 채우면 목표 구간으로 처리된다.
* '''지점-경계 분석''' : 출발점 목록 CSV와 목적지 군현 경계 폴리곤 GPKG를 입력하며, 양자는 route_id로 매칭된다. 종점은 CSV에 정의하지 않고 폴리곤 경계 노드 탐색으로 결정된다.
* '''장애물(선택)''' : 선(Line) 또는 면(Polygon) 형식의 GPKG를 입력하면, 해당 영역과 교차하는 간선을 제거한 사본 그래프가 생성되어 특정 구간을 경로 탐색에서 배제한다.

=== 분석 파이프라인 ===
전체 파이프라인은 그래프 변환, 경로 분석, 후속 분석의 3단계로 운영된다. 각 단계의 입력·출력은 다음과 같다.

{| class="wikitable"
! 단계 !! 기능 !! 입력 !! 출력
|-
| 1 || 네트워크 그래프 변환 || 네트워크 GPKG || 그래프 캐시(pkl)
|-
| 2 || 기본 경로 분석(지점 간 / 지점-경계) || pkl + CSV + (장애물) || 경로 GPKG (6 레이어)
|-
| 2 || 순위 분석 || 〃 || 순위 GPKG (1 레이어)
|-
| 2 || 편차범위 분석 || 〃 || 편차범위 GPKG (1 레이어)
|-
| 3 || 경로 간 유사도 분석 || pkl + 경로 GPKG || 유사도 CSV
|-
| 3 || 순위·편차범위 경로 유사도 || pkl + 순위/편차범위 GPKG || 유사도 CSV + 필터 GPKG
|-
| 3 || 레이어 간 경로 구성 비교 || pkl + 타겟·비교 GPKG || 요약 CSV + 매칭 CSV
|}

1단계에서 네트워크 데이터셋을 방향 그래프 캐시로 변환하면, 네트워크가 바뀌지 않는 한 이후 모든 분석에서 재사용된다. 2단계에서는 기본·순위·편차범위 분석 중 목적에 맞는 것을 실행하며, 분석 유형(거리/시간)과 장애물 적용 여부를 실행 시점에 선택한다. 3단계에서는 2단계 출력물을 입력으로 경로 간 유사도 또는 레이어 간 구성 비교를 수행한다.

=== 파생 분석 ===
* '''순위 분석''' : 목표값 근접도 상위 N개 경로를 모두 산출하여, rank 1 경로가 유일한 대안인지 복수의 대안이 존재하는지를 판별한다.
* '''편차범위 분석''' : 사료의 거리 기록에 내재한 불확실성(±5리 ≈ 2.25 km)을 명시적으로 반영하여, 목표값 ±margin 범위 내의 경로만 산출한다.
* '''경로 간 유사도 분석''' : 두 경로의 간선 집합에 대한 길이 가중 Jaccard 유사도를 산출하여, 재현 경로가 어떤 성격의 이동(거리·시간·에너지 최소, 군현 영역 제한 여부)에 가장 가까운지를 정량화한다.

=== 관련 도구 ===
* Python (NetworkX, GeoPandas, Shapely, pyproj, rasterio)
* ArcGIS Pro / QGIS

== 필드 설계 ==

=== 네트워크 데이터셋 필드 ===
도로 라인의 비용지표 필드 설계(필드명·단위·정의 및 DEM 기반 표면거리·보행 속도 함수·에너지 소비 모델의 산출 방법)는 [[근대_교통로_DB|근대 교통로 DB]] 항목과 동일하므로, 구체적인 내용은 해당 항목을 참조한다. 본 분석 모델에서는 그래프 변환 시 정방향(f)·역방향(b) 필드를 읽어 방향별 간선에 매핑하며, 간선 비용 속성은 length_3dkm, hour_ks, hour_tob, kcal_ks, kcal_tob의 5종 임피던스로 구성된다.

=== 경로 분석 결과 필드 ===
경로 분석 결과 레이어의 주요 속성은 다음과 같다.

{| class="wikitable"
! 필드명 !! 단위 !! 정의
|-
| route_id || — || 경로 식별자
|-
| weight_attr || — || 선택된 임피던스 필드명(length_3dkm / hour_ks / hour_tob 등)
|-
| target_km / target_hr || km / hour || 사용자 입력 목표값(거리 또는 시간)
|-
| metric_val || km / hour / kcal || 선택 임피던스의 누적 비용
|-
| abs_diff || km / hour || 누적 비용과 목표값의 차이(metric_val − target)
|-
| length_km || km || 경로 전체 3D 표면거리
|-
| hour_ks / hour_tob || hour || Kondo–Seino / Tobler 총 보행시간(방향 비대칭 반영)
|-
| kcal_ks / kcal_tob || kcal || Kondo–Seino / Tobler 총 에너지 소비량(방향 비대칭 반영)
|-
| candidate_n || 개 || 탐색된 후보 경로 수(탐색 규모 지표)
|-
| legs_n || 개 || 경로 구간(leg) 수
|-
| rank || — || (순위·편차범위 레이어) 목표값 근접도 순위. 1 = 최근접
|-
| margin || km / hour || (편차범위 레이어) 적용된 편차범위
|-
| snap_m_start / snap_m_end || m || 기점·종점의 최근접 간선 스냅 거리(데이터 정합성 지표)
|}

== 분석 스크립트 ==
경로 분석에 사용한 스크립트는 GitHub 저장소에 공개되어 있다. 본 위키에서 내려받은 GIS 데이터와 함께 사용하면 분석을 그대로 재현할 수 있다. 스크립트의 구성과 실행 방법은 저장소를 참조한다.

* 저장소 : https://github.com/yachagye/target-approximating-path-analysis

== 자료 공개 ==
* DB 설계 : 양정현
* 비영리적 활동(논문, 연구서)에 본 자료 사용 시, 인용 문구만 표시하면 사용에 제한 없음.
* 영리적인 목적(프로젝트)으로 사용할 경우에는 관계자(yachagye@naver.com)와 상의 후 처리.
* 본 자료 전체를 다른 곳에서 서비스하는 것은 제한함.
* 본 DB에 오류가 발견된 경우, yachagye@naver.com에 오류 신고.
* 인용 표기 : 조선 군현도로 GIS(○○ 군현), 연·월 기준, 양정현, 역지사지(https://www.hisgeo.info). 구체 표기는 각 군현 문서를 참조.

== 참고 문헌 ==
* 양정현, 2026, 역사 GIS를 위한 목표값 근접 경로 분석 모델의 설계와 적용 - 조선시대 경기 광주의 사례를 중심으로, 조선시대사학보 117.

[[분류:조선 군현도로 GIS]]

조선 군현도로 GIS

2026-06-09T08:37:56Z

Yachagye: /* 분석 유형 */

조선 군현도로 GIS는 1910년대 한반도 1:5만 지형도(3차지형도)에서 직접 디지타이징한 군현 단위 도로 네트워크를 기반으로, 사료에 기록된 거리 정보에 부합하는 조선시대 역사적 경로를 재현·복원하는 GIS 데이터 시리즈이다. 도로 네트워크에 NetworkX 기반 '목표값 근접 경로 분석' 모델을 적용하여 산출한 결과물을 군현 단위로 배포한다. 분석 스크립트는 GitHub 저장소에, GIS 데이터는 본 위키에 함께 공개되어, 상용 GIS 소프트웨어 없이 Python 오픈소스 환경만으로 분석을 그대로 재현할 수 있다. 군현별 데이터와 사례는 하위 문서에서 다룬다.

== DB 설명 ==
* 1910년대 한반도 1:5만 지형도(3차지형도)의 도로 정보를 직접 디지타이징하여 구축한 군현 단위 도로 네트워크를 기반으로, 조선시대 개별 군현의 도로 체계와 역사적 이동 경로를 재현하기 위해 산출한 분석 결과 데이터이다.
* 도로 데이터의 범위는 3차지형도의 1·2등 도로, 달로, 간로, 연로 및 소로까지 포함하여, 군현 내부의 세부 이동 경로를 재현할 수 있도록 구성하였다.
* 도로 라인에는 Tobler(1993)·Kondo–Seino(2010) 보행 속도 함수와 ACSM 에너지 소비 공식을 적용하여, 세그먼트마다 표면거리·보행시간·보행 중 에너지 소비량의 방향 비대칭 비용을 부여하였다.
* 활용 모델은 경로 분석의 목적함수를 '비용 최소화(min f)'에서 '목표값 근접(min|f − T|)'으로 전환한 모델이다. 이는 조선시대 사료에 기재된 거리(예: "○○까지 ○○리")에 부합하는 경로를 직접 탐색하기 위한 것으로, 최단·최소 비용 경로만으로는 포착되지 않는 역사적 경로를 복원하는 데 목적이 있다.
* 분석 그래프는 NetworkX 방향 그래프(DiGraph)로 변환되며, 좌표계는 EPSG:5179, degree-2 체인 축약을 적용한다.

== 구축 군현 ==
{| class="wikitable"
! 도 !! 군현 !! 시기 구분 !! 문서
|-
| 경기 || 광주(廣州) || 1626년 읍치 이동 전후 || [[경기_광주_군현도로_GIS|경기 광주 군현도로 GIS]]
|}

이후 군현을 추가할 때마다 위 표에 행을 추가하고, 해당 군현 문서에 분류:(도명)을 부여한다.

== 활용 모델: 목표값 근접 경로 분석 ==
모델의 구체적인 작동 방식과 실행 절차(그래프 변환, 입력 형식, 단계별 파라미터, 분석 파이프라인 등)는 [https://github.com/yachagye/target-approximating-path-analysis GitHub 저장소]의 스크립트 운영 지침에 상세히 정리되어 있다. 아래에서는 배포 데이터를 이해하는 데 필요한 개요만 기술한다.

=== 개요 ===
도로 네트워크를 방향 그래프로 변환한 뒤, 사료에 기록된 거리·시간 정보를 목표값(T)으로 설정하여 그에 가장 가까운 경로를 탐색하는 분석 모델이다. 일반적인 최단·최소 비용 경로 분석이 목적함수를 비용 최소화(min f)로 두는 데 비해, 본 모델은 목적함수를 목표값 근접(min|f − T|)으로 전환한다.

비용 속성은 표면거리(length_3dkm), 보행시간(Kondo–Seino, Tobler), 에너지 소비량(Kondo–Seino, Tobler)의 5종 임피던스를 사용하며, 정방향·역방향을 구분한 방향 비대칭 비용을 반영한다.

=== 분석 그래프 구축 ===
* GeoPackage 도로 라인을 NetworkX 방향 그래프(DiGraph)로 변환한다. 좌표계는 EPSG:5179.
* degree-2 체인 축약(contract_degree2)을 적용하여, 분기점이 아닌 중간 노드를 제거하고 인접 간선을 병합한다. 비용은 합산, geometry는 연결되며, 축약 전후의 경로 비용은 수학적으로 동일하다.
* 축약 간선에는 원본 노드 순서열(chain_nodes)과 구간별 비용(chain_costs)을 저장하여, 좌표 스냅 시 정확한 선형 보간과 분할이 가능하도록 한다.
* 입력 좌표(EPSG:4326)는 최근접 간선에 투영하여 그래프에 스냅하며, 분석 완료 후 임시 노드를 복원하여 동일 그래프를 여러 분석에 재사용한다.

=== 분석 유형 ===
* '''포인트-포인트 분석''' : 기점·종점(및 경유지)이 모두 점으로 지정된 경로를 산출한다. 각 임피던스별 최소 비용 경로와 목표값 근접 경로를 함께 출력한다.
* '''포인트-폴리곤 분석''' : 출발점에서 목적 폴리곤(읍치 사방경계 등)에 도달하는 경로를 산출한다. 폴리곤 경계와 교차하는 간선의 진입 지점을 목적지 후보 노드로 설정하고, 그중 목표값에 근접하는 경로를 선택한다. 읍치의 사방경계 기록("동으로 ○○ 경계까지 ○○리")을 반영하기 위한 분석이다.

=== 입력 형식 ===
* '''지점 간 분석''' : 경로별 기점·경유지·종점 좌표와 목표값을 CSV로 입력한다. 좌표는 경위도(EPSG:4326)이며, 첫 좌표쌍이 기점, 마지막 좌표쌍이 종점, 중간 좌표쌍은 경유지이다. 목표값은 마지막 두 컬럼(거리는 km_beg·km_end, 시간은 hr_beg·hr_end)에 입력하며, 끝값을 비우면 단일 목표값으로, 두 값을 모두 채우면 목표 구간으로 처리된다.
* '''지점-경계 분석''' : 출발점 목록 CSV와 목적지 군현 경계 폴리곤 GPKG를 입력하며, 양자는 route_id로 매칭된다. 종점은 CSV에 정의하지 않고 폴리곤 경계 노드 탐색으로 결정된다.
* '''장애물(선택)''' : 선(Line) 또는 면(Polygon) 형식의 GPKG를 입력하면, 해당 영역과 교차하는 간선을 제거한 사본 그래프가 생성되어 특정 구간을 경로 탐색에서 배제한다.

=== 분석 파이프라인 ===
전체 파이프라인은 그래프 변환, 경로 분석, 후속 분석의 3단계로 운영된다. 각 단계의 입력·출력은 다음과 같다.

{| class="wikitable"
! 단계 !! 기능 !! 입력 !! 출력
|-
| 1 || 네트워크 그래프 변환 || 네트워크 GPKG || 그래프 캐시(pkl)
|-
| 2 || 기본 경로 분석(지점 간 / 지점-경계) || pkl + CSV + (장애물) || 경로 GPKG (6 레이어)
|-
| 2 || 순위 분석 || 〃 || 순위 GPKG (1 레이어)
|-
| 2 || 편차범위 분석 || 〃 || 편차범위 GPKG (1 레이어)
|-
| 3 || 경로 간 유사도 분석 || pkl + 경로 GPKG || 유사도 CSV
|-
| 3 || 순위·편차범위 경로 유사도 || pkl + 순위/편차범위 GPKG || 유사도 CSV + 필터 GPKG
|-
| 3 || 레이어 간 경로 구성 비교 || pkl + 타겟·비교 GPKG || 요약 CSV + 매칭 CSV
|}

1단계에서 네트워크 데이터셋을 방향 그래프 캐시로 변환하면, 네트워크가 바뀌지 않는 한 이후 모든 분석에서 재사용된다. 2단계에서는 기본·순위·편차범위 분석 중 목적에 맞는 것을 실행하며, 분석 유형(거리/시간)과 장애물 적용 여부를 실행 시점에 선택한다. 3단계에서는 2단계 출력물을 입력으로 경로 간 유사도 또는 레이어 간 구성 비교를 수행한다.

=== 파생 분석 ===
* '''순위 분석''' : 목표값 근접도 상위 N개 경로를 모두 산출하여, rank 1 경로가 유일한 대안인지 복수의 대안이 존재하는지를 판별한다.
* '''편차범위 분석''' : 사료의 거리 기록에 내재한 불확실성(±5리 ≈ 2.25 km)을 명시적으로 반영하여, 목표값 ±margin 범위 내의 경로만 산출한다.
* '''경로 간 유사도 분석''' : 두 경로의 간선 집합에 대한 길이 가중 Jaccard 유사도를 산출하여, 재현 경로가 어떤 성격의 이동(거리·시간·에너지 최소, 군현 영역 제한 여부)에 가장 가까운지를 정량화한다.

=== 관련 도구 ===
* Python (NetworkX, GeoPandas, Shapely, pyproj, rasterio)
* ArcGIS Pro / QGIS

== 필드 설계 ==

=== 네트워크 데이터셋 필드 ===
도로 라인의 비용지표 필드 설계(필드명·단위·정의 및 DEM 기반 표면거리·보행 속도 함수·에너지 소비 모델의 산출 방법)는 [[근대_교통로_DB|근대 교통로 DB]] 항목과 동일하므로, 구체적인 내용은 해당 항목을 참조한다. 본 분석 모델에서는 그래프 변환 시 정방향(f)·역방향(b) 필드를 읽어 방향별 간선에 매핑하며, 간선 비용 속성은 length_3dkm, hour_ks, hour_tob, kcal_ks, kcal_tob의 5종 임피던스로 구성된다.

=== 경로 분석 결과 필드 ===
경로 분석 결과 레이어의 주요 속성은 다음과 같다.

{| class="wikitable"
! 필드명 !! 단위 !! 정의
|-
| route_id || — || 경로 식별자
|-
| weight_attr || — || 선택된 임피던스 필드명(length_3dkm / hour_ks / hour_tob 등)
|-
| target_km / target_hr || km / hour || 사용자 입력 목표값(거리 또는 시간)
|-
| metric_val || km / hour / kcal || 선택 임피던스의 누적 비용
|-
| abs_diff || km / hour || 누적 비용과 목표값의 차이(metric_val − target)
|-
| length_km || km || 경로 전체 3D 표면거리
|-
| hour_ks / hour_tob || hour || Kondo–Seino / Tobler 총 보행시간(방향 비대칭 반영)
|-
| kcal_ks / kcal_tob || kcal || Kondo–Seino / Tobler 총 에너지 소비량(방향 비대칭 반영)
|-
| candidate_n || 개 || 탐색된 후보 경로 수(탐색 규모 지표)
|-
| legs_n || 개 || 경로 구간(leg) 수
|-
| rank || — || (순위·편차범위 레이어) 목표값 근접도 순위. 1 = 최근접
|-
| margin || km / hour || (편차범위 레이어) 적용된 편차범위
|-
| snap_m_start / snap_m_end || m || 기점·종점의 최근접 간선 스냅 거리(데이터 정합성 지표)
|}

== 분석 스크립트 ==
경로 분석에 사용한 스크립트는 GitHub 저장소에 공개되어 있다. 본 위키에서 내려받은 GIS 데이터와 함께 사용하면 분석을 그대로 재현할 수 있다. 스크립트의 구성과 실행 방법은 저장소를 참조한다.

* 저장소 : https://github.com/yachagye/target-approximating-path-analysis

== 자료 공개 ==
* DB 설계 : 양정현
* 비영리적 활동(논문, 연구서)에 본 자료 사용 시, 인용 문구만 표시하면 사용에 제한 없음.
* 영리적인 목적(프로젝트)으로 사용할 경우에는 관계자(yachagye@naver.com)와 상의 후 처리.
* 본 자료 전체를 다른 곳에서 서비스하는 것은 제한함.
* 본 DB에 오류가 발견된 경우, yachagye@naver.com에 오류 신고.
* 인용 표기 : 조선 군현도로 GIS(○○ 군현), 연·월 기준, 양정현, 역지사지(https://www.hisgeo.info). 구체 표기는 각 군현 문서를 참조.

== 참고 문헌 ==
* 양정현, 2023, HGIS를 통해 본 조선 전기 양주의 도로 체계와 역사적 경로 재현 - 양주 회암사의 사례를 중심으로, 남도문화연구 50.
* 양정현, 2024, 조선시대 도로 네트워크 분석 방법론과 사례 연구 - 양주의 사례를 중심으로, 문화역사지리 36-3.
* 양정현, 2025, '신출귀몰'의 재구성 - 역사 연구와 GIS가 연결되는 한 방식, 역사비평 153.
* 양정현, 2026, 역사 GIS를 위한 목표값 근접 경로 분석 모델의 설계와 적용 - 조선시대 경기 광주의 사례를 중심으로, 조선시대사학보 117.
* Tobler, W. (1993). Three presentations on geographical analysis and modeling. Technical Report 93-1. National Center for Geographic Information and Analysis, University of California, Santa Barbara.
* Kondo, Y., & Seino, Y. (2010). GPS-aided walking experiments and data-driven travel cost modeling on the historical road of Nakasendō-Kisoji (Central Highland Japan). In B. Frischer (Ed.), Making history interactive: CAA. Proceedings of the 37th international conference (pp. 158-165). Archaeopress.

[[분류:조선 군현도로 GIS]]

조선 군현도로 GIS

2026-06-09T08:36:32Z

Yachagye:

조선 군현도로 GIS는 1910년대 한반도 1:5만 지형도(3차지형도)에서 직접 디지타이징한 군현 단위 도로 네트워크를 기반으로, 사료에 기록된 거리 정보에 부합하는 조선시대 역사적 경로를 재현·복원하는 GIS 데이터 시리즈이다. 도로 네트워크에 NetworkX 기반 '목표값 근접 경로 분석' 모델을 적용하여 산출한 결과물을 군현 단위로 배포한다. 분석 스크립트는 GitHub 저장소에, GIS 데이터는 본 위키에 함께 공개되어, 상용 GIS 소프트웨어 없이 Python 오픈소스 환경만으로 분석을 그대로 재현할 수 있다. 군현별 데이터와 사례는 하위 문서에서 다룬다.

== DB 설명 ==
* 1910년대 한반도 1:5만 지형도(3차지형도)의 도로 정보를 직접 디지타이징하여 구축한 군현 단위 도로 네트워크를 기반으로, 조선시대 개별 군현의 도로 체계와 역사적 이동 경로를 재현하기 위해 산출한 분석 결과 데이터이다.
* 도로 데이터의 범위는 3차지형도의 1·2등 도로, 달로, 간로, 연로 및 소로까지 포함하여, 군현 내부의 세부 이동 경로를 재현할 수 있도록 구성하였다.
* 도로 라인에는 Tobler(1993)·Kondo–Seino(2010) 보행 속도 함수와 ACSM 에너지 소비 공식을 적용하여, 세그먼트마다 표면거리·보행시간·보행 중 에너지 소비량의 방향 비대칭 비용을 부여하였다.
* 활용 모델은 경로 분석의 목적함수를 '비용 최소화(min f)'에서 '목표값 근접(min|f − T|)'으로 전환한 모델이다. 이는 조선시대 사료에 기재된 거리(예: "○○까지 ○○리")에 부합하는 경로를 직접 탐색하기 위한 것으로, 최단·최소 비용 경로만으로는 포착되지 않는 역사적 경로를 복원하는 데 목적이 있다.
* 분석 그래프는 NetworkX 방향 그래프(DiGraph)로 변환되며, 좌표계는 EPSG:5179, degree-2 체인 축약을 적용한다.

== 구축 군현 ==
{| class="wikitable"
! 도 !! 군현 !! 시기 구분 !! 문서
|-
| 경기 || 광주(廣州) || 1626년 읍치 이동 전후 || [[경기_광주_군현도로_GIS|경기 광주 군현도로 GIS]]
|}

이후 군현을 추가할 때마다 위 표에 행을 추가하고, 해당 군현 문서에 분류:(도명)을 부여한다.

== 활용 모델: 목표값 근접 경로 분석 ==
모델의 구체적인 작동 방식과 실행 절차(그래프 변환, 입력 형식, 단계별 파라미터, 분석 파이프라인 등)는 [https://github.com/yachagye/target-approximating-path-analysis GitHub 저장소]의 스크립트 운영 지침에 상세히 정리되어 있다. 아래에서는 배포 데이터를 이해하는 데 필요한 개요만 기술한다.

=== 개요 ===
도로 네트워크를 방향 그래프로 변환한 뒤, 사료에 기록된 거리·시간 정보를 목표값(T)으로 설정하여 그에 가장 가까운 경로를 탐색하는 분석 모델이다. 일반적인 최단·최소 비용 경로 분석이 목적함수를 비용 최소화(min f)로 두는 데 비해, 본 모델은 목적함수를 목표값 근접(min|f − T|)으로 전환한다.

비용 속성은 표면거리(length_3dkm), 보행시간(Kondo–Seino, Tobler), 에너지 소비량(Kondo–Seino, Tobler)의 5종 임피던스를 사용하며, 정방향·역방향을 구분한 방향 비대칭 비용을 반영한다.

=== 분석 그래프 구축 ===
* GeoPackage 도로 라인을 NetworkX 방향 그래프(DiGraph)로 변환한다. 좌표계는 EPSG:5179.
* degree-2 체인 축약(contract_degree2)을 적용하여, 분기점이 아닌 중간 노드를 제거하고 인접 간선을 병합한다. 비용은 합산, geometry는 연결되며, 축약 전후의 경로 비용은 수학적으로 동일하다.
* 축약 간선에는 원본 노드 순서열(chain_nodes)과 구간별 비용(chain_costs)을 저장하여, 좌표 스냅 시 정확한 선형 보간과 분할이 가능하도록 한다.
* 입력 좌표(EPSG:4326)는 최근접 간선에 투영하여 그래프에 스냅하며, 분석 완료 후 임시 노드를 복원하여 동일 그래프를 여러 분석에 재사용한다.

=== 분석 유형 ===
* '''포인트-포인트 분석''' : 기점·종점(및 경유지)이 모두 점으로 지정된 경로를 산출한다. 각 임피던스별 최소 비용 경로와 목표값 근접 경로를 함께 출력한다.
* '''포인트-폴리곤 분석''' : 출발점에서 목적 폴리곤(읍치 사방경계 등)에 도달하는 경로를 산출한다. 폴리곤 경계와 교차하는 간선의 진입 지점을 목적지 후보 노드로 설정하고, 그중 목표값에 근접하는 경로를 선택한다. 읍치의 사방경계 기록("동으로 ○○리에 이르러 ○○ 경계")을 반영하기 위한 분석이다.

=== 입력 형식 ===
* '''지점 간 분석''' : 경로별 기점·경유지·종점 좌표와 목표값을 CSV로 입력한다. 좌표는 경위도(EPSG:4326)이며, 첫 좌표쌍이 기점, 마지막 좌표쌍이 종점, 중간 좌표쌍은 경유지이다. 목표값은 마지막 두 컬럼(거리는 km_beg·km_end, 시간은 hr_beg·hr_end)에 입력하며, 끝값을 비우면 단일 목표값으로, 두 값을 모두 채우면 목표 구간으로 처리된다.
* '''지점-경계 분석''' : 출발점 목록 CSV와 목적지 군현 경계 폴리곤 GPKG를 입력하며, 양자는 route_id로 매칭된다. 종점은 CSV에 정의하지 않고 폴리곤 경계 노드 탐색으로 결정된다.
* '''장애물(선택)''' : 선(Line) 또는 면(Polygon) 형식의 GPKG를 입력하면, 해당 영역과 교차하는 간선을 제거한 사본 그래프가 생성되어 특정 구간을 경로 탐색에서 배제한다.

=== 분석 파이프라인 ===
전체 파이프라인은 그래프 변환, 경로 분석, 후속 분석의 3단계로 운영된다. 각 단계의 입력·출력은 다음과 같다.

{| class="wikitable"
! 단계 !! 기능 !! 입력 !! 출력
|-
| 1 || 네트워크 그래프 변환 || 네트워크 GPKG || 그래프 캐시(pkl)
|-
| 2 || 기본 경로 분석(지점 간 / 지점-경계) || pkl + CSV + (장애물) || 경로 GPKG (6 레이어)
|-
| 2 || 순위 분석 || 〃 || 순위 GPKG (1 레이어)
|-
| 2 || 편차범위 분석 || 〃 || 편차범위 GPKG (1 레이어)
|-
| 3 || 경로 간 유사도 분석 || pkl + 경로 GPKG || 유사도 CSV
|-
| 3 || 순위·편차범위 경로 유사도 || pkl + 순위/편차범위 GPKG || 유사도 CSV + 필터 GPKG
|-
| 3 || 레이어 간 경로 구성 비교 || pkl + 타겟·비교 GPKG || 요약 CSV + 매칭 CSV
|}

1단계에서 네트워크 데이터셋을 방향 그래프 캐시로 변환하면, 네트워크가 바뀌지 않는 한 이후 모든 분석에서 재사용된다. 2단계에서는 기본·순위·편차범위 분석 중 목적에 맞는 것을 실행하며, 분석 유형(거리/시간)과 장애물 적용 여부를 실행 시점에 선택한다. 3단계에서는 2단계 출력물을 입력으로 경로 간 유사도 또는 레이어 간 구성 비교를 수행한다.

=== 파생 분석 ===
* '''순위 분석''' : 목표값 근접도 상위 N개 경로를 모두 산출하여, rank 1 경로가 유일한 대안인지 복수의 대안이 존재하는지를 판별한다.
* '''편차범위 분석''' : 사료의 거리 기록에 내재한 불확실성(±5리 ≈ 2.25 km)을 명시적으로 반영하여, 목표값 ±margin 범위 내의 경로만 산출한다.
* '''경로 간 유사도 분석''' : 두 경로의 간선 집합에 대한 길이 가중 Jaccard 유사도를 산출하여, 재현 경로가 어떤 성격의 이동(거리·시간·에너지 최소, 군현 영역 제한 여부)에 가장 가까운지를 정량화한다.

=== 관련 도구 ===
* Python (NetworkX, GeoPandas, Shapely, pyproj, rasterio)
* ArcGIS Pro / QGIS

== 필드 설계 ==

=== 네트워크 데이터셋 필드 ===
도로 라인의 비용지표 필드 설계(필드명·단위·정의 및 DEM 기반 표면거리·보행 속도 함수·에너지 소비 모델의 산출 방법)는 [[근대_교통로_DB|근대 교통로 DB]] 항목과 동일하므로, 구체적인 내용은 해당 항목을 참조한다. 본 분석 모델에서는 그래프 변환 시 정방향(f)·역방향(b) 필드를 읽어 방향별 간선에 매핑하며, 간선 비용 속성은 length_3dkm, hour_ks, hour_tob, kcal_ks, kcal_tob의 5종 임피던스로 구성된다.

=== 경로 분석 결과 필드 ===
경로 분석 결과 레이어의 주요 속성은 다음과 같다.

{| class="wikitable"
! 필드명 !! 단위 !! 정의
|-
| route_id || — || 경로 식별자
|-
| weight_attr || — || 선택된 임피던스 필드명(length_3dkm / hour_ks / hour_tob 등)
|-
| target_km / target_hr || km / hour || 사용자 입력 목표값(거리 또는 시간)
|-
| metric_val || km / hour / kcal || 선택 임피던스의 누적 비용
|-
| abs_diff || km / hour || 누적 비용과 목표값의 차이(metric_val − target)
|-
| length_km || km || 경로 전체 3D 표면거리
|-
| hour_ks / hour_tob || hour || Kondo–Seino / Tobler 총 보행시간(방향 비대칭 반영)
|-
| kcal_ks / kcal_tob || kcal || Kondo–Seino / Tobler 총 에너지 소비량(방향 비대칭 반영)
|-
| candidate_n || 개 || 탐색된 후보 경로 수(탐색 규모 지표)
|-
| legs_n || 개 || 경로 구간(leg) 수
|-
| rank || — || (순위·편차범위 레이어) 목표값 근접도 순위. 1 = 최근접
|-
| margin || km / hour || (편차범위 레이어) 적용된 편차범위
|-
| snap_m_start / snap_m_end || m || 기점·종점의 최근접 간선 스냅 거리(데이터 정합성 지표)
|}

== 분석 스크립트 ==
경로 분석에 사용한 스크립트는 GitHub 저장소에 공개되어 있다. 본 위키에서 내려받은 GIS 데이터와 함께 사용하면 분석을 그대로 재현할 수 있다. 스크립트의 구성과 실행 방법은 저장소를 참조한다.

* 저장소 : https://github.com/yachagye/target-approximating-path-analysis

== 자료 공개 ==
* DB 설계 : 양정현
* 비영리적 활동(논문, 연구서)에 본 자료 사용 시, 인용 문구만 표시하면 사용에 제한 없음.
* 영리적인 목적(프로젝트)으로 사용할 경우에는 관계자(yachagye@naver.com)와 상의 후 처리.
* 본 자료 전체를 다른 곳에서 서비스하는 것은 제한함.
* 본 DB에 오류가 발견된 경우, yachagye@naver.com에 오류 신고.
* 인용 표기 : 조선 군현도로 GIS(○○ 군현), 연·월 기준, 양정현, 역지사지(https://www.hisgeo.info). 구체 표기는 각 군현 문서를 참조.

== 참고 문헌 ==
* 양정현, 2023, HGIS를 통해 본 조선 전기 양주의 도로 체계와 역사적 경로 재현 - 양주 회암사의 사례를 중심으로, 남도문화연구 50.
* 양정현, 2024, 조선시대 도로 네트워크 분석 방법론과 사례 연구 - 양주의 사례를 중심으로, 문화역사지리 36-3.
* 양정현, 2025, '신출귀몰'의 재구성 - 역사 연구와 GIS가 연결되는 한 방식, 역사비평 153.
* 양정현, 2026, 역사 GIS를 위한 목표값 근접 경로 분석 모델의 설계와 적용 - 조선시대 경기 광주의 사례를 중심으로, 조선시대사학보 117.
* Tobler, W. (1993). Three presentations on geographical analysis and modeling. Technical Report 93-1. National Center for Geographic Information and Analysis, University of California, Santa Barbara.
* Kondo, Y., & Seino, Y. (2010). GPS-aided walking experiments and data-driven travel cost modeling on the historical road of Nakasendō-Kisoji (Central Highland Japan). In B. Frischer (Ed.), Making history interactive: CAA. Proceedings of the 37th international conference (pp. 158-165). Archaeopress.

[[분류:조선 군현도로 GIS]]

경기 광주 군현도로 GIS

2026-06-09T08:34:05Z

Yachagye: /* 경로 분석 결과 레이어 (재현 결과물) */

경기 광주 군현도로 GIS는 [[조선_군현도로_GIS|조선 군현도로 GIS]] 모델을 조선시대 경기 광주(廣州)에 적용하여 산출한 GIS 데이터이다. 1626년(인조 4) 읍치(邑治) 이전 전후 두 시기의 도로 체계와 역사적 경로를 재현한다. 분석 모델·필드 설계·스크립트에 대한 설명은 상위 문서 [[조선_군현도로_GIS|조선 군현도로 GIS]]를 참조한다.

== 구축자 ==
* DB 설계·구축 : 양정현
* 데이터 검수 : 양정현

== 공간 데이터 ==
본 군현의 공간 데이터는 분석에 입력한 데이터(기반 네트워크·보조 레이어)와, 이 입력에 목표값 근접 경로 분석을 수행하여 산출한 결과물(경로 레이어)로 구성된다. [[조선_군현도로_GIS#분석 스크립트|GitHub에 공개된 스크립트]]로 동일한 입력을 다시 분석하면 결과물을 그대로 재현할 수 있다.

=== 기반 네트워크 데이터셋 (입력) ===
* 도로_1914_광주_nd.gpkg : 경기 광주 일대의 도로 네트워크 데이터셋. 1:5만 지형도에서 소로까지 디지타이징한 도로 라인에 비용 필드를 부여한 것이다.
** 다운로드: [[Media:도로_1914_경기_광주_nd.zip|【네트워크 데이터셋】]](2026년06월)

=== 분석 보조 레이어 (입력) ===
* 장애물.gpkg : 군현 영역 제한(경계 밖 이동 차단) 등에 사용하는 장애물 레이어. 장애물과 교차하는 간선을 그래프에서 제거하여 경로 탐색에서 배제한다.
* 전1626_폴리곤.gpkg / 후1626_폴리곤.gpkg : 1626년 읍치 이전 '이전'·'이후' 시기의 읍치 사방경계 폴리곤. 포인트-폴리곤 분석의 목적 폴리곤으로 사용한다. 본 페이지에서 제공하는 것은 광주 분석을 위해 편집한 편집본이며, 원본 경계 데이터는 [[조선_행정구역_DB|조선 행정구역 DB]]를 참조한다.
** 다운로드: [[Media:경기_광주_보조 레이어.zip|【보조 레이어】]](2026년06월)

=== 경로 분석 결과 레이어 (재현 결과물) ===
아래 레이어들은 위 입력 데이터에 목표값 근접 경로 분석을 수행하여 산출한 재현 결과물이다. 1626년 읍치 이전을 기준으로 '이전'과 '이후' 두 시기로 구분하여 폴더로 제공한다. 레이어 명명 규칙은 다음과 같다.

{| class="wikitable"
! 명칭 요소 !! 의미
|-
| 경로_point_point || 포인트-포인트 분석. 기점·종점이 모두 점으로 지정된 경로.
|-
| 경로_point_polygon || 포인트-폴리곤 분석. 출발점에서 읍치 사방경계(폴리곤)에 도달하는 경로.
|-
| _순위 || 순위 분석. 목표값 근접도 상위 N개 경로를 단일 레이어로 산출.
|-
| _제한 || 장애물(군현 영역 제한)을 적용한 분석.
|-
| _편차범위 || 목표값 ±margin(거리 ±2.25 km = 5리) 범위 내 후보만 산출.
|-
| 최종 재현 경로 || 위 분석 결과를 종합하여 확정한 대표 재현 경로.
|}

각 레이어는 목표값 근접 경로(route_target)와 임피던스별 최소 비용 경로(route_min_km, route_min_hr_ks, route_min_hr_tob, route_min_kcal_ks, route_min_kcal_tob)를 포함한다(순위·편차범위 레이어는 route_target 단일 레이어).

'''1626년 이전''' :[[Media:경기_광주_1626년 이전.zip|【다운로드】]](2026년06월)
* 경로_point_point.gpkg
* 경로_point_point_순위.gpkg
* 경로_point_point_제한.gpkg
* 경로_point_polygon.gpkg
* 경로_point_polygon_순위.gpkg
* 경로_point_polygon_제한.gpkg
* 경로_point_polygon_편차범위.gpkg
* 최종 재현 경로.gpkg

'''1626년 이후''' :[[Media:경기_광주_1626년 이후.zip|【다운로드】]](2026년06월)
* 경로_point_point.gpkg
* 경로_point_point_순위.gpkg
* 경로_point_point_제한.gpkg
* 경로_point_point_편차범위.gpkg
* 경로_point_polygon.gpkg
* 경로_point_polygon_순위.gpkg
* 경로_point_polygon_제한.gpkg
* 경로_point_polygon_편차범위.gpkg
* 최종 재현 경로.gpkg

== 사례: 1626년 읍치 이전 ==
조선 초기 광주 읍치는 현 경기도 하남시 교산동에 있었으나, 1626년(인조 4) 남한산성(현 광주시 남한산성면 산성리)으로 이전하였다. 읍치의 위치 변화는 군현 도로망의 중심 노드를 재편하므로, 동일 군현 내에서 읍치 이전 전후의 도로 체계와 이동 경로를 비교할 수 있는 사례가 된다. 1846년 간행된 중정남한지(重訂南漢志) 강역조에는 1626년 이전과 이후의 사방경계 구성 변화가 모두 수록되어 있다. 본 데이터는 이전 전후 두 시기에 대해 각각 경로 분석을 수행하고 결과를 구분하여 제공한다.

=== 1626년 이전 ===
신증동국여지승람(新增東國輿地勝覽) 단계의 거리·방향 기록을 목표값으로 하여, 한성을 포함한 인접 9개 군현 경계로 가는 9개 경로를 재현한다.

=== 1626년 이후 ===
해동지도(海東地圖)·여지도서(輿地圖書) 등의 거리·방향 기록을 목표값으로 하여 24개 경로를 재현한다. 예를 들어 도로 관련 기록이 "읍치에서 ○○군현 경계까지 ○○리"와 같이 도착 지점이 경계를 가리키는 경우는 지점-경계 분석으로, 출발 지점과 도착 종점이 흥인지문, 양재역과 같은 특정 지점으로 비정되는 경로는 지점 간 분석으로 수행한다.

== 자료 공개 ==
라이선스 및 이용 조건은 [[조선_군현도로_GIS#자료 공개|조선 군현도로 GIS]]의 자료 공개 항목을 따른다.
* 인용 표기 : 조선 군현도로 GIS(경기 광주), 202X년 X월 기준, 양정현, 역지사지(https://www.hisgeo.info).

== 참고 문헌 ==
* 양정현, 2026, 역사 GIS를 위한 목표값 근접 경로 분석 모델의 설계와 적용 - 조선시대 경기 광주의 사례를 중심으로, 조선시대사학보 117.

== 변화 이력 ==
* 2026년 6월 9일 : 최초 공개.

[[분류:조선 군현도로 GIS 경기]]

경기 광주 군현도로 GIS

2026-06-09T08:32:40Z

Yachagye: /* 분석 보조 레이어 (입력) */

경기 광주 군현도로 GIS는 [[조선_군현도로_GIS|조선 군현도로 GIS]] 모델을 조선시대 경기 광주(廣州)에 적용하여 산출한 GIS 데이터이다. 1626년(인조 4) 읍치(邑治) 이전 전후 두 시기의 도로 체계와 역사적 경로를 재현한다. 분석 모델·필드 설계·스크립트에 대한 설명은 상위 문서 [[조선_군현도로_GIS|조선 군현도로 GIS]]를 참조한다.

== 구축자 ==
* DB 설계·구축 : 양정현
* 데이터 검수 : 양정현

== 공간 데이터 ==
본 군현의 공간 데이터는 분석에 입력한 데이터(기반 네트워크·보조 레이어)와, 이 입력에 목표값 근접 경로 분석을 수행하여 산출한 결과물(경로 레이어)로 구성된다. [[조선_군현도로_GIS#분석 스크립트|GitHub에 공개된 스크립트]]로 동일한 입력을 다시 분석하면 결과물을 그대로 재현할 수 있다.

=== 기반 네트워크 데이터셋 (입력) ===
* 도로_1914_광주_nd.gpkg : 경기 광주 일대의 도로 네트워크 데이터셋. 1:5만 지형도에서 소로까지 디지타이징한 도로 라인에 비용 필드를 부여한 것이다.
** 다운로드: [[Media:도로_1914_경기_광주_nd.zip|【네트워크 데이터셋】]](2026년06월)

=== 분석 보조 레이어 (입력) ===
* 장애물.gpkg : 군현 영역 제한(경계 밖 이동 차단) 등에 사용하는 장애물 레이어. 장애물과 교차하는 간선을 그래프에서 제거하여 경로 탐색에서 배제한다.
* 전1626_폴리곤.gpkg / 후1626_폴리곤.gpkg : 1626년 읍치 이전 '이전'·'이후' 시기의 읍치 사방경계 폴리곤. 포인트-폴리곤 분석의 목적 폴리곤으로 사용한다. 본 페이지에서 제공하는 것은 광주 분석을 위해 편집한 편집본이며, 원본 경계 데이터는 [[조선_행정구역_DB|조선 행정구역 DB]]를 참조한다.
** 다운로드: [[Media:경기_광주_보조 레이어.zip|【보조 레이어】]](2026년06월)

=== 경로 분석 결과 레이어 (재현 결과물) ===
아래 레이어들은 위 입력 데이터에 목표값 근접 경로 분석을 수행하여 산출한 재현 결과물이다. 1626년 읍치 이전을 기준으로 '이전'과 '이후' 두 시기로 구분하여 폴더로 제공한다. 레이어 명명 규칙은 다음과 같다.

{| class="wikitable"
! 명칭 요소 !! 의미
|-
| 경로_point_point || 포인트-포인트 분석. 기점·종점이 모두 점으로 지정된 경로.
|-
| 경로_point_polygon || 포인트-폴리곤 분석. 출발점에서 읍치 사방경계(폴리곤)에 도달하는 경로.
|-
| _순위 || 순위 분석. 목표값 근접도 상위 N개 경로를 단일 레이어로 산출.
|-
| _제한 || 장애물(군현 영역 제한)을 적용한 분석.
|-
| _편차범위 || 목표값 ±margin(거리 ±2.25 km = 5리) 범위 내 후보만 산출.
|-
| 최종 재현 경로 || 위 분석 결과를 종합하여 확정한 대표 재현 경로.
|}

각 레이어는 목표값 근접 경로(route_target)와 임피던스별 최소 비용 경로(route_min_km, route_min_hr_ks, route_min_hr_tob, route_min_kcal_ks, route_min_kcal_tob)를 포함한다(순위·편차범위 레이어는 route_target 단일 레이어).

'''1626년 이전'''
* 경로_point_point.gpkg
* 경로_point_point_순위.gpkg
* 경로_point_point_제한.gpkg
* 경로_point_polygon.gpkg
* 경로_point_polygon_순위.gpkg
* 경로_point_polygon_제한.gpkg
* 경로_point_polygon_편차범위.gpkg
* 최종 재현 경로.gpkg

'''1626년 이후'''
* 경로_point_point.gpkg
* 경로_point_point_순위.gpkg
* 경로_point_point_제한.gpkg
* 경로_point_point_편차범위.gpkg
* 경로_point_polygon.gpkg
* 경로_point_polygon_순위.gpkg
* 경로_point_polygon_제한.gpkg
* 경로_point_polygon_편차범위.gpkg
* 최종 재현 경로.gpkg

== 사례: 1626년 읍치 이전 ==
조선 초기 광주 읍치는 현 경기도 하남시 교산동에 있었으나, 1626년(인조 4) 남한산성(현 광주시 남한산성면 산성리)으로 이전하였다. 읍치의 위치 변화는 군현 도로망의 중심 노드를 재편하므로, 동일 군현 내에서 읍치 이전 전후의 도로 체계와 이동 경로를 비교할 수 있는 사례가 된다. 1846년 간행된 중정남한지(重訂南漢志) 강역조에는 1626년 이전과 이후의 사방경계 구성 변화가 모두 수록되어 있다. 본 데이터는 이전 전후 두 시기에 대해 각각 경로 분석을 수행하고 결과를 구분하여 제공한다.

=== 1626년 이전 ===
신증동국여지승람(新增東國輿地勝覽) 단계의 거리·방향 기록을 목표값으로 하여, 한성을 포함한 인접 9개 군현 경계로 가는 9개 경로를 재현한다.

=== 1626년 이후 ===
해동지도(海東地圖)·여지도서(輿地圖書) 등의 거리·방향 기록을 목표값으로 하여 24개 경로를 재현한다. 예를 들어 도로 관련 기록이 "읍치에서 ○○군현 경계까지 ○○리"와 같이 도착 지점이 경계를 가리키는 경우는 지점-경계 분석으로, 출발 지점과 도착 종점이 흥인지문, 양재역과 같은 특정 지점으로 비정되는 경로는 지점 간 분석으로 수행한다.

== 자료 공개 ==
라이선스 및 이용 조건은 [[조선_군현도로_GIS#자료 공개|조선 군현도로 GIS]]의 자료 공개 항목을 따른다.
* 인용 표기 : 조선 군현도로 GIS(경기 광주), 202X년 X월 기준, 양정현, 역지사지(https://www.hisgeo.info).

== 참고 문헌 ==
* 양정현, 2026, 역사 GIS를 위한 목표값 근접 경로 분석 모델의 설계와 적용 - 조선시대 경기 광주의 사례를 중심으로, 조선시대사학보 117.

== 변화 이력 ==
* 2026년 6월 9일 : 최초 공개.

[[분류:조선 군현도로 GIS 경기]]

경기 광주 군현도로 GIS

2026-06-09T08:32:05Z

Yachagye: /* 기반 네트워크 데이터셋 (입력) */

경기 광주 군현도로 GIS는 [[조선_군현도로_GIS|조선 군현도로 GIS]] 모델을 조선시대 경기 광주(廣州)에 적용하여 산출한 GIS 데이터이다. 1626년(인조 4) 읍치(邑治) 이전 전후 두 시기의 도로 체계와 역사적 경로를 재현한다. 분석 모델·필드 설계·스크립트에 대한 설명은 상위 문서 [[조선_군현도로_GIS|조선 군현도로 GIS]]를 참조한다.

== 구축자 ==
* DB 설계·구축 : 양정현
* 데이터 검수 : 양정현

== 공간 데이터 ==
본 군현의 공간 데이터는 분석에 입력한 데이터(기반 네트워크·보조 레이어)와, 이 입력에 목표값 근접 경로 분석을 수행하여 산출한 결과물(경로 레이어)로 구성된다. [[조선_군현도로_GIS#분석 스크립트|GitHub에 공개된 스크립트]]로 동일한 입력을 다시 분석하면 결과물을 그대로 재현할 수 있다.

=== 기반 네트워크 데이터셋 (입력) ===
* 도로_1914_광주_nd.gpkg : 경기 광주 일대의 도로 네트워크 데이터셋. 1:5만 지형도에서 소로까지 디지타이징한 도로 라인에 비용 필드를 부여한 것이다.
** 다운로드: [[Media:도로_1914_경기_광주_nd.zip|【네트워크 데이터셋】]](2026년06월)

=== 분석 보조 레이어 (입력) ===
* 장애물.gpkg : 군현 영역 제한(경계 밖 이동 차단) 등에 사용하는 장애물 레이어. 장애물과 교차하는 간선을 그래프에서 제거하여 경로 탐색에서 배제한다.
* 전1626_폴리곤.gpkg / 후1626_폴리곤.gpkg : 1626년 읍치 이전 '이전'·'이후' 시기의 읍치 사방경계 폴리곤. 포인트-폴리곤 분석의 목적 폴리곤으로 사용한다. 본 페이지에서 제공하는 것은 광주 분석을 위해 편집한 편집본이며, 원본 경계 데이터는 [[조선_행정구역_DB|조선 행정구역 DB]]를 참조한다.

=== 경로 분석 결과 레이어 (재현 결과물) ===
아래 레이어들은 위 입력 데이터에 목표값 근접 경로 분석을 수행하여 산출한 재현 결과물이다. 1626년 읍치 이전을 기준으로 '이전'과 '이후' 두 시기로 구분하여 폴더로 제공한다. 레이어 명명 규칙은 다음과 같다.

{| class="wikitable"
! 명칭 요소 !! 의미
|-
| 경로_point_point || 포인트-포인트 분석. 기점·종점이 모두 점으로 지정된 경로.
|-
| 경로_point_polygon || 포인트-폴리곤 분석. 출발점에서 읍치 사방경계(폴리곤)에 도달하는 경로.
|-
| _순위 || 순위 분석. 목표값 근접도 상위 N개 경로를 단일 레이어로 산출.
|-
| _제한 || 장애물(군현 영역 제한)을 적용한 분석.
|-
| _편차범위 || 목표값 ±margin(거리 ±2.25 km = 5리) 범위 내 후보만 산출.
|-
| 최종 재현 경로 || 위 분석 결과를 종합하여 확정한 대표 재현 경로.
|}

각 레이어는 목표값 근접 경로(route_target)와 임피던스별 최소 비용 경로(route_min_km, route_min_hr_ks, route_min_hr_tob, route_min_kcal_ks, route_min_kcal_tob)를 포함한다(순위·편차범위 레이어는 route_target 단일 레이어).

'''1626년 이전'''
* 경로_point_point.gpkg
* 경로_point_point_순위.gpkg
* 경로_point_point_제한.gpkg
* 경로_point_polygon.gpkg
* 경로_point_polygon_순위.gpkg
* 경로_point_polygon_제한.gpkg
* 경로_point_polygon_편차범위.gpkg
* 최종 재현 경로.gpkg

'''1626년 이후'''
* 경로_point_point.gpkg
* 경로_point_point_순위.gpkg
* 경로_point_point_제한.gpkg
* 경로_point_point_편차범위.gpkg
* 경로_point_polygon.gpkg
* 경로_point_polygon_순위.gpkg
* 경로_point_polygon_제한.gpkg
* 경로_point_polygon_편차범위.gpkg
* 최종 재현 경로.gpkg

== 사례: 1626년 읍치 이전 ==
조선 초기 광주 읍치는 현 경기도 하남시 교산동에 있었으나, 1626년(인조 4) 남한산성(현 광주시 남한산성면 산성리)으로 이전하였다. 읍치의 위치 변화는 군현 도로망의 중심 노드를 재편하므로, 동일 군현 내에서 읍치 이전 전후의 도로 체계와 이동 경로를 비교할 수 있는 사례가 된다. 1846년 간행된 중정남한지(重訂南漢志) 강역조에는 1626년 이전과 이후의 사방경계 구성 변화가 모두 수록되어 있다. 본 데이터는 이전 전후 두 시기에 대해 각각 경로 분석을 수행하고 결과를 구분하여 제공한다.

=== 1626년 이전 ===
신증동국여지승람(新增東國輿地勝覽) 단계의 거리·방향 기록을 목표값으로 하여, 한성을 포함한 인접 9개 군현 경계로 가는 9개 경로를 재현한다.

=== 1626년 이후 ===
해동지도(海東地圖)·여지도서(輿地圖書) 등의 거리·방향 기록을 목표값으로 하여 24개 경로를 재현한다. 예를 들어 도로 관련 기록이 "읍치에서 ○○군현 경계까지 ○○리"와 같이 도착 지점이 경계를 가리키는 경우는 지점-경계 분석으로, 출발 지점과 도착 종점이 흥인지문, 양재역과 같은 특정 지점으로 비정되는 경로는 지점 간 분석으로 수행한다.

== 자료 공개 ==
라이선스 및 이용 조건은 [[조선_군현도로_GIS#자료 공개|조선 군현도로 GIS]]의 자료 공개 항목을 따른다.
* 인용 표기 : 조선 군현도로 GIS(경기 광주), 202X년 X월 기준, 양정현, 역지사지(https://www.hisgeo.info).

== 참고 문헌 ==
* 양정현, 2026, 역사 GIS를 위한 목표값 근접 경로 분석 모델의 설계와 적용 - 조선시대 경기 광주의 사례를 중심으로, 조선시대사학보 117.

== 변화 이력 ==
* 2026년 6월 9일 : 최초 공개.

[[분류:조선 군현도로 GIS 경기]]

파일:경기 광주 1626년 이후.zip

2026-06-09T08:30:49Z

Yachagye:

파일:경기 광주 1626년 이전.zip

2026-06-09T08:30:42Z

Yachagye:

파일:경기 광주 보조 레이어.zip

2026-06-09T08:30:35Z

Yachagye:

파일:도로 1914 경기 광주 nd.zip

2026-06-09T08:30:24Z

Yachagye:

대문

2026-06-09T08:17:42Z

Yachagye: /* 역사지리정보(역지사지) */

[[파일:역지사지 로고 2024.png|섬네일|역사지리정보WIKI]]

== 역사지리정보(역지사지) ==
=== 완료 ===
* [[파일:Icon_update.png]][[현대_표석_DB]] : [[최유식]](2026년03월)
* [[파일:Icon_new.png]][[조선_대동여지도_DB]] : [[역지사지]](2026년01월)
* [[파일:Icon_update.png]] [[조선_행정구역_DB]] : [[역지사지]](2026년01월)
** [[파일:Icon_link.png]][[조선시대_행정구역_이력]]
** [[파일:Icon_link.png]][[조선시대_읍치_이력]]
* [[파일:Icon_new.png]][[조선_교통로_DB]] : [[김종혁]], [[김현종]](2026년01월)
* [[파일:Icon_update.png]][[근대_철도_DB]] : [[김종혁]](2026년01월)
* [[파일:Icon_new.png]][[인구경지_민적통계표_DB]] : [[역지사지]](2025년07월)
* [[파일:Icon_update.png]][[조선_호구총수_DB]] : [[역지사지]](2025년04월)
* [[파일:Icon_update.png]][[조선_역_DB]] : [[양정현]](2026년05월)
** [[파일:Icon_link.png]][[조선시대_역_이력]]
** [[파일:Icon_link.png]][[조선시대_역_위치]]

=== 진행중 ===
* [[조선_고지도_통합방안체계_GIS]] : [[김현종]]
* [[조선_고적_DB]] : [[최유식]]
* [[근대_교통로_DB]] : [[양정현]]
* [[조선_군현도로_GIS]]: [[양정현]]
* [[지리지_XML_정규화_개발]] : [[김현종]], [[최경현]]

=== 예정 ===
* [[근대_지형도_DB]] : [[박선영]]
* [[인구경지_호구총수_DB]] : [[역지사지]]
* [[근대_행정구역_1917_전후비교_DB]] : [[김현종]]
* [[조선_고개_DB]] : [[김현종]]

== 역사지리정보(국사편찬위원회) ==
* [https://hgis.history.go.kr/pro_g1/dataset.do 근대_행정구역_DB] : 국사편찬위원회, 역사지리정보DB(2026년02월 기준)
** 행정구역 데이터 (1910~1945년) : xlsx, csv
** 행정구역 변경이력 데이터 (1910~1945년) : xslsx, csv
** 행정구역 GIS 데이터 : geopackage
* [https://hgis.history.go.kr/pro_g1/dataset.do 현대_행정구역_DB] : 국사편찬위원회, 역사지리정보DB(2026년02월 기준)
** 행정구역 데이터 (1955~1975년) : xslsx, csv
** 행정구역 변경이력 데이터 (1955~1975년) : xslsx, csv
** 행정구역 GIS 데이터 : geopacakge
** 행정구역 데이터(1975년) : xlsx, csv
** 행정구역 GIS 데이터(1975년) : geopackage
* [https://hgis.history.go.kr/pro_g1/dataset.do 근대_지형도기호_DB] : 국사편찬위원회, 역사지리정보DB(2026년02월 기준)
** 근대지리정보 심볼 포인트 : geopackage
* [https://hgis.history.go.kr/pro_g1/dataset.do 근대_지형도목록_DB] : 국사편찬위원회, 역사지리정보DB(2026년02월 기준)
** 일제시기 지형도 도엽 목록 : xlsx
* [https://hgis.history.go.kr/pro_g1/dataset.do 현대_지형도목록_DB] : 국사편찬위원회, 역사지리정보DB(2026년02월 기준)
** 1970년대 지형도 도엽 정보 : xlsx
* [https://hgis.history.go.kr/api/intro.do 근대_근대지형도_OpenAPI] : 국사편찬위원회, 역사지리정보DB(2026년02월 기준)
* [https://hgis.history.go.kr/api/intro.do 현대_현대지형도_OpenAPI] : 국사편찬위원회, 역사지리정보DB(2026년02월 기준)

== DB 구축 계획 ==
* [[파일:Icon_new.png]][[역지사지_계획]]

== 역사지리연구 DB ==
* [[파일:Icon_update.png]][[역사GIS_서비스]](2025년10월)
* [[역사GIS_연구자]]
* [[고지도_연구자]]
* [[역사지리정보_문헌]]
** [[파일:Icon_link.png]][[지리지_편목]]
** [[파일:Icon_link.png]][[한국지리_지역구분]]
* [[파일:Icon_update.png]][[역사지리정보_지역]]
** [[충청_당진]]|[[충청_예산]]
** [[충청_아산]]|[[충청_천안]]|[[충청_대전]]
* [[파일:Icon_new.png]][[대동여지도_지리정보]](2025년11월)
** [[대동여지도_경기_광주]]|[[대동여지도_경기_안산]]|[[대동여지도_경기_인천]]|[[대동여지도_경기_수원]]|[[대동여지도_경기_통진]]
** [[대동여지도_충청_결성]]|[[대동여지도_충청_아산]]|[[대동여지도_충청_천안]]|[[대동여지도_충청_회덕]]|[[대동여지도_충청_진잠]]
** [[대동여지도_전라_무안]]|[[대동여지도_전라_전주]]
** [[대동여지도_경상_경주]]|[[대동여지도_경상_동래]]|[[대동여지도_경상_고성]]
** [[대동여지도_평안_정주]]

== 역지사지 회원 ==
* [[김종혁]] : 역사지리, 문화지리, HGIS
* [[박선영]] : 역사지리, 근대지도, HGIS
* [[김현종]] : 역사지리, HGIS, 디지털인문학
* [[양정현]] : 한국사, 역사지리, HGIS, 디지털인문학
* [[최유식]] : 역사지리, HGIS

경기 광주 군현도로 GIS

2026-06-09T08:16:21Z

Yachagye:

경기 광주 군현도로 GIS는 [[조선_군현도로_GIS|조선 군현도로 GIS]] 모델을 조선시대 경기 광주(廣州)에 적용하여 산출한 GIS 데이터이다. 1626년(인조 4) 읍치(邑治) 이전 전후 두 시기의 도로 체계와 역사적 경로를 재현한다. 분석 모델·필드 설계·스크립트에 대한 설명은 상위 문서 [[조선_군현도로_GIS|조선 군현도로 GIS]]를 참조한다.

== 구축자 ==
* DB 설계·구축 : 양정현
* 데이터 검수 : 양정현

== 공간 데이터 ==
본 군현의 공간 데이터는 분석에 입력한 데이터(기반 네트워크·보조 레이어)와, 이 입력에 목표값 근접 경로 분석을 수행하여 산출한 결과물(경로 레이어)로 구성된다. [[조선_군현도로_GIS#분석 스크립트|GitHub에 공개된 스크립트]]로 동일한 입력을 다시 분석하면 결과물을 그대로 재현할 수 있다.

=== 기반 네트워크 데이터셋 (입력) ===
* 도로_1914_광주_nd.gpkg : 경기 광주 일대의 도로 네트워크 데이터셋. 1:5만 지형도에서 소로까지 디지타이징한 도로 라인에 비용 필드를 부여한 것이다.

=== 분석 보조 레이어 (입력) ===
* 장애물.gpkg : 군현 영역 제한(경계 밖 이동 차단) 등에 사용하는 장애물 레이어. 장애물과 교차하는 간선을 그래프에서 제거하여 경로 탐색에서 배제한다.
* 전1626_폴리곤.gpkg / 후1626_폴리곤.gpkg : 1626년 읍치 이전 '이전'·'이후' 시기의 읍치 사방경계 폴리곤. 포인트-폴리곤 분석의 목적 폴리곤으로 사용한다. 본 페이지에서 제공하는 것은 광주 분석을 위해 편집한 편집본이며, 원본 경계 데이터는 [[조선_행정구역_DB|조선 행정구역 DB]]를 참조한다.

=== 경로 분석 결과 레이어 (재현 결과물) ===
아래 레이어들은 위 입력 데이터에 목표값 근접 경로 분석을 수행하여 산출한 재현 결과물이다. 1626년 읍치 이전을 기준으로 '이전'과 '이후' 두 시기로 구분하여 폴더로 제공한다. 레이어 명명 규칙은 다음과 같다.

{| class="wikitable"
! 명칭 요소 !! 의미
|-
| 경로_point_point || 포인트-포인트 분석. 기점·종점이 모두 점으로 지정된 경로.
|-
| 경로_point_polygon || 포인트-폴리곤 분석. 출발점에서 읍치 사방경계(폴리곤)에 도달하는 경로.
|-
| _순위 || 순위 분석. 목표값 근접도 상위 N개 경로를 단일 레이어로 산출.
|-
| _제한 || 장애물(군현 영역 제한)을 적용한 분석.
|-
| _편차범위 || 목표값 ±margin(거리 ±2.25 km = 5리) 범위 내 후보만 산출.
|-
| 최종 재현 경로 || 위 분석 결과를 종합하여 확정한 대표 재현 경로.
|}

각 레이어는 목표값 근접 경로(route_target)와 임피던스별 최소 비용 경로(route_min_km, route_min_hr_ks, route_min_hr_tob, route_min_kcal_ks, route_min_kcal_tob)를 포함한다(순위·편차범위 레이어는 route_target 단일 레이어).

'''1626년 이전'''
* 경로_point_point.gpkg
* 경로_point_point_순위.gpkg
* 경로_point_point_제한.gpkg
* 경로_point_polygon.gpkg
* 경로_point_polygon_순위.gpkg
* 경로_point_polygon_제한.gpkg
* 경로_point_polygon_편차범위.gpkg
* 최종 재현 경로.gpkg

'''1626년 이후'''
* 경로_point_point.gpkg
* 경로_point_point_순위.gpkg
* 경로_point_point_제한.gpkg
* 경로_point_point_편차범위.gpkg
* 경로_point_polygon.gpkg
* 경로_point_polygon_순위.gpkg
* 경로_point_polygon_제한.gpkg
* 경로_point_polygon_편차범위.gpkg
* 최종 재현 경로.gpkg

== 사례: 1626년 읍치 이전 ==
조선 초기 광주 읍치는 현 경기도 하남시 교산동에 있었으나, 1626년(인조 4) 남한산성(현 광주시 남한산성면 산성리)으로 이전하였다. 읍치의 위치 변화는 군현 도로망의 중심 노드를 재편하므로, 동일 군현 내에서 읍치 이전 전후의 도로 체계와 이동 경로를 비교할 수 있는 사례가 된다. 1846년 간행된 중정남한지(重訂南漢志) 강역조에는 1626년 이전과 이후의 사방경계 구성 변화가 모두 수록되어 있다. 본 데이터는 이전 전후 두 시기에 대해 각각 경로 분석을 수행하고 결과를 구분하여 제공한다.

=== 1626년 이전 ===
신증동국여지승람(新增東國輿地勝覽) 단계의 거리·방향 기록을 목표값으로 하여, 한성을 포함한 인접 9개 군현 경계로 가는 9개 경로를 재현한다.

=== 1626년 이후 ===
해동지도(海東地圖)·여지도서(輿地圖書) 등의 거리·방향 기록을 목표값으로 하여 24개 경로를 재현한다. 예를 들어 도로 관련 기록이 "읍치에서 ○○군현 경계까지 ○○리"와 같이 도착 지점이 경계를 가리키는 경우는 지점-경계 분석으로, 출발 지점과 도착 종점이 흥인지문, 양재역과 같은 특정 지점으로 비정되는 경로는 지점 간 분석으로 수행한다.

== 자료 공개 ==
라이선스 및 이용 조건은 [[조선_군현도로_GIS#자료 공개|조선 군현도로 GIS]]의 자료 공개 항목을 따른다.
* 인용 표기 : 조선 군현도로 GIS(경기 광주), 202X년 X월 기준, 양정현, 역지사지(https://www.hisgeo.info).

== 참고 문헌 ==
* 양정현, 2026, 역사 GIS를 위한 목표값 근접 경로 분석 모델의 설계와 적용 - 조선시대 경기 광주의 사례를 중심으로, 조선시대사학보 117.

== 변화 이력 ==
* 2026년 6월 9일 : 최초 공개.

[[분류:조선 군현도로 GIS 경기]]

경기 광주 군현도로 GIS

2026-06-09T08:14:04Z

Yachagye: /* 1626년 이후 */

경기 광주 군현도로 GIS는 [[조선_군현도로_GIS|조선 군현도로 GIS]] 모델을 조선시대 경기 광주(廣州)에 적용하여 산출한 GIS 데이터이다. 1626년(인조 4) 읍치(邑治) 이전 전후 두 시기의 도로 체계와 역사적 경로를 재현한다. 분석 모델·필드 설계·스크립트에 대한 설명은 상위 문서 [[조선_군현도로_GIS|조선 군현도로 GIS]]를 참조한다.

== 구축자 ==
* DB 설계·구축 : 양정현
* 데이터 검수 : 양정현

== 공간 데이터 ==
본 군현의 공간 데이터는 분석에 입력한 데이터(기반 네트워크·보조 레이어)와, 이 입력에 목표값 근접 경로 분석을 수행하여 산출한 결과물(경로 레이어)로 구성된다. [[조선_군현도로_GIS#분석 스크립트|GitHub에 공개된 스크립트]]로 동일한 입력을 다시 분석하면 결과물을 그대로 재현할 수 있다.

=== 기반 네트워크 데이터셋 (입력) ===
* 도로_1914_광주_nd.gpkg : 경기 광주 일대의 도로 네트워크 데이터셋. 1:5만 지형도에서 소로까지 디지타이징한 도로 라인에 비용 필드를 부여한 것이다.

=== 분석 보조 레이어 (입력) ===
* 장애물.gpkg : 군현 영역 제한(경계 밖 이동 차단) 등에 사용하는 장애물 레이어. 장애물과 교차하는 간선을 그래프에서 제거하여 경로 탐색에서 배제한다.
* 전1626_폴리곤.gpkg / 후1626_폴리곤.gpkg : 1626년 읍치 이전 '이전'·'이후' 시기의 읍치 사방경계 폴리곤. 포인트-폴리곤 분석의 목적 폴리곤으로 사용한다. 본 페이지에서 제공하는 것은 광주 분석을 위해 편집한 편집본이며, 원본 경계 데이터는 [[조선_행정구역_DB|조선 행정구역 DB]]를 참조한다.

=== 경로 분석 결과 레이어 (재현 결과물) ===
아래 레이어들은 위 입력 데이터에 목표값 근접 경로 분석을 수행하여 산출한 재현 결과물이다. 1626년 읍치 이전을 기준으로 '이전'과 '이후' 두 시기로 구분하여 폴더로 제공한다. 레이어 명명 규칙은 다음과 같다.

{| class="wikitable"
! 명칭 요소 !! 의미
|-
| 경로_point_point || 포인트-포인트 분석. 기점·종점이 모두 점으로 지정된 경로.
|-
| 경로_point_polygon || 포인트-폴리곤 분석. 출발점에서 읍치 사방경계(폴리곤)에 도달하는 경로.
|-
| _순위 || 순위 분석. 목표값 근접도 상위 N개 경로를 단일 레이어로 산출.
|-
| _제한 || 장애물(군현 영역 제한)을 적용한 분석.
|-
| _편차범위 || 목표값 ±margin(거리 ±2.25 km = 5리) 범위 내 후보만 산출.
|-
| 최종 재현 경로 || 위 분석 결과를 종합하여 확정한 대표 재현 경로.
|}

각 레이어는 목표값 근접 경로(route_target)와 임피던스별 최소 비용 경로(route_min_km, route_min_hr_ks, route_min_hr_tob, route_min_kcal_ks, route_min_kcal_tob)를 포함한다(순위·편차범위 레이어는 route_target 단일 레이어).

'''1626년 이전'''
* 경로_point_point.gpkg
* 경로_point_point_순위.gpkg
* 경로_point_point_제한.gpkg
* 경로_point_polygon.gpkg
* 경로_point_polygon_순위.gpkg
* 경로_point_polygon_제한.gpkg
* 경로_point_polygon_편차범위.gpkg
* 최종 재현 경로.gpkg

'''1626년 이후'''
* 경로_point_point.gpkg
* 경로_point_point_순위.gpkg
* 경로_point_point_제한.gpkg
* 경로_point_point_편차범위.gpkg
* 경로_point_polygon.gpkg
* 경로_point_polygon_순위.gpkg
* 경로_point_polygon_제한.gpkg
* 경로_point_polygon_편차범위.gpkg
* 최종 재현 경로.gpkg

== 사례: 1626년 읍치 이전 ==
조선 초기 광주 읍치는 현 경기도 하남시 교산동에 있었으나, 1626년(인조 4) 남한산성(현 광주시 남한산성면 산성리)으로 이전하였다. 읍치의 위치 변화는 군현 도로망의 중심 노드를 재편하므로, 동일 군현 내에서 읍치 이전 전후의 도로 체계와 이동 경로를 비교할 수 있는 사례가 된다. 1846년 간행된 중정남한지(重訂南漢志) 강역조에는 1626년 이전과 이후의 사방경계 구성 변화가 모두 수록되어 있다. 본 데이터는 이전 전후 두 시기에 대해 각각 경로 분석을 수행하고 결과를 구분하여 제공한다.

=== 1626년 이전 ===
신증동국여지승람(新增東國輿地勝覽) 단계의 거리·방향 기록을 목표값으로 하여, 한성을 포함한 인접 9개 군현 경계로 가는 9개 경로를 재현한다.

=== 1626년 이후 ===
해동지도(海東地圖)·여지도서(輿地圖書) 등의 거리·방향 기록을 목표값으로 하여 24개 경로를 재현한다. 예를 들어 도로 관련 기록이 "읍치에서 ○○군현 경계까지 ○○리"와 같이 도착 지점이 경계를 가리키는 경우는 지점-경계 분석으로, 출발 지점과 도착 종점이 흥인지문, 양재역과 같은 특정 지점으로 비정되는 경로는 지점 간 분석으로 수행한다.

== 자료 공개 ==
라이선스 및 이용 조건은 [[조선_군현도로_GIS#자료 공개|조선 군현도로 GIS]]의 자료 공개 항목을 따른다.
* 인용 표기 : 조선 군현도로 GIS(경기 광주), 202X년 X월 기준, 양정현, 역지사지(https://www.hisgeo.info).

== 변화 이력 ==
* 2026년 6월 9일 : 최초 공개.

[[분류:조선 군현도로 GIS 경기]]

조선 군현도로 GIS

2026-06-09T08:09:14Z

Yachagye: /* 활용 모델: 목표값 근접 경로 분석 */

조선 군현도로 GIS는 1910년대 한반도 1:5만 지형도(3차지형도)에서 직접 디지타이징한 군현 단위 도로 네트워크를 기반으로, 사료에 기록된 거리 정보에 부합하는 조선시대 역사적 경로를 재현·복원하는 GIS 데이터 시리즈이다. 도로 네트워크에 NetworkX 기반 '목표값 근접 경로 분석' 모델을 적용하여 산출한 결과물을 군현 단위로 배포한다. 분석 스크립트는 GitHub 저장소에, GIS 데이터는 본 위키에 함께 공개되어, 상용 GIS 소프트웨어 없이 Python 오픈소스 환경만으로 분석을 그대로 재현할 수 있다. 군현별 데이터와 사례는 하위 문서에서 다룬다.

== DB 설명 ==
* 1910년대 한반도 1:5만 지형도(3차지형도)의 도로 정보를 직접 디지타이징하여 구축한 군현 단위 도로 네트워크를 기반으로, 조선시대 개별 군현의 도로 체계와 역사적 이동 경로를 재현하기 위해 산출한 분석 결과 데이터이다.
* 도로 데이터의 범위는 3차지형도의 1·2등 도로, 달로, 간로, 연로 및 소로까지 포함하여, 군현 내부의 세부 이동 경로를 재현할 수 있도록 구성하였다.
* 도로 라인에는 Tobler(1993)·Kondo–Seino(2010) 보행 속도 함수와 ACSM 에너지 소비 공식을 적용하여, 세그먼트마다 표면거리·보행시간·보행 중 에너지 소비량의 방향 비대칭 비용을 부여하였다.
* 활용 모델은 경로 분석의 목적함수를 '비용 최소화(min f)'에서 '목표값 근접(min|f − T|)'으로 전환한 모델이다. 이는 조선시대 사료에 기재된 거리(예: "○○까지 ○○리")에 부합하는 경로를 직접 탐색하기 위한 것으로, 최단·최소 비용 경로만으로는 포착되지 않는 역사적 경로를 복원하는 데 목적이 있다.
* 분석 그래프는 NetworkX 방향 그래프(DiGraph)로 변환되며, 좌표계는 EPSG:5179, degree-2 체인 축약을 적용한다.

== 활용 모델: 목표값 근접 경로 분석 ==
모델의 구체적인 작동 방식과 실행 절차(그래프 변환, 입력 형식, 단계별 파라미터, 분석 파이프라인 등)는 [https://github.com/yachagye/target-approximating-path-analysis GitHub 저장소]의 스크립트 운영 지침에 상세히 정리되어 있다. 아래에서는 배포 데이터를 이해하는 데 필요한 개요만 기술한다.

=== 개요 ===
도로 네트워크를 방향 그래프로 변환한 뒤, 사료에 기록된 거리·시간 정보를 목표값(T)으로 설정하여 그에 가장 가까운 경로를 탐색하는 분석 모델이다. 일반적인 최단·최소 비용 경로 분석이 목적함수를 비용 최소화(min f)로 두는 데 비해, 본 모델은 목적함수를 목표값 근접(min|f − T|)으로 전환한다.

비용 속성은 표면거리(length_3dkm), 보행시간(Kondo–Seino, Tobler), 에너지 소비량(Kondo–Seino, Tobler)의 5종 임피던스를 사용하며, 정방향·역방향을 구분한 방향 비대칭 비용을 반영한다.

=== 분석 그래프 구축 ===
* GeoPackage 도로 라인을 NetworkX 방향 그래프(DiGraph)로 변환한다. 좌표계는 EPSG:5179.
* degree-2 체인 축약(contract_degree2)을 적용하여, 분기점이 아닌 중간 노드를 제거하고 인접 간선을 병합한다. 비용은 합산, geometry는 연결되며, 축약 전후의 경로 비용은 수학적으로 동일하다.
* 축약 간선에는 원본 노드 순서열(chain_nodes)과 구간별 비용(chain_costs)을 저장하여, 좌표 스냅 시 정확한 선형 보간과 분할이 가능하도록 한다.
* 입력 좌표(EPSG:4326)는 최근접 간선에 투영하여 그래프에 스냅하며, 분석 완료 후 임시 노드를 복원하여 동일 그래프를 여러 분석에 재사용한다.

=== 분석 유형 ===
* '''포인트-포인트 분석''' : 기점·종점(및 경유지)이 모두 점으로 지정된 경로를 산출한다. 각 임피던스별 최소 비용 경로와 목표값 근접 경로를 함께 출력한다.
* '''포인트-폴리곤 분석''' : 출발점에서 목적 폴리곤(읍치 사방경계 등)에 도달하는 경로를 산출한다. 폴리곤 경계와 교차하는 간선의 진입 지점을 목적지 후보 노드로 설정하고, 그중 목표값에 근접하는 경로를 선택한다. 읍치의 사방경계 기록("동으로 ○○리에 이르러 ○○ 경계")을 반영하기 위한 분석이다.

=== 입력 형식 ===
* '''지점 간 분석''' : 경로별 기점·경유지·종점 좌표와 목표값을 CSV로 입력한다. 좌표는 경위도(EPSG:4326)이며, 첫 좌표쌍이 기점, 마지막 좌표쌍이 종점, 중간 좌표쌍은 경유지이다. 목표값은 마지막 두 컬럼(거리는 km_beg·km_end, 시간은 hr_beg·hr_end)에 입력하며, 끝값을 비우면 단일 목표값으로, 두 값을 모두 채우면 목표 구간으로 처리된다.
* '''지점-경계 분석''' : 출발점 목록 CSV와 목적지 군현 경계 폴리곤 GPKG를 입력하며, 양자는 route_id로 매칭된다. 종점은 CSV에 정의하지 않고 폴리곤 경계 노드 탐색으로 결정된다.
* '''장애물(선택)''' : 선(Line) 또는 면(Polygon) 형식의 GPKG를 입력하면, 해당 영역과 교차하는 간선을 제거한 사본 그래프가 생성되어 특정 구간을 경로 탐색에서 배제한다.

=== 분석 파이프라인 ===
전체 파이프라인은 그래프 변환, 경로 분석, 후속 분석의 3단계로 운영된다. 각 단계의 입력·출력은 다음과 같다.

{| class="wikitable"
! 단계 !! 기능 !! 입력 !! 출력
|-
| 1 || 네트워크 그래프 변환 || 네트워크 GPKG || 그래프 캐시(pkl)
|-
| 2 || 기본 경로 분석(지점 간 / 지점-경계) || pkl + CSV + (장애물) || 경로 GPKG (6 레이어)
|-
| 2 || 순위 분석 || 〃 || 순위 GPKG (1 레이어)
|-
| 2 || 편차범위 분석 || 〃 || 편차범위 GPKG (1 레이어)
|-
| 3 || 경로 간 유사도 분석 || pkl + 경로 GPKG || 유사도 CSV
|-
| 3 || 순위·편차범위 경로 유사도 || pkl + 순위/편차범위 GPKG || 유사도 CSV + 필터 GPKG
|-
| 3 || 레이어 간 경로 구성 비교 || pkl + 타겟·비교 GPKG || 요약 CSV + 매칭 CSV
|}

1단계에서 네트워크 데이터셋을 방향 그래프 캐시로 변환하면, 네트워크가 바뀌지 않는 한 이후 모든 분석에서 재사용된다. 2단계에서는 기본·순위·편차범위 분석 중 목적에 맞는 것을 실행하며, 분석 유형(거리/시간)과 장애물 적용 여부를 실행 시점에 선택한다. 3단계에서는 2단계 출력물을 입력으로 경로 간 유사도 또는 레이어 간 구성 비교를 수행한다.

=== 파생 분석 ===
* '''순위 분석''' : 목표값 근접도 상위 N개 경로를 모두 산출하여, rank 1 경로가 유일한 대안인지 복수의 대안이 존재하는지를 판별한다.
* '''편차범위 분석''' : 사료의 거리 기록에 내재한 불확실성(±5리 ≈ 2.25 km)을 명시적으로 반영하여, 목표값 ±margin 범위 내의 경로만 산출한다.
* '''경로 간 유사도 분석''' : 두 경로의 간선 집합에 대한 길이 가중 Jaccard 유사도를 산출하여, 재현 경로가 어떤 성격의 이동(거리·시간·에너지 최소, 군현 영역 제한 여부)에 가장 가까운지를 정량화한다.

=== 관련 도구 ===
* Python (NetworkX, GeoPandas, Shapely, pyproj, rasterio)
* ArcGIS Pro / QGIS

== 필드 설계 ==

=== 네트워크 데이터셋 필드 ===
도로 라인의 비용지표 필드 설계(필드명·단위·정의 및 DEM 기반 표면거리·보행 속도 함수·에너지 소비 모델의 산출 방법)는 [[근대_교통로_DB|근대 교통로 DB]] 항목과 동일하므로, 구체적인 내용은 해당 항목을 참조한다. 본 분석 모델에서는 그래프 변환 시 정방향(f)·역방향(b) 필드를 읽어 방향별 간선에 매핑하며, 간선 비용 속성은 length_3dkm, hour_ks, hour_tob, kcal_ks, kcal_tob의 5종 임피던스로 구성된다.

=== 경로 분석 결과 필드 ===
경로 분석 결과 레이어의 주요 속성은 다음과 같다.

{| class="wikitable"
! 필드명 !! 단위 !! 정의
|-
| route_id || — || 경로 식별자
|-
| weight_attr || — || 선택된 임피던스 필드명(length_3dkm / hour_ks / hour_tob 등)
|-
| target_km / target_hr || km / hour || 사용자 입력 목표값(거리 또는 시간)
|-
| metric_val || km / hour / kcal || 선택 임피던스의 누적 비용
|-
| abs_diff || km / hour || 누적 비용과 목표값의 차이(metric_val − target)
|-
| length_km || km || 경로 전체 3D 표면거리
|-
| hour_ks / hour_tob || hour || Kondo–Seino / Tobler 총 보행시간(방향 비대칭 반영)
|-
| kcal_ks / kcal_tob || kcal || Kondo–Seino / Tobler 총 에너지 소비량(방향 비대칭 반영)
|-
| candidate_n || 개 || 탐색된 후보 경로 수(탐색 규모 지표)
|-
| legs_n || 개 || 경로 구간(leg) 수
|-
| rank || — || (순위·편차범위 레이어) 목표값 근접도 순위. 1 = 최근접
|-
| margin || km / hour || (편차범위 레이어) 적용된 편차범위
|-
| snap_m_start / snap_m_end || m || 기점·종점의 최근접 간선 스냅 거리(데이터 정합성 지표)
|}

== 분석 스크립트 ==
경로 분석에 사용한 스크립트는 GitHub 저장소에 공개되어 있다. 본 위키에서 내려받은 GIS 데이터와 함께 사용하면 분석을 그대로 재현할 수 있다. 스크립트의 구성과 실행 방법은 저장소를 참조한다.

* 저장소 : https://github.com/yachagye/target-approximating-path-analysis

== 자료 공개 ==
* DB 설계 : 양정현
* 비영리적 활동(논문, 연구서)에 본 자료 사용 시, 인용 문구만 표시하면 사용에 제한 없음.
* 영리적인 목적(프로젝트)으로 사용할 경우에는 관계자(yachagye@naver.com)와 상의 후 처리.
* 본 자료 전체를 다른 곳에서 서비스하는 것은 제한함.
* 본 DB에 오류가 발견된 경우, yachagye@naver.com에 오류 신고.
* 인용 표기 : 조선 군현도로 GIS(○○ 군현), 연·월 기준, 양정현, 역지사지(https://www.hisgeo.info). 구체 표기는 각 군현 문서를 참조.

== 구축 군현 ==
{| class="wikitable"
! 도 !! 군현 !! 시기 구분 !! 문서
|-
| 경기 || 광주(廣州) || 1626년 읍치 이동 전후 || [[경기_광주_군현도로_GIS|경기 광주 군현도로 GIS]]
|}

이후 군현을 추가할 때마다 위 표에 행을 추가하고, 해당 군현 문서에 분류:(도명)을 부여한다.

== 참고 문헌 ==
* 양정현, 2023, HGIS를 통해 본 조선 전기 양주의 도로 체계와 역사적 경로 재현 - 양주 회암사의 사례를 중심으로, 남도문화연구 50.
* 양정현, 2024, 조선시대 도로 네트워크 분석 방법론과 사례 연구 - 양주의 사례를 중심으로, 문화역사지리 36-3.
* 양정현, 2025, '신출귀몰'의 재구성 - 역사 연구와 GIS가 연결되는 한 방식, 역사비평 153.
* 양정현, 2026, 역사 GIS를 위한 목표값 근접 경로 분석 모델의 설계와 적용 - 조선시대 경기 광주의 사례를 중심으로, 조선시대사학보 117.
* Tobler, W. (1993). Three presentations on geographical analysis and modeling. Technical Report 93-1. National Center for Geographic Information and Analysis, University of California, Santa Barbara.
* Kondo, Y., & Seino, Y. (2010). GPS-aided walking experiments and data-driven travel cost modeling on the historical road of Nakasendō-Kisoji (Central Highland Japan). In B. Frischer (Ed.), Making history interactive: CAA. Proceedings of the 37th international conference (pp. 158-165). Archaeopress.

[[분류:조선 군현도로 GIS]]

경기 광주 군현도로 GIS

2026-06-09T08:04:33Z

Yachagye: 새 문서: 경기 광주 군현도로 GIS는 조선 군현도로 GIS 모델을 조선시대 경기 광주(廣州)에 적용하여 산출한 GIS 데이터이다. 1626년(인조 4) 읍치(邑治) 이전 전후 두 시기의 도로 체계와 역사적 경로를 재현한다. 분석 모델·필드 설계·스크립트에 대한 설명은 상위 문서 조선 군현도로 GIS를 참조한다. == 구축자 == * DB 설계·구축 : 양정...

경기 광주 군현도로 GIS는 [[조선_군현도로_GIS|조선 군현도로 GIS]] 모델을 조선시대 경기 광주(廣州)에 적용하여 산출한 GIS 데이터이다. 1626년(인조 4) 읍치(邑治) 이전 전후 두 시기의 도로 체계와 역사적 경로를 재현한다. 분석 모델·필드 설계·스크립트에 대한 설명은 상위 문서 [[조선_군현도로_GIS|조선 군현도로 GIS]]를 참조한다.

== 구축자 ==
* DB 설계·구축 : 양정현
* 데이터 검수 : 양정현

== 공간 데이터 ==
본 군현의 공간 데이터는 분석에 입력한 데이터(기반 네트워크·보조 레이어)와, 이 입력에 목표값 근접 경로 분석을 수행하여 산출한 결과물(경로 레이어)로 구성된다. [[조선_군현도로_GIS#분석 스크립트|GitHub에 공개된 스크립트]]로 동일한 입력을 다시 분석하면 결과물을 그대로 재현할 수 있다.

=== 기반 네트워크 데이터셋 (입력) ===
* 도로_1914_광주_nd.gpkg : 경기 광주 일대의 도로 네트워크 데이터셋. 1:5만 지형도에서 소로까지 디지타이징한 도로 라인에 비용 필드를 부여한 것이다.

=== 분석 보조 레이어 (입력) ===
* 장애물.gpkg : 군현 영역 제한(경계 밖 이동 차단) 등에 사용하는 장애물 레이어. 장애물과 교차하는 간선을 그래프에서 제거하여 경로 탐색에서 배제한다.
* 전1626_폴리곤.gpkg / 후1626_폴리곤.gpkg : 1626년 읍치 이전 '이전'·'이후' 시기의 읍치 사방경계 폴리곤. 포인트-폴리곤 분석의 목적 폴리곤으로 사용한다. 본 페이지에서 제공하는 것은 광주 분석을 위해 편집한 편집본이며, 원본 경계 데이터는 [[조선_행정구역_DB|조선 행정구역 DB]]를 참조한다.

=== 경로 분석 결과 레이어 (재현 결과물) ===
아래 레이어들은 위 입력 데이터에 목표값 근접 경로 분석을 수행하여 산출한 재현 결과물이다. 1626년 읍치 이전을 기준으로 '이전'과 '이후' 두 시기로 구분하여 폴더로 제공한다. 레이어 명명 규칙은 다음과 같다.

{| class="wikitable"
! 명칭 요소 !! 의미
|-
| 경로_point_point || 포인트-포인트 분석. 기점·종점이 모두 점으로 지정된 경로.
|-
| 경로_point_polygon || 포인트-폴리곤 분석. 출발점에서 읍치 사방경계(폴리곤)에 도달하는 경로.
|-
| _순위 || 순위 분석. 목표값 근접도 상위 N개 경로를 단일 레이어로 산출.
|-
| _제한 || 장애물(군현 영역 제한)을 적용한 분석.
|-
| _편차범위 || 목표값 ±margin(거리 ±2.25 km = 5리) 범위 내 후보만 산출.
|-
| 최종 재현 경로 || 위 분석 결과를 종합하여 확정한 대표 재현 경로.
|}

각 레이어는 목표값 근접 경로(route_target)와 임피던스별 최소 비용 경로(route_min_km, route_min_hr_ks, route_min_hr_tob, route_min_kcal_ks, route_min_kcal_tob)를 포함한다(순위·편차범위 레이어는 route_target 단일 레이어).

'''1626년 이전'''
* 경로_point_point.gpkg
* 경로_point_point_순위.gpkg
* 경로_point_point_제한.gpkg
* 경로_point_polygon.gpkg
* 경로_point_polygon_순위.gpkg
* 경로_point_polygon_제한.gpkg
* 경로_point_polygon_편차범위.gpkg
* 최종 재현 경로.gpkg

'''1626년 이후'''
* 경로_point_point.gpkg
* 경로_point_point_순위.gpkg
* 경로_point_point_제한.gpkg
* 경로_point_point_편차범위.gpkg
* 경로_point_polygon.gpkg
* 경로_point_polygon_순위.gpkg
* 경로_point_polygon_제한.gpkg
* 경로_point_polygon_편차범위.gpkg
* 최종 재현 경로.gpkg

== 사례: 1626년 읍치 이전 ==
조선 초기 광주 읍치는 현 경기도 하남시 교산동에 있었으나, 1626년(인조 4) 남한산성(현 광주시 남한산성면 산성리)으로 이전하였다. 읍치의 위치 변화는 군현 도로망의 중심 노드를 재편하므로, 동일 군현 내에서 읍치 이전 전후의 도로 체계와 이동 경로를 비교할 수 있는 사례가 된다. 1846년 간행된 중정남한지(重訂南漢志) 강역조에는 1626년 이전과 이후의 사방경계 구성 변화가 모두 수록되어 있다. 본 데이터는 이전 전후 두 시기에 대해 각각 경로 분석을 수행하고 결과를 구분하여 제공한다.

=== 1626년 이전 ===
신증동국여지승람(新增東國輿地勝覽) 단계의 거리·방향 기록을 목표값으로 하여, 한성을 포함한 인접 9개 군현 경계로 가는 9개 경로를 재현한다.

=== 1626년 이후 ===
해동지도(海東地圖)·여지도서(輿地圖書) 등의 거리·방향 기록을 목표값으로 하여 24개 경로를 재현한다. 사방경계로 가는 경로는 도착지가 "경계"로만 기재되므로 지점-경계 분석으로, 흥인지문·양재역 등 특정 지점으로 비정되는 경로는 지점 간 분석으로 수행한다.

== 자료 공개 ==
라이선스 및 이용 조건은 [[조선_군현도로_GIS#자료 공개|조선 군현도로 GIS]]의 자료 공개 항목을 따른다.
* 인용 표기 : 조선 군현도로 GIS(경기 광주), 202X년 X월 기준, 양정현, 역지사지(https://www.hisgeo.info).

== 변화 이력 ==
* 2026년 6월 9일 : 최초 공개.

[[분류:조선 군현도로 GIS 경기]]

조선 군현도로 GIS

2026-06-09T07:56:09Z

Yachagye: /* 구축 군현 */

조선 군현도로 GIS는 1910년대 한반도 1:5만 지형도(3차지형도)에서 직접 디지타이징한 군현 단위 도로 네트워크를 기반으로, 사료에 기록된 거리 정보에 부합하는 조선시대 역사적 경로를 재현·복원하는 GIS 데이터 시리즈이다. 도로 네트워크에 NetworkX 기반 '목표값 근접 경로 분석' 모델을 적용하여 산출한 결과물을 군현 단위로 배포한다. 분석 스크립트는 GitHub 저장소에, GIS 데이터는 본 위키에 함께 공개되어, 상용 GIS 소프트웨어 없이 Python 오픈소스 환경만으로 분석을 그대로 재현할 수 있다. 군현별 데이터와 사례는 하위 문서에서 다룬다.

== DB 설명 ==
* 1910년대 한반도 1:5만 지형도(3차지형도)의 도로 정보를 직접 디지타이징하여 구축한 군현 단위 도로 네트워크를 기반으로, 조선시대 개별 군현의 도로 체계와 역사적 이동 경로를 재현하기 위해 산출한 분석 결과 데이터이다.
* 도로 데이터의 범위는 3차지형도의 1·2등 도로, 달로, 간로, 연로 및 소로까지 포함하여, 군현 내부의 세부 이동 경로를 재현할 수 있도록 구성하였다.
* 도로 라인에는 Tobler(1993)·Kondo–Seino(2010) 보행 속도 함수와 ACSM 에너지 소비 공식을 적용하여, 세그먼트마다 표면거리·보행시간·보행 중 에너지 소비량의 방향 비대칭 비용을 부여하였다.
* 활용 모델은 경로 분석의 목적함수를 '비용 최소화(min f)'에서 '목표값 근접(min|f − T|)'으로 전환한 모델이다. 이는 조선시대 사료에 기재된 거리(예: "○○까지 ○○리")에 부합하는 경로를 직접 탐색하기 위한 것으로, 최단·최소 비용 경로만으로는 포착되지 않는 역사적 경로를 복원하는 데 목적이 있다.
* 분석 그래프는 NetworkX 방향 그래프(DiGraph)로 변환되며, 좌표계는 EPSG:5179, degree-2 체인 축약을 적용한다.

== 활용 모델: 목표값 근접 경로 분석 ==

=== 개요 ===
도로 네트워크를 방향 그래프로 변환한 뒤, 사료에 기록된 거리·시간 정보를 목표값(T)으로 설정하여 그에 가장 가까운 경로를 탐색하는 분석 모델이다. 일반적인 최단·최소 비용 경로 분석이 목적함수를 비용 최소화(min f)로 두는 데 비해, 본 모델은 목적함수를 목표값 근접(min|f − T|)으로 전환한다.

비용 속성은 표면거리(length_3dkm), 보행시간(Kondo–Seino, Tobler), 에너지 소비량(Kondo–Seino, Tobler)의 5종 임피던스를 사용하며, 정방향·역방향을 구분한 방향 비대칭 비용을 반영한다.

=== 분석 그래프 구축 ===
* GeoPackage 도로 라인을 NetworkX 방향 그래프(DiGraph)로 변환한다. 좌표계는 EPSG:5179.
* degree-2 체인 축약(contract_degree2)을 적용하여, 분기점이 아닌 중간 노드를 제거하고 인접 간선을 병합한다. 비용은 합산, geometry는 연결되며, 축약 전후의 경로 비용은 수학적으로 동일하다.
* 축약 간선에는 원본 노드 순서열(chain_nodes)과 구간별 비용(chain_costs)을 저장하여, 좌표 스냅 시 정확한 선형 보간과 분할이 가능하도록 한다.
* 입력 좌표(EPSG:4326)는 최근접 간선에 투영하여 그래프에 스냅하며, 분석 완료 후 임시 노드를 복원하여 동일 그래프를 여러 분석에 재사용한다.

=== 분석 유형 ===
* '''포인트-포인트 분석''' : 기점·종점(및 경유지)이 모두 점으로 지정된 경로를 산출한다. 각 임피던스별 최소 비용 경로와 목표값 근접 경로를 함께 출력한다.
* '''포인트-폴리곤 분석''' : 출발점에서 목적 폴리곤(읍치 사방경계 등)에 도달하는 경로를 산출한다. 폴리곤 경계와 교차하는 간선의 진입 지점을 목적지 후보 노드로 설정하고, 그중 목표값에 근접하는 경로를 선택한다. 읍치의 사방경계 기록("동으로 ○○리에 이르러 ○○ 경계")을 반영하기 위한 분석이다.

=== 입력 형식 ===
* '''지점 간 분석''' : 경로별 기점·경유지·종점 좌표와 목표값을 CSV로 입력한다. 좌표는 경위도(EPSG:4326)이며, 첫 좌표쌍이 기점, 마지막 좌표쌍이 종점, 중간 좌표쌍은 경유지이다. 목표값은 마지막 두 컬럼(거리는 km_beg·km_end, 시간은 hr_beg·hr_end)에 입력하며, 끝값을 비우면 단일 목표값으로, 두 값을 모두 채우면 목표 구간으로 처리된다.
* '''지점-경계 분석''' : 출발점 목록 CSV와 목적지 군현 경계 폴리곤 GPKG를 입력하며, 양자는 route_id로 매칭된다. 종점은 CSV에 정의하지 않고 폴리곤 경계 노드 탐색으로 결정된다.
* '''장애물(선택)''' : 선(Line) 또는 면(Polygon) 형식의 GPKG를 입력하면, 해당 영역과 교차하는 간선을 제거한 사본 그래프가 생성되어 특정 구간을 경로 탐색에서 배제한다.

=== 분석 파이프라인 ===
전체 파이프라인은 그래프 변환, 경로 분석, 후속 분석의 3단계로 운영된다. 각 단계의 입력·출력은 다음과 같다.

{| class="wikitable"
! 단계 !! 기능 !! 입력 !! 출력
|-
| 1 || 네트워크 그래프 변환 || 네트워크 GPKG || 그래프 캐시(pkl)
|-
| 2 || 기본 경로 분석(지점 간 / 지점-경계) || pkl + CSV + (장애물) || 경로 GPKG (6 레이어)
|-
| 2 || 순위 분석 || 〃 || 순위 GPKG (1 레이어)
|-
| 2 || 편차범위 분석 || 〃 || 편차범위 GPKG (1 레이어)
|-
| 3 || 경로 간 유사도 분석 || pkl + 경로 GPKG || 유사도 CSV
|-
| 3 || 순위·편차범위 경로 유사도 || pkl + 순위/편차범위 GPKG || 유사도 CSV + 필터 GPKG
|-
| 3 || 레이어 간 경로 구성 비교 || pkl + 타겟·비교 GPKG || 요약 CSV + 매칭 CSV
|}

1단계에서 네트워크 데이터셋을 방향 그래프 캐시로 변환하면, 네트워크가 바뀌지 않는 한 이후 모든 분석에서 재사용된다. 2단계에서는 기본·순위·편차범위 분석 중 목적에 맞는 것을 실행하며, 분석 유형(거리/시간)과 장애물 적용 여부를 실행 시점에 선택한다. 3단계에서는 2단계 출력물을 입력으로 경로 간 유사도 또는 레이어 간 구성 비교를 수행한다.

=== 파생 분석 ===
* '''순위 분석''' : 목표값 근접도 상위 N개 경로를 모두 산출하여, rank 1 경로가 유일한 대안인지 복수의 대안이 존재하는지를 판별한다.
* '''편차범위 분석''' : 사료의 거리 기록에 내재한 불확실성(±5리 ≈ 2.25 km)을 명시적으로 반영하여, 목표값 ±margin 범위 내의 경로만 산출한다.
* '''경로 간 유사도 분석''' : 두 경로의 간선 집합에 대한 길이 가중 Jaccard 유사도를 산출하여, 재현 경로가 어떤 성격의 이동(거리·시간·에너지 최소, 군현 영역 제한 여부)에 가장 가까운지를 정량화한다.

=== 관련 도구 ===
* Python (NetworkX, GeoPandas, Shapely, pyproj, rasterio)
* ArcGIS Pro / QGIS

== 필드 설계 ==

=== 네트워크 데이터셋 필드 ===
도로 라인의 비용지표 필드 설계(필드명·단위·정의 및 DEM 기반 표면거리·보행 속도 함수·에너지 소비 모델의 산출 방법)는 [[근대_교통로_DB|근대 교통로 DB]] 항목과 동일하므로, 구체적인 내용은 해당 항목을 참조한다. 본 분석 모델에서는 그래프 변환 시 정방향(f)·역방향(b) 필드를 읽어 방향별 간선에 매핑하며, 간선 비용 속성은 length_3dkm, hour_ks, hour_tob, kcal_ks, kcal_tob의 5종 임피던스로 구성된다.

=== 경로 분석 결과 필드 ===
경로 분석 결과 레이어의 주요 속성은 다음과 같다.

{| class="wikitable"
! 필드명 !! 단위 !! 정의
|-
| route_id || — || 경로 식별자
|-
| weight_attr || — || 선택된 임피던스 필드명(length_3dkm / hour_ks / hour_tob 등)
|-
| target_km / target_hr || km / hour || 사용자 입력 목표값(거리 또는 시간)
|-
| metric_val || km / hour / kcal || 선택 임피던스의 누적 비용
|-
| abs_diff || km / hour || 누적 비용과 목표값의 차이(metric_val − target)
|-
| length_km || km || 경로 전체 3D 표면거리
|-
| hour_ks / hour_tob || hour || Kondo–Seino / Tobler 총 보행시간(방향 비대칭 반영)
|-
| kcal_ks / kcal_tob || kcal || Kondo–Seino / Tobler 총 에너지 소비량(방향 비대칭 반영)
|-
| candidate_n || 개 || 탐색된 후보 경로 수(탐색 규모 지표)
|-
| legs_n || 개 || 경로 구간(leg) 수
|-
| rank || — || (순위·편차범위 레이어) 목표값 근접도 순위. 1 = 최근접
|-
| margin || km / hour || (편차범위 레이어) 적용된 편차범위
|-
| snap_m_start / snap_m_end || m || 기점·종점의 최근접 간선 스냅 거리(데이터 정합성 지표)
|}

== 분석 스크립트 ==
경로 분석에 사용한 스크립트는 GitHub 저장소에 공개되어 있다. 본 위키에서 내려받은 GIS 데이터와 함께 사용하면 분석을 그대로 재현할 수 있다. 스크립트의 구성과 실행 방법은 저장소를 참조한다.

* 저장소 : https://github.com/yachagye/target-approximating-path-analysis

== 자료 공개 ==
* DB 설계 : 양정현
* 비영리적 활동(논문, 연구서)에 본 자료 사용 시, 인용 문구만 표시하면 사용에 제한 없음.
* 영리적인 목적(프로젝트)으로 사용할 경우에는 관계자(yachagye@naver.com)와 상의 후 처리.
* 본 자료 전체를 다른 곳에서 서비스하는 것은 제한함.
* 본 DB에 오류가 발견된 경우, yachagye@naver.com에 오류 신고.
* 인용 표기 : 조선 군현도로 GIS(○○ 군현), 연·월 기준, 양정현, 역지사지(https://www.hisgeo.info). 구체 표기는 각 군현 문서를 참조.

== 구축 군현 ==
{| class="wikitable"
! 도 !! 군현 !! 시기 구분 !! 문서
|-
| 경기 || 광주(廣州) || 1626년 읍치 이동 전후 || [[경기_광주_군현도로_GIS|경기 광주 군현도로 GIS]]
|}

이후 군현을 추가할 때마다 위 표에 행을 추가하고, 해당 군현 문서에 분류:(도명)을 부여한다.

== 참고 문헌 ==
* 양정현, 2023, HGIS를 통해 본 조선 전기 양주의 도로 체계와 역사적 경로 재현 - 양주 회암사의 사례를 중심으로, 남도문화연구 50.
* 양정현, 2024, 조선시대 도로 네트워크 분석 방법론과 사례 연구 - 양주의 사례를 중심으로, 문화역사지리 36-3.
* 양정현, 2025, '신출귀몰'의 재구성 - 역사 연구와 GIS가 연결되는 한 방식, 역사비평 153.
* 양정현, 2026, 역사 GIS를 위한 목표값 근접 경로 분석 모델의 설계와 적용 - 조선시대 경기 광주의 사례를 중심으로, 조선시대사학보 117.
* Tobler, W. (1993). Three presentations on geographical analysis and modeling. Technical Report 93-1. National Center for Geographic Information and Analysis, University of California, Santa Barbara.
* Kondo, Y., & Seino, Y. (2010). GPS-aided walking experiments and data-driven travel cost modeling on the historical road of Nakasendō-Kisoji (Central Highland Japan). In B. Frischer (Ed.), Making history interactive: CAA. Proceedings of the 37th international conference (pp. 158-165). Archaeopress.

[[분류:조선 군현도로 GIS]]

조선 군현도로 GIS

2026-06-09T07:55:27Z

Yachagye:

조선 군현도로 GIS는 1910년대 한반도 1:5만 지형도(3차지형도)에서 직접 디지타이징한 군현 단위 도로 네트워크를 기반으로, 사료에 기록된 거리 정보에 부합하는 조선시대 역사적 경로를 재현·복원하는 GIS 데이터 시리즈이다. 도로 네트워크에 NetworkX 기반 '목표값 근접 경로 분석' 모델을 적용하여 산출한 결과물을 군현 단위로 배포한다. 분석 스크립트는 GitHub 저장소에, GIS 데이터는 본 위키에 함께 공개되어, 상용 GIS 소프트웨어 없이 Python 오픈소스 환경만으로 분석을 그대로 재현할 수 있다. 군현별 데이터와 사례는 하위 문서에서 다룬다.

== DB 설명 ==
* 1910년대 한반도 1:5만 지형도(3차지형도)의 도로 정보를 직접 디지타이징하여 구축한 군현 단위 도로 네트워크를 기반으로, 조선시대 개별 군현의 도로 체계와 역사적 이동 경로를 재현하기 위해 산출한 분석 결과 데이터이다.
* 도로 데이터의 범위는 3차지형도의 1·2등 도로, 달로, 간로, 연로 및 소로까지 포함하여, 군현 내부의 세부 이동 경로를 재현할 수 있도록 구성하였다.
* 도로 라인에는 Tobler(1993)·Kondo–Seino(2010) 보행 속도 함수와 ACSM 에너지 소비 공식을 적용하여, 세그먼트마다 표면거리·보행시간·보행 중 에너지 소비량의 방향 비대칭 비용을 부여하였다.
* 활용 모델은 경로 분석의 목적함수를 '비용 최소화(min f)'에서 '목표값 근접(min|f − T|)'으로 전환한 모델이다. 이는 조선시대 사료에 기재된 거리(예: "○○까지 ○○리")에 부합하는 경로를 직접 탐색하기 위한 것으로, 최단·최소 비용 경로만으로는 포착되지 않는 역사적 경로를 복원하는 데 목적이 있다.
* 분석 그래프는 NetworkX 방향 그래프(DiGraph)로 변환되며, 좌표계는 EPSG:5179, degree-2 체인 축약을 적용한다.

== 활용 모델: 목표값 근접 경로 분석 ==

=== 개요 ===
도로 네트워크를 방향 그래프로 변환한 뒤, 사료에 기록된 거리·시간 정보를 목표값(T)으로 설정하여 그에 가장 가까운 경로를 탐색하는 분석 모델이다. 일반적인 최단·최소 비용 경로 분석이 목적함수를 비용 최소화(min f)로 두는 데 비해, 본 모델은 목적함수를 목표값 근접(min|f − T|)으로 전환한다.

비용 속성은 표면거리(length_3dkm), 보행시간(Kondo–Seino, Tobler), 에너지 소비량(Kondo–Seino, Tobler)의 5종 임피던스를 사용하며, 정방향·역방향을 구분한 방향 비대칭 비용을 반영한다.

=== 분석 그래프 구축 ===
* GeoPackage 도로 라인을 NetworkX 방향 그래프(DiGraph)로 변환한다. 좌표계는 EPSG:5179.
* degree-2 체인 축약(contract_degree2)을 적용하여, 분기점이 아닌 중간 노드를 제거하고 인접 간선을 병합한다. 비용은 합산, geometry는 연결되며, 축약 전후의 경로 비용은 수학적으로 동일하다.
* 축약 간선에는 원본 노드 순서열(chain_nodes)과 구간별 비용(chain_costs)을 저장하여, 좌표 스냅 시 정확한 선형 보간과 분할이 가능하도록 한다.
* 입력 좌표(EPSG:4326)는 최근접 간선에 투영하여 그래프에 스냅하며, 분석 완료 후 임시 노드를 복원하여 동일 그래프를 여러 분석에 재사용한다.

=== 분석 유형 ===
* '''포인트-포인트 분석''' : 기점·종점(및 경유지)이 모두 점으로 지정된 경로를 산출한다. 각 임피던스별 최소 비용 경로와 목표값 근접 경로를 함께 출력한다.
* '''포인트-폴리곤 분석''' : 출발점에서 목적 폴리곤(읍치 사방경계 등)에 도달하는 경로를 산출한다. 폴리곤 경계와 교차하는 간선의 진입 지점을 목적지 후보 노드로 설정하고, 그중 목표값에 근접하는 경로를 선택한다. 읍치의 사방경계 기록("동으로 ○○리에 이르러 ○○ 경계")을 반영하기 위한 분석이다.

=== 입력 형식 ===
* '''지점 간 분석''' : 경로별 기점·경유지·종점 좌표와 목표값을 CSV로 입력한다. 좌표는 경위도(EPSG:4326)이며, 첫 좌표쌍이 기점, 마지막 좌표쌍이 종점, 중간 좌표쌍은 경유지이다. 목표값은 마지막 두 컬럼(거리는 km_beg·km_end, 시간은 hr_beg·hr_end)에 입력하며, 끝값을 비우면 단일 목표값으로, 두 값을 모두 채우면 목표 구간으로 처리된다.
* '''지점-경계 분석''' : 출발점 목록 CSV와 목적지 군현 경계 폴리곤 GPKG를 입력하며, 양자는 route_id로 매칭된다. 종점은 CSV에 정의하지 않고 폴리곤 경계 노드 탐색으로 결정된다.
* '''장애물(선택)''' : 선(Line) 또는 면(Polygon) 형식의 GPKG를 입력하면, 해당 영역과 교차하는 간선을 제거한 사본 그래프가 생성되어 특정 구간을 경로 탐색에서 배제한다.

=== 분석 파이프라인 ===
전체 파이프라인은 그래프 변환, 경로 분석, 후속 분석의 3단계로 운영된다. 각 단계의 입력·출력은 다음과 같다.

{| class="wikitable"
! 단계 !! 기능 !! 입력 !! 출력
|-
| 1 || 네트워크 그래프 변환 || 네트워크 GPKG || 그래프 캐시(pkl)
|-
| 2 || 기본 경로 분석(지점 간 / 지점-경계) || pkl + CSV + (장애물) || 경로 GPKG (6 레이어)
|-
| 2 || 순위 분석 || 〃 || 순위 GPKG (1 레이어)
|-
| 2 || 편차범위 분석 || 〃 || 편차범위 GPKG (1 레이어)
|-
| 3 || 경로 간 유사도 분석 || pkl + 경로 GPKG || 유사도 CSV
|-
| 3 || 순위·편차범위 경로 유사도 || pkl + 순위/편차범위 GPKG || 유사도 CSV + 필터 GPKG
|-
| 3 || 레이어 간 경로 구성 비교 || pkl + 타겟·비교 GPKG || 요약 CSV + 매칭 CSV
|}

1단계에서 네트워크 데이터셋을 방향 그래프 캐시로 변환하면, 네트워크가 바뀌지 않는 한 이후 모든 분석에서 재사용된다. 2단계에서는 기본·순위·편차범위 분석 중 목적에 맞는 것을 실행하며, 분석 유형(거리/시간)과 장애물 적용 여부를 실행 시점에 선택한다. 3단계에서는 2단계 출력물을 입력으로 경로 간 유사도 또는 레이어 간 구성 비교를 수행한다.

=== 파생 분석 ===
* '''순위 분석''' : 목표값 근접도 상위 N개 경로를 모두 산출하여, rank 1 경로가 유일한 대안인지 복수의 대안이 존재하는지를 판별한다.
* '''편차범위 분석''' : 사료의 거리 기록에 내재한 불확실성(±5리 ≈ 2.25 km)을 명시적으로 반영하여, 목표값 ±margin 범위 내의 경로만 산출한다.
* '''경로 간 유사도 분석''' : 두 경로의 간선 집합에 대한 길이 가중 Jaccard 유사도를 산출하여, 재현 경로가 어떤 성격의 이동(거리·시간·에너지 최소, 군현 영역 제한 여부)에 가장 가까운지를 정량화한다.

=== 관련 도구 ===
* Python (NetworkX, GeoPandas, Shapely, pyproj, rasterio)
* ArcGIS Pro / QGIS

== 필드 설계 ==

=== 네트워크 데이터셋 필드 ===
도로 라인의 비용지표 필드 설계(필드명·단위·정의 및 DEM 기반 표면거리·보행 속도 함수·에너지 소비 모델의 산출 방법)는 [[근대_교통로_DB|근대 교통로 DB]] 항목과 동일하므로, 구체적인 내용은 해당 항목을 참조한다. 본 분석 모델에서는 그래프 변환 시 정방향(f)·역방향(b) 필드를 읽어 방향별 간선에 매핑하며, 간선 비용 속성은 length_3dkm, hour_ks, hour_tob, kcal_ks, kcal_tob의 5종 임피던스로 구성된다.

=== 경로 분석 결과 필드 ===
경로 분석 결과 레이어의 주요 속성은 다음과 같다.

{| class="wikitable"
! 필드명 !! 단위 !! 정의
|-
| route_id || — || 경로 식별자
|-
| weight_attr || — || 선택된 임피던스 필드명(length_3dkm / hour_ks / hour_tob 등)
|-
| target_km / target_hr || km / hour || 사용자 입력 목표값(거리 또는 시간)
|-
| metric_val || km / hour / kcal || 선택 임피던스의 누적 비용
|-
| abs_diff || km / hour || 누적 비용과 목표값의 차이(metric_val − target)
|-
| length_km || km || 경로 전체 3D 표면거리
|-
| hour_ks / hour_tob || hour || Kondo–Seino / Tobler 총 보행시간(방향 비대칭 반영)
|-
| kcal_ks / kcal_tob || kcal || Kondo–Seino / Tobler 총 에너지 소비량(방향 비대칭 반영)
|-
| candidate_n || 개 || 탐색된 후보 경로 수(탐색 규모 지표)
|-
| legs_n || 개 || 경로 구간(leg) 수
|-
| rank || — || (순위·편차범위 레이어) 목표값 근접도 순위. 1 = 최근접
|-
| margin || km / hour || (편차범위 레이어) 적용된 편차범위
|-
| snap_m_start / snap_m_end || m || 기점·종점의 최근접 간선 스냅 거리(데이터 정합성 지표)
|}

== 분석 스크립트 ==
경로 분석에 사용한 스크립트는 GitHub 저장소에 공개되어 있다. 본 위키에서 내려받은 GIS 데이터와 함께 사용하면 분석을 그대로 재현할 수 있다. 스크립트의 구성과 실행 방법은 저장소를 참조한다.

* 저장소 : https://github.com/yachagye/target-approximating-path-analysis

== 자료 공개 ==
* DB 설계 : 양정현
* 비영리적 활동(논문, 연구서)에 본 자료 사용 시, 인용 문구만 표시하면 사용에 제한 없음.
* 영리적인 목적(프로젝트)으로 사용할 경우에는 관계자(yachagye@naver.com)와 상의 후 처리.
* 본 자료 전체를 다른 곳에서 서비스하는 것은 제한함.
* 본 DB에 오류가 발견된 경우, yachagye@naver.com에 오류 신고.
* 인용 표기 : 조선 군현도로 GIS(○○ 군현), 연·월 기준, 양정현, 역지사지(https://www.hisgeo.info). 구체 표기는 각 군현 문서를 참조.

== 구축 군현 ==
{| class="wikitable"
! 도 !! 군현 !! 시기 구분 !! 문서
|-
| 경기 || 광주(廣州) || 1626년 읍치 이전 전후 || [[경기_광주_군현도로_GIS|경기 광주 군현도로 GIS]]
|}

이후 군현을 추가할 때마다 위 표에 행을 추가하고, 해당 군현 문서에 분류:(도명)을 부여한다.

== 참고 문헌 ==
* 양정현, 2023, HGIS를 통해 본 조선 전기 양주의 도로 체계와 역사적 경로 재현 - 양주 회암사의 사례를 중심으로, 남도문화연구 50.
* 양정현, 2024, 조선시대 도로 네트워크 분석 방법론과 사례 연구 - 양주의 사례를 중심으로, 문화역사지리 36-3.
* 양정현, 2025, '신출귀몰'의 재구성 - 역사 연구와 GIS가 연결되는 한 방식, 역사비평 153.
* 양정현, 2026, 역사 GIS를 위한 목표값 근접 경로 분석 모델의 설계와 적용 - 조선시대 경기 광주의 사례를 중심으로, 조선시대사학보 117.
* Tobler, W. (1993). Three presentations on geographical analysis and modeling. Technical Report 93-1. National Center for Geographic Information and Analysis, University of California, Santa Barbara.
* Kondo, Y., & Seino, Y. (2010). GPS-aided walking experiments and data-driven travel cost modeling on the historical road of Nakasendō-Kisoji (Central Highland Japan). In B. Frischer (Ed.), Making history interactive: CAA. Proceedings of the 37th international conference (pp. 158-165). Archaeopress.

[[분류:조선 군현도로 GIS]]

조선 군현도로 GIS

2026-06-09T07:48:44Z

Yachagye: 새 문서: 조선 군현도로 GIS는 1910년대 한반도 1:5만 지형도(3차지형도)에서 직접 디지타이징한 군현 단위 도로 네트워크를 기반으로, 사료에 기록된 거리·방향 정보에 부합하는 조선시대 역사적 경로를 재현·복원하는 GIS 데이터 시리즈이다. 도로망은 간선도로뿐 아니라 소로(小路)까지 포함하며, 여기에 NetworkX 기반 '목표값 근접 경로 분석' 모델을 적용하여 산출한 결과물...

조선 군현도로 GIS는 1910년대 한반도 1:5만 지형도(3차지형도)에서 직접 디지타이징한 군현 단위 도로 네트워크를 기반으로, 사료에 기록된 거리·방향 정보에 부합하는 조선시대 역사적 경로를 재현·복원하는 GIS 데이터 시리즈이다. 도로망은 간선도로뿐 아니라 소로(小路)까지 포함하며, 여기에 NetworkX 기반 '목표값 근접 경로 분석' 모델을 적용하여 산출한 결과물을 군현 단위로 배포한다. 분석 스크립트는 GitHub 저장소에, GIS 데이터는 본 위키에 함께 공개되어, 상용 GIS 소프트웨어 없이 Python 오픈소스 환경만으로 분석을 그대로 재현할 수 있다. 군현별 데이터와 사례는 하위 문서에서 다룬다.

== DB 설명 ==
* 1910년대 한반도 1:5만 지형도(3차지형도)의 도로 정보를 직접 디지타이징하여 구축한 군현 단위 도로 네트워크를 기반으로, 조선시대 개별 군현의 도로 체계와 역사적 이동 경로를 재현하기 위해 구축한 분석 결과 데이터이다.
* 도로 데이터의 범위는 3차지형도의 1·2등 도로, 달로, 간로, 연로 및 소로까지를 포함하여, 군현 내부의 세부 이동 경로를 재현할 수 있도록 구성하였다.
* 도로 라인에는 Tobler(1993)·Kondo–Seino(2010) 보행 속도 함수와 ACSM 에너지 소비 공식을 적용하여, 세그먼트마다 표면거리·보행시간·보행 중 에너지 소비량의 방향 비대칭 비용을 부여하였다.
* 활용 모델은 경로 분석의 목적함수를 '비용 최소화(min f)'에서 '목표값 근접(min|f − T|)'으로 전환한 모델이다. 이는 조선시대 사료에 기재된 거리(예: "○○까지 ○○리")에 부합하는 경로를 직접 탐색하기 위한 것으로, 최단·최소 비용 경로만으로는 포착되지 않는 역사적 경로를 복원하는 데 목적이 있다.
* 분석 그래프는 NetworkX 방향 그래프(DiGraph)로 변환되며, 좌표계는 EPSG:5179, degree-2 체인 축약을 적용한다.

== 활용 모델: 목표값 근접 경로 분석 ==

=== 개요 ===
도로 네트워크를 방향 그래프로 변환한 뒤, 사료에 기록된 거리·시간 정보를 목표값(T)으로 설정하여 그에 가장 가까운 경로를 탐색하는 분석 모델이다. 일반적인 최단·최소 비용 경로 분석이 목적함수를 비용 최소화(min f)로 두는 데 비해, 본 모델은 목적함수를 목표값 근접(min|f − T|)으로 전환한다.

비용 속성은 표면거리(length_3dkm), 보행시간(Kondo–Seino, Tobler), 에너지 소비량(Kondo–Seino, Tobler)의 5종 임피던스를 사용하며, 정방향·역방향을 구분한 방향 비대칭 비용을 반영한다.

=== 분석 그래프 구축 ===
* GeoPackage 도로 라인을 NetworkX 방향 그래프(DiGraph)로 변환한다. 좌표계는 EPSG:5179.
* degree-2 체인 축약(contract_degree2)을 적용하여, 분기점이 아닌 중간 노드를 제거하고 인접 간선을 병합한다. 비용은 합산, geometry는 연결되며, 축약 전후의 경로 비용은 수학적으로 동일하다.
* 축약 간선에는 원본 노드 순서열(chain_nodes)과 구간별 비용(chain_costs)을 저장하여, 좌표 스냅 시 정확한 선형 보간과 분할이 가능하도록 한다.
* 입력 좌표(EPSG:4326)는 최근접 간선에 투영하여 그래프에 스냅하며, 분석 완료 후 임시 노드를 복원하여 동일 그래프를 여러 분석에 재사용한다.

=== 분석 유형 ===
* '''포인트-포인트 분석''' : 기점·종점(및 경유지)이 모두 점으로 지정된 경로를 산출한다. 각 임피던스별 최소 비용 경로와 목표값 근접 경로를 함께 출력한다.
* '''포인트-폴리곤 분석''' : 출발점에서 목적 폴리곤(읍치 사방경계 등)에 도달하는 경로를 산출한다. 폴리곤 경계와 교차하는 간선의 진입 지점을 목적지 후보 노드로 설정하고, 그중 목표값에 근접하는 경로를 선택한다. 읍치의 사방경계 기록("동으로 ○○리에 이르러 ○○ 경계")을 반영하기 위한 분석이다.

=== 입력 형식 ===
* '''지점 간 분석''' : 경로별 기점·경유지·종점 좌표와 목표값을 CSV로 입력한다. 좌표는 경위도(EPSG:4326)이며, 첫 좌표쌍이 기점, 마지막 좌표쌍이 종점, 중간 좌표쌍은 경유지이다. 목표값은 마지막 두 컬럼(거리는 km_beg·km_end, 시간은 hr_beg·hr_end)에 입력하며, 끝값을 비우면 단일 목표값으로, 두 값을 모두 채우면 목표 구간으로 처리된다.
* '''지점-경계 분석''' : 출발점 목록 CSV와 목적지 군현 경계 폴리곤 GPKG를 입력하며, 양자는 route_id로 매칭된다. 종점은 CSV에 정의하지 않고 폴리곤 경계 노드 탐색으로 결정된다.
* '''장애물(선택)''' : 선(Line) 또는 면(Polygon) 형식의 GPKG를 입력하면, 해당 영역과 교차하는 간선을 제거한 사본 그래프가 생성되어 특정 구간을 경로 탐색에서 배제한다.

=== 분석 파이프라인 ===
전체 파이프라인은 그래프 변환, 경로 분석, 후속 분석의 3단계로 운영된다. 각 단계의 입력·출력은 다음과 같다.

{| class="wikitable"
! 단계 !! 기능 !! 입력 !! 출력
|-
| 1 || 네트워크 그래프 변환 || 네트워크 GPKG || 그래프 캐시(pkl)
|-
| 2 || 기본 경로 분석(지점 간 / 지점-경계) || pkl + CSV + (장애물) || 경로 GPKG (6 레이어)
|-
| 2 || 순위 분석 || 〃 || 순위 GPKG (1 레이어)
|-
| 2 || 편차범위 분석 || 〃 || 편차범위 GPKG (1 레이어)
|-
| 3 || 경로 간 유사도 분석 || pkl + 경로 GPKG || 유사도 CSV
|-
| 3 || 순위·편차범위 경로 유사도 || pkl + 순위/편차범위 GPKG || 유사도 CSV + 필터 GPKG
|-
| 3 || 레이어 간 경로 구성 비교 || pkl + 타겟·비교 GPKG || 요약 CSV + 매칭 CSV
|}

1단계에서 네트워크 데이터셋을 방향 그래프 캐시로 변환하면, 네트워크가 바뀌지 않는 한 이후 모든 분석에서 재사용된다. 2단계에서는 기본·순위·편차범위 분석 중 목적에 맞는 것을 실행하며, 분석 유형(거리/시간)과 장애물 적용 여부를 실행 시점에 선택한다. 3단계에서는 2단계 출력물을 입력으로 경로 간 유사도 또는 레이어 간 구성 비교를 수행한다.

=== 파생 분석 ===
* '''순위 분석''' : 목표값 근접도 상위 N개 경로를 모두 산출하여, rank 1 경로가 유일한 대안인지 복수의 대안이 존재하는지를 판별한다.
* '''편차범위 분석''' : 사료의 거리 기록에 내재한 불확실성(±5리 ≈ 2.25 km)을 명시적으로 반영하여, 목표값 ±margin 범위 내의 경로만 산출한다.
* '''경로 간 유사도 분석''' : 두 경로의 간선 집합에 대한 길이 가중 Jaccard 유사도를 산출하여, 재현 경로가 어떤 성격의 이동(거리·시간·에너지 최소, 군현 영역 제한 여부)에 가장 가까운지를 정량화한다.

=== 관련 도구 ===
* Python (NetworkX, GeoPandas, Shapely, pyproj, rasterio)
* ArcGIS Pro / QGIS

== 필드 설계 ==

=== 네트워크 데이터셋 필드 ===
도로 라인의 비용지표 필드 설계(필드명·단위·정의 및 DEM 기반 표면거리·보행 속도 함수·에너지 소비 모델의 산출 방법)는 [[근대_교통로_DB|근대 교통로 DB]] 항목과 동일하므로, 구체적인 내용은 해당 항목을 참조한다. 본 분석 모델에서는 그래프 변환 시 정방향(f)·역방향(b) 필드를 읽어 방향별 간선에 매핑하며, 간선 비용 속성은 length_3dkm, hour_ks, hour_tob, kcal_ks, kcal_tob의 5종 임피던스로 구성된다.

=== 경로 분석 결과 필드 ===
경로 분석 결과 레이어의 주요 속성은 다음과 같다.

{| class="wikitable"
! 필드명 !! 단위 !! 정의
|-
| route_id || — || 경로 식별자
|-
| weight_attr || — || 선택된 임피던스 필드명(length_3dkm / hour_ks / hour_tob 등)
|-
| target_km / target_hr || km / hour || 사용자 입력 목표값(거리 또는 시간)
|-
| metric_val || km / hour / kcal || 선택 임피던스의 누적 비용
|-
| abs_diff || km / hour || 누적 비용과 목표값의 차이(metric_val − target)
|-
| length_km || km || 경로 전체 3D 표면거리
|-
| hour_ks / hour_tob || hour || Kondo–Seino / Tobler 총 보행시간(방향 비대칭 반영)
|-
| kcal_ks / kcal_tob || kcal || Kondo–Seino / Tobler 총 에너지 소비량(방향 비대칭 반영)
|-
| candidate_n || 개 || 탐색된 후보 경로 수(탐색 규모 지표)
|-
| legs_n || 개 || 경로 구간(leg) 수
|-
| rank || — || (순위·편차범위 레이어) 목표값 근접도 순위. 1 = 최근접
|-
| margin || km / hour || (편차범위 레이어) 적용된 편차범위
|-
| snap_m_start / snap_m_end || m || 기점·종점의 최근접 간선 스냅 거리(데이터 정합성 지표)
|}

== 분석 스크립트 ==
경로 분석에 사용한 스크립트는 GitHub 저장소에 공개되어 있다. 본 위키에서 내려받은 GIS 데이터와 함께 사용하면 분석을 그대로 재현할 수 있다. 스크립트의 구성과 실행 방법은 저장소를 참조한다.

* 저장소 : https://github.com/yachagye/target-approximating-path-analysis

== 자료 공개 ==
* DB 설계 : 양정현
* 비영리적 활동(논문, 연구서)에 본 자료 사용 시, 인용 문구만 표시하면 사용에 제한 없음.
* 영리적인 목적(프로젝트)으로 사용할 경우에는 관계자(yachagye@naver.com)와 상의 후 처리.
* 본 자료 전체를 다른 곳에서 서비스하는 것은 제한함.
* 본 DB에 오류가 발견된 경우, yachagye@naver.com에 오류 신고.
* 인용 표기 : 조선 군현도로 GIS(○○ 군현), 연·월 기준, 양정현, 역지사지(https://www.hisgeo.info). 구체 표기는 각 군현 문서를 참조.

== 구축 군현 ==
{| class="wikitable"
! 도 !! 군현 !! 시기 구분 !! 문서
|-
| 경기 || 광주(廣州) || 1626년 읍치 이전 전후 || [[경기_광주_군현도로_GIS|경기 광주 군현도로 GIS]]
|}

이후 군현을 추가할 때마다 위 표에 행을 추가하고, 해당 군현 문서에 분류:(도명)을 부여한다.

== 참고 문헌 ==
* 양정현, 2023, HGIS를 통해 본 조선 전기 양주의 도로 체계와 역사적 경로 재현 - 양주 회암사의 사례를 중심으로, 남도문화연구 50.
* 양정현, 2024, 조선시대 도로 네트워크 분석 방법론과 사례 연구 - 양주의 사례를 중심으로, 문화역사지리 36-3.
* 양정현, 2025, '신출귀몰'의 재구성 - 역사 연구와 GIS가 연결되는 한 방식, 역사비평 153.
* 양정현, 2026, 역사 GIS를 위한 목표값 근접 경로 분석 모델의 설계와 적용 - 조선시대 경기 광주의 사례를 중심으로, 조선시대사학보 117.
* Tobler, W. (1993). Three presentations on geographical analysis and modeling. Technical Report 93-1. National Center for Geographic Information and Analysis, University of California, Santa Barbara.
* Kondo, Y., & Seino, Y. (2010). GPS-aided walking experiments and data-driven travel cost modeling on the historical road of Nakasendō-Kisoji (Central Highland Japan). In B. Frischer (Ed.), Making history interactive: CAA. Proceedings of the 37th international conference (pp. 158-165). Archaeopress.

[[분류:조선 군현도로 GIS]]

양정현

2026-06-09T07:31:48Z

Yachagye: /* 학술논문 */

==개요==
*이름 : 양정현
*소속 : 순천대학교 지리산권문화연구원 학술연구교수
*이메일 : yachagye@naver.com

== 학술논문 ==
[학위논문]
*조선 초기의 驛道 편제와 그 성격, 고려대학교 석사학위논문, 2014[https://dcollection.korea.ac.kr/srch/srchDetail/000000049241]
*조선 전기 驛道制 연구, 고려대학교 박사학위논문, 2021[https://dcollection.korea.ac.kr/srch/srchDetail/000000251662]

[학술논문]
*조선 초기 원경왕후 喪葬禮 의식과 그 특징, 역사민속학 45, 2014[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART001898736]
*조선 초기 驛道制의 정비 과정과 그 성격, 한국사연구 174, 2016[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART002155158]
*조선 『璿源錄』 중종 공주·옹주 계열 후손의 연혼 양상과 그 성격, 고문서연구 52, 2018[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART002323447]
*조선 『璿源錄』을 통해 본 성종 공주·옹주 후손의 혼인 양상과 그 성격, 고문서연구 60, 2022[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART002816615]
*『조선왕조실록』의 차(茶) 관련 정보 열람을 위한 문헌 DB 구축, 2022 한국스마트미디어학회 종합학술대회 논문집 11-1, 2022 (공저)
*공간의 연결 - 15~16세기 조선의 역제(驛制)를 통한 도로 체계의 실현 구조, 한국사연구 198, 2022[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART002886474]
*한국 역사문화 문헌 DB의 구축과 시공간적 통합 모색 - 연대기·지리지 문헌 속 전통 茶 관련 기록을 중심으로, 사총 110, 2023[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003001140]
*한국 차-연대기 문헌 DB 구축 및 웹서비스 구현, 스마트미디어저널 12-9, 2023 (공저)[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003011384]
*HGIS를 통해 본 조선 전기 양주의 도로 체계와 역사적 경로 재현 - 양주 회암사의 사례를 중심으로, 남도문화연구 50, 2023[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003041719]
*재편된 공간 - 조선시대 驛 분포 양상의 추이와 특징, 사학연구 155, 2024[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003128029]
*조선시대 도로 네트워크 분석 방법론과 사례 연구 - 양주의 사례를 중심으로, 문화역사지리 36-3, 2024[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003161965]
*'신출귀몰'의 재구성 - 역사 연구와 GIS가 연결되는 한 방식, 역사비평 153, 2025[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003271672]
*딥러닝 기반 한국 고전한문 표점 추론 자동화 모델의 구축과 활용, 역사학연구 100, 2025[https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART003273177]
*해석의 관습 - 한국 고전한문 전용 표점 추론 모델의 개선, 민족문화연구 111, 2026[]
*역사 GIS를 위한 목표값 근접 경로 분석 모델의 설계와 적용 - 조선시대 경기 광주의 사례를 중심으로, 조선시대사학보 117, 2026[]

==저서==
*조선 전기의 국가 의례와 의주, 민속원, 2015 (공저)
*회암사와 중세사회, 양주시립회암사지박물관, 2023 (공저)
*조선시대 서울의 유교 의례와 음악, 서울역사편찬원, 2024 (공저)
*하남 역사 총서 6, 하남역사박물관, 2024 (공저)
*K-인문 2.0 디지털 인문학의 새로운 주제들, 국립경국대학교 글로컬대학추진단, 2025 (공저)

==코드 및 데이터 공개 저장소==
*https://github.com/yachagye/korean-classical-chinese-punctuation
*https://huggingface.co/yachagye/korean-classical-chinese-punctuation

대문

2026-06-09T05:27:40Z

Yachagye: /* 진행중 */

[[파일:역지사지 로고 2024.png|섬네일|역사지리정보WIKI]]

== 역사지리정보(역지사지) ==
=== 완료 ===
* [[파일:Icon_update.png]][[현대_표석_DB]] : [[최유식]](2026년03월)
* [[파일:Icon_new.png]][[조선_대동여지도_DB]] : [[역지사지]](2026년01월)
* [[파일:Icon_update.png]] [[조선_행정구역_DB]] : [[역지사지]](2026년01월)
** [[파일:Icon_link.png]][[조선시대_행정구역_이력]]
** [[파일:Icon_link.png]][[조선시대_읍치_이력]]
* [[파일:Icon_new.png]][[조선_교통로_DB]] : [[김종혁]], [[김현종]](2026년01월)
* [[파일:Icon_update.png]][[근대_철도_DB]] : [[김종혁]](2026년01월)
* [[파일:Icon_new.png]][[인구경지_민적통계표_DB]] : [[역지사지]](2025년07월)
* [[파일:Icon_update.png]][[조선_호구총수_DB]] : [[역지사지]](2025년04월)
* [[파일:Icon_update.png]][[조선_역_DB]] : [[양정현]](2024년09월)
** [[파일:Icon_link.png]][[조선시대_역_이력]]
** [[파일:Icon_link.png]][[조선시대_역_위치]]

=== 진행중 ===
* [[조선_고지도_통합방안체계_GIS]] : [[김현종]]
* [[조선_고적_DB]] : [[최유식]]
* [[근대_교통로_DB]] : [[양정현]]
* [[조선_군현도로_GIS]]: [[양정현]]
* [[지리지_XML_정규화_개발]] : [[김현종]], [[최경현]]

=== 예정 ===
* [[근대_지형도_DB]] : [[박선영]]
* [[인구경지_호구총수_DB]] : [[역지사지]]
* [[근대_행정구역_1917_전후비교_DB]] : [[김현종]]
* [[조선_고개_DB]] : [[김현종]]

== 역사지리정보(국사편찬위원회) ==
* [https://hgis.history.go.kr/pro_g1/dataset.do 근대_행정구역_DB] : 국사편찬위원회, 역사지리정보DB(2026년02월 기준)
** 행정구역 데이터 (1910~1945년) : xlsx, csv
** 행정구역 변경이력 데이터 (1910~1945년) : xslsx, csv
** 행정구역 GIS 데이터 : geopackage
* [https://hgis.history.go.kr/pro_g1/dataset.do 현대_행정구역_DB] : 국사편찬위원회, 역사지리정보DB(2026년02월 기준)
** 행정구역 데이터 (1955~1975년) : xslsx, csv
** 행정구역 변경이력 데이터 (1955~1975년) : xslsx, csv
** 행정구역 GIS 데이터 : geopacakge
** 행정구역 데이터(1975년) : xlsx, csv
** 행정구역 GIS 데이터(1975년) : geopackage
* [https://hgis.history.go.kr/pro_g1/dataset.do 근대_지형도기호_DB] : 국사편찬위원회, 역사지리정보DB(2026년02월 기준)
** 근대지리정보 심볼 포인트 : geopackage
* [https://hgis.history.go.kr/pro_g1/dataset.do 근대_지형도목록_DB] : 국사편찬위원회, 역사지리정보DB(2026년02월 기준)
** 일제시기 지형도 도엽 목록 : xlsx
* [https://hgis.history.go.kr/pro_g1/dataset.do 현대_지형도목록_DB] : 국사편찬위원회, 역사지리정보DB(2026년02월 기준)
** 1970년대 지형도 도엽 정보 : xlsx
* [https://hgis.history.go.kr/api/intro.do 근대_근대지형도_OpenAPI] : 국사편찬위원회, 역사지리정보DB(2026년02월 기준)
* [https://hgis.history.go.kr/api/intro.do 현대_현대지형도_OpenAPI] : 국사편찬위원회, 역사지리정보DB(2026년02월 기준)

== DB 구축 계획 ==
* [[파일:Icon_new.png]][[역지사지_계획]]

== 역사지리연구 DB ==
* [[파일:Icon_update.png]][[역사GIS_서비스]](2025년10월)
* [[역사GIS_연구자]]
* [[고지도_연구자]]
* [[역사지리정보_문헌]]
** [[파일:Icon_link.png]][[지리지_편목]]
** [[파일:Icon_link.png]][[한국지리_지역구분]]
* [[파일:Icon_update.png]][[역사지리정보_지역]]
** [[충청_당진]]|[[충청_예산]]
** [[충청_아산]]|[[충청_천안]]|[[충청_대전]]
* [[파일:Icon_new.png]][[대동여지도_지리정보]](2025년11월)
** [[대동여지도_경기_광주]]|[[대동여지도_경기_안산]]|[[대동여지도_경기_인천]]|[[대동여지도_경기_수원]]|[[대동여지도_경기_통진]]
** [[대동여지도_충청_결성]]|[[대동여지도_충청_아산]]|[[대동여지도_충청_천안]]|[[대동여지도_충청_회덕]]|[[대동여지도_충청_진잠]]
** [[대동여지도_전라_무안]]|[[대동여지도_전라_전주]]
** [[대동여지도_경상_경주]]|[[대동여지도_경상_동래]]|[[대동여지도_경상_고성]]
** [[대동여지도_평안_정주]]

== 역지사지 회원 ==
* [[김종혁]] : 역사지리, 문화지리, HGIS
* [[박선영]] : 역사지리, 근대지도, HGIS
* [[김현종]] : 역사지리, HGIS, 디지털인문학
* [[양정현]] : 한국사, 역사지리, HGIS, 디지털인문학
* [[최유식]] : 역사지리, HGIS

대문

2026-06-09T05:27:21Z

Yachagye: /* 진행중 */

[[파일:역지사지 로고 2024.png|섬네일|역사지리정보WIKI]]

== 역사지리정보(역지사지) ==
=== 완료 ===
* [[파일:Icon_update.png]][[현대_표석_DB]] : [[최유식]](2026년03월)
* [[파일:Icon_new.png]][[조선_대동여지도_DB]] : [[역지사지]](2026년01월)
* [[파일:Icon_update.png]] [[조선_행정구역_DB]] : [[역지사지]](2026년01월)
** [[파일:Icon_link.png]][[조선시대_행정구역_이력]]
** [[파일:Icon_link.png]][[조선시대_읍치_이력]]
* [[파일:Icon_new.png]][[조선_교통로_DB]] : [[김종혁]], [[김현종]](2026년01월)
* [[파일:Icon_update.png]][[근대_철도_DB]] : [[김종혁]](2026년01월)
* [[파일:Icon_new.png]][[인구경지_민적통계표_DB]] : [[역지사지]](2025년07월)
* [[파일:Icon_update.png]][[조선_호구총수_DB]] : [[역지사지]](2025년04월)
* [[파일:Icon_update.png]][[조선_역_DB]] : [[양정현]](2024년09월)
** [[파일:Icon_link.png]][[조선시대_역_이력]]
** [[파일:Icon_link.png]][[조선시대_역_위치]]

=== 진행중 ===
* [[조선_고지도_통합방안체계_GIS]] : [[김현종]]
* [[조선_고적_DB]] : [[최유식]]
* [[근대_교통로_DB]] : [[양정현]]
* 조선_군현도로_GIS: 양정현
* [[지리지_XML_정규화_개발]] : [[김현종]], [[최경현]]

=== 예정 ===
* [[근대_지형도_DB]] : [[박선영]]
* [[인구경지_호구총수_DB]] : [[역지사지]]
* [[근대_행정구역_1917_전후비교_DB]] : [[김현종]]
* [[조선_고개_DB]] : [[김현종]]

== 역사지리정보(국사편찬위원회) ==
* [https://hgis.history.go.kr/pro_g1/dataset.do 근대_행정구역_DB] : 국사편찬위원회, 역사지리정보DB(2026년02월 기준)
** 행정구역 데이터 (1910~1945년) : xlsx, csv
** 행정구역 변경이력 데이터 (1910~1945년) : xslsx, csv
** 행정구역 GIS 데이터 : geopackage
* [https://hgis.history.go.kr/pro_g1/dataset.do 현대_행정구역_DB] : 국사편찬위원회, 역사지리정보DB(2026년02월 기준)
** 행정구역 데이터 (1955~1975년) : xslsx, csv
** 행정구역 변경이력 데이터 (1955~1975년) : xslsx, csv
** 행정구역 GIS 데이터 : geopacakge
** 행정구역 데이터(1975년) : xlsx, csv
** 행정구역 GIS 데이터(1975년) : geopackage
* [https://hgis.history.go.kr/pro_g1/dataset.do 근대_지형도기호_DB] : 국사편찬위원회, 역사지리정보DB(2026년02월 기준)
** 근대지리정보 심볼 포인트 : geopackage
* [https://hgis.history.go.kr/pro_g1/dataset.do 근대_지형도목록_DB] : 국사편찬위원회, 역사지리정보DB(2026년02월 기준)
** 일제시기 지형도 도엽 목록 : xlsx
* [https://hgis.history.go.kr/pro_g1/dataset.do 현대_지형도목록_DB] : 국사편찬위원회, 역사지리정보DB(2026년02월 기준)
** 1970년대 지형도 도엽 정보 : xlsx
* [https://hgis.history.go.kr/api/intro.do 근대_근대지형도_OpenAPI] : 국사편찬위원회, 역사지리정보DB(2026년02월 기준)
* [https://hgis.history.go.kr/api/intro.do 현대_현대지형도_OpenAPI] : 국사편찬위원회, 역사지리정보DB(2026년02월 기준)

== DB 구축 계획 ==
* [[파일:Icon_new.png]][[역지사지_계획]]

== 역사지리연구 DB ==
* [[파일:Icon_update.png]][[역사GIS_서비스]](2025년10월)
* [[역사GIS_연구자]]
* [[고지도_연구자]]
* [[역사지리정보_문헌]]
** [[파일:Icon_link.png]][[지리지_편목]]
** [[파일:Icon_link.png]][[한국지리_지역구분]]
* [[파일:Icon_update.png]][[역사지리정보_지역]]
** [[충청_당진]]|[[충청_예산]]
** [[충청_아산]]|[[충청_천안]]|[[충청_대전]]
* [[파일:Icon_new.png]][[대동여지도_지리정보]](2025년11월)
** [[대동여지도_경기_광주]]|[[대동여지도_경기_안산]]|[[대동여지도_경기_인천]]|[[대동여지도_경기_수원]]|[[대동여지도_경기_통진]]
** [[대동여지도_충청_결성]]|[[대동여지도_충청_아산]]|[[대동여지도_충청_천안]]|[[대동여지도_충청_회덕]]|[[대동여지도_충청_진잠]]
** [[대동여지도_전라_무안]]|[[대동여지도_전라_전주]]
** [[대동여지도_경상_경주]]|[[대동여지도_경상_동래]]|[[대동여지도_경상_고성]]
** [[대동여지도_평안_정주]]

== 역지사지 회원 ==
* [[김종혁]] : 역사지리, 문화지리, HGIS
* [[박선영]] : 역사지리, 근대지도, HGIS
* [[김현종]] : 역사지리, HGIS, 디지털인문학
* [[양정현]] : 한국사, 역사지리, HGIS, 디지털인문학
* [[최유식]] : 역사지리, HGIS

조선 역 DB

2026-05-16T03:24:41Z

Yachagye: /* DB 설계 */

== DB 개요 ==
* DB 설명
** 조선시대 간행된 지리서 및 법전에 수록된 전국의 역 분포 정보를 문헌별로 정리하고 각각의 비정 위치를 기재한 DB.
** 각 역의 비정 위치에 대응하는 경위도 값과 현재 주소 정보 수록, 북한 지역의 경우 1914년 시점의 주소 정보를 기재.
* DB 구축자
** DB 설계 : 양정현
** DB 구축 : 양정현
** 데이터 검수 : 김종혁, 김현종, 박선영, 최유식
* 자료 공개
** 비영리적 활동(논문, 연구서)에 본 자료 사용시, 인용 문구만 표시하면 사용에 제한 없음.
** 영리적인 목적(프로젝트)으로 사용할 경우에는 관계자(yachagye@naver.com)와 상의 후 처리.
** 본 자료 전체를 다른 곳에서 서비스하는 것은 제한함.
** 본 DB에 오류가 발견된 경우, yachagye@naver.com에 오류 신고.
** 인용 표기 : 「조선시대 역 DB_○○○(예시: 『신증동국여지승람』)」, 202X년 X월 기준, 양정현, 역지사지(https://www.hisgeo.info).

== DB 및 공간 데이터 목록 ==
* DB : [[미디어:역 출전 통합.xlsx|【출전 통합 DB_다운로드(xlsx)】]], [[미디어:역 시계열 통합.xlsx|【시계열 통합 DB_다운로드(xlsx)】]]
** [[고려사_역 | 『고려사』 병지의 역]]
** [[세종실록지리지_역 | 『세종실록』 지리지의 역]]
** [[경국대전_역 | 『경국대전』의 역]]
** [[동국여지승람_역 | 『동국여지승람』의 역]]
** [[신증동국여지승람_역 | 『신증동국여지승람』의 역]]
** [[동국여지지_역 | 『동국여지지』의 역]]
** [[속대전_역 | 『속대전』의 역]]
** [[여지도서_역 | 『여지도서』의 역]]
** [[동국문헌비고_역 | 『동국문헌비고』의 역]]
** [[대전통편_역 | 『대전통편』의 역]]
** [[도로고_역 | 『도로고』의 역]]
** [[만기요람_역 | 『만기요람』의 역]]
** [[여도비지_역 | 『여도비지』의 역]]
** [[대동지지_역 | 『대동지지』의 역]]
** [[대전회통_역 | 『대전회통』의 역]]
** [[여재촬요_역 | 『여재촬요』의 역]]
** [[증보문헌비고_역 | 『증보문헌비고』의 역]]
* 공간 데이터
** 역 위치 비정 포인트 데이터 : 『고려사』 ~ 『증보문헌비고』
** shp 파일 : [[미디어:조선시대 역 공간데이터 shp.zip|【다운로드】]]
** gpkg 파일 : [[미디어:조선시대 역 공간데이터 gpkg.zip|【다운로드】]]

== DB 설계 ==

=== 출전 통합 DB ===

한 행은 하나의 역이 한 출전에 등장한 사례에 대응. 같은 역이라도 등장하는 출전마다 별도 행으로 기재.

{| class="wikitable"
! 필드명 !! 설명
|-
| OID || 자료 내 자동 부여된 순번 정수 식별자.
|-
| 도 || 관찰사도의 한글 명칭. 조선시대 지방행정체계에서 역도를 관할하는 최상층 행정구역단위.
|-
| 군현_한글 || 역이 지리적으로 위치한 군현의 한글 명칭.
|-
| 군현_한자 || 역이 지리적으로 위치한 군현의 한자 명칭.
|-
| 역_한글 || 역의 한글 명칭.
|-
| 역_한자 || 역의 한자 명칭.
|-
| 아이디 || 역 단위 식별자. '군현한자_역한글' 형식(예: 開城_산예). 동일 역의 행은 출전이 달라도 같은 값. 시계열 통합 DB의 역_아이디와 동일한 키.
|-
| 역도 || 역이 소속된 상위 단위인 역도의 한글 명칭.
|-
| 본역 || 역도 관할 관원이 주재하는 중심 역인 경우 ○, 그 외는 공란.
|-
| 유형 || 역이 소속된 역도의 등급에 따라 부여된 관할 관원의 직명을 기준으로 한 분류(찰방·역승 등). 『고려사』 병지 시점에는 부여하지 않음.
|-
| 위치_방위 || 사료에 기재된 군현 읍치 기준 역의 방위.
|-
| 위치_리수 || 사료에 기재된 군현 읍치 기준 역까지의 거리(리).
|-
| 위치_지명 || 사료에 기재된 역의 소재 지명.
|-
| 출전 || 역이 수록된 자료의 명칭. 개별 지리서·법전 등 단행 문헌인 경우 문헌의 한글 명칭(예: 『세종실록지리지』, 『경국대전』), 조선왕조실록 기사인 경우 해당 기사의 연월일(예: 세종11년8월18일)을 기재.
|-
| 출전_순번 || 출전 내 역의 등재 순서.
|-
| 기준시점 || 출전에 수록된 역 분포 양상의 서력 기준 시점.
|-
| 시작_월일 || 출전이 연월일 형식의 실록 기사 등인 경우, 거기서 월·일만 분리해 기재(예: 8월18일). 단행 문헌은 공란.
|-
| 위치_1914 || 1914년 3월 1일 이후 시점의 행정구역 기준 주소. 북한 지역은 본 주소로 통일.
|-
| 위치_지번 || 2024년 이전 시점 한국의 지번 주소(동리 수준까지).
|-
| 중복 || 같은 출전 내에 동일 역이 중복 기재된 경우의 표시.
|-
| X || 역의 비정 위치 경도.
|-
| Y || 역의 비정 위치 위도.
|}

=== 시계열 통합 DB ===

한 행은 하나의 역이 동일한 속성(역도·본역·유형·역_한글 등)을 유지한 시간 구간 하나에 대응. 속성이 변경되는 시점마다 새 행이 생성되며, 한 역의 전체 이력은 역_아이디 그룹 내에서 구간순서 오름차순으로 재구성됨.

{| class="wikitable"
! 필드명 !! 설명
|-
| 아이디 || 시계열 통합 DB의 고유 키. '역_아이디_구간순서'(2자리) 형식(예: 가산嘉山_가평_01).
|-
| 구간순서 || 한 역 내에서 시간순으로 부여한 구간 일련번호. 1부터 시작하며 속성 변경마다 1씩 증가.
|-
| 역_아이디 || 역 단위 식별자. 동일 역의 모든 구간 행이 같은 값을 공유. 출전 통합 DB의 아이디와 동일한 키.
|-
| 군현_한글 || 해당 구간의 지리적 소재 군현의 한글 명칭.
|-
| 역_한글 || 해당 구간의 역 한글 명칭. 명칭 변경이 있는 구간은 변경된 명칭을 기재.
|-
| 역도 || 해당 구간의 소속 역도 한글 명칭.
|-
| 본역 || 해당 구간이 본역에 해당하면 ○, 그 외는 공란.
|-
| 유형 || 해당 구간의 관할 관원 유형(찰방·역승 등). 『고려사』 병지 시점에는 부여하지 않음.
|-
| 도 || 해당 구간의 관찰사도 한글 명칭.
|-
| 군현_한자 || 해당 구간의 지리적 소재 군현의 한자 명칭.
|-
| 위치_지명 || 사료에 기재된 역의 소재 지명(있는 경우).
|-
| 출전 || 해당 구간의 시작을 확인한 최초 출전. 개별 지리서·법전 등 단행 문헌인 경우 문헌의 한글 명칭, 조선왕조실록 기사인 경우 해당 기사의 연월일을 기재.
|-
| 시작_월일 || 출전이 연월일 형식의 실록 기사 등인 경우, 거기서 월·일만 분리해 기재. 단행 문헌은 공란.
|-
| X || 역의 비정 위치 경도.
|-
| Y || 역의 비정 위치 위도.
|-
| 위치_1914 || 1914년 3월 1일 이후 시점의 행정구역 기준 주소. 북한 지역은 본 주소로 통일.
|-
| 위치_지번 || 2024년 이전 시점 한국의 지번 주소(동리 수준까지).
|-
| 역_한자 || 해당 구간의 역 한자 명칭.
|-
| 역_한자_이칭 || 사료에 따라 달리 나타나는 한자 표기.
|-
| 시작 || 해당 구간이 시작된 서력 연도(정수). 속성이 안정적으로 유지된 기간의 시작점.
|-
| 종료 || 해당 구간이 종료된 서력 연도. 다음 구간의 시작 직전 연도(마지막 구간의 경우 최종 등장 출전의 기준시점)로 산출.
|-
| 마지막_등장시점 || 해당 구간의 속성이 사료상 마지막으로 확인된 서력 연도. 마지막_등장시점과 종료 사이는 다음 변경이 관측되기 전까지 속성 지속을 추정한 구간.
|-
| 등장_사료수 || 해당 구간 동안 등장한 사료의 수.
|-
| 시점_목록 || 해당 구간이 등장한 시점들을 세미콜론(;)으로 구분한 목록.
|-
| 출전_목록 || 해당 구간이 등장한 출전들을 세미콜론(;)으로 구분한 목록.
|-
| 분기_사유 || 직전 구간 대비 변경 사유. '시작'(최초 구간), '역도변경(A→B)', '유형변경(역승→찰방)', '본역변경(○→공란)', '역_한글변경(목계→수계)' 등이 단일 또는 조합으로 기재.
|}

== 메모 ==
*(todo) 1914주소와 현재주소를 한 필드로 병합 필요

== DB 변화 이력 ==
* 2024년 08월 04일 : DB 최초 공개
* 2024년 09월 04일 : 조선시대_역_DB(xlsx) 업로드
* 2024년 09월 17일 : 조선시대_역_공간데이터(shp, gpkg) 업로드
* 2026년 05월 16일 : 출전 기준 통합 DB, 시간 기준 통합 DB 업로드

파일:역 출전 통합.xlsx

2026-05-16T03:14:33Z

Yachagye: Yachagye님이 파일:역 출전 통합.xlsx의 새 판을 올렸습니다

조선 역 DB

2026-05-16T02:29:11Z

Yachagye: /* DB 변화 이력 */

조선 역 DB

2026-05-16T02:27:17Z

Yachagye: /* DB 및 공간 데이터 목록 */

파일:역 시계열 통합.xlsx

2026-05-16T02:25:08Z

Yachagye:

파일:역 출전 통합.xlsx

2026-05-16T02:24:52Z

Yachagye: