diff --git a/common_util/common_util_help_router.py b/common_util/common_util_help_router.py index f08a44ba8..6960521b7 100644 --- a/common_util/common_util_help_router.py +++ b/common_util/common_util_help_router.py @@ -14,7 +14,7 @@ from fastapi import APIRouter, HTTPException router = APIRouter(prefix="/api/help", tags=["help"]) HELP_ROOT = Path(__file__).resolve().parent.parent / "resources" / "help" -PAGE_RE = re.compile(r"^(B0[2-9]|D0[1-4]|E0[1-5])$") +PAGE_RE = re.compile(r"^(B0[2-9]|D0[1-4]|E0[1-7])$") def read_help(page: str, root: Path = HELP_ROOT) -> list[dict[str, str]]: diff --git a/resources/help/D01/00_설명서.md b/resources/help/D01/00_설명서.md new file mode 100644 index 000000000..0647091dd --- /dev/null +++ b/resources/help/D01/00_설명서.md @@ -0,0 +1,35 @@ +# 예정노선 등록 설명서 + +## 이 화면에서 하는 일 +- 여러 해에 걸친 예정노선의 기본 정보(사업 연도 · 지역 · 임도 종류 · 설계속도 · 이름)를 넣고 새 예정노선 프로젝트를 만드는 첫 화면임. +- 대시보드의 [+] 에서 「예정노선」 카드를 고르면 이 화면이 열림. +- 도면 관련 칸은 없음. 노선의 실제 위치는 만든 뒤 다음 화면(1단계 기준 지정)에서 정함. +- 예정노선은 **산림청만** 만들 수 있음. 산림청 = 시스템 관리자 또는 메일 주소가 `.go.kr` 로 끝나는 사용자임. + +## 작업 순서 +1. 대시보드에서 [+] 를 누르고 「예정노선」 카드를 고름. 산림청이 아니면 카드가 흐리게 보이고 누르면 「예정노선은 산림청(시스템 관리자 · go.kr 메일)만 만들 수 있습니다.」 안내가 나옴. +2. 「사업 연도 시작」 · 「사업 연도 끝」 에 사업 기간을 넣음. 한 해짜리면 두 칸을 같은 해로 둠. +3. 「사업 지역」 을 적음. 필수 칸임. +4. 「임도 종류」 를 고르고, 그에 맞춰 「설계속도」 를 고름. +5. 「프로젝트명」 을 확인함. 위 칸을 채우면 자동으로 이름이 만들어지며, 직접 고쳐도 됨. +6. 필요하면 「노선 시작 누가거리 (m)」 · 「노선 종료 누가거리 (m)」 를 넣음. 비워 두어도 됨. +7. [등록] 을 누름. 칸에 문제가 있으면 해당 칸 아래에 빨간 안내가 나오고 등록되지 않음. + +## 단추 +| 단추 | 하는 일 | +| --- | --- | +| [?] | 이 도움말을 엶 | +| [취소] | 등록하지 않고 대시보드로 돌아감 | +| [등록] | 입력한 값으로 예정노선 프로젝트를 만들고 곧바로 D02 「기준 지정」 화면으로 감 | + +## 결과 읽는 법 +- 등록에 성공하면 「프로젝트를 만들었습니다.」 알림이 뜨고, 만든 프로젝트가 현재 프로젝트가 되어 「기준 지정」 화면(지도 화면)이 열림. +- 대시보드 프로젝트 표에도 종류 「예정노선」 으로 올라감. 표의 단계 막대(기준 지정 · 노선 분석 · 확정 · 내보내기)를 누르면 그 단계 화면으로 감. +- 실패하면 서버가 알려 준 까닭이 알림으로 뜨고 이 화면에 머묾. + +## 알아 둘 것 +- 칸마다 뜻과 기본값은 「칸 뜻」 문서에 있음. +- 임도 종류 · 설계속도는 임도설계(B 그룹)와 같은 기준을 씀. 등록 뒤 이 화면에서 고치는 방법은 코드에서 확인하지 못함. +- 누가거리(노선을 따라 잰 거리) 두 칸은 저장만 되며, 다음 화면들에서 쓰이는 곳은 확인하지 못함. 「분석 뒤 실제 누가와 다르면 차이 표시」 는 준비 중으로 봄. +- 등록 직후에는 노선 위치가 비어 있음. 지점을 정하고 저장해야 분석 단계로 갈 수 있음. +- 지정받은 다른 회사 구성원은 예정노선을 보기만 할 수 있고 만들거나 고칠 수 없음. diff --git a/resources/help/D01/10_칸_뜻.md b/resources/help/D01/10_칸_뜻.md new file mode 100644 index 000000000..692332260 --- /dev/null +++ b/resources/help/D01/10_칸_뜻.md @@ -0,0 +1,36 @@ +# 칸 뜻 + +| 칸 | 뜻 | 기본값 | 범위 · 규칙 | +| --- | --- | --- | --- | +| 사업 연도 시작 | 사업 첫 해 | 올해 | 2000 ~ 2100 의 정수 | +| 사업 연도 끝 | 사업 마지막 해 | 올해 | 시작 연도와 같거나 뒤여야 함 · 2100 까지 | +| 사업 지역 | 사업이 있는 지역 이름 | 비어 있음 | 필수 · 글자 100 자까지 · 예: 울진군 금강송면 | +| 종류 | 프로젝트 종류 | 「노선 계획」 | 고정 · 고칠 수 없음 | +| 임도 종류 | 간선임도 · 산불진화임도 · 작업임도 중 하나 | 간선임도(목록 맨 위) | 설계속도 선택지와 이름 조합에 쓰임 | +| 설계속도 | 노선을 설계하는 기준 속도 | 20 km/h | 아래 표 참조 | +| 프로젝트명 | 대시보드에 보이는 이름 | 자동 조합 | 필수 · 글자 255 자까지 | +| 노선 시작 누가거리 (m) | 노선 첫 지점의 측점 값 | 비어 있음 | 0 이상 · 선택 | +| 노선 종료 누가거리 (m) | 노선 끝 지점의 계획 목표 거리 | 비어 있음 | 시작 값보다 커야 함 · 선택 | + +## 설계속도 선택지 +| 임도 종류 | 고를 수 있는 값 | +| --- | --- | +| 간선임도 | 20 · 30 · 40 km/h | +| 산불진화임도 | 20 · 30 · 40 km/h | +| 작업임도 | 20 km/h 만 | + +- 임도 종류를 바꾸면 설계속도 목록이 바뀌고 값이 가장 낮은 값(20 km/h)으로 돌아감. +- 임도설계(B 그룹)와 같은 기준이며, 허용되지 않는 값이 서버에 오면 20 km/h 로 처리함. + +## 프로젝트명 자동 조합 +- 「사업 연도」 · 「사업 지역」 · 「임도 종류」 를 띄어 이어 붙임. 예: 2026~2028 울진군 금강송면 간선임도 +- 연도가 여러 해이면 「시작~끝」 꼴이고, 한 해이면 해 하나만 들어감. +- 이름을 직접 고치기 전에는 위 칸을 바꿀 때마다 통째로 다시 만들어짐. +- 이름을 고친 뒤에는 위 칸이 바뀌어도 자동 조각이 차지한 부분만 새 값으로 바뀌고, 직접 넣은 글은 그대로 남음. 직접 지운 조각은 되살아나지 않음. + +## 입력 오류 안내 +- 시작 연도가 2000 ~ 2100 밖이면 숫자 범위 안내가 나옴. +- 끝 연도가 시작보다 앞이면 「끝 연도는 시작 연도와 같거나 뒤여야 합니다.」 가 나옴. +- 지역이나 이름이 비면 필수 입력 안내가 나옴. +- 종료 누가거리가 시작 이하이면 「종료 누가거리는 시작보다 커야 합니다.」 가 나옴. +- 산림청이 아닌 계정으로 등록하면 서버가 「예정노선은 산림청만 만들 수 있습니다.」 로 막음. 회사에 연결되지 않은 계정도 막힘. diff --git a/resources/help/D02/00_설명서.md b/resources/help/D02/00_설명서.md new file mode 100644 index 000000000..a8eda8d5a --- /dev/null +++ b/resources/help/D02/00_설명서.md @@ -0,0 +1,59 @@ +# 기준 지정 설명서 + +## 이 화면에서 하는 일 +- 예정노선 1단계. 사업 연도마다 노선의 **시점**과 **종점**을 지도 위에 정하는 화면임. +- 가운데 = 카카오맵(지점과 연도별 선이 그려짐). 왼쪽 = 「연도 지점」 표(지점 이름 · 경도 · 위도 입력칸). +- 정한 지점은 다음 단계(노선 분석)가 길을 찾는 기준이 됨. +- 지점 저장은 산림청만 할 수 있음. 지정받은 다른 회사는 보기만 가능하며 저장하면 「예정노선 지점은 산림청만 고칠 수 있습니다.」 로 막힘. + +## 작업 순서 +1. 화면이 열리면 사업 연도 수 + 1 개의 지점 줄이 표에 나타남. 예: 2026 ~ 2027 두 해이면 「2026 시점」 · 「2026 종점 · 2027 시점」 · 「2027 종점」 세 줄. +2. 처음에는 비어 있는 첫 줄이 놓을 지점으로 잡혀 있음(줄이 강조되어 보임). +3. 지도를 눌러 그 지점을 놓음. 놓으면 다음 빈 지점이 자동으로 놓을 지점이 됨. +4. 놓은 뒤 고치려면 지도의 표지를 끌어 옮기거나, 표의 경도 · 위도 칸에 값을 직접 넣음. +5. 모든 줄이 채워지면 연도마다 다른 색의 선이 지점 사이를 이음. +6. [저장] 또는 [>] 를 누름. + +## 지점 정하는 방법 +| 방법 | 하는 법 | 결과 | +| --- | --- | --- | +| 지도 누름 | 줄 옆 📍 로 놓을 지점을 고른 뒤 지도를 누름 | 그 자리에 표지가 놓임 | +| 표지 끌기 | 지도의 표지를 끌어 놓음 | 표의 값이 따라 바뀜 | +| 좌표 입력 | 경도 · 위도 두 칸에 값을 넣고 칸을 벗어남 | 값이 맞으면 표지가 옮겨짐 · 틀리면 칸이 빨갛게 표시됨 | + +- 놓을 지점을 고르지 않고 지도를 누르면 「지도에 놓을 지점 고르기」 안내가 나옴. +- 다른 프로그램에서 구한 좌표는 경도 · 위도(WGS84, 소수 7 자리까지 반영)로 넣을 것. +- 경도는 120 ~ 135, 위도는 30 ~ 45 범위만 받음. + +## 연도 표 읽는 법 +| 줄 이름 | 뜻 | +| --- | --- | +| 첫 연도 시점 | 노선 전체의 출발점 | +| 앞 연도 종점 · 다음 연도 시점 | 한 점이 두 역할. 앞 연도의 끝이자 다음 연도의 시작 | +| 마지막 연도 종점 | 노선 전체의 도착점 | + +- 직전 연도 종점과 다음 연도 시점은 항상 같은 점이며, 하나만 옮기면 두 연도의 선이 함께 움직임. +- 줄 색과 지도 선 색은 연도별로 대응함(6 색을 돌려 씀). + +## 단추 +| 단추 | 하는 일 | +| --- | --- | +| [?] | 이 도움말 | +| [<] | 이전 단계. 이 화면이 첫 단계라 흐림 | +| [>] | 지점 저장 뒤 다음 단계 「노선 분석」 으로 감 | +| [저장] | 지점을 저장하고 좌표계를 정함 | +| 📍 | 지도를 눌렀을 때 놓을 지점으로 이 줄을 고름 | +| 위 단계 막대 | 「기준 지정」 · 「노선 분석」 · 「확정 · 내보내기」 로 바로 이동 | + +## 결과 읽는 법 +- 저장하면 「지점을 저장했습니다.」 알림이 뜸. +- 표 아래 한 줄에 「저장 좌표계 EPSG:번호」 와 첫 연도 시점의 X · Y(m)가 나옴. 저장 전에는 「아직 저장 안 함」 이 나옴. +- 저장 전 고친 값은 이 화면을 다시 열어도 같은 브라우저 안에서는 남아 있음. 서버에는 [저장] 이나 [>] 를 눌러야 반영됨(자동 저장 없음). + +## 알아 둘 것 +- **[>] 와 수치지형도**: [>] 는 지점을 저장한 뒤 「노선 분석」 화면을 엶. 수치지형도(도엽) · 위성 사진 · 연도별 지형면 받기는 그 화면이 열릴 때 뒤에서 시작되며, 이미 받은 범위 안이면 건너뜀. 지점을 저장하지 못하면(예: 빈 지점) 이 화면에 머묾. +- 빈 지점이 남은 채 저장하면 「○○○○년 시점이 비었습니다.」 또는 「○○○○년 종점이 비었습니다.」 로 막힘. +- 연도 범위(시작 · 끝)는 등록 때 정해지며 이 화면에서 바꿀 수 없음. +- **이미 분석 · 확정한 연도의 지점을 옮기면** 그 연도의 분석 노선과 확정 상태가 비워지고 다시 분석해야 함. 1 mm 이내 변화는 같은 지점으로 보아 지우지 않음. +- 좌표계가 바뀌는 경우(「쓰인 방법과 근거」 문서의 좌표계 절)에는 모든 연도의 분석 노선이 비워짐. +- 지도는 카카오맵을 씀. 점이 하나도 없어도 우리나라 가운데쯤을 먼저 보여 줌. diff --git a/resources/help/D02/10_칸_뜻.md b/resources/help/D02/10_칸_뜻.md new file mode 100644 index 000000000..24a2720a4 --- /dev/null +++ b/resources/help/D02/10_칸_뜻.md @@ -0,0 +1,25 @@ +# 칸 뜻 + +## 왼쪽 「연도 지점」 표 +| 칸 | 뜻 | 규칙 | +| --- | --- | --- | +| 지점 이름 | 어느 연도의 시점 · 종점인지 | 예: 「2026 시점」 · 「2026 종점 · 2027 시점」 | +| 📍 | 지도 누름이 놓을 지점으로 고름 | 고른 줄이 강조됨 | +| 경도 | 동서 위치(도) | 120 ~ 135 · 소수 가능 | +| 위도 | 남북 위치(도) | 30 ~ 45 · 소수 가능 | + +- 경도 · 위도 중 하나만 넣으면 반영되지 않음. 두 칸이 모두 범위 안일 때 반영됨. +- 반영될 때 소수 7 자리(약 1 cm)로 반올림됨. +- 범위 밖 값은 두 칸이 모두 빨갛게 표시되고 반영되지 않음. + +## 지도 위 +- 표지 하나 = 지점 하나. 마우스로 끌어 옮길 수 있음. +- 선 하나 = 연도 하나(그 해의 시점에서 종점까지). 색은 연도별로 다름. +- 지점이 하나도 없으면 우리나라 가운데쯤이 먼저 보임. 지점을 놓으면 처음 한 번만 그 지점에 맞춰 보이고, 그 뒤로는 사용자가 맞춘 보기(중심 · 확대)를 그대로 둠. +- 지도 아래 안내문 = 「지도를 눌러 지점을 놓습니다.」 + +## 표 아래 한 줄 +| 표시 | 뜻 | +| --- | --- | +| 아직 저장 안 함 | 서버에 지점이 한 번도 저장되지 않음 | +| 저장 좌표계 EPSG:번호 · 연도 X · Y | 저장된 좌표계와 첫 연도 시점의 평면좌표(m, 소수 3 자리) | diff --git a/resources/help/D02/20_쓰인_방법과_근거.md b/resources/help/D02/20_쓰인_방법과_근거.md new file mode 100644 index 000000000..712ba6ee5 --- /dev/null +++ b/resources/help/D02/20_쓰인_방법과_근거.md @@ -0,0 +1,34 @@ +# 쓰인 방법과 근거 + +## 좌표계 처리 +- 사용자가 넣는 값은 모두 경도 · 위도(WGS84)임. 지도(카카오맵)도 이 값으로 그려짐. +- 저장할 때 서버가 모든 지점의 **평균 경도**를 보고 한국 평면좌표(TM) 띠 하나를 고른 뒤, 모든 지점을 그 한 가지 좌표계의 X(동쪽) · Y(북쪽) 미터 값으로 바꿔 저장함. +- 분석과 지형 받기는 이 평면좌표를 씀. 사용자가 변환을 따로 할 필요는 없음. + +| 평균 경도 | 좌표계 | 이름 | +| --- | --- | --- | +| 126° 미만 | EPSG:5185 | 서부 | +| 126° 이상 128° 미만 | EPSG:5186 | 중부 | +| 128° 이상 | EPSG:5187 | 동부 | + +- 한 노선은 연도가 달라도 항상 같은 좌표계 한 벌을 씀(연도마다 띠를 따로 쓰지 않음). +- 동해(5188)는 쓰지 않음. +- 지점을 옮겨 평균 경도가 126° 나 128° 선을 넘으면 좌표계가 바뀌고, 그러면 모든 연도가 다시 저장되며 분석 노선이 비워짐. +- 내보내기 때의 좌표계(5179)는 확정 · 내보내기 단계에서 다룸. 이 화면에서는 쓰지 않음. + +## 직전 연도 종점 = 다음 연도 시점 +- 화면: 점 하나를 두 연도가 함께 쓰는 지점 목록(연도 수 + 1 개)으로 다룸. +- 서버: 저장할 때 첫 연도는 보낸 시점을 쓰고, 이후 연도의 시점은 항상 직전 연도의 종점으로 맞춤. 따로 다른 값을 보내도 무시됨. +- 사업 연도 밖의 연도가 오거나 같은 연도가 두 번 오면 거절됨. +- 비어 있는 시점 · 종점이 있으면 「○○○○년 시점(종점)이 비었습니다.」 로 거절됨. + +## 저장 규칙 +- 바뀐 연도만 새로 쓰고, 안 바뀐 연도(1 mm 이내)는 그대로 둠. +- 바뀐 연도는 이미 있던 분석 노선과 확정 시각을 지움. 한 묶음으로 처리되어 일부만 저장되는 일은 없음. +- 사업 연도 밖으로 남아 있던 연도 행은 함께 지움. +- 저장은 산림청 계정만 가능함(시스템 관리자 또는 `.go.kr` 메일). + +## 한계 +- 좌표 입력은 경위도만 받음. 평면좌표(X · Y)를 직접 넣는 칸은 없음. +- 지도 위 위치는 카카오맵 화면 기준이며, 정밀한 측량 값이 필요하면 좌표 입력으로 넣을 것. +- 지형 받기와 분석에 관한 설명은 「노선 분석」 화면의 도움말을 볼 것. diff --git a/resources/help/D03/00_설명서.md b/resources/help/D03/00_설명서.md new file mode 100644 index 000000000..f5c9fc505 --- /dev/null +++ b/resources/help/D03/00_설명서.md @@ -0,0 +1,80 @@ +# 예정노선 2단계 분석 설명서 + +## 이 화면에서 하는 일 + +- 1단계(기준 지정)에서 정한 지점들을 연도 구간마다 이어 주는 노선을 자동으로 찾아 줌. +- 연도마다 노선 후보 넷(영선 · 토공 최소 · 기울기 최소 · 비중 계산)을 만들어 보여 주고, 연도별로 하나씩 고름. +- 고른 후보를 이어 붙여 전체 예정노선 한 줄과 측점(20 m 간격)을 평면에 표시함. +- 측점을 누르면 그 자리 지반선 횡단을 아래에 보여 주고, [3D] 로 지형과 노선을 입체로 봄. +- 지점이 마음에 안 들면 평면에서 직접 끌어 옮긴 뒤 다시 분석 가능. +- 노선 후보를 찾는 엔진은 임도설계 노선 추천(B05)과 같은 엔진임. 이 화면에서는 시작점과 끝점만 정해진 두 지점 사이를 구간별로 한 번씩 찾음. + +## 화면 구성 + +- 가운데 위 = 평면 지도. 위성 사진 위에 등고선, 지점, 노선, 측점이 겹쳐 보임. +- 가운데 아래 = 횡단 판. 측점을 누르면 채워지며, 제목 줄(「횡단」)을 누르면 접고 펼 수 있음. +- 왼쪽 = 「지형」 카드, 「연도별 노선」 카드, 아래쪽 단추 [분석] [저장] [3D]. + +## 작업 순서 + +1. 화면을 열면 자동으로 지형을 확인함. 지점이 이미 받은 지형 범위 안이면 그대로 두고, 아니면 뒤에서 지형을 받기 시작함(왼쪽 「지형」 카드에 진행률 표시). +2. 지점 위치가 마음에 안 들면 평면에서 지점(원)을 끌어 옮김. 지점이 받은 지형 밖이면 [범위 밖 — 더 받기] 를 눌러 지형을 더 받음. +3. [분석] 을 누름. 연도 구간마다 후보 넷을 찾으며, 진행률이 「지형」 카드 자리에 표시됨. +4. 「연도별 노선」 카드에서 연도마다 후보 하나를 누름(눌린 카드가 강조됨). 평면의 노선과 누가(거리) 숫자가 곧바로 바뀜. +5. 평면의 측점 눈금을 눌러 횡단을 확인하고, 필요하면 [3D] 로 확인함. +6. 모든 연도에 노선이 있으면 [저장] 을 누름. 저장 중에는 화면 전체가 잠깐 잠김. +7. 다음 단계(확정 · 업체 · 내보내기)로 넘어감. + +## 단추 + +| 단추 | 하는 일 | +| --- | --- | +| 분석 | 연도 구간마다 노선 후보 넷을 찾음. 입력(지점 · 기준 · 지형)이 이전과 같으면 저장된 결과를 그대로 불러와 바로 끝남. 받은 지형 밖에 지점이 있으면 눌 수 없음 | +| 저장 | 연도별로 고른 후보를 정본으로 저장함. 끌어 옮긴 지점도 이때 함께 저장됨. 어느 연도든 노선이 없으면 눌 수 없음(마우스를 올리면 안내 문구 표시) | +| 3D | 지형과 노선을 입체로 보는 창을 엶. 노선이 하나라도 있어야 눌 수 있음 | +| 범위 밖 — 더 받기 | 지점이 받은 지형 밖일 때만 나타남. 지형(수치지형도 · 위성 · 연도별 높이 자료)을 더 받음 | + +- 산림청 소속이 아닌 사용자(지정받은 회사 등)에게는 [분석] [저장] [범위 밖 — 더 받기] 가 보이지 않으며 지점도 끌 수 없음. 보기만 가능. + +## 결과 읽는 법 + +- **평면의 선 모양** + - 굵은 선 = 연도별로 고른 후보를 이은 예정노선. + - 흰 점선(옅음) = 고르지 않은 다른 후보들. 분석 전에는 지점끼리 잇는 점선만 보임. + - 누른 측점 = 보라색 고리로 표시됨. +- **지점(마디) 색** + - 초록 = 첫 지점(시점), 빨강 = 마지막 지점(종점), 파랑 = 연도가 바뀌는 중간 지점. + - 지점 둘레에 빨간 고리와 점선 고리 = 그 지점이 받은 지형 밖이라는 뜻. 「지형」 카드에 「빨간 고리 지점이 받은 지형 밖입니다 — 더 받아야 분석합니다.」 가 나옴. +- **등고선** = 도엽(수치지형도) 등고선. 노란 점선과 노란 숫자(높이)로 보임. 지도를 확대하면 더 촘촘히 보임. +- **연도별 노선 카드** + - 윗줄 = 「연도 · 시작 측점 ~ 끝 측점 (연장 m)」. 분석 전에는 「분석 전 — [분석]을 누르세요」 가 보임. + - 후보 카드 한 장마다 「연장 · 최대 기울기(%) · 위반 개수」 를 보여 줌. 위반 = 기울기 기준을 지키지 못한 곳의 수. + - 「노선 없음」 으로 회색 처리된 카드 = 그 후보는 길을 찾지 못함. 마우스를 올리면 까닭 표시. 누를 수 없음. + - 고르지 않고 두면 네 후보 중 차례(영선 → 토공 최소 → 기울기 최소 → 비중 계산)대로 처음 성공한 후보가 자동으로 잡힘. +- **누가(측점 번호)** = 앞 연도 끝 = 다음 연도 시작으로 이어서 셈. 시작 값은 프로젝트 등록 때 정한 노선 시작 누가. 연도 경계는 꺾인 채 한 측점으로 표시됨. +- **횡단 판** = 누른 측점의 지반선 단면. 제목 줄에 「연도 · 측점 이름 · 중심 지반고」 표시. 좌우 20 m 범위의 지반만 보이며 설계선은 없음. + +## 보이는 것과 안 보이는 것 + +| 구분 | 내용 | +| --- | --- | +| 보임 | 위성 지도, 등고선, 지점, 노선 중심선, 측점 눈금과 이름, 지반선 횡단, 지형 + 중심선 3D | +| 안 보임 | 노견, 절토 · 성토선, 종단도, 배수유역, 구조물(3D 에도 없음) | +| 이 화면에 칸 없음 | 종단 기울기 상한 · 최소 곡선 반지름 등 기준값. 등록 때 정한 임도 종류와 설계속도로 자동 정해짐 | + +## 지점 끌기 + +- 지점(원) 위에서 마우스 왼쪽 단추를 누른 채 끌면 지점이 따라 움직임. 끝점은 이웃 연도의 시작점과 한 점으로 묶여 있어 함께 움직임. +- 지점을 옮기면 그 지점 앞 · 뒤 연도의 분석 결과가 비워지고 「지점을 옮겼습니다 — [분석] 뒤 측점을 누르세요.」 가 횡단 판에 나옴. 다시 [분석] 을 눌러야 함. +- 옮긴 위치는 [저장] 전까지 이 브라우저 탭에만 임시로 남아 있음(새로 고침해도 유지, 탭을 닫으면 사라짐). [저장] 을 눌러야 정본이 바뀜. +- 손이 조금 떨리는 정도(몇 픽셀)의 움직임은 끌기로 치지 않고 단순 누름으로 처리함. +- 지도 자체는 지점이 아닌 곳을 끌어 옮기고, 휠로 확대 · 축소함. + +## 알아 둘 것 + +- [저장] 은 노선 모양을 화면에서 받지 않고, 고른 후보 이름만 서버에 보냄. 서버가 저장된 분석 결과로 노선을 다시 이어 붙여 저장하므로, [분석] 을 하지 않은 상태에서는 저장할 수 없음(「분석 저장본이 없습니다 — [분석]을 먼저 하세요.」). +- 처음 열 때 지점이 비어 있으면 「N년 지점이 비었습니다 — 1단계(기준 지정)에서 정하세요.」 라는 문구만 나오고 진행이 안 됨. +- 지형 받기와 분석은 서버 뒤에서 도는 작업임. 화면을 닫았다 다시 열어도 도는 중이면 이어서 진행률을 보여 줌. +- 위성 사진은 못 받아도 지형 받기가 멈추지 않음. 위성이 없으면 어두운 바탕에 지점과 노선만 보임. +- 3D 창은 한 번에 한 연도씩 보며, 창 위쪽 선택칸으로 연도를 바꿈. 창을 닫으면 3D 화면 자원이 정리됨. +- 법 기준의 세부 수치와 사용자 확정 전 값은 「30_사용자_확정_전_값」 문서 참고. diff --git a/resources/help/D03/20_쓰인_방법과_근거.md b/resources/help/D03/20_쓰인_방법과_근거.md new file mode 100644 index 000000000..5f6a760a7 --- /dev/null +++ b/resources/help/D03/20_쓰인_방법과_근거.md @@ -0,0 +1,52 @@ +# 쓰인 방법과 근거 + +## 노선을 찾는 방법 + +- 연도마다 그 연도의 시점과 종점 두 점 사이를 한 번씩 찾음. 연도 사이의 경계점은 옮기지 않으므로 앞 연도 끝과 다음 연도 시작이 정확히 맞물림. +- 찾는 엔진은 임도설계 「노선 추천」(B05)과 같은 엔진임. 지형 높이 자료(연도별 높이 격자)에서 경사를 읽고, 기울기 · 곡선 · 하천 이격을 지키는 길을 찾아 곡선까지 맞춘 중심선을 냄. +- 후보는 네 갈래로 같은 입력에서 각각 구함. + +| 후보 | 고르는 기준 | +| --- | --- | +| 영선 | 목표 기울기로 등고선을 비스듬히 건너가는 일정한 기울기 선. 목표 기울기를 따로 주지 않으므로 기울기 상한을 목표로 삼음 | +| 토공 최소 | 후보 길 중 절토 + 성토 + 반입 + 사토 물량이 가장 적은 길 | +| 기울기 최소 | 후보 길 중 최대 종단 기울기가 가장 작은 길(같으면 평균 기울기가 작은 길) | +| 비중 계산 | 예상 · 토공 · 기울기 세 가지 비용을 비중으로 섞어 한 번 찾은 길. 비중은 기본값 50 : 25 : 25(%) 그대로 씀 | + +- B05 의 다른 후보(예상노선 추적 · 안전 우선 · 계류 횡단 최소 · 공사비 어림 최소)는 이 화면에서 쓰지 않음. +- 예상노선 추적은 두 점 사이가 직선이 되어 의미가 없어 뺐음. + +## 추천 기준(자동으로 정해지는 값) + +- 화면에 기준 칸이 없음. 프로젝트 등록 때 정한 「임도 종류」와 「설계속도」로 임도 법정 함수가 값을 냄. +- 설계속도는 종류별로 고를 수 있는 값이 정해져 있음. 작업임도는 20 km/h 하나, 간선 · 산불진화 임도는 20 · 30 · 40 km/h 중 선택. 지정하지 않으면 20 km/h. +- 지형 구분은 등록 칸이 없어 가장 완화된 쪽(특수지형)으로 고정해 씀. + +| 설계속도 | 종단 기울기 상한 | 최소 곡선 반지름 | +| --- | --- | --- | +| 20 km/h | 14 % | 12 m | +| 30 km/h | 12 % | 20 m | +| 40 km/h | 10 % | 40 m | + +- 하천 이격 = 100 m. 도엽 하천선 중 소하천 · 지방하천 · 국가하천만 대상. +- 탐색 복도 반폭 = 300 m. 두 지점을 이은 선 양옆 300 m 안에서만 길을 찾음. 100 m · 200 m 로는 기준을 못 지키는 곳이 남아 300 m 로 넓힘. +- 위반 개수 = 기울기 기준을 지키지 못한 곳의 수. 지형상 길이 없을 때만 어쩔 수 없이 기준을 넘은 길이 나옴. + +## 쓰는 지형 자료 + +- 수치지형도 도엽(축척 1/5,000)을 지점 둘레 3×3 장씩 받아 한 장으로 병합함. 이미 받은 도엽은 다시 받지 않고, 옛 도엽도 지우지 않음. +- 위성 지도(VWorld)는 배경 그림용. 이미 받은 범위가 덮으면 건너뜀. +- 연도별 높이 격자는 그 연도 구간 상자 + 탐색 복도 300 m + 여유 50 m 범위로 만듦. 지점이 격자 가장자리에서 300 m 안쪽에 있어야 「받은 지형 안」 으로 판정함. +- 도엽 등고선을 평활화한 높이 격자라 실제 측량 지형과 차이가 있을 수 있음. + +## 저장 방식 + +- 같은 입력(지점 · 기준 · 지형)이면 이전에 계산한 결과를 그대로 써서 [분석] 이 빨리 끝남. 지점이나 기준이 바뀌면 그 연도만 다시 계산함. +- [저장] 은 서버가 저장된 분석 결과에서 고른 후보를 다시 이어 정본으로 기록함. 화면에서 계산한 값을 그대로 받아 적지 않음. +- 누가 계산, 후보 고름, 중심선 잇기는 화면과 서버가 같은 규칙으로 따로 셈. 한쪽만 고치지 않도록 짝으로 관리하며 시험으로 대조함. + +## 한계 + +- 후보 네 개가 서로 비슷한 길이 될 수 있음(가파른 지형에서 기준을 지키는 길이 좁은 띠 하나뿐인 경우). +- 평면 노선만 다룸. 종단(세로 단면) · 토공량 확정 · 구조물 계획은 이 단계 범위가 아니며, 임도설계 단계에서 다룸. +- 횡단은 지반선만 보여 주며 설계 단면은 아님. diff --git a/resources/help/D03/30_사용자_확정_전_값.md b/resources/help/D03/30_사용자_확정_전_값.md new file mode 100644 index 000000000..8933630b4 --- /dev/null +++ b/resources/help/D03/30_사용자_확정_전_값.md @@ -0,0 +1,21 @@ +# 사용자 확정 전 값 + +아래 값은 코드에 기본값으로 들어 있으나 사용자가 최종 확정한 값이 아님. 바꾸려면 개발 담당에게 요청. + +| 값 | 지금 기본값 | 출처 | 상태 | +| --- | --- | --- | --- | +| 지형 구분 | 특수지형(가장 완화) 고정 | 예정노선 등록 화면에 지형 구분 칸이 없어 임도설계 기본 대체값을 그대로 씀 | 확정 전 | +| 종단 기울기 상한 | 설계속도 20 · 30 · 40 km/h 에 14 · 12 · 10 % | 임도 규정 별표 설계속도별 값 중 특수지형 열 | 지형 구분 확정에 따라 바뀜 | +| 최소 곡선 반지름 | 12 · 20 · 40 m | 같은 별표의 특수지형 열 | 지형 구분 확정에 따라 바뀜 | +| 하천 이격 | 100 m | 법정 수치 없음. 타당성 평가 별표 비고(산지계류 100 m 이내 구간 비율)를 후보로 씀 | 임도설계와 같은 기본값 | +| 탐색 복도 반폭 | 300 m | 예정노선 화면 전용값. 실제 지형으로 시험해 정함 | 시험 결과 기준 | +| 비중 계산 비중 | 예상 50 · 토공 25 · 기울기 25 (%) | 임도설계 기본 비중 | 이 화면에서 바꾸는 칸 없음 | +| 영선 목표 기울기 | 기울기 상한과 같게 | 임도설계 기본 동작 | 이 화면에서 바꾸는 칸 없음 | +| 측점 간격 | 20 m | 임도설계 측점 규칙과 같음 | 고정 | +| 횡단 표시 폭 | 좌우 각 20 m | 화면 고정값 | 고정 | +| 지형 판정 여유 | 지점이 지형 가장자리에서 300 m 안쪽 | 탐색 복도와 같은 값 | 복도 값과 함께 움직임 | + +## 준비 중 + +- 예정노선 단계에서 연도별 비중이나 목표 기울기를 직접 정하는 화면 칸은 없음. 지금은 모두 기본값으로 계산함. +- 3D 보기에 노견 · 절성토면 · 구조물을 올리는 기능은 없음. diff --git a/resources/help/D04/00_설명서.md b/resources/help/D04/00_설명서.md new file mode 100644 index 000000000..8127e7330 --- /dev/null +++ b/resources/help/D04/00_설명서.md @@ -0,0 +1,81 @@ +# 예정노선 확정 · 업체 · 내보내기 설명서 + +## 이 화면에서 하는 일 + +- 2단계(분석)에서 저장한 연도별 노선을 한눈에 확인함(연장 · 시점 · 종점 · 누가 · 확정 여부). +- 연도마다 일을 맡길 업체를 지정함. 아이슬로에 등록된 회사를 고르거나, 업체명과 메일 주소를 직접 적는 수기 지정 중 선택. 한 연도에 업체 여럿 지정 가능. +- [확정] 으로 연도 노선을 확정하고, 지정 업체에 노선 파일이 든 압축 파일(zip)을 메일로 보냄. +- [내보내기] 로 노선 파일 묶음을 내려받음. +- 업체 쪽에서는 받은 예정노선을 자기 임도 프로젝트로 연결해 설계를 이어 감(아래 「받은 업체의 임도 연결」 참고). + +## 화면 구성 + +- 가운데 = 연도 표. 프로젝트 이름이 위에 크게 나오고, 표 열은 연도 · 연장(m) · 시점(위도, 경도) · 종점(위도, 경도) · 누가(m) · 확정 · 지정 업체. +- 왼쪽 위 = 「확정할 연도」 카드. 분석 [저장] 이 된 연도마다 선택 상자가 있음. 아직 확정하지 않은 연도는 처음부터 선택되어 있음. +- 왼쪽 아래 = 단추 [내보내기] [확정] [저장]. + +## 작업 순서 + +1. 연도 표에서 연도마다 연장과 누가를 확인함. 분석을 저장하지 않은 연도는 누가 칸에 「노선 분석 [저장] 전」 이 나오며, 확정할 연도 목록에도 나타나지 않음. +2. 지정 업체 칸에서 업체를 추가함. + - 등록 회사: 「업체(등록 회사 찾기 또는 이름)」 칸에 글자를 입력하면 가입된 회사 이름이 목록으로 뜸. 목록에서 고르면 등록 회사로 지정됨. 메일 칸을 비우면 그 회사의 대표 메일이 쓰임. + - 수기 지정: 업체명과 메일 주소(@ 포함)를 둘 다 적음. 없으면 「등록 회사가 아니면 업체명과 메일이 필요합니다.」 안내가 나오고 추가되지 않음. + - [추가] 를 누르면 그 연도 칸에 업체 이름 + 메일이 표시됨. 같은 업체를 두 번 넣어도 한 번만 들어감. + - 잘못 넣은 업체는 업체 옆 [×] 로 뺌. +3. [저장] 을 누르면 지정 업체가 서버에 저장됨(「지정 업체를 저장했습니다.」). 저장 전에는 표 위에 「저장 안 된 변경이 있습니다.」 가 표시됨. +4. 「확정할 연도」 에서 확정할 연도를 고르고 [확정] 을 누름. 확인 창(「고른 연도를 확정하고 지정 업체에 노선 묶음을 메일로 보냅니다. 진행할까요?」)에서 진행을 누르면 확정과 메일 발송이 이뤄짐. 저장하지 않은 업체 변경이 있으면 자동으로 먼저 저장됨. +5. 필요하면 [내보내기] 로 파일을 내려받아 보관함. + +## 단추 + +| 단추 | 하는 일 | +| --- | --- | +| 내보내기 | 「프로젝트이름_예정노선.zip」 을 내려받음. 산림청은 모든 연도와 전체 노선을 받음. 지정받은 회사는 확정된 자기 연도만 받음 | +| 확정 | 고른 연도를 확정 처리하고 지정 업체에 메일을 보냄. 고른 연도가 없으면 「확정할 연도를 고르세요.」 안내 | +| 저장 | 연도별 지정 업체 목록을 서버에 저장함 | + +- 업체 추가와 삭제는 [저장] 을 누르기 전까지 이 브라우저 탭에만 임시로 남음. 탭을 닫으면 사라지므로 [저장] 을 누를 것. +- [저장] [확정] 은 산림청 소속 사용자만 가능. 그 밖의 사용자가 누르면 「산림청만 예정노선을 확정 · 지정할 수 있습니다.」 안내가 나옴. + +## 결과 읽는 법 + +- **확정 열** = 확정한 날짜와 시각(한국 시간). 비어 있으면 아직 확정 전. +- **지정 업체 열의 표시** + - 「Aislo」 = 아이슬로 등록 회사로 지정된 업체. + - 「메일 보냄」 = 확정 때 메일이 나갔다는 표시. 같은 업체에는 다시 확정해도 중복 발송하지 않음. + - 「연결됨」 = 그 업체가 이 연도 노선을 자기 임도 프로젝트로 가져가 연결했다는 표시. +- **[확정] 후 안내 문구** = 「확정 — 메일 sent 2 · already_sent 1」 꼴로 업체별 처리 결과를 개수로 보여 줌. + +| 결과 이름 | 뜻 | +| --- | --- | +| sent | 메일 발송 성공 | +| already_sent | 이미 보낸 업체여서 다시 보내지 않음 | +| no_email | 메일 주소가 없어 보내지 못함(등록 회사의 대표 메일이 비어 있는 경우 등) | +| failed | 메일 발송 실패 | + +## 보내지는 메일 + +- 제목: 「[예정노선 확정] 프로젝트이름 N년」. +- 본문: 프로젝트 · 사업 지역 · 연도 · 연장(km 와 m) 요약과 첨부 파일 목록, 압축을 풀면 노선 입력에 바로 올릴 수 있다는 안내 문구. +- 첨부: 그 업체의 연도 한 해 분량 zip 1개(파일 이름 「프로젝트이름_예정노선_연도.zip」). 내용은 「10_내보내기_파일_구성」 참고. + +## 받은 업체의 임도 연결 + +- 지정받은 등록 회사는 대시보드의 「받은 예정노선」 구역에서 확정된 연도를 봄. 열은 예정노선 · 연도 · 확정 · 연결 상태(연결됨 / 미연결 / 업데이트 있음) · 작업. +- [보기] = 예정노선 화면을 보기만 가능한 상태로 엶. +- [연결] = 모달에서 두 가지 중 선택. + - 「새 임도 프로젝트로」: 예정노선 이름 + 연도로 임도 프로젝트를 새로 만들고 노선 입력 단계(B03)로 이동. 예정노선의 설계속도(20 · 30 · 40 km/h)가 새 프로젝트의 설계속도 기본값으로 들어감. + - 「기존 프로젝트에 연결」: 우리 회사의 임도 프로젝트를 골라 그 프로젝트에 연결. 임도 프로젝트가 없으면 「우리 회사 임도 프로젝트가 없습니다.」 표시. +- 연결하면 그 연도 노선(shapefile 한 벌)이 노선 입력 단계의 입력 파일로 들어감. 파일을 직접 올린 것과 같은 길이라 이후 처리도 같음. 지형 자료는 업체가 따로 올려야 함. +- 이미 분석 결과가 있는 임도 프로젝트에 연결하면 기존 결과를 지워도 되는지 묻는 확인 창이 먼저 나옴. 취소하면 아무것도 바뀌지 않음. +- 임도 프로젝트 노선 입력 화면의 [예정노선에서 가져오기] 단추로도 같은 일을 할 수 있음. 지정받은 연도를 고르면 노선이 입력됨. +- 연결 시점의 노선이 복사되므로, 산림청이 뒤에 노선을 바꿔도 임도 프로젝트는 자동으로 바뀌지 않음. 대신 「업데이트 있음」 표시가 뜨며, 노선 입력 화면 위쪽 띠에서 [다시 가져오기] 로 직접 반영 여부를 결정함. +- 한 임도 프로젝트는 한 연도에만 연결됨. 다른 연도로 다시 연결하면 앞의 연결은 풀림. + +## 알아 둘 것 + +- 확정 시각은 [확정] 을 누를 때마다 새로 기록됨. 이미 메일을 보낸 업체에는 다시 보내지 않음(다시 보내는 단추는 화면에 없음). +- 확정은 분석 [저장] 이 된 연도만 가능. 저장하지 않은 연도를 억지로 확정하려 하면 「분석 [저장]이 안 된 연도입니다」 오류가 나옴. +- [저장] 은 표에 있는 모든 연도의 지정 업체를 화면 내용대로 맞춤. 업체를 모두 뺀 연도는 지정이 비워짐. +- 같은 업체 판정: 등록 회사는 회사 번호, 수기 업체는 메일 주소(대소문자 구분 없음). +- 내보내기는 서버에 저장된 노선만 사용함. 2단계에서 [저장] 하지 않은 변경은 반영되지 않음. diff --git a/resources/help/D04/10_내보내기_파일_구성.md b/resources/help/D04/10_내보내기_파일_구성.md new file mode 100644 index 000000000..edfcf1655 --- /dev/null +++ b/resources/help/D04/10_내보내기_파일_구성.md @@ -0,0 +1,64 @@ +# 내보내기 파일 구성 + +## 한눈에 + +- 내려받는 파일 이름 = 「프로젝트이름_예정노선.zip」. 이름에 쓸 수 없는 글자는 밑줄(_)로 바뀜. +- 압축 안에 연도 이름의 폴더가 연도마다 하나, 그리고 「전체」 폴더가 하나 들어 있음(전체 폴더는 산림청만 받음). +- 업체에 보내는 메일 첨부 zip 은 한 연도 분량이며, 폴더 없이 그 연도 파일들이 바로 들어 있음. + +| 위치 | 내용 | +| --- | --- | +| 연도 폴더(예: 2026) | 그해 시점에서 종점까지 중심선 한 줄(shapefile 한 벌) + 좌표표 엑셀 | +| 전체 폴더 | 모든 연도를 이은 한 줄(shapefile 한 벌, 발주처 보관용) + 모든 연도가 담긴 좌표표 엑셀 | + +## shapefile 한 벌 + +- 확장자 다섯 가지가 한 벌임: .shp(선 모양) · .shx(색인) · .dbf(속성 표) · .prj(좌표계 정의) · .cpg(글자 코드). 하나라도 빠지면 안 되므로 같이 보관할 것. +- 파일 이름 = 「대상지_지역.연장km_연도」. 예: 연장이 2.2 km 이면 「대상지_지역.2.2_2026」. 전체 노선은 연도 자리에 「전체」. +- 좌표계 = UTM-K(EPSG:5179). 프로젝트가 다른 좌표계로 작업했더라도 내보낼 때 5179 로 바뀜. +- 글자 코드 = cp949(한글 윈도우 표준). 엑셀 · 지리정보 프로그램에서 한글 칸 이름이 깨지지 않음. +- 선 모양 = 평면 중심선 한 줄(높이 값 없음), 기록 한 건. +- 양식은 2026년 임도 용화 예정노선 파일(대상지_일월.용화.2.2)과 같은 꼴임. 좌표계 정의(.prj)는 그 파일 원문을 그대로 씀. + +### 속성 표 칸 + +| 칸 이름 | 뜻 | 형식 | +| --- | --- | --- | +| 대상지 | 「사업지역.연장km」 글자(예: 지역.2.2). 20바이트(한글 10자 안팎)를 넘으면 뒤가 잘림 | 글자 20 | +| 길이 | 노선 연장, 단위 km(소수 셋째 자리) | 숫자 11.3 | +| 연도 | 사업 연도. 전체 노선은 비어 있음 | 정수 4 | +| 시점누가 | 그 선이 시작하는 측점 값(m) | 숫자 11.2 | +| 종점누가 | 그 선이 끝나는 측점 값(m) | 숫자 11.2 | + +- 대상지 · 길이 두 칸은 용화 양식과 같고, 연도 · 시점누가 · 종점누가 는 이 프로그램이 덧붙인 칸임. +- 누가 값은 2단계에서 이어 셈한 값 그대로임. 앞 연도 종점 누가 = 다음 연도 시점 누가. + +## 좌표표 엑셀 + +- 파일 이름 = 「좌표표_프로젝트이름.xlsx」, 시트 이름 「좌표표」. +- 첫 줄에 「프로젝트이름 예정노선 좌표표 (UTM-K EPSG:5179)」 제목, 둘째 줄이 열 이름, 이후 연도마다 한 줄. +- 연도 폴더의 좌표표는 그 연도 한 줄, 전체 폴더의 좌표표는 모든 연도가 줄마다 들어 있음. + +| 열 | 뜻 | +| --- | --- | +| 연도 | 사업 연도 | +| 시점 X · 시점 Y | 시작점 UTM-K 좌표(m) | +| 종점 X · 종점 Y | 끝점 UTM-K 좌표(m) | +| 시점 경도 · 시점 위도 | 시작점 위경도(도) | +| 종점 경도 · 종점 위도 | 끝점 위경도(도) | +| 시점누가(m) · 종점누가(m) | 이어 셈한 측점 값 | +| 연장(m) | 그 연도 노선 길이 | + +## 보는 사람에 따른 차이 + +| 사용자 | 받는 범위 | +| --- | --- | +| 산림청 | 분석이 저장된 모든 연도 폴더 + 전체 폴더 | +| 지정받은 등록 회사 | 확정되었고 자기 회사가 지정된 연도 폴더만. 전체 폴더 없음. 받을 연도가 없으면 「받을 수 있는 연도가 없습니다」 로 거절됨 | +| 저장된 분석이 전혀 없을 때 | 「분석 [저장]이 된 연도가 없습니다.」 로 거절됨 | + +## 알아 둘 것 + +- 파일은 서버에 저장된 노선으로만 만들며, 화면에서 아직 저장하지 않은 노선은 반영되지 않음. +- 전체 노선은 앞 연도 끝점과 다음 연도 시작점이 겹치므로 겹치는 한 점을 빼고 이어 붙임. +- 임도 프로젝트로 연결할 때는 좌표표 없이 shapefile 한 벌만 노선 입력에 들어감. diff --git a/resources/help/D04/30_사용자_확정_전_값.md b/resources/help/D04/30_사용자_확정_전_값.md new file mode 100644 index 000000000..4e12a87dd --- /dev/null +++ b/resources/help/D04/30_사용자_확정_전_값.md @@ -0,0 +1,18 @@ +# 사용자 확정 전 값 + +아래 항목은 코드의 현재 동작이며, 바꾸려면 개발 담당에게 요청. + +| 값 | 지금 기본값 | 출처 | 상태 | +| --- | --- | --- | --- | +| 내보내기 좌표계 | UTM-K(EPSG:5179) 고정 | 용화 예정노선 양식 | 양식 따름 | +| 글자 코드 | cp949 | 용화 예정노선 양식 | 양식 따름 | +| 덧붙은 속성 칸 | 연도 · 시점누가 · 종점누가 | 이 프로그램에서 추가 | 업체 쪽 요청 시 조정 가능 | +| 좌표표 엑셀 | 연도 폴더 · 전체 폴더에 포함, 선택 기능은 아님 | 요구서는 「선택」 으로 적었으나 실제로는 항상 만듦 | 확정 전 | +| 메일 재발송 | 이미 보낸 업체에는 다시 보내지 않음, 화면에 재발송 단추 없음 | 서버에 재발송 옵션은 있으나 화면에 연결되지 않음 | 준비 중 | +| 연결 시 연도 측점 | 연결한 임도 프로젝트에서 측점이 처음부터 다시 시작할지 | 이어 받기 기능이 필요해 뒤로 미룬 항목 | 준비 중 | +| 설계속도 전달 | 새 임도 프로젝트로 연결할 때 예정노선 설계속도가 노선 단계(B05) 설정에도 들어감. 기존 프로젝트는 프로젝트 설계속도 칸이 비어 있을 때만 채움 | 임도설계 설정과 같은 값 범위 | 동작 중 | + +## 준비 중 + +- 지정받은 업체에 확정 메일 외 별도 알림을 보내는 기능은 없음. +- 업체 지정 이력(누가 언제 바꿨는지)을 보여 주는 화면은 없음. diff --git a/resources/help/E01/00_설명서.md b/resources/help/E01/00_설명서.md new file mode 100644 index 000000000..0998ead39 --- /dev/null +++ b/resources/help/E01/00_설명서.md @@ -0,0 +1,55 @@ +# 안정성평가 만들기 설명서 + +## 이 화면에서 하는 일 + +- 횡단 설계(B06)까지 끝난 임도 프로젝트 하나를 골라 새 안정성평가 프로젝트를 만듦. +- 만드는 순간의 원본 자료를 안정성평가 쪽에 따로 복사해 둠(동결 복사). 그 뒤 해석은 모두 이 복사본으로 함. +- 대시보드 [+] 새 프로젝트 → 「안정성평가」를 누르면 이 화면이 열림. + +## 작업 순서 + +1. **대상 임도 프로젝트** 칸에서 원본 임도를 고름. 목록 글 = 프로젝트 이름 · 지역 · 사업 연도(최근에 고친 프로젝트가 위). +2. **프로젝트명** 칸을 확인함. 손대지 않으면 「원본 이름 안정성평가」로 자동으로 채워짐 — 원하는 이름으로 바꿔도 됨. +3. [등록]을 누름. 복사하는 동안 화면 전체가 잠기고, 끝나면 「프로젝트를 만들었습니다.」 알림이 뜸. +4. 새 프로젝트가 현재 프로젝트가 되고 첫 단계 「지반 조건」(E02) 화면으로 넘어감. + +## 단추 + +| 단추 | 하는 일 | +| --- | --- | +| [?] | 이 설명서를 엶 | +| [취소] | 만들지 않고 대시보드로 돌아감 | +| [등록] | 고른 임도를 복사해 안정성평가 프로젝트를 만듦. 고를 임도가 없으면 흐리게 꺼져 있음 | + +## 목록에 나오는 임도 + +- 우리 회사 임도 설계 프로젝트 중 **횡단 설계(B06) 단계가 끝난 것만** 나옴. +- 고를 임도가 하나도 없으면 칸 아래에 「횡단 설계(B06)까지 끝난 임도 프로젝트가 없습니다.」가 보임 — 먼저 임도 프로젝트에서 횡단 설계를 끝낼 것. +- 지역 · 도로 종류 · 사업 연도는 원본 값을 그대로 물려받음. + +## 복사하는 것 · 안 하는 것 + +해석에 쓰는 자료만 복사함(보통 수십 MB 안쪽). + +| 복사함 | 안 함 | +| --- | --- | +| 원본 프로젝트 정보 · 단계 상태 · 지표면 확정 값 | 원본 점군(LAS) 파일 | +| 최신 노선과 측점 · 종단 · 횡단 자료 | 상세 설계(B07) · 수량(B08) · 내역(B09) | +| 노선 폴더(구조물 배치 포함) · 종횡단 파일 | 쓰이지 않은 다른 지형 격자 | +| 원본 설계에 쓰인 지형 격자(DTM) 하나 | | +| 최신 노선 3D 면 · 배수 편집분 | | + +## 결과 읽는 법 + +- [등록]이 끝나면 지반 조건(E02) 화면이 열리고, 지반물성치 · 기준안전율 등은 기본값으로, 측점별 토층 두께는 복사한 B06 값으로 채워져 있음. +- 원본 횡단 파일이 없는 측점이 있으면 E02 · E03 화면 위에 **「횡단 없는 측점 N 개 — 해석에서 빠짐」** 띠가 보임. 띠를 누르면 빠진 측점의 누가거리(m)가 펼쳐짐. +- 빠진 측점은 해석 목록에 나오지 않음. 나머지 측점 해석에는 영향 없음. + +## 알아 둘 것 + +- **업데이트 없음**: 만든 뒤 원본 임도를 고쳐도 이 안정성평가는 바뀌지 않음(만든 순간의 자료로 고정). +- 원본의 바뀐 설계로 다시 평가하려면 이 화면에서 **안정성평가를 새로 만들 것**. +- 복사에 실패하면 「원본 자료 복사에 실패했습니다.」 알림이 뜨고, 만들다 만 프로젝트는 자동으로 지워짐 — 다시 [등록]하면 됨. +- 원본 임도 프로젝트에는 아무것도 쓰지 않음(읽기만 함). +- 안정성평가의 지반 값은 **문헌 추정치 · 현장 시험 없음**이 기본임 — 다음 단계(E02)에서 현장 여건에 맞게 확인 · 수정할 것. +- 횡단 없는 측점을 살리려면 원본 임도에서 그 측점 횡단을 다시 만든 뒤 안정성평가를 새로 만들 것. diff --git a/resources/help/E02/00_설명서.md b/resources/help/E02/00_설명서.md new file mode 100644 index 000000000..385338eda --- /dev/null +++ b/resources/help/E02/00_설명서.md @@ -0,0 +1,50 @@ +# 지반 조건 설명서 + +## 이 화면에서 하는 일 + +- 2D 해석(E03)에 들어갈 지반 조건을 정함 — 지반물성치 · 기준안전율 · 노면 하중 · 지진 · 지하수 · 층 두께. +- 처음 열면 기본값(문헌 추정치)과 복사한 B06 측점 값으로 채워져 있음. 칸마다 바꿀 수 있음. +- 좌측 = 안내 글 · 상태 글 · [초기화] [저장]. +- 가운데 = 카드 다섯 — 「지반물성치」 · 「기준안전율」 · 「노면 하중 · 지진」 · 「지하수」 · 「층 두께 · 구간 덮어쓰기」. + +## 작업 순서 + +1. **지반물성치** 카드에서 지층별 γt · γsat · c · φ 를 확인함. 현장 값이 있으면 고쳐 넣고, 필요하면 [지층 추가]. +2. 같은 카드 아래 **B06 지반 → 지층** 줄에서 B06 의 토사 · 리핑암 · 발파암 · 성토체가 어느 지층으로 해석될지 고름. +3. **기준안전율** 카드에서 조건(건기 · 우기 · 지진 시 · 단기)별 기준을 확인함. +4. **노면 하중 · 지진** 카드에서 노면 하중(kPa)과 지진 검토 켬/끔 · 수평지진계수 kh 를 정함. +5. **지하수** 카드에서 건기 지하수와 우기 규칙(넷 중 하나)을 고름. +6. **층 두께 · 구간 덮어쓰기** 카드에서 특정 구간만 지층 · 토층 두께를 바꿀 것이 있으면 [구간 추가]. 아래 **측점별 적용 지층** 표로 결과를 확인함. +7. 좌측 [저장]을 누름. 저장해야 2D 해석(E03)에 쓰임. + +## 단추 + +| 단추 | 자리 | 하는 일 | +| --- | --- | --- | +| [저장] | 좌측 아래 | 화면 값을 검사한 뒤 작업본으로 저장함. 틀린 칸이 있으면 저장하지 않고 알림 | +| [초기화] | 좌측 아래 | 확인 창 뒤 초기값(만들 때 기본값 + B06 측점)으로 되돌림. 저장한 값이 사라짐 | +| [?] [<] [>] | 좌측 아래 | 설명서 · 이전 단계 · 다음 단계(2D 해석) | +| [지층 추가] | 지반물성치 카드 | 「새 지층 n」 줄을 덧붙임(풍화토 기본값으로 시작) | +| [지움] | 표 줄 끝 | 그 줄을 지움. 쓰이는 지층은 지울 수 없음 | +| [기본값] | 카드마다 | 그 카드 값만 기본값으로 되돌림(다른 카드는 그대로) | +| [구간 추가] | 층 두께 카드 | 덮어쓰기 구간 한 줄(첫 측점 ~ 끝 측점)을 덧붙임 | +| [수위선 구간 추가] · [점 추가] | 지하수 카드 | 우기 규칙이 「사용자 수위선」일 때만 보임 | + +## 결과 읽는 법 + +- 칸에 마우스를 올리면 **기본값과 근거**(지식DB 07 · KDS 11 70 05 등)가 보임. 사용자가 더한 지층은 「사용자 지층 — 출처 없음」. +- 틀린 값은 칸 테두리가 **빨갛게** 되고, 마우스를 올리면 까닭(「범위 밖 (0 ~ 60)」 등)이 보임. 좌측에 「입력값을 확인하세요 — 틀린 칸 N」. +- 바꾸고 저장하지 않으면 좌측에 「저장 안 된 변경이 있습니다.」가 보임. +- **측점별 적용 지층** 표 = 측점마다 실제로 해석에 들어갈 위 지층 · 아래 지층 · 토층 두께. 구간 덮어쓰기가 걸린 줄은 바탕색이 다름. 아래 지층이 없으면 「전부 위 지층」. +- 공유받은 회사(보기만)는 칸과 단추가 꺼지고 「보기만 허용된 프로젝트입니다.」가 보임. + +## 알아 둘 것 + +- **문헌 추정치 · 현장 시험 없음**: 지반물성치 기본값은 국내 설계 편람 · 학술 자료의 대표값임. 현장 시추 · 시험 값이 아니므로 결과는 참고용 — 현장 조사 값이 있으면 꼭 바꿔 넣을 것. +- 자동저장 없음. 바꾼 값은 이 브라우저 탭에만 임시로 남고, [저장]해야 E03 [해석]에 쓰임. +- 화면 위 「횡단 없는 측점 N 개 — 해석에서 빠짐」 띠 = 원본에 횡단 파일이 없어 해석에서 빠지는 측점. 누르면 목록이 펼쳐짐. +- 측점의 B06 지반 · B06 토층 두께는 복사본 값이라 화면에서 고칠 수 없음 — 바꾸려면 구간 덮어쓰기를 쓸 것. +- 저장 뒤 E03 에서 [해석]을 다시 누르면 값이 바뀐 측점만 다시 계산함. +- 기준안전율 표의 「단기」 줄 · 「쌓기(연약지반)」 칸은 값만 보관함 — 지금 2D 해석 판정은 건기 · 우기 · 지진 시의 깎기 · 쌓기 칸만 씀. +- 우기 지하수 규칙(KDS 기본 외 갈래 포함)은 지금 E03 횡단 그림의 수위선에 반영됨. 안전율 계산은 아직 모든 측점을 「공사 뒤 지표까지 포화」로 셈 — 고른 갈래의 계산 반영은 준비 중. +- 칸 뜻 · 범위는 「칸 뜻」, 근거 · 수식은 「쓰인 방법과 근거」, 확정 안 된 값 목록은 「사용자 확정 전 값」 항목에 있음. diff --git a/resources/help/E02/10_칸_뜻.md b/resources/help/E02/10_칸_뜻.md new file mode 100644 index 000000000..872615c53 --- /dev/null +++ b/resources/help/E02/10_칸_뜻.md @@ -0,0 +1,75 @@ +# 칸 뜻 + +## 지반물성치 표 + +| 칸 | 뜻 | 넣을 수 있는 범위 | +| --- | --- | --- | +| 지층 | 지층 이름 | 1~30 자 · 같은 이름 안 됨 | +| γt (kN/m³) | 습윤 단위중량 — 물에 잠기지 않은 흙 1 m³ 의 무게 | 10 ~ 30 | +| γsat (kN/m³) | 포화 단위중량 — 물에 잠긴 흙 1 m³ 의 무게. 지하수위 아래에서 씀 | 10 ~ 30 · γt 이상 | +| c (kPa) | 점착력 — 흙 알갱이끼리 붙잡는 힘 | 0 ~ 1,000 | +| φ (°) | 내부마찰각 — 흙이 서로 비비며 버티는 정도(클수록 단단함) | 0 ~ 60 | +| 지하수 무리 | 「토사 · 풍화암」 또는 「암반」. 우기 규칙이 KDS 기본일 때 어느 수위 규칙을 쓸지 가름 | 둘 중 하나 | + +기본 지층 여섯 = 풍화토 · 풍화암 · 연암 · 경암 · 성토 · 붕적토. 값은 「사용자 확정 전 값」 항목에 있음. + +## B06 지반 → 지층 + +| 칸 | 뜻 | 기본 | +| --- | --- | --- | +| 토사 (경계 위) | B06 횡단의 암 경계 위 흙(모든 측점) | 풍화토 | +| 리핑암 (경계 아래) | B06 리핑암 측점의 암 경계 아래 | 풍화암 | +| 발파암 (경계 아래) | B06 발파암 측점의 암 경계 아래 | 연암 | +| 성토체 | 쌓기로 새로 올린 흙 | 성토 | + +## 층 두께 · 구간 덮어쓰기 + +| 칸 | 뜻 | +| --- | --- | +| 시작 (m) · 끝 (m) | 덮어쓸 누가거리 구간. 양 끝 측점 포함 · 끝은 시작보다 커야 함(0 ~ 100,000) | +| 위 지층 | 구간 안 측점의 위 지층. 「B06 그대로」 = 바꾸지 않음 | +| 아래 지층 | 구간 안 측점의 아래 지층. 「B06 그대로」 = 바꾸지 않음 | +| 토층 두께 (m) | 원지반에서 아래 지층 윗면까지 깊이. 빈 칸 = B06 그대로(0 ~ 50) | + +- 줄이 여럿 겹치면 **뒤 줄이 이김**. +- 토사 측점은 B06 토층 두께가 없어 「전부 위 지층」임. 토사 측점에 아래 지층을 넣으려면 아래 지층과 함께 토층 두께도 넣을 것. +- 쓰이는 지층(B06 지반 연결 · 구간에서 고른 지층)은 물성 표에서 지울 수 없음. + +## 측점별 적용 지층 (읽기 전용) + +| 칸 | 뜻 | +| --- | --- | +| 측점 | 측점 번호(예 `5+20`) | +| B06 지반 | 복사한 B06 횡단의 지반 구분(토사 · 리핑암 · 발파암) | +| B06 토층 두께 (m) | B06 암 경계 깊이. 토사 측점은 「-」 | +| 위 지층 · 아래 지층 · 토층 두께 (m) | 연결 · 구간 덮어쓰기를 모두 반영한 최종 값 | + +## 기준안전율 + +- 줄 = 건기 · 우기 · 지진 시 · 단기 · 칸 = 깎기 · 쌓기 · 쌓기(연약지반). +- 넣을 수 있는 범위 = 1.0 ~ 3.0. +- 지금 2D 해석 판정은 건기 · 우기 · 지진 시 줄의 깎기 · 쌓기 칸만 씀. + +## 노면 하중 · 지진 + +| 칸 | 뜻 | 기본 · 범위 | +| --- | --- | --- | +| 노면 하중 (kPa) | 노면 양 끝 사이에 고르게 얹는 차량 · 통행 하중 | 10 · 0 ~ 100 | +| 지진 검토 | 켜면 E03 에 「지진」 조건이 생김 | 끔 | +| 수평지진계수 kh | 흙 무게의 몇 배를 옆으로 미는 힘으로 볼지. 지진 검토를 켰을 때만 넣음 | 0 · 0 ~ 0.5 | + +## 지하수 + +| 칸 | 뜻 | 기본 | +| --- | --- | --- | +| 건기 지하수 | 건기 · 지진 시 수위 규칙(없음 · 지표 포화 · 비탈 높이 ½ 포화) | 없음 | +| 우기 규칙 | 넷 중 하나 — KDS 기본 · 지표 아래 깊이 = 비탈 높이 × 비율 · 간극수압비 r_u · 사용자 수위선 | KDS 기본 | +| 우기 · 토사 · 풍화암 | KDS 기본일 때, 비탈 겉 지층이 「토사 · 풍화암」 무리인 측점의 규칙 | 지표 포화 | +| 우기 · 암반 | KDS 기본일 때, 비탈 겉 지층이 「암반」 무리인 측점의 규칙 | 비탈 높이 ½ 포화 | +| 깊이 비율 | 수위 = 공사 뒤 지표에서 (비탈 높이 × 비율)만큼 아래 | 0.5 · 0 ~ 1 | +| r_u | 간극수압 = 그 자리 흙 무게 압력 × r_u | 0.2 · 0 ~ 0.9 | +| 수위선 구간 — 시작 · 끝 (m) | 수위선을 쓸 누가거리 구간. 덮지 않은 측점은 KDS 기본 규칙 | 없음 | +| 점 (offset · 깊이) | offset = 중심선에서 거리(m · 좌 +, −200 ~ 200) · 깊이 = 공사 뒤 지표 아래(m, 0 ~ 50). 점은 둘 이상 · offset 은 작은 쪽부터 커지게 | [−10 : 1] · [10 : 1] 로 시작 | + +- 비탈 겉 지층 = 토층 두께가 0 인 측점은 아래(암) 지층, 그 밖은 위 지층. +- 수위선 구간이 겹치면 뒤 줄이 이김. diff --git a/resources/help/E02/20_쓰인_방법과_근거.md b/resources/help/E02/20_쓰인_방법과_근거.md new file mode 100644 index 000000000..eb8f3ee94 --- /dev/null +++ b/resources/help/E02/20_쓰인_방법과_근거.md @@ -0,0 +1,60 @@ +# 쓰인 방법과 근거 + +## 지반 값이 해석에 들어가는 길 + +- 비탈 안 흙덩이를 세로로 잘게 나눈 조각(절편)마다 무게와 버티는 힘을 셈(자세한 해석 방법은 E03 설명서 「쓰인 방법과 근거」). +- **무게** = 지층별 (단위중량 × 그 지층 두께)의 합 × 절편 폭 + 노면 하중. 지하수위 위는 γt, 아래는 γsat 를 씀. +- **버티는 힘**(Mohr-Coulomb 강도) = c × 바닥 길이 + (바닥을 누르는 힘 − 물이 떠받치는 힘) × tanφ. +- 물이 떠받치는 힘(간극수압) = 물 단위중량 9.81 kN/m³ × 수위에서 절편 바닥까지 깊이. 물이 차면 버티는 힘이 줄어 안전율이 낮아짐. +- **안전율** = 버티는 힘 합 ÷ 미끄러지게 하는 힘 합. 1 보다 작으면 무너지는 쪽, 기준안전율 이상이면 O.K. + +## 지층을 나누는 방법 + +- 암 경계 = 원지반 선을 토층 두께만큼 그대로 아래로 내린 선(B06 물량 가름과 같은 정의). +- 경계 위 = 위 지층(기본 풍화토) · 경계 아래 = 아래 지층(리핑암 측점 = 풍화암 · 발파암 측점 = 연암) · 쌓기 흙 = 성토. +- B06 토층 두께는 물량을 가르려고 정한 값(기본 0.5 m)이라 실제 지층 두께와 다를 수 있음 — 구간 덮어쓰기로 고칠 것. + +## 기준안전율 — KDS 11 70 05 (건설공사 비탈면 설계기준) + +| 조건 | 깎기 | 쌓기 | 쌓기(연약지반) | 지하수 · 하중 조건 | +| --- | --- | --- | --- | --- | +| 건기 | 1.5 | 1.5 | 1.3 | 비탈 안에 지하수 없음 | +| 우기 | 1.2 | 1.3 | 1.2 | 토사 · 풍화암 = 지표까지 포화 · 암반 = 비탈 높이 ½ 깊이까지 포화 | +| 지진 시 | 1.1 | 1.1 | 1.1 | 건기 수위 + 수평지진계수 kh | +| 단기 | 1.1 | 1.1 | 1.1 | 1 년 미만 · 시공 중 | + +- 근거 표 = KDS 11 70 05 표 4.3-1(쌓기 일반) · 4.3-2(연약지반 쌓기) · 4.3-3(깎기). +- 우기 깎기 1.2 = 지하수위를 정해 두고 해석하는 방식의 값(강우 침투 해석을 따로 하면 1.3). 지하수 카드의 KDS 기본 규칙과 짝을 이룸 — 다른 우기 규칙을 고르면 기준안전율도 함께 검토할 것. + +## 지하수 규칙 넷 + +1. **KDS 기본** — 비탈 겉 지층이 토사 · 풍화암이면 지표까지 포화, 암반이면 비탈 높이 ½ 깊이까지 포화(KDS 11 70 05 표 4.3-3). +2. **지표 아래 깊이 = 비탈 높이 × 비율** — 수위 = 공사 뒤 지표에서 (비탈 높이 × 비율)만큼 아래. 좌 · 우 비탈은 각자 높이로 셈. 근거 없음 · 사용자 판단(0.5 = KDS 암반 ½ 와 같은 값). +3. **간극수압비 r_u** — 수위선 없이 간극수압 = r_u × 그 자리 흙 무게 압력(γ × 깊이). 근거 없음 · 사용자 판단. +4. **사용자 수위선** — 구간마다 점(offset · 지표 아래 깊이)을 이은 선. 점 사이는 곧은 선. 덮지 않은 측점은 KDS 기본 규칙. + +- 건기 · 지진 시는 「건기 지하수」 규칙(기본 없음)을 씀. +- 지금 E03 안전율 계산은 우기를 모든 측점 「공사 뒤 지표까지 포화」로 셈 — 위 규칙은 횡단 그림의 수위선에만 반영됨(계산 반영은 준비 중). 포화는 가장 불리한 쪽 가정임. + +## 노면 하중 + +- 노면 양 끝 사이에 고르게 얹는 하중(기본 10 kPa = 1 m² 에 약 1 t). +- 근거 = 옹벽 뒤 상재하중 10 kN/m² 를 빌려 씀(지식DB 구조물 안정계산 · KDS 11 80 05). 임도 차량 하중의 고유 근거는 없음. + +## 지진 + +- 유사정적 해석 — 흙 무게 × kh 만큼 옆으로 미는 힘을 더해 셈. +- KDS 11 90 00 1.8.1 ② — 무너졌을 때 영향 범위에 주요 구조물이 없으면 적용하지 않음. 임도는 발주자와 협의할 것 · 기본 끔. +- kh 는 지반 가속도의 비율로 사용자가 넣음(지식DB 02 예시 0.05 ~ 0.15). + +## 지반물성치 기본값 근거 + +- 지식DB 07(지반물성치 원문 근거) §3 · §4 종합 대조표 — 「도로설계요령」 · 「도로교시방서」 · 서울시 「지반조사편람」(2006) · 한국지반공학회 사면안정 학술발표회 · 한국도로공사 「도로설계실무편람」(1996) · 「건설공사 비탈면 설계기준 해설」 · Hoek & Bray. +- 지식DB 04(표준 지반물성치 후보군 · 허용안전율) — 지층별 범위와 후보값. +- 칸마다 근거 문장은 칸에 마우스를 올리면 보임. + +## 한계 + +- 현장 시추 · 시험 없이 문헌 대표값을 씀 — 같은 이름의 지층도 현장마다 값이 크게 다를 수 있음. +- 측점마다 지층은 위 · 아래 두 층까지만 나눔(구간 덮어쓰기도 두 층). +- 강우 침투 해석(시간에 따른 수위 변화)은 하지 않음. diff --git a/resources/help/E02/30_사용자_확정_전_값.md b/resources/help/E02/30_사용자_확정_전_값.md new file mode 100644 index 000000000..631fd941c --- /dev/null +++ b/resources/help/E02/30_사용자_확정_전_값.md @@ -0,0 +1,58 @@ +# 사용자 확정 전 값 + +아래 값은 문헌 · 기준에서 고른 **추정 기본값**임. 현장 시험 값이 아니며, 발주처 · 설계자 확인 전 상태임. 화면에서 언제든 바꿀 수 있음. + +## 지반물성치 기본값 + +| 지층 | γt (kN/m³) | γsat (kN/m³) | c (kPa) | φ (°) | 문헌 범위(지식DB 07 §4) | 상태 | +| --- | --- | --- | --- | --- | --- | --- | +| 풍화토 | 18.0 | 19.0 | 15 | 30 | γt 18~19 · c 5~20 · φ 27~32 | 문헌 추정 · 확정 전 | +| 풍화암 | 20.0 | 21.0 | 30 | 33 | γt 19.5~21 · c 10~30 · φ 30~36 | 문헌 추정 · 확정 전 | +| 연암 | 24.0 | 24.5 | 150 | 35 | γt 22~24 · c 50~300 · φ 33~40 | 문헌 추정 · 확정 전 | +| 경암 | 26.0 | 26.0 | 300 | 40 | γt 25~27 · c 200 이상 · φ 40~45 | 문헌 추정 · 확정 전 | +| 성토 | 18.0 | 19.0 | 10 | 28 | γt 18~19 · c 0~15 · φ 28~30 | 문헌 추정 · 확정 전 | +| 붕적토 | 17.5 | 18.5 | 5 | 27 | γt 17~18 · c 0~10 · φ 25~28 | 문헌 추정 · 확정 전 | + +- 출처 문장은 칸에 마우스를 올리면 보임. + +## 지층 연결 · 두께 + +| 값 | 지금 기본값 | 출처 | 상태 | +| --- | --- | --- | --- | +| B06 토사 → | 풍화토 | 요구서 345 6장 · 분석 345-D | 브레인 제안 · 확정 전 | +| B06 리핑암 → | 풍화암 | 같음 | 브레인 제안 · 확정 전 | +| B06 발파암 → | 연암 | 같음 | 브레인 제안 · 확정 전 | +| B06 성토체 → | 성토 | 같음 | 브레인 제안 · 확정 전 | +| 암 측점 토층 두께 | B06 암 경계 깊이(기본 0.5 m) | B06 물량 가름용 값 — 지층 조사 값 아님 | 확인 필요 | + +## 기준안전율 + +| 값 | 지금 기본값 | 출처 | 상태 | +| --- | --- | --- | --- | +| 건기 · 우기 · 지진 시 · 단기 | 「쓰인 방법과 근거」 표 | KDS 11 70 05 표 4.3-1 · 4.3-2 · 4.3-3 | 기준값 · 사용자 변경 가능 | +| 우기 깎기 | 1.2 | 기본값 근거 글 = 지하수위 결정 방식 1.2(강우 침투 해석 1.3) | 지식DB 04 표는 「지표 포화 1.2 · 일반 지하수위 1.3」로 풀어 적음 — 어느 해석을 따를지 확인 필요 | + +## 하중 · 지진 + +| 값 | 지금 기본값 | 출처 | 상태 | +| --- | --- | --- | --- | +| 노면 하중 | 10 kPa | 옹벽 뒤 상재하중 10 kN/m² 준용(KDS 11 80 05) · 임도 차량 하중 고유 근거 없음 | 브레인 제안 · 확정 전 | +| 지진 검토 | 끔 | KDS 11 90 00 1.8.1 ② · 임도는 발주자 협의 | 발주자 협의 필요 | +| 수평지진계수 kh | 0 | 사용자 입력 몫 | 켤 때 값 정할 것 | + +## 지하수 규칙 + +| 값 | 지금 기본값 | 출처 | 상태 | +| --- | --- | --- | --- | +| 건기 지하수 | 없음 | KDS 11 70 05 표 4.3-3 | 기준값 | +| 우기 규칙 | KDS 기본 | KDS 11 70 05 표 4.3-3 | 기준값 | +| 우기 · 토사 · 풍화암 | 지표 포화 | KDS 11 70 05 표 4.3-3 | 기준값 | +| 우기 · 암반 | 비탈 높이 ½ 포화 | KDS 11 70 05 표 4.3-3 | 기준값 | +| 깊이 비율 | 0.5 | 근거 없음(KDS 암반 ½ 와 같은 값) | 사용자 입력 | +| r_u | 0.2 | 근거 없음 | 사용자 입력 | +| 지하수 무리 | 풍화토 · 풍화암 · 성토 · 붕적토 → 「토사 · 풍화암」, 연암 · 경암 → 「암반」 | 기본값 파일 | 확정 전 | + +## 계산에 아직 안 들어간 값 + +- 우기 규칙(KDS 기본의 암반 ½ · 깊이 비율 · r_u · 사용자 수위선)은 지금 E03 횡단 그림의 수위선에만 보임. 안전율 계산은 모든 측점을 「공사 뒤 지표까지 포화」로 셈 — 계산 반영은 준비 중. +- 기준안전율 「단기」 줄 · 「쌓기(연약지반)」 칸은 2D 판정에 아직 안 쓰임. diff --git a/resources/help/E03/00_설명서.md b/resources/help/E03/00_설명서.md new file mode 100644 index 000000000..a4407ce83 --- /dev/null +++ b/resources/help/E03/00_설명서.md @@ -0,0 +1,69 @@ +# 2D 해석 설명서 + +## 이 화면에서 하는 일 + +- 모든 측점 횡단에서 비탈이 미끄러질 위험을 2D 한계평형해석으로 셈 — 측점 · 좌우 비탈 · 조건(건기 · 우기 · 지진)마다 최소 안전율과 판정(O.K · N.G). +- 깎기 비탈 · 쌓기 비탈을 따로 셈. 옹벽 · 석축 등 벽이 있는 측점은 벽을 넣어 셈. +- 「보강 검토」 탭에서 비탈 완화 · 소단 가정을 다시 해석하고, 벽의 외적 안정(활동 · 전도 · 지지력)을 검토함. +- 화면 = 좌 측점 목록 · 위 평면 위험 띠 · 가운데 횡단 · 우 결과. + +## 작업 순서 + +### 해석 + +1. 지반 조건(E02)에서 값을 확인하고 [저장]해 둠 — 저장한 값으로만 계산함. +2. 좌측 아래 [해석]을 누름. 화면이 잠기고 「해석 중 n% · 측점 k / N」 진행률이 보임. 측점 수십 개면 몇 분 걸림. +3. 끝나면 「해석이 끝났습니다.」 알림 뒤 목록 · 평면 띠 · 횡단이 채워짐. 처음 보이는 측점 = 지금 조건에서 안전율이 가장 낮은 측점. +4. 좌측 위 **조건**에서 건기 · 우기(지진 검토를 켰으면 지진도)를 고름. 목록 · 평면 띠 · 횡단이 그 조건으로 바뀜. +5. 목록 줄이나 평면 띠의 측점 근처를 눌러 측점을 고름. 가운데 위 비탈 칸에서 「좌 비탈 · 깎기」 등 비탈을 고름(처음 = 안전율 낮은 쪽). +6. 횡단의 절편이나 우측 절편표 줄을 누르면 그 절편의 힘이 자유물체도 · 그래프에 보임. +7. 보고서(E05)에 넣을 대표 단면은 목록 「대표」 칸 별(★ · ☆)을 눌러 켜고 끈 뒤 [대표 단면 저장]. +8. [3D 보기]로 노선 3D 면 위 안전율 색을 봄. + +### 보강 검토 + +1. 측점을 고르고 가운데 위 보기 칸에서 「보강 검토」를 고름. 우측이 보강 검토 판으로 바뀜. +2. **비탈 완화 · 소단 가정**: 비탈 · 기울기 1:n · 소단 폭 · 소단 높이를 넣고 [가정 해석]. 또는 [최소 완화 찾기]로 지금 조건 기준안전율을 맞추는 가장 급한 기울기를 찾음(수십 초 ~ 1 분). +3. **벽 외적 안정**: 벽 있는 측점에서만 보임. 보강 검토 탭을 열면 Coulomb · 배면 수위 0 으로 한 번 자동 검토함. 토압 · 배면 수위를 바꿔 [외적 안정 검토]. +4. 네일 · 앵커 보강 가정은 준비 중. + +## 단추 + +| 단추 · 칸 | 자리 | 하는 일 | +| --- | --- | --- | +| 조건 · 정렬 | 좌측 위 | 조건 고름 · 「측점 순」 또는 「안전율 낮은 순」 | +| N.G 만 | 좌측 위 | 지금 조건에서 N.G 인 측점만 보임 | +| [해석] | 좌측 아래 | 전 측점 해석. 입력이 같으면 「입력이 같아 다시 셀 것이 없습니다.」 · 바뀐 측점만 다시 셈 | +| [3D 보기] | 좌측 아래 | 노선 3D 면 색칠 창을 엶(해석 뒤에만 켜짐) · [닫기]로 닫음 | +| [대표 단면 저장] | 좌측 아래 | 별 켬/끔을 저장함(바꾼 것이 있을 때만 켜짐) | +| 비탈 칸 | 가운데 위 | 볼 비탈(좌 · 우 · 깎기 · 쌓기) | +| 보기 칸 | 가운데 위 | 「해석 결과」 ↔ 「보강 검토」 | +| 등안전율 지도 · 원호 중심 격자 · 다른 후보 | 가운데 위 | 횡단 그림에 켜고 끔(기본 = 지도 켬 · 격자 끔 · 후보 켬) | +| [가정 해석] · [최소 완화 찾기] | 보강 검토 | 비탈 가정 재해석 | +| [외적 안정 검토] | 보강 검토 | 벽 활동 · 전도 · 지지력 검토 | + +- 횡단 그림: 휠 = 확대 · 축소 · 가운데 단추 끌기 = 옮기기 · 두 번 누름 = 처음 배율. 마우스 아래 「거리 · EL」(offset · 표고) 표시. + +## 결과 읽는 법 + +- **O.K** = 최소 안전율 ≥ 기준안전율(E02) · **N.G** = 그보다 작음 · 「-」 = 해석 없음 · 「오류」 = 그 측점 계산 실패(줄에 마우스를 올리면 까닭). +- 판정에 쓰는 안전율 = Bishop 간편법 최소값(원호 · 비원호 중 작은 쪽). 측점 판정 = 그 조건 좌 · 우 비탈 중 하나라도 N.G 면 N.G. +- **좌측 목록**: 측점 · 좌 · 우(깎 · 쌓) · 조건별 최소 안전율 · 판정 · 대표. ▦ = 벽 있는 측점. +- **평면 위험 띠**: 노선을 지금 조건 판정 색으로 칠함(초록 O.K · 빨강 N.G · 회색 해석 없음). 오른쪽 위에 판정별 측점 수. 고른 측점은 동그라미. +- **횡단 색(등안전율)**: 원호 중심 자리마다 최소 안전율을 기준안전율 대비 일곱 띠로 칠함(밝은 화면 기준) — 진한 빨강(기준의 0.8 배 미만) · 빨강(0.8 ~ 0.9) · 분홍(0.9 ~ 1.0) · 연회색(1.0 ~ 1.1) · 연파랑(1.1 ~ 1.25) · 파랑(1.25 ~ 1.5) · 진파랑(1.5 배 이상). 범례에는 실제 안전율 값으로 적힘. +- **횡단 선**: 굵은 선 = 임계 활동면(Fs 값 · 원호 중심 Xc · Zc · 반경 R) · 옅은 선 = 다른 방법 · 다른 꼴 후보 · 점선 = 지하수위 · 노면 위 눈금 = 노면 하중 · 회색 빗금 = 벽. +- **우측 결과**: 최소 안전율 · 판정 · 기준안전율 · 방법 · 수렴 · 비탈 높이 · 원호 중심 · 반경 · 방법별 최소 안전율 표(Fellenius · Bishop · Janbu 보정 · Spencer) · 절편표 · 절편 자유물체도 · 절편력 그래프. 칸 뜻은 「칸 뜻」 항목. +- **3D 보기**: 노선 면을 가장 가까운 측점의 (최소 안전율 ÷ 기준안전율) 띠 색으로 칠함 · 해석 없는 측점은 회색. 표시만 함. +- **대표 단면 별**: 채운 별 ★ = 켬 · 밑줄 = 사용자가 바꿈. 자동으로 켜지는 측점 = 쌓기 높이 10 m 이상 · 깎기 높이 15 m 이상 · 최소 안전율 하위 5 곳. +- 좌측 상태 글: 「해석 시각」 · 「지반 조건이 바뀌었습니다 — [해석]을 다시 누르세요」(보이는 결과는 옛 결과) · 「대표 단면 바뀜 — 저장 안 됨」. + +## 알아 둘 것 + +- **문헌 추정치 · 현장 시험 없음**: 지반 값이 문헌 대표값이라 안전율은 설계 검토용 참고값임. 현장 조사 값으로 바꿔 다시 해석할 것. +- 해석은 서버가 함 · 화면은 결과만 보임. 같은 입력이면 다시 셈하지 않음. +- 우기 계산 = 지금은 모든 측점 「공사 뒤 지표까지 포화」. E02 에서 고른 우기 규칙은 횡단 그림의 지하수위 점선에만 반영됨(계산 반영은 준비 중). r_u 를 골랐으면 그림 아래에 「지하수 = 간극수압비 r_u …」 글만 보임. +- 탐색 범위 = 노면 반대쪽 끝 ~ 비탈 끝 바깥 (5 m 와 비탈 높이 2 배 중 큰 값)까지 — 설계 비탈을 지나는 면만 봄. 노선 밖 자연 비탈 전체 붕괴는 광역 위험(E07) 몫. +- 깊이 0.3 m 미만으로 겉만 긁는 면은 붕괴로 보지 않음. +- 벽은 아주 단단한 물체로 넣어 활동면이 벽을 지나지 않음 — 벽 자체 안정은 보강 검토의 「벽 외적 안정」으로 봄. +- 보강 가정은 따로 저장되는 검토용 결과임 — 설계 · 원본 해석 결과 · 임도 프로젝트는 바뀌지 않음. 먼저 지금 입력으로 [해석]이 끝나 있어야 함. 벽이 선 비탈은 가정 해석 대신 벽 외적 안정으로 검토할 것. +- 공유받은 회사(보기만)는 [해석] · 별 · 보강 단추가 꺼짐. diff --git a/resources/help/E03/10_칸_뜻.md b/resources/help/E03/10_칸_뜻.md new file mode 100644 index 000000000..7f7ba573c --- /dev/null +++ b/resources/help/E03/10_칸_뜻.md @@ -0,0 +1,73 @@ +# 칸 뜻 + +## 좌측 측점 목록 + +| 칸 | 뜻 | +| --- | --- | +| 측점 | 측점 번호 · ▦ = 벽(옹벽 · 석축 등) 있는 측점 | +| 좌 · 우 | 좌 비탈 · 우 비탈 역할(깎 = 깎기 · 쌓 = 쌓기) | +| 건기 · 우기 · 지진 | 조건별 그 측점 최소 안전율(좌 · 우 중 작은 값 · Bishop) | +| 판정 | 지금 조건의 O.K · N.G · 「-」(해석 없음) · 「오류」 | +| 대표 | 보고서 대표 단면 별. 마우스를 올리면 자동으로 켜진 까닭(쌓기 10 m 이상 · 깎기 15 m 이상 · 최소 안전율 하위 5 · 사용자 지정) | + +## 우측 결과 + +| 칸 | 뜻 | +| --- | --- | +| 최소 안전율 | 고른 비탈 · 조건에서 Bishop 간편법으로 찾은 가장 낮은 안전율(소수 셋째 자리) | +| 판정 | 최소 안전율 ≥ 기준안전율이면 O.K | +| 기준안전율 | E02 기준안전율 표의 그 조건 · 깎기 또는 쌓기 칸 | +| 방법 | 「Bishop · 원호」 또는 「Bishop · 비원호」 — 임계면 꼴 | +| 수렴 | 반복 계산이 답에 닿았는지(예 · 아니오)와 반복 횟수 | +| 비탈 높이 | 노면 끝에서 비탈 끝(원지반과 만나는 점)까지 높이차(m) | +| 벽 있음 | 이 측점 단면에 넣은 벽 수 | +| 원호 중심 · 반경 | 임계 원호의 중심(offset, 표고)과 반지름(m). 비원호면 안 보임 | +| 방법별 표 | Fellenius · Bishop · Janbu 보정 · Spencer 각각의 최소 안전율(원호 · 비원호 중 작은 값) | + +## 절편표 + +임계 활동면 위 흙을 세로로 나눈 조각(절편)마다 한 줄. 줄을 누르면 그 절편을 고름. + +| 칸 | 뜻 · 단위 | +| --- | --- | +| # | 절편 번호 | +| 폭 b | 절편 가로 폭(m) | +| 높이 h | 절편 가운데 높이(m) | +| α° | 절편 바닥 기울기(°) | +| W+Q | 절편 무게 + 노면 하중(kN/m — 단면 1 m 폭당) | +| u | 바닥 간극수압(kPa) | +| N' | 바닥을 누르는 유효 수직력(kN/m) — 물이 떠받치는 몫을 뺀 힘 | +| S | 바닥에서 동원된 전단력 = 버틸 수 있는 힘 ÷ 안전율(kN/m) | +| c · φ° | 바닥이 지나는 지층의 점착력(kPa) · 내부마찰각(°) | + +## 절편 자유물체도 · 절편력 그래프 + +- 자유물체도 = 고른 절편 하나를 크게 그리고 힘을 화살로 보임. 화살 길이 = 힘 크기 비례(kN/m). +- 화살 이름: W = 무게 · Q = 노면 하중 · N = 유효 수직력 · U = 바닥 수압 · S = 전단 저항 · EL · ER = 양옆 수평력 · XL · XR = 양옆 연직력(값이 있을 때만). +- 그래프 = 절편마다 바닥의 유효 수직응력 σ' · 간극수압 u · 동원 전단응력 τ(kPa 한 축). 가로 = 거리(offset). 기둥에 마우스를 올리면 세 값이 보임. + +## 보강 검토 — 비탈 완화 · 소단 가정 + +| 칸 | 뜻 | +| --- | --- | +| 비탈 | 가정을 넣을 비탈(좌 · 우 · 깎기 · 쌓기) | +| 기울기 1:n | 비탈 전체를 바꿀 기울기 n(세로 1 에 가로 n). 빈 칸 = 지금 값 · 0.1 ~ 4 | +| 소단 폭 m | 소단 한 칸 폭(0 ~ 10 m) | +| 소단 높이 m 마다 | 몇 m 높이마다 소단을 둘지(0 ~ 30 m). 폭 · 높이 둘 다 넣어야 소단이 생김 | +| 결과 글 | 「1:지금 → 1:가정 · 소단 폭 / 높이 · 찾은 결과(회) · 걸린 초」 | +| 결과 표 | 조건마다 전 Fs · 후 Fs · 기준안전율 · 전 판정 · 후 판정 | +| 가정 단면 | 바뀐 비탈과 그 임계면 그림(지금 조건) | + +- [최소 완화 찾기] 목표 = 지금 조건 기준안전율. 지금 기울기부터 성긴 걸음으로 완만하게 하며 처음 맞는 기울기를 찾고, 그 앞 칸 사이를 반씩 좁혀 0.05 단위로 맞춤. 비탈이 급한 자연 사면에서는 완만하게 할수록 깎기 높이가 커져 오히려 안전율이 낮아질 수도 있음. 못 찾으면 「못 찾음 — 원지반을 만나는 가장 완만한 1:n 까지 봄」. + +## 보강 검토 — 벽 외적 안정 (KDS 11 80 05) + +| 칸 | 뜻 | +| --- | --- | +| 토압 | 벽 뒤 흙이 미는 힘 계산법 — Coulomb(기본) · Rankine | +| 배면 수위 ÷ 벽 높이 | 벽 뒤 물 높이 비율(0 = 물 없음 · 1 = 벽 꼭대기까지) | +| 머리 글 | 벽 이름 · 평상시 또는 지진 시 · H(벽 높이 m) · B(바닥 폭 m) · Ka(주동토압계수) · KAE(지진 시 토압계수) · e(바닥 합력이 가운데서 벗어난 거리 m) · q_max(최대 지반 반력 kPa) | +| 활동 · 전도 · 지지력 | 줄마다 안전율 · 기준 · 판정 | + +- 기준(KDS 11 80 05): 평상시 활동 1.5 · 전도 2.0 · 지지력 3.0 · 지진 시 활동 1.2 · 전도 1.5 · 지지력 2.0. +- 지진 시 줄은 E02 에서 지진 검토를 켜고 kh 가 0 보다 클 때만 나옴. diff --git a/resources/help/E03/20_쓰인_방법과_근거.md b/resources/help/E03/20_쓰인_방법과_근거.md new file mode 100644 index 000000000..b3d132a89 --- /dev/null +++ b/resources/help/E03/20_쓰인_방법과_근거.md @@ -0,0 +1,81 @@ +# 쓰인 방법과 근거 + +## 한계평형해석 — 절편법 + +- 가상의 미끄럼면(활동면) 위 흙덩이를 세로 조각(절편) 50 개로 나눔. +- 절편마다 무게 W(지층별 단위중량 × 두께 × 폭 + 노면 하중) · 바닥 수압 u · 바닥 강도 c · φ 를 셈. +- **안전율 Fs** = 버티는 힘(또는 모멘트) 합 ÷ 미끄러지게 하는 힘(또는 모멘트) 합. 1 미만 = 무너지는 쪽. +- 버티는 힘 = c × 바닥 길이 + (바닥을 누르는 힘 − 수압 × 바닥 길이) × tanφ (Mohr-Coulomb). +- 수압 u = 9.81 kN/m³ × 지하수위에서 절편 바닥까지 깊이. 지하수위 아래 흙 무게는 γsat 로 셈. +- 근거 = 지식DB 02(토사 · 복합 비탈면 한계평형해석 수식 명세) §1 · §2. + +## 네 가지 방법 + +| 방법 | 화면 이름 | 원리(쉬운 말) | 쓰임 | +| --- | --- | --- | --- | +| Bishop 간편법 | Bishop | 절편 옆 수평력은 넣고 연직력은 뺌 · 원 중심 둘레 모멘트로 평형 | **기본 · 판정** | +| Janbu 간편법 + 보정 | Janbu 보정 | 수평 · 연직 힘 평형만으로 셈 → 면 모양 보정계수 f0 를 곱함 | 비원호(꺾인 면) 탐색 · 비교 | +| Fellenius 법 | Fellenius | 절편 사이 힘을 모두 뺌 · 반복 없이 한 번에 셈 · 보통 낮게(보수적으로) 나옴 | 비교 | +| Spencer 법 | Spencer | 모멘트 · 힘 평형을 함께 맞춤(절편 사이 힘 기울기 λ 를 함께 찾음) | 비원호 탐색 · 비교 | + +- 이 밖의 방법(GLE · Morgenstern-Price 등)은 쓰지 않음. +- **Bishop 식 말풀이**: Fs = Σ[(c × 폭 + (W − u × 폭) × tanφ) ÷ mα] ÷ Σ(W × sinα + 지진 항). mα = cosα + sinα × tanφ ÷ Fs. 양쪽에 Fs 가 있어 맞을 때까지 되풀이해 셈. +- 진출부가 급해 어느 절편의 mα 가 0.2 보다 작아지는 면은 값이 터지므로 버림(상용 프로그램 관례). +- **Janbu 보정계수** f0 = 1 + b1 × (d/L − 1.4 × (d/L)²). L = 면 양 끝을 이은 직선 길이 · d = 그 직선에서 면까지 가장 깊은 거리 · b1 = 0.31(c 가 모두 0) · 0.69(φ 가 모두 0) · 0.50(그 밖). +- **지진**: 절편마다 무게 × kh 만큼 옆으로 미는 힘을 더함(유사정적). + +## 임계 활동면 찾기 + +- **원호** — 두 방식을 함께 씀. +- Entry & Exit: 비탈 위 · 아래 진입 · 진출 점 25 개씩을 여러 각도의 원호로 이음. +- Grid & Radius: 원호 중심 격자 15 × 15 자리마다 반지름 10 가지. +- 위 후보를 절편 30 개로 빠르게 거른 뒤, 안전율 낮은 30 개를 출발점으로 차분진화(무리 최적화)로 다듬어 절편 50 개로 최종 셈. +- **비원호** — 꼭짓점 4 개 꺾은선. 출발점 = 가장 낮은 원호 + 블록 모양 면. Janbu · Spencer 로 꼭짓점을 옮겨 가며 최소를 찾고, 찾은 면에서 Fellenius · Bishop 값도 셈. +- 방법마다 원호 · 비원호 중 작은 값이 그 방법의 최소 안전율 · 판정은 Bishop 최소 안전율. +- 같은 입력이면 늘 같은 답이 나오도록 무작위 씨앗을 고정함. +- **등안전율 지도** = 원호 중심 격자 자리마다 그 중심으로 그린 원호 중 Bishop 최소 안전율. +- 깊이 0.3 m 미만으로 겉만 긁는 면은 뺌(표토 벗겨짐은 붕괴로 보지 않음). +- 근거 = 지식DB 02 §3(Grid & Radius · Entry & Exit). 상용 대응 = SLOPE/W · Slide 의 같은 이름 방식. + +## 조건 · 비탈 + +| 조건 | 지하수 · 하중 | 기준안전율(E02 기본 · 깎기 / 쌓기) | +| --- | --- | --- | +| 건기 | 지하수 없음 | 1.5 / 1.5 | +| 우기 | 지금은 모든 측점 공사 뒤 지표까지 포화 | 1.2 / 1.3 | +| 지진(E02 에서 켰을 때) | 건기 수위 + 수평지진계수 kh | 1.1 / 1.1 | + +- 기준 = KDS 11 70 05 표 4.3-1 · 4.3-2 · 4.3-3(지식DB 04 §2). 값은 E02 에서 바꿀 수 있음. +- 좌 · 우 비탈을 따로 셈 — 깎기 = 산 쪽에서 노면 쪽으로 미끄러짐 · 쌓기 = 노면에서 바깥쪽으로 미끄러짐. +- 탐색 범위 = 노면 반대쪽 끝 ~ 비탈 끝 바깥 (5 m 와 비탈 높이 2 배 중 큰 값). +- 노면 하중 = 노면 양 끝 사이 고른 하중(E02 · 기본 10 kPa). +- 판정 = Bishop 최소 안전율 ≥ 그 조건 · 그 비탈(깎기 · 쌓기) 기준안전율이면 O.K. + +## 벽 넣기 + +- B06 에 놓인 옹벽 · 석축 · 돌쌓기 · 관 기슭막이 단면을 B06 화면과 같은 계산으로 그려 넣음. +- 벽 = 단위중량 23 kN/m³ · c 1,000 kPa · φ 45° 의 아주 단단한 물체 — 활동면이 벽을 지나지 않고 벽 뒤 · 아래로 돎. + +## 보강 검토 + +- **비탈 완화 · 소단** — 비탈 시작점(깎기 = 측구 바깥 · 쌓기 = 노면 끝)부터 1:n 기울기(+ 높이마다 소단)로 원지반을 만날 때까지 다시 그려 같은 방법 · 조건으로 다시 해석함. 2 단 경사(암 · 토사)는 한 기울기로 갈음. +- **벽 외적 안정**(KDS 11 80 05 · 지식DB 04 §2) — 토압 = Coulomb 또는 Rankine · 지진 시 = Mononobe-Okabe + 벽 관성 kh × 벽 무게. +- 활동 안전율 = (바닥 연직력 × 마찰계수 + 바닥 점착 × 폭) ÷ 수평력 합(앞쪽 수동토압 뺌). +- 전도 안전율 = 앞굽 둘레 버티는 모멘트 ÷ 넘기는 모멘트. +- 지지력 안전율 = Meyerhof 극한 지지력(유효 폭 · 경사 보정) ÷ 최대 지반 반력. +- 기준 = 평상시 활동 1.5 · 전도 2.0 · 지지력 3.0 · 지진 시 1.2 · 1.5 · 2.0. +- 가정: 벽 뒤 흙 점착 0(안전 쪽) · 벽 단위중량 23 kN/m³ · 벽 뒤 상재하중 = 쌓기 쪽 벽만 노면 하중 · 수압 = 배면 수위만큼 정수압 + 바닥 양압력. + +## 검증 + +- 상용 프로그램 검증 예제 12 문제(40 개 값)와 비교해 차이 2.2 % 안. +- 벽 외적 안정은 교과서 손계산과 비교해 차이 2 % 안. + +## 가정 · 한계 + +- 지반 값 = 문헌 추정치 · 현장 시험 없음. +- 2D 해석이라 비탈 양옆이 붙잡아 주는 효과(끝단 효과)는 빠짐 — 3D 해석(E04) 몫. +- 우기는 지표까지 포화로 셈(가장 불리한 쪽). E02 우기 규칙 갈래(암반 ½ · 깊이 비율 · r_u · 수위선)의 계산 반영은 준비 중. +- 강우 침투 해석(시간에 따른 수위 변화) · 인장균열은 넣지 않음. +- 암반 절리를 따라 미끄러지는 평면 · 쐐기 파괴는 암반 해석(E06) 몫. +- 네일 · 앵커 보강 가정은 준비 중. diff --git a/resources/help/E04/00_설명서.md b/resources/help/E04/00_설명서.md new file mode 100644 index 000000000..43ae4e0e2 --- /dev/null +++ b/resources/help/E04/00_설명서.md @@ -0,0 +1,68 @@ +# 3D 해석 설명서 + +## 이 화면에서 하는 일 + +- 노선 한 구간(보통 약 100 m)을 골라 지형 전체를 입체로 보고 가장 위험한 3차원 활동면(흙이 미끄러져 내리는 바닥면)을 찾음. +- 땅을 1 m 기둥 격자로 나눠 셀마다 「그 셀을 지나는 활동면 중 가장 낮은 안전율」을 색 지도로 보여 줌. +- 가장 위험한 활동면의 안전율 · 무너질 흙의 양(임계 체적) · 같은 구간 2D(E03) 결과와의 비를 오른쪽에 보여 줌. +- 계산은 모두 서버가 함. 화면은 결과를 그리기만 함. + +## 작업 순서 + +1. 왼쪽 **구간** 카드 목록에서 구간 하나를 누름(예: `0 – 100 m`). 직접 정하려면 아래 **시작 (m)** · **끝 (m)** 칸에 숫자를 넣음. +2. **탐색 설정** 카드에서 **조건**(건기 · 우기)과 **활동면 모양**을 고름. 처음에는 기본값 그대로 써도 됨. +3. 필요하면 **고급 설정** 카드를 펼쳐 기둥 크기 · 구 중심 격자 · 부피 범위를 바꿈(칸 뜻은 「칸 뜻」 문서). +4. 왼쪽 아래 **[해석]** 을 누름. 진행 막대에 「해석 중 n% · 합성 지형 → 거친 탐색 → 고운 탐색 → 타원체」 차례가 보임. +5. 끝나면 「3D 해석이 끝났습니다.」 알림과 함께 가운데 지도에 색이 칠해지고 오른쪽 **구간 결과** 가 채워짐. +6. 가운데 위 **[3D 보기]** 로 바꿔 입체 지형 위의 임계 활동면을 확인함. +7. 다른 구간도 같은 방법으로 해석함. 해석한 구간은 목록에 색 점과 `Fs` 값이 붙음. +8. 보고서에 넣으려면 E05 보고서 화면에서 **[보고서 갱신]** 을 누름(3D요약 시트에 구간마다 한 줄). + +## 단추 + +| 자리 | 단추 | 하는 일 | +| --- | --- | --- | +| 왼쪽 아래 | **[해석]** | 고른 구간을 해석함. 입력(지반 조건 · 탐색 설정 · 구간)이 저장된 결과와 같으면 다시 셈하지 않고 「입력이 같아 저장된 결과를 엽니다.」 | +| 왼쪽 아래 | **[다시 해석]** | 입력이 같아도 처음부터 다시 셈 | +| 진행 막대 옆 | **[끊기]** | 돌고 있는 해석을 멈춤. 전에 저장된 결과는 그대로 남음 | +| 고급 설정 카드 | **[기본값]** | 탐색 설정 칸을 기본값으로 되돌림(구간 시작 · 끝은 그대로 · 조건은 건기) | +| 가운데 위 | **[평면 지도]** · **[3D 보기]** | 위에서 본 색 지도와 입체 보기를 바꿈 | +| 가운데 위 | **[최소 안전율]** · **[임계 체적]** | 지도 · 3D 색칠 기준을 바꿈 | +| 3D 보기 위 | **임계 활동면** 체크 | 켬 = 활동체를 걷어낸 지표 + 붉은 활동면 · 끔 = 원래 지표만 | + +- 평면 지도: 마우스 휠 = 확대 · 축소, 끌기 = 옮김, 두 번 누름 = 화면 맞춤, 셀 위에 올리면 그 셀의 최소 안전율 · 임계 체적 · 가까운 측점이 뜸. +- 3D 보기: 끌기 = 돌림, 휠 = 확대 · 축소. 오른쪽 위 나침반이 방위를 알려 줌. + +## 결과 읽는 법 + +- **평면 지도**: 셀 색 = 그 셀을 지나는 활동면 중 가장 낮은 안전율. 붉을수록 위험. 점선 윤곽 = 구간 전체에서 가장 위험한 활동면이 땅을 자르는 범위, 동그라미와 `Fs` 글 = 그 활동면 자리. 굵은 선 = 고른 구간. +- **안전율 색 단계**: 1.0 미만 · 1.0~1.2 · 1.2~1.3 · 1.3~1.5 · 1.5~2.0 · 2.0~3.0 · 3.0 이상 · 회색 = 값 없음(활동면이 닿지 않은 셀). 1.3(우기) · 1.5(건기)가 기준 경계. +- **임계 체적 색 단계**: 10 m³ 미만 · 10~100 · 100~1,000 · 1,000~10,000 · 10,000 m³ 이상 — 짙을수록 큰 붕괴. +- **3D 보기**: 지표 색 = 지금 고른 층(안전율 또는 체적) · 파란 관 = 노선 중심선 · 짙은 붉은 면 = 임계 활동면(지표 아래 부분만). +- **오른쪽 구간 결과**: + +| 줄 | 뜻 | +| --- | --- | +| 3D 최소 안전율 | 구간에서 찾은 가장 낮은 3D 안전율 | +| 판정 | 「만족」 또는 「불만족」 · 괄호 안 = 조건과 기준(예: 건기 ≥ 1.50) | +| 2D 최소 안전율 (같은 구간) | E03 측점 결과 중 이 구간 안 가장 낮은 값 · 없으면 「2D 결과 없음」 | +| 3D / 2D 비 | 3D 최소 ÷ 2D 최소 · 1 보다 크면 2D 가 안전 쪽(보수적) | +| 임계 체적 | 가장 위험한 활동면 위 흙의 부피(m³) | +| 다스린 방법 | 판정에 쓴 방법(3D Bishop 또는 3D Janbu 보정) | +| 3D Bishop · 3D Janbu 보정 · Hovland (비교) | 같은 활동면을 세 방법으로 셈한 값 | +| 위치 (가까운 측점) | 가장 위험한 활동면에 가장 가까운 측점 | +| 셀 수 · 시험 활동면 수 · 계산 시간 | 계산 규모 | + +## 알아 둘 것 + +- **문헌 추정치 · 현장 시험 없음** — 지반 물성치는 문헌 · 기준값을 적용한 추정치이며 현장 조사 · 시험 성과를 반영하지 않았음. 안전율은 비교 · 검토용으로 볼 것. +- 결과는 서버에 구간마다 자동 보관됨(따로 [저장] 없음). 탐색 설정 칸 값은 이 브라우저 탭에만 기억됨. +- E02 지반 조건을 바꾸면 그 구간 결과 아래 「입력(지반 조건 · 탐색 설정 · 엔진)이 바뀌었습니다 — 다시 해석하세요.」 경고가 뜨고 목록에 「옛 결과」 가 붙음. **[해석]** 을 다시 누를 것. +- 3D 는 E02 에서 **[저장]** 한 지반 조건을 씀. 해석 전 E02 에서 [저장] 을 한 번 눌러 둘 것. +- 한 번에 해석할 수 있는 구간은 500 m 이하. 구간 안 측점이 둘 이상이어야 함. +- 해석 하나에 수십 초 ~ 수 분 걸림(구간 길이 · 탐색 폭 · 기둥 크기에 따라). 한 프로젝트에서 한 번에 하나만 돎. +- 「조건에 맞는 활동면이 없습니다 — 부피 · 높이 범위를 넓히세요.」 가 뜨면 고급 설정의 최소 · 최대 부피나 중심 높이 범위를 넓힐 것. +- 우기는 「지표까지 포화」 한 가지로 셈 — E02 의 지하수 규칙(깊이 비율 · r_u · 수위선)은 3D 에 쓰지 않음. 지진 조건 · 옹벽 · 석축은 3D 에 넣지 않음. +- 2D 대조 값은 E03 측점마다 기준 대비 가장 낮은 조건 · 비탈의 안전율이라 조건을 맞추지 않음. 같은 조건끼리 견준 표는 E05 보고서 「3D요약」 시트에 있음. +- 보기만 허용된 프로젝트에서는 「보기만 허용된 프로젝트입니다.」 가 뜨고 [해석] 단추가 꺼짐. +- 쓰인 방법 · 근거 · 한계는 「쓰인 방법과 근거」 문서, 아직 사용자 확정 전인 값은 「사용자 확정 전 값」 문서 참고. diff --git a/resources/help/E04/10_칸_뜻.md b/resources/help/E04/10_칸_뜻.md new file mode 100644 index 000000000..b89c0e2c4 --- /dev/null +++ b/resources/help/E04/10_칸_뜻.md @@ -0,0 +1,51 @@ +# 3D 해석 칸 뜻 + +## 구간 카드 + +| 칸 | 뜻 | 기본값 · 범위 | +| --- | --- | --- | +| 구간 목록 | 측점을 앞에서부터 100 m 이상씩 묶은 자동 구간 · 경계는 측점 · 끝에 50 m 미만이 남으면 앞 구간에 붙임 | 자동 | +| 시작 (m) | 해석 구간 시작 누가거리 | 첫 구간 시작 | +| 끝 (m) | 해석 구간 끝 누가거리 | 시작보다 커야 함 · 구간 길이 500 m 이하 | + +- 목록 항목 = `시작 – 끝 m` · 색 점(해석한 구간의 최소 안전율 색) · `Fs 0.00` · 입력이 바뀌었으면 「옛 결과」. +- 시작 · 끝을 직접 넣어 해석한 구간도 목록 끝에 더해짐. + +## 탐색 설정 카드 + +| 칸 | 뜻 | 기본값 · 범위 | +| --- | --- | --- | +| 조건 | 건기 = 지하수 없음 · 우기 (지표까지 포화) = 지하수위면을 지표에 둠 | 건기 | +| 활동면 모양 | 구 = 공 모양 면만 · 구 + 타원체 = 공 모양으로 찾은 위험 자리에서 옆으로 늘린 타원체도 봄 | 구 + 타원체 | +| 타원체 길이비 | 타원체를 활동 방향(비탈 아래쪽)에 직각인 옆 방향으로 몇 배 늘릴지 | 2.0 · 1.1~5.0 | +| 탐색 폭 (중심선 ±m) | 활동면 중심을 찾는 범위 = 노선 중심선 좌우 이 거리 안 | 30 m · 5~100 m | + +## 고급 설정 카드(접힘) + +| 칸 | 뜻 | 기본값 · 범위 | +| --- | --- | --- | +| 기둥 크기 (m) | 땅을 나누는 정사각 기둥(셀) 한 변 · 작을수록 정밀하나 느림 | 1.0 m · 0.5~5 m | +| 구 중심 간격 (m) | 가장 고운 탐색에서 구 중심끼리 수평 간격 | 2.0 m · 0.5~10 m | +| 중심 높이 최소 (m) | 구 중심을 지표 위 몇 m 부터 둘지 | 2 m · 0~100 m | +| 중심 높이 최대 (m) | 구 중심을 지표 위 몇 m 까지 둘지 | 30 m · 1~200 m | +| 중심 높이 간격 (m) | 중심 높이를 몇 m 씩 올려 볼지 | 2 m · 0.5~20 m | +| 반지름 증분 (m) | 구 반지름을 몇 m 씩 키워 볼지 | 1.0 m · 0.2~5 m | +| 최대 깊이 (m) | 반지름 상한 = 중심 높이 + 이 값 · 활동면이 땅속 얼마나 깊이 갈 수 있는지 | 15 m · 1~60 m | +| 최소 부피 (m³) | 이보다 작은 활동체는 셈에서 뺌(아주 얕은 표면 긁힘 제외) | 10 m³ · 0 이상 | +| 최대 부피 (m³) | 이보다 큰 활동체는 셈에서 뺌 · 그 중심에서 더 큰 반지름도 그만 봄 | 10,000 m³ · 최소보다 커야 함 | + +- **[기본값]** = 위 기본값으로 되돌림(시작 · 끝 그대로 · 조건 건기). +- 최소가 최대보다 크면 「탐색 범위의 최소가 최대보다 큽니다.」 로 거절됨. +- 칸 값은 이 브라우저 탭에 바로 기억됨(서버에는 [해석] 때 결과와 함께 남음). + +## 화면에 안 나오는 고정값 + +| 값 | 뜻 | 지금 값 | +| --- | --- | --- | +| 거친 탐색 배수 | 처음엔 구 중심 간격의 4 배로 성기게 보고, 위험한 곳 둘레만 절반씩 좁혀 감 | 4 배 · 고운 단계 4 번까지 | +| 셀 안 표본 | 셀마다 2 × 2 점에서 활동면 높이를 봐 가장자리 셀을 부분 기둥으로 셈 | 2 × 2 | +| 고운 탐색 대상 | 안전율이 2.0 또는 지금까지 최소의 1.2 배보다 낮은 자리만 더 촘촘히 · 타원체도 그 자리만 | 2.0 · 1.2 배 | +| Janbu 보정 전환 | 활동면 바닥이 못 뚫는 암반에 잘린 면적이 10 % 이상이면 3D Janbu 보정 값을 같이 봄 | 10 % | +| 흙 두께(토사 측점) | 암 경계 정보가 없는 측점의 흙 두께 | 3 m | +| 노면 하중 | E02 노면 하중(없으면 10 kPa)을 노면 띠 셀에 얹음 | E02 값 | +| 기준 안전율 | E02 기준 안전율 중 깎기 · 쌓기 가운데 큰 값(엄한 쪽) | 건기 1.5 · 우기 1.3(기본) | diff --git a/resources/help/E04/20_쓰인_방법과_근거.md b/resources/help/E04/20_쓰인_방법과_근거.md new file mode 100644 index 000000000..c1706c8ec --- /dev/null +++ b/resources/help/E04/20_쓰인_방법과_근거.md @@ -0,0 +1,74 @@ +# 3D 해석 쓰인 방법과 근거 + +## 한눈에 + +| 단계 | 쓰인 방법 | 근거 | +| --- | --- | --- | +| 입력 지형 | 복사 DEM + 노선 계획면(B06 깎기 · 쌓기) 합성 | E01 복사본 · B06 횡단 설계 | +| 지층 | 지층 경계 격자(B06 암 경계를 측점 사이 보간) | B06 암 경계 · E02 물성 | +| 활동면 찾기 | Scoops3D 방식 구 격자 + 부피 제약 · 타원체 덧봄 | Reid 외(2015) USGS TM 14-A1 | +| 안전율(기본) | Hungr 3D Bishop 간편법 | Hungr(1987) · Hungr 외(1989) | +| 안전율(암반에 잘린 면) | 3D Janbu 간편법 + 보정 계수 | Hungr 외(1989) · Janbu(1973) | +| 안전율(비교) | Hovland 3D 단순 기둥법 | Hovland(1977) | + +- 지식DB 근거: `안정성평가/05_3D_사면안정해석_논문_기술정보` 1장(기둥법 수식) · 3장(Scoops3D) · 6.1절(구 격자 탐색) · 8장(3D/2D 비). +- 계산 코드는 수식만 옮겨 직접 짬(외부 해석 프로그램 안 씀). + +## 입력 지형 만들기 + +- 원지형 = 임도 프로젝트에서 복사해 온 DEM(지형 격자). +- 측점마다 B06 설계선(깎기 · 쌓기 단면)과 원지형의 높이 차를 구하고, 이웃 두 측점 사이는 횡단선을 서로 이은 면 위에서 그 차를 고르게 이어 붙임. +- 그래서 측점 위 단면은 B06 설계 단면과 같고, 노선 띠 밖은 원지형 그대로임. +- 비탈이 횡단 끝에서 원지형과 안 만나면 끝 기울기로 원지형과 만날 때까지 늘림(최대 60 m) — 띠 끝에 가짜 절벽이 생기지 않게. +- 해석 격자는 기둥 크기(기본 1 m) 정사각으로 다시 뜸. 구간 앞뒤 측점 하나씩을 더 붙여 구간 끝 지형이 끊기지 않게 함. + +## 지층 경계 + +- 위에서 아래로 성토 · 풍화토 · 리핑암(풍화암 물성) · 발파암(연암 물성) 네 층. +- 흙 두께 = 암 측점은 B06 암 경계 깊이 · 토사 측점은 3 m · 측점 사이는 고르게 보간, 노선 띠 밖은 가장 가까운 측점 값. +- 토사 측점 아래는 리핑암으로 봄. **발파암(연암)은 활동면이 못 뚫는 층** — 활동면이 그 윗면에서 잘림. +- 물성 값(γt · γsat · c · φ)은 E02 지반 조건 표의 성토 · 풍화토 · 풍화암 · 연암 줄을 그대로 씀. +- 노면 띠(두 노면 끝 사이)에 E02 노면 하중(기본 10 kPa)을 얹음. + +## 활동면 찾기 (Scoops3D 방식) + +- 노선 중심선 좌우 탐색 폭(기본 ±30 m) 안, 구간 안에 구 중심 자리를 격자로 깖. 중심 높이 = 그 자리 지표 + 2~30 m(2 m 간격). +- 중심마다 반지름을 1 m 씩 키우며 땅을 자르는 구를 만들고, 그 아래 흙 기둥들로 안전율을 셈. +- 부피 제약: 활동체 부피가 10 m³ 미만이면 빼고 10,000 m³ 를 넘으면 그 중심에서 더 키우지 않음. +- 거친 격자(중심 간격의 4 배)로 먼저 보고, 안전율이 낮게 나온 중심 둘레만 간격을 절반씩 좁혀 다시 봄. +- 셀마다 지나간 활동면 중 가장 낮은 안전율과 그 부피를 남김 → 셀별 최소 안전율 지도 · 임계 체적 지도. +- 구 + 타원체를 고르면, 위험하게 나온 중심에서 활동 방향에 직각으로 늘린 타원체(기본 2 배)를 더 봄. +- 한 구가 땅을 여러 덩이로 자르면 덩이마다 따로 셈. 격자 끝이나 지형 빈칸에 닿은 덩이는 버림. +- Scoops3D 와 다른 점: 중심 높이를 「그 자리 지표 위」 로 잡음(산지 고저차 대응) · 노선 띠 안에만 중심을 둠. + +## 안전율 셈 + +- 안전율 = 활동면을 따라 버티는 힘(점착력 + 마찰) ÷ 미끄러뜨리는 힘. 1 보다 작으면 무너지는 쪽. +- **Hungr 3D Bishop**: 기둥마다 위아래 힘이 맞도록 바닥 힘을 구하고, 회전축 둘레 힘의 모멘트가 맞도록 안전율을 되풀이 셈. 기본 방법. +- **3D Janbu 보정**: 회전 대신 활동 방향 수평 힘이 맞도록 셈한 뒤 보정 계수 f0 = 1 + b1 × (d/L − 1.4 × (d/L)²) 를 곱함(b1 = 점착 · 마찰 둘 다 0.50 · 마찰만 0.69 · 점착만 0.31 · d/L = 활동면 양끝을 이은 직선에서 바닥까지 가장 먼 거리 ÷ 활동 방향 길이). +- **Hovland**: 기둥 사이 힘을 모두 무시한 가장 단순한 셈. 판정에는 안 쓰고 비교로만 보여 줌. +- 다스리는 값: 바닥이 못 뚫는 암반에 잘린 면적이 10 % 이상이면 Bishop 과 Janbu 보정 중 **작은 값**, 그 밖은 Bishop. Bishop 이 수렴하지 않은 후보는 버림. 너무 큰 안전율은 100 으로 자름. +- 우기 = 지하수위면을 지표에 둔 간극수압(KDS 우기 규칙의 3D 꼴). 지진은 넣지 않음. +- 판정 = 다스리는 값 ≥ 기준 안전율(E02 깎기 · 쌓기 중 큰 값 · 기본 건기 1.5 · 우기 1.3, KDS 11 70 05). + +## 시험으로 맞춘 기준 문제 + +- Baligh & Azzouz 구 해석해 1.402 → 1.402. +- Zhang(1988) 경우 1 = 2.158(문헌 Hungr 2.167) · 경우 2 약층 = 1.617(1.620). +- Scoops3D 제방 30° = 1.325(1.32) · 원뿔 r_u 0.4 = 1.637(1.626). + +## 2D 와 다른 점 + +- 2D(E03)는 측점 횡단마다 폭이 끝없이 긴 사면으로 보고 셈 — 양옆 흙이 잡아 주는 힘(끝단 효과)이 없음. +- 3D 는 활동체 양옆 저항과 지형 굴곡(오목 · 볼록)을 넣음. 같은 땅이면 대개 3D 안전율이 2D 보다 크거나 같음(Cavounidis 1987). +- 문헌 경향(지식DB 05 8장): 폭 ÷ 높이 1~1.5 = 3D/2D 약 1.25~1.50 · 2~3 = 약 1.10~1.25 · 6 이상 = 약 1.01~1.05. +- 3D/2D 비가 1 보다 크면 2D 판정이 안전 쪽. 1 보다 작으면 측점 사이(20 m 간격 횡단이 놓친 곳)나 비스듬한 지형에 위험이 있을 수 있어 그 자리를 살펴볼 것. +- 3D 는 무너질 흙 양(m³)을 알려 줌 — 2D 는 못 줌. + +## 한계 + +- **3D 강도감소 FEM(유한요소) 안 함** — 활동면 모양을 미리 가정하지 않는 정밀 방법이지만 노선 전체에 쓰기엔 무거워 보류. +- 활동면 모양은 구 · 타원체(암반에 잘린 면 포함)만. 비대칭 엄밀해(Cheng & Yip · 3D Spencer 등)는 안 씀. +- 지층은 네 층 고정. E02 에서 더한 지층 · 구간별 덮어쓰기 · 지반 라벨 바꿈 · 붕적토 · 경암은 3D 에 안 들어감. 흙 두께는 B06 암 경계(없으면 3 m)를 씀. +- 우기는 지표까지 포화 한 가지. 지진 · 옹벽 · 석축 · 배수 시설은 넣지 않음. +- 물성은 문헌 추정치 · 현장 시험 없음. 시추 · 시험 성과가 있으면 E02 에서 바꿀 것. diff --git a/resources/help/E04/30_사용자_확정_전_값.md b/resources/help/E04/30_사용자_확정_전_값.md new file mode 100644 index 000000000..837924bb6 --- /dev/null +++ b/resources/help/E04/30_사용자_확정_전_값.md @@ -0,0 +1,30 @@ +# 3D 해석 사용자 확정 전 값 + +- 아래 값은 근거 문헌 · 기술정보를 보고 정한 지금 기본값임. 사용자 협의로 확정되기 전이며 바뀔 수 있음. +- 「화면」 = 탐색 설정 · 고급 설정 칸에서 바꿀 수 있음 · 「고정」 = 화면에서 못 바꿈. + +| 값 | 지금 기본값 | 출처 · 까닭 | 바꾸는 곳 | 상태 | +| --- | --- | --- | --- | --- | +| 3D 기본 방법 | Hungr 3D Bishop · 암반에 잘린 면은 3D Janbu 보정과 작은 값 · Hovland 비교 | 지식DB 05 1장 · 요구서 345 4-2 | 고정 | 사용자 확정 전 | +| Janbu 보정 전환 문턱 | 잘린 바닥 면적 10 % | 기둥 몇 개만 닿아 지도에 이음매가 생기는 것을 막는 값 · Zhang(1988) 약층 경우 잘림 비 33 % | 고정 | 사용자 확정 전 | +| 활동면 모양 | 구 + 타원체 | Scoops3D · Hungr(1989) 타원체 꼴 | 화면 | 사용자 확정 전 | +| 타원체 길이비 | 2.0 | 브레인 정함 | 화면 | 사용자 확정 전 | +| 탐색 폭 | 중심선 ±30 m | 브레인 정함 · 지식DB 05 6.1절(노선 따라 탐색 상자 · 문헌 예 ±50 m) | 화면 | 사용자 확정 전 | +| 기둥 크기 | 1.0 m | 브레인 정함 | 화면 | 사용자 확정 전 | +| 구 중심 간격 · 높이 범위 · 간격 | 2 m · 지표 위 2~30 m · 2 m | 브레인 정함 · Scoops3D 탐색 격자 방식 | 화면 | 사용자 확정 전 | +| 반지름 증분 · 최대 깊이 | 1 m · 15 m | 브레인 정함 · Scoops3D 방식 | 화면 | 사용자 확정 전 | +| 부피 범위 | 10~10,000 m³ | 브레인 정함 · 지식DB 05 6.1절(문헌 예 50~50,000 m³) | 화면 | 사용자 확정 전 | +| 토사 측점 흙 두께 | 3 m | 국내 산지 풍화토 · 붕적토 1~3 m 의 큰 쪽 | 고정 | 사용자 확정 전 | +| 못 뚫는 층 | 발파암(연암 물성) | 토사 측점 아래 = 리핑암(풍화암 물성)으로 봄 | 고정 | 사용자 확정 전 | +| 우기 지하수 | 지표까지 포화 | KDS 우기 규칙(토사)의 3D 꼴 | 고정 | 사용자 확정 전 | +| 3D 기준 안전율 | E02 깎기 · 쌓기 중 큰 값(건기 1.5 · 우기 1.3) | KDS 11 70 05 · 한 구간에 깎기 · 쌓기가 섞여 엄한 쪽 | E02 기준 안전율 | 사용자 확정 전 | +| 자동 구간 길이 | 100 m(경계 = 측점) · 꼬리 50 m 미만은 앞에 붙임 | 브레인 정함 | 고정(시작 · 끝 칸으로 직접 지정 가능) | 사용자 확정 전 | +| 한 번에 해석할 구간 상한 | 500 m | 브레인 정함(계산 시간 · 메모리) | 고정 | 사용자 확정 전 | +| 안전율 색 단계 | 1.0 · 1.2 · 1.3 · 1.5 · 2.0 · 3.0 | 1.3(우기) · 1.5(건기) 기준 경계 | 고정 | 사용자 확정 전 | + +## 다른 화면에서 오는 값 + +| 값 | 지금 기본값 | 출처 | 상태 | +| --- | --- | --- | --- | +| 지반 물성치(성토 · 풍화토 · 풍화암 · 연암) | E02 표 값 | 문헌 추정치 · 현장 시험 없음(지식DB 04 · 07) | 사용자가 E02 에서 바꿈 | +| 노면 하중 | 10 kPa | 옹벽 배면 상재하중 준용 | 사용자가 E02 에서 바꿈 | diff --git a/resources/help/E05/00_설명서.md b/resources/help/E05/00_설명서.md new file mode 100644 index 000000000..5342c10a1 --- /dev/null +++ b/resources/help/E05/00_설명서.md @@ -0,0 +1,55 @@ +# 보고서 설명서 + +## 이 화면에서 하는 일 + +- E02~E04 · E07 · E03 보강 검토 결과를 모아 비탈면 안정성 검토 보고서를 엑셀 꼴로 만듦. +- 가운데 = 내장 엑셀(시트 탭 · 그림 · 쪽 나눔 점선)로 보고서를 바로 보고 고침. +- 왼쪽 = 안내 글 · 상태 줄 · 내보내기 단추 · 저장 단추. +- 내보내기 = 엑셀(xlsx) · PDF 파일. +- 처음 들어오면 서버가 보고서를 한 번 만듦(2D 해석 결과가 있을 때만). 그 첫 판이 [초기화] 의 되돌림 기준이 됨. + +## 작업 순서 + +1. E03 측점 해석에서 **[해석]** 을 먼저 끝냄(없으면 가운데에 「2D 해석 결과가 없습니다 — E03 에서 [해석] 뒤 만드세요.」). +2. 필요하면 E04 3D 해석 · E07 광역 해석 · E03 보강 검토도 끝냄(하지 않은 부분은 시트에 「… 전」 으로 남음). +3. E05 를 열면 보고서가 뜸. 아래 시트 탭(표지 · 개요 · 입력조건 · 측점표 · 대표단면 · 3D요약 · 광역요약 · 보강검토)을 눌러 차례로 확인함. +4. **표지** 의 발주처 · 작성자 칸, **개요** 의 「4. 의견」 칸에 글을 씀. +5. 왼쪽 **[저장]** 을 누름(「저장했습니다.」). +6. 해석을 다시 했으면 가운데 위 주의 색 띠 「해석 결과가 바뀜 —」 옆 **[보고서 갱신]** 을 누름. +7. **[PDF 미리보기]** 로 인쇄 모양을 보고, **[엑셀]** 또는 **[PDF]** 로 내려받음. + +## 단추 + +| 자리 | 단추 | 하는 일 | +| --- | --- | --- | +| 왼쪽 위 줄 | **[엑셀]** | 지금 화면의 보고서를 `안정성평가_보고서.xlsx` 로 내려받음 · 저장은 안 함 | +| 왼쪽 위 줄 | **[PDF]** | 지금 화면의 보고서를 `안정성평가_보고서.pdf` 로 내려받음 · 저장은 안 함 | +| 왼쪽 위 줄 | **[PDF 미리보기]** | PDF 를 화면 안 창으로 띄움 · **[닫기]** 로 닫음 | +| 왼쪽 아래 줄 | **[보고서 갱신]** | 프로그램 몫 시트 · 그림만 지금 해석 결과로 다시 씀 · 표지 · 개요 · 사용자가 더한 시트는 그대로 | +| 왼쪽 아래 줄 | **[초기화]** | 처음 만든 보고서로 되돌림 · 확인 창 「처음 만든 보고서로 되돌립니다. 고친 내용 · 갱신이 모두 사라집니다.」 | +| 왼쪽 아래 줄 | **[저장]** | 고친 보고서를 서버에 저장 · 고친 것이 있을 때만 켜짐 · 수식은 서버가 다시 풂 | +| 가운데 위 띠 | **[보고서 갱신]** | 왼쪽 같은 이름 단추와 같음 · 해석 결과가 바뀐 때만 띠가 뜸 | + +- 저장 안 한 고침이 있는데 [보고서 갱신] 을 누르면 「저장 안 한 고침이 있습니다. 저장한 뒤 갱신할까요?」 → **[저장]** 을 고르면 저장 뒤 갱신함. +- 시트 탭 줄 끝 **+** = 빈 시트 추가 · 탭 오른쪽 누름 메뉴 = 이름 바꾸기 · 복사 · 숨기기 · 삭제. + +## 결과 읽는 법 + +- 상태 줄(왼쪽): 「저장 안 된 변경이 있습니다.」 · 「만드는 중…」 · 「보고서 만든 때 날짜 시각」. +- 판정 칸 `O.K` = 초록 채움 · `N.G` = 빨강 채움. +- 개요의 측점 수 · 최소 안전율 · 종합 판정 · 판정 글은 측점표 · 입력조건 시트를 가리키는 수식이라 갱신하면 같이 바뀜. +- 시트마다 새 쪽에서 시작. 긴 표(측점표 등)는 자동으로 쪽이 나뉘고 머리 줄이 쪽마다 되풀이됨. 쪽 나눔은 화면에 점선으로 보임. +- 시트별 내용은 「시트 구성」 문서 참고. + +## 알아 둘 것 + +- **문헌 추정치 · 현장 시험 없음** — 표지 · 입력조건 시트에 고정 글로 들어 있음. 지반 물성치는 문헌 · 기준값을 적용한 추정치이며 현장 조사 · 시험 성과를 반영하지 않았음. 입력조건 물성 표 「출처」 열 = 기본값 그대로면 「문헌 추정치(기본값)」 · 바꿨으면 「사용자 입력」. +- **사용자 몫** = 표지 · 개요 — 처음 만들 때만 채우고 [보고서 갱신] 때 건드리지 않음. **프로그램 몫** = 입력조건 · 측점표 · 대표단면 · 3D요약 · 광역요약 · 보강검토 — 갱신 때 통째로 다시 씀. +- 프로그램 몫 시트를 손으로 고쳤다면 갱신 때 덮임. 이때 「고친 내용이 덮인 시트 — 옛 판은 _지난/ 에 보관: 시트 이름」 알림이 뜨고 옛 판은 서버에 보관됨. 오래 남길 글은 개요 의견 칸이나 새 시트에 쓸 것. +- 프로그램 몫 시트를 지웠어도 갱신하면 끝에 다시 생김. 보강검토 시트는 E03 보강 검토 결과가 있을 때만 생김. +- 고친 내용은 [저장] 전까지 이 브라우저 탭에만 남음(자동 저장 없음). 탭을 닫기 전 [저장] 할 것. +- [엑셀] · [PDF] 는 화면에 지금 보이는 판(저장 안 한 고침 포함)으로 만듦. 보기만 허용된 프로젝트는 서버에 저장된 판으로 만듦. +- 다른 곳에서 먼저 저장했으면 「다른 곳에서 보고서가 바뀌었습니다 — 다시 여세요.」 → 화면을 다시 열 것. +- 보기만 허용된 프로젝트에서는 「보기만 허용된 프로젝트입니다.」 가 뜨고 [저장] · [초기화] · [보고서 갱신] 이 꺼짐(내보내기는 됨). +- 왼쪽 안내 글은 입력조건 · 측점표 · 대표단면 · 3D요약만 적고 있으나, 광역요약 · 보강검토도 갱신 때 다시 씀. +- **「사용자 확정 전」 표기** — E07 광역 화면에는 뿌리 점착 1 kPa · 측점 등급 문턱 5 % · 20 % 가 「사용자 확정 전」 으로 적혀 있으나, 보고서 광역요약 시트에는 그 줄이 아직 없음(준비 중). 값 자체는 광역요약 「토층 물성」 줄 · 「위험 측점」 제목에 들어감. diff --git a/resources/help/E05/10_시트_구성.md b/resources/help/E05/10_시트_구성.md new file mode 100644 index 000000000..e49665421 --- /dev/null +++ b/resources/help/E05/10_시트_구성.md @@ -0,0 +1,66 @@ +# 보고서 시트 구성 + +| 차례 | 시트 | 몫 | 용지 | 내용 출처 | +| --- | --- | --- | --- | --- | +| 1 | 표지 | 사용자 | A4 세로 | 처음 만들 때 사업명 · 노선명 · 작성일만 채움 | +| 2 | 개요 | 사용자 | A4 세로 | 수식이 측점표 · 입력조건을 따라감 | +| 3 | 입력조건 | 프로그램 | A4 세로 | E02 지반 조건 · 해석 방법 | +| 4 | 측점표 | 프로그램 | A4 가로 | E03 측점 해석 | +| 5 | 대표단면 | 프로그램 | A4 세로 | E03 대표 단면 · 그림 | +| 6 | 3D요약 | 프로그램 | A4 세로 | E04 3D 해석 · 평면 위험 띠 그림 | +| 7 | 광역요약 | 프로그램 | A4 세로 | E07 광역 해석 | +| 8 | 보강검토 | 프로그램 | A4 세로 | E03 보강 검토(있을 때만) | + +## 1. 표지 + +- 제목 「비탈면 안정성 검토 보고서」 · 부제 「임도 노선 비탈면 안정해석 결과」. +- 사업명 · 노선명(지역 · 임도 종류) · 작성일 = 자동 · 발주처 · 작성자 = 사용자가 씀. +- 「문헌 추정치 · 현장 시험 없음」 과 주의 글 「※ 지반 물성치는 문헌 · 기준값을 적용한 추정치이며 현장 조사 · 시험 성과를 반영하지 않았음.」 고정. + +## 2. 개요 + +- 1. 해석 대상 — 대상 측점 수(개소) · 해석 구간 연장(m). +- 2. 조건별 최소 안전율 — 건기 · 우기 · 지진마다 최소 안전율 · 기준 안전율 · 판정 · 최소 안전율 측점. 지진을 안 쓰면 「-」. +- 3. 종합 판정 — 기준 미달(N.G) 측점 수 · 종합 판정 · 판정 글(예: 「대상 측점 57개소 중 3개소가 기준 안전율에 미달함. 미달 구간은 보강 대책 검토가 필요함.」). +- 4. 의견 — 사용자 글 칸. + +## 3. 입력조건 + +- 1. 해석 방법 — 해석 기법(Bishop 간편법 기본 · Janbu 보정 · Fellenius 비교) · 활동면 탐색(원호 + 비원호 · 좌우 비탈 따로) · 3D 해석(Hungr 3D Bishop(+Janbu 보정) · 구 · 타원체 탐색, 3D 를 안 했으면 「3D 해석 전」) · 적용 기준(KDS 11 70 05). +- 2. 기준 안전율 — 건기 · 우기 · 지진 값 = 깎기 · 쌓기 중 엄한 쪽 · 비고에 둘 다 적음. +- 3. 지하수 규칙 — 건기 · 우기(토사 · 풍화암 / 암반) · 지진 시. +- 4. 노면 하중(kPa). +- 5. 지반 물성치 — 지층 · 적용 구간(전체 · 구간 글) · γt · γsat · c · φ · 출처(「문헌 추정치(기본값)」 또는 「사용자 입력」). E02 구간별 덮어쓰기도 줄로 더해짐. + +## 4. 측점표 + +- 측점 하나 = 한 줄 · 측점 · 누가거리 · 구분(깎기 · 쌓기 중 기준 대비 가장 낮은 쪽) · 건기 · 우기 · 지진 안전율 · 기준 안전율 · 판정. +- 판정 = 모든 조건이 기준 이상이면 O.K · 하나라도 미달이면 N.G. + +## 5. 대표단면 + +- 단면 하나 = 한 쪽 · 제목(대표 단면 ① — 측점 · 깎기/쌓기 · 높이) · 선정 사유 · 단면 그림(지반선 · 설계면 · 암선 · 노면 · 비탈 높이 · 조건별 임계 활동면). +- 선정 사유 = 「쌓기 높이 10 m 이상」 · 「깎기 높이 15 m 이상」 · 「최소 안전율 하위 5」 · 「사용자 지정」(E03 대표 단면 켬). +- 조건별 해석 방법 · 안전율 · 기준 · 판정 · 활동면 반경 R · 중심 x · y · 비고(원호 · 비원호 · 지반 · 토층 두께). +- 대표 단면이 없으면 「대표 단면 — 해당 없음」. + +## 6. 3D요약 + +- 1. 평면 위험 띠 그림 — 노선 · 측점 2D 판정 색 · 3D 구간 띠(O.K · N.G). 3D 를 안 했으면 「3D 해석 전」. +- 2. 구간별 3D 안전율 — 구간 · 시작 측점 · 끝 측점 · 3D 최소 Fs · 2D 최소 Fs · 3D/2D 비(수식) · 임계 체적(m³) · 판정. +- 2D 최소 Fs = 그 구간 측점들의 **같은 조건**(3D 를 셈한 건기 또는 우기) 최소값. 판정 · 기준은 E04 값을 그대로 씀. +- 3D/2D 비가 1 보다 크면 2D 가 안전 쪽. + +## 7. 광역요약 + +- 1. 해석 조건 — 노선 띠(중심선 ± m · 격자) · 토층 물성(γt · γsat · c · φ · 뿌리 점착 · 토층 두께) · 시나리오(표준 SINMAP 습윤지수 또는 최악 완전 포화) · 해석 때. +- 2. 등급별 면적 — 안정 · 보통 안정 · 준안정 · 위험 하한 · 위험 상한 · 불안정의 SI 범위 · 면적(m²) · 비율(%) · 합계, 옆에 측점 등급(낮음 · 보통 · 높음)별 측점 수. +- 3. 위험 측점 — 보통 · 높음 측점만 한 줄씩 · 최소 Fs · 최소 SI · 등급(SI<1 비율) · 위험 면적 · 최대 경사. 없으면 「위험 측점 없음」. +- E07 해석 전이면 「광역 해석 전 — E07 광역에서 [해석] 뒤 [보고서 갱신]」. + +## 8. 보강검토(가정) + +- 머리 글 「E 안 가정 검토 — 비탈 완화 · 소단은 형상만 바꿔 다시 해석 · 설계(임도)에 안 돌려 씀 · 문헌 추정치」. +- 1. 비탈 완화 · 소단 가정 — 측점 · 비탈 · 가정(1:n 전 → 후 · 소단 · 최소 완화) · 조건 · 전 Fs · 후 Fs · 기준 · 전 판정 · 후 판정. +- 2. 벽 외적 안정 — 측점 · 벽 · 평상시/지진 시 · 토압법 · 배면 수위 · 활동 · 전도 · 지지력 Fs와 기준(KDS 11 80 05) · 판정. +- E03 보강 검토 결과가 없으면 시트 자체가 빠짐. diff --git a/resources/help/E06/00_설명서.md b/resources/help/E06/00_설명서.md new file mode 100644 index 000000000..89e38d24a --- /dev/null +++ b/resources/help/E06/00_설명서.md @@ -0,0 +1,72 @@ +# 암반 해석 설명서 + +## 이 화면에서 하는 일 + +암 측점(리핑암 · 발파암)의 깎기 비탈이 절리(암반 틈) 때문에 무너질 수 있는지 봄. +현장에서 조사한 절리 방향을 넣으면 측점마다 두 가지를 셈. + +- **Markland 판정** — 절리 방향만 보고 평면 · 쐐기 · 전도 가운데 어떤 무너짐이 생길 수 있는지 가림. +- **Hoek-Bray 안전율** — 평면 · 쐐기로 판정된 것만 건기 · 우기(· 지진) 안전율을 셈. 전도는 판정만 함. + +사면 방향 · 경사 · 높이는 복사본 횡단에서, 물성 · 지진 · 기준 안전율은 지반 조건(E02)에서 가져옴. + +## 작업 순서 + +1. 좌측 **절리군** 카드에서 [+ 절리군] 을 눌러 줄을 늘림. +2. 줄마다 이름 · 구간(시작 · 끝, m) · 경사방향 · 경사 · φj · cj · 지속성을 넣음. 칸 뜻은 `10_칸_뜻` 참고. +3. 필요하면 **해석 설정** 카드(측방 한계 · 암 단위중량 · 우기 수위 비 · 인장균열 · 볼트)를 고침. +4. [저장] 을 누름. 빨간 칸이 있으면 저장되지 않음. +5. [해석] 을 누름. 저장 안 한 고침이 있으면 먼저 저장한 뒤 셈. +6. 가운데 **위험 띠** 나 우측 **측점 결과** 표에서 측점을 눌러 스테레오넷 · 안전율 표를 봄. + +## 단추 + +| 단추 | 자리 | 하는 일 | +| --- | --- | --- | +| [+ 절리군] | 좌 · 절리군 카드 | 새 줄 추가(구간 = 0 m ~ 마지막 암 측점 · 경사방향 0° · 경사 45° · φj 30° · cj 0 kPa) | +| [×] | 좌 · 절리군 줄 끝 | 그 줄 지움 | +| [초기화] | 좌 아래 | 확인 창 뒤 절리군 · 설정을 처음 상태(절리 없음 · 기본 설정)로 되돌림 | +| [저장] | 좌 아래 | 절리군 · 설정을 작업본에 씀 | +| [해석] | 좌 아래 | 암 측점 × 깎기 쪽을 모두 셈 · 입력이 지난번과 같으면 지난 결과를 씀 | +| [등각] [등면적] | 가운데 위 | 스테레오넷 투영 바꿈(보기만 · 저장 안 됨) | +| [전체] [평면] [쐐기] [전도] | 가운데 위 | 스테레오넷에 그 모드 위험 영역만 보임 | + +- 칸을 고치기만 하면 이 탭 안에만 남음(자동 저장 없음). 「저장 안 된 변경이 있습니다.」가 뜨면 [저장] 할 것. +- 보기만 허용된 프로젝트는 칸 · 단추가 잠김. + +## 결과 읽는 법 + +**가운데 위 · 위험 띠** — 누가거리 축에 측점마다 가장 나쁜 판정 색. 띠 조각을 누르면 그 측점이 열림. 왼쪽에 판정별 측점 수. + +**가운데 · 스테레오넷** — 하반구 투영. 그림 보는 법은 `20_쓰인_방법과_근거` 의 스테레오넷 절 참고. + +- 굵은 선 · 네모 = 사면 대원 · 사면 극점 +- 점 + 이름 = 절리 극점(평면 · 전도 보기) · 세모 + 이름 = 두 절리 교선(쐐기 보기) +- 테두리가 강조된 점 · 세모 = 이 측점에서 위험으로 판정된 것 +- 원 = 마찰원 φ · 색 영역 = 평면 · 쐐기 · 전도 위험 영역 · 선 = 일광 엔벨로프(평면) + +**우측 · 측점 결과 표** — 측점 · 쪽(좌 · 우) · 평 · 쐐 · 전(위험 모드 수) · 최소 Fs · 판정. + +| 판정 | 뜻 | +| --- | --- | +| N.G | 안전율이 기준보다 낮은 경우가 하나라도 있음 | +| 검토 | 전도 위험이 있음, 또는 위험 판정은 났으나 블록이 안 생겨 안전율을 못 셈 | +| O.K | 위험 모드는 있으나 모든 안전율이 기준 이상 | +| 위험 없음 | Markland 판정에서 위험 모드 없음 | + +**우측 아래 · 고른 측점** — 사면 경사방향 / 경사 · 높이 · 윗면 경사 · 암 단위중량 한 줄, 모드별 위험 절리, 안전율 표(모드 · 절리 · 조건 · Fs · 기준 · 판정). + +- Fs 옆 「(블록 안 생김)」 = 그 조건에서 덩이가 만들어지지 않음. +- Fs 옆 「(지속성 < 활동면)」 = 절리 길이가 활동면보다 짧음 · 실제로는 덩이가 덜 생길 수 있음. +- 기준 = 지반 조건(E02)의 깎기 기준 안전율(기본 건기 1.5 · 우기 1.2 · 지진 1.1). + +## 알아 둘 것 + +- **문헌 추정치 · 현장 시험 없음.** 절리면 φj · cj · 암 단위중량 기본값은 문헌 값임. 현장 조사 · 시험 값으로 바꿀 것. +- 절리 방향은 반드시 현장 조사값을 넣을 것. 절리가 없으면 해석할 것이 없음. +- 주향으로 적은 야장은 경사방향 = 주향 + 90°(오른손 법칙)로 바꿔 넣을 것. 주향 입력 칸은 없음. +- 대상 = 암 측점의 깎기 쪽 중 높이 1 m 이상만. 토사 측점 · 쌓기 쪽은 2D 해석(E03)에서 봄. +- 지진 조건은 지반 조건(E02)에서 지진을 켠 때만 셈. +- 절리 · 지반 조건이 해석 뒤 바뀌면 가운데 위에 「[해석] 을 다시 누르세요」 띠가 뜸. +- 전도는 기하 판정만 함. 블록 전도 안전율은 별도 정밀 검토 몫. +- 보고서(E05)에 암반 결과 시트는 **준비 중**. diff --git a/resources/help/E06/10_칸_뜻.md b/resources/help/E06/10_칸_뜻.md new file mode 100644 index 000000000..24ec84671 --- /dev/null +++ b/resources/help/E06/10_칸_뜻.md @@ -0,0 +1,51 @@ +# 칸 뜻 + +범위 밖 · 빈 칸(필수)은 칸이 빨갛게 되고 마우스를 올리면 「범위 밖 (아래 ~ 위)」가 보임. 빨간 칸이 있으면 [저장] · [해석] 이 안 됨. + +## 절리군 표 (좌 · 절리군 카드) + +한 줄 = 방향이 비슷한 절리 무리 하나. 현장 조사값을 넣음. + +| 칸 | 뜻 | 단위 | 범위 | 새 줄 기본 | +| --- | --- | --- | --- | --- | +| 이름 | 절리군 이름(그림 · 표에 쓰임) | - | 비우면 안 됨 | J1, J2 … | +| 시작 · 끝 | 이 절리군을 쓰는 누가거리 구간 · 구간 안 측점에만 씀 | m | 0 ~ 100,000 · 끝 ≥ 시작 | 0 ~ 마지막 암 측점 | +| 경사방향 | 절리면이 기울어 내려가는 방위(북 0° · 시계 방향) | ° | 0 ~ 360 | 0 | +| 경사 | 절리면이 수평에서 기운 각 | ° | 0 ~ 90 | 45 | +| φj | 절리면 마찰각 | ° | 0 ~ 60 | 30 | +| cj | 절리면 점착력 | kPa | 0 ~ 1,000 | 0 | +| 지속성 | 절리가 이어지는 길이 · 비우면 끝없이 이어진다고 봄 | m | 0 ~ 1,000 | 빈 칸 | + +- 한 측점에 구간이 겹치는 절리군이 여럿이면 모두 함께 봄(쐐기 = 두 절리군 짝마다). +- 새 줄 φj 30° · cj 0 kPa = 지식DB 07 절리면 범위(φj 25~35° · cj 0~30 kPa)의 보수 쪽. +- 지속성은 안전율을 바꾸지 않음. 활동면보다 짧으면 결과 표에 「(지속성 < 활동면)」 표시만 붙음. + +## 해석 설정 (좌 · 해석 설정 카드) + +| 칸 | 뜻 | 범위 | 기본 | +| --- | --- | --- | --- | +| 평면 측방 한계 (°) | 사면과 절리 경사방향 차이가 이 각 안이면 평면 무너짐 후보 | 5 ~ 45 | 20 | +| 전도 측방 한계 (°) | 절리가 사면 반대로 기운 방향 차이가 이 각 안이면 전도 후보 | 5 ~ 45 | 20 | +| 암 단위중량 (kN/m³ · 비우면 E02) | 덩이 무게 계산 값 · 비우면 지반 조건(E02)의 그 측점 암 물성 γt · 그것도 없으면 25 | 15 ~ 35 | 빈 칸 | +| 우기 수위 비 (0~1) | 우기 조건 물 차는 정도 · 0 = 마름 · 1 = 가득 참 | 0 ~ 1 | 0.5 | +| 인장균열 | 사면 윗면에서 아래로 갈라진 틈을 볼지 · 없음 · 임계(최소 안전율 자리) · 깊이 지정 | - | 없음 | +| 균열 깊이 (m) | 「깊이 지정」 때만 보임 · 윗면에서 잰 균열 깊이 | 0.1 ~ 100 | 1 | +| 볼트 힘 (평면 kN/m · 쐐기 kN) | 록볼트 · 앵커가 잡아 주는 힘 · 평면은 폭 1 m 당 · 쐐기는 덩이 하나당 | 0 ~ 5,000 | 0 | +| 볼트 경사 (수평 아래 °) | 볼트가 산 쪽으로 박히는 각(수평 아래가 +) | -30 ~ 60 | 15 | + +- 측방 한계 기본 20° = 상용 Dips 기본 · 지식DB 03 은 전도에 30° 를 씀 — 화면에서 바꿀 수 있음. +- 우기 수위 비 기본 0.5 = 비탈 높이 ½ 수위(KDS 11 70 05 암반). +- 인장균열 「임계」 = 균열 자리를 마루 뒤로 옮겨 가며 안전율이 가장 낮은 자리를 찾음. 균열 없는 쪽이 더 낮으면 균열 없음으로 셈. 평면 무너짐에만 씀. +- 볼트 = 수동 지지력(덩이가 움직이면 버팀). 0 이면 보강 없음. + +## 결과 칸 (우측) + +| 칸 | 뜻 | +| --- | --- | +| 쪽 | 노선 좌 · 우 깎기 비탈 | +| 평 · 쐐 · 전 | 위험으로 판정된 평면 절리 수 · 쐐기 짝 수 · 전도 절리 수 | +| 최소 Fs | 그 비탈 모든 경우 중 가장 낮은 안전율 | +| 사면 줄 | 사면 경사방향 / 경사 · 높이 · 윗면(비탈 끝 바깥 원지반) 경사 · 쓴 암 단위중량 | +| 쐐기 (추향/선주각) | 두 절리 교선이 향하는 방위 / 수평 아래 기운 각 | +| 조건 | 건기(물 없음) · 우기(우기 수위 비) · 지진(E02 kh) | +| 기준 | 지반 조건(E02) 깎기 기준 안전율 | diff --git a/resources/help/E06/20_쓰인_방법과_근거.md b/resources/help/E06/20_쓰인_방법과_근거.md new file mode 100644 index 000000000..d9763ab61 --- /dev/null +++ b/resources/help/E06/20_쓰인_방법과_근거.md @@ -0,0 +1,72 @@ +# 쓰인 방법과 근거 + +## 근거 문서 + +- 지식DB `안정성평가/03` 암반 비탈면 평사투영 및 블록 해석 수식 명세 — Markland 판정 · Hoek-Bray 평면 · 쐐기 안전율. +- Hoek & Bray 「Rock Slope Engineering」 · Rocscience Dips · RocPlane · SWedge 이론서(식만 따름 · 프로그램은 쓰지 않음). +- KDS 11 70 05 — 우기 수위(암반 = 비탈 높이 ½). +- 지식DB `안정성평가/07` — 암 단위중량(25~27 kN/m³) · 절리면 강도 범위. + +## 방향 적는 법 + +- 면 = 경사방향 / 경사. 예: 135/60 = 남동쪽으로 60° 기운 면. +- 선 = 추향 / 선주각. 추향 = 선이 내려가는 방위 · 선주각 = 수평 아래로 기운 각. +- 극점 = 면에 수직인 선. 면이 완만할수록 극점이 그림 가운데로 감. +- 사면 경사방향 = 그 측점 노선 방향에 직각으로, 비탈이 노면 쪽으로 내려가는 방위(프로그램이 자동으로 셈). + +## Markland 판정 (무너질 수 있는 모양인지) + +절리 방향 · 사면 방향 · 마찰각만 봄. 힘 계산 없음. + +| 모드 | 조건(모두 맞으면 위험) | +| --- | --- | +| 평면 | 절리 경사방향이 사면 경사방향 ± 평면 측방 한계 안 · φj < 절리 경사 < 그 방향에서 본 사면 경사 | +| 쐐기 | 두 절리 교선이 사면 쪽(방위 차 90° 안)으로 향함 · φ < 교선 선주각 < 그 방향에서 본 사면 경사 · φ = 두 절리 중 작은 φj | +| 전도 | 절리가 사면 반대쪽으로 기움(경사방향 차가 180° ± 전도 측방 한계 안) · 절리 경사 > 90° − 사면 경사 + φj | + +쉬운 말 풀이 +- 평면 = 사면과 같은 쪽으로 기운 절리 하나를 따라 덩이가 미끄러짐. 절리가 사면보다 완만해야 비탈 면에 드러남(일광). 마찰각보다 가팔라야 미끄러짐. +- 쐐기 = 두 절리가 만나 생긴 V 자 홈을 따라 덩이가 미끄러짐. 판정은 교선 하나로 봄. +- 전도 = 사면 반대로 가파르게 선 절리 사이 기둥이 앞으로 넘어짐. +- 「그 방향에서 본 사면 경사」(겉보기 경사) = 사면을 비스듬히 볼 때 덜 가팔라 보이는 경사. 지식DB 03 의 평면 조건은 사면 경사 그대로를 쓰나, 이 화면은 겉보기 경사를 씀(측방 한계 안에서 차이가 작음). + +## Hoek-Bray 평면 안전율 + +안전율 = 버티는 힘 ÷ 미는 힘. +- 버티는 힘 = cj × 활동면 길이 + (면을 누르는 힘) × tanφj + 볼트가 버티는 몫 +- 미는 힘 = 덩이 무게가 면을 따라 미는 몫 + 수압 · 지진 힘이 미는 몫 +- 덩이 = 단위 폭(1 m) 2D 단면 · 윗면은 비탈 끝 바깥 원지반 경사로 오름. +- 물 · 인장균열 없음 = 활동면 가운데 수두가 (활동면 오름 높이 × 수위 비 ÷ 2)인 삼각형 양압력. +- 물 · 인장균열 있음 = 균열 안 수심 = 균열 깊이 × 수위 비 · 균열 수평 수압 + 활동면 양압력. +- 지진 = 바깥 쪽 수평 힘(무게 × kh). +- 활동면이 윗면과 안 만나 덩이가 안 생기면 「(블록 안 생김)」. + +## Hoek-Bray 쐐기 안전율 + +- 덩이 = 두 절리 · 사면 · 윗면 네 면이 만드는 삼각뿔. 부피 × 암 단위중량 = 무게. +- 무게 · 수압 · 지진 · 볼트 힘을 3차원 벡터로 더한 뒤 미끄러지는 길을 고름 — 두 면을 함께 타고 미끄러짐 · 한 면만 타고 미끄러짐 · 들려 떨어짐. +- 각 면 수직력으로 마찰 저항을 구해 안전율 = 버티는 힘 ÷ 미는 힘. 들린 면은 저항 없음. +- 물 = 수위 비가 1 이면 지식DB 03 평균 수두(γw × Hw ÷ 6) · 수위 비 p 이면 그 p³ 배. Hw = 교선이 윗면에 닿는 높이. +- 지진 = 교선 방향 수평 힘. 볼트 = 산 쪽(사면 반대 방위)으로 박힌 수동력. +- 지식DB 03 의 닫힌 꼴 쐐기 식 대신 같은 이론의 벡터 풀이(SWedge 이론서 꼴)를 씀 — 한 면 미끄러짐 · 들림까지 가림. + +## 스테레오넷 읽는 법 + +- 구를 아래 반쪽만 보고(하반구) 평면에 펼친 그림. 위 = 북 · 가장자리 = 수평 · 가운데 = 연직. +- 등각 = 각도 모양이 바르게 보임 · 등면적 = 넓이 비율이 바르게 보임. 판정 결과는 같음. +- **마찰원** = 마찰각 φ 원. 그림의 φ = 그 측점 절리 중 가장 작은 φj(제목 줄에 표시) · 표 판정은 절리마다 제 φj 를 씀 — φj 가 서로 다르면 그림과 표가 조금 다를 수 있음. + - 극점 보기(평면 · 전도) — 극점이 마찰원 안이면 절리가 φ 보다 완만해 미끄러지지 않음. + - 교선 보기(쐐기) — 교선이 마찰원 안이면 φ 보다 가팔라 미끄러질 수 있음. +- **평면 위험 영역** = 마찰원 밖 · 일광 엔벨로프 안 · 사면 반대편 측방 한계 부채꼴. 극점이 이 안이면 평면 위험. +- **쐐기 위험 영역** = 사면 대원 밖 · 교선 마찰원 안 · 사면 쪽 반원. 교선 세모가 이 안이면 쐐기 위험. +- **전도 위험 영역** = 가장자리 쪽 · 사면 경사방향 측방 한계 부채꼴. 극점이 이 안이면 전도 위험. +- 영역 경계는 Markland 조건과 같은 식으로 그림. + +## 한계 + +- 문헌 추정치 · 현장 시험 없음. 결과는 넣은 절리 값만큼만 맞음. +- 2D 평면 · 단순 삼각뿔 쐐기만 봄. 여러 덩이가 이어진 무너짐 · 단계 깎기 소단 · 지형 굴곡은 안 봄. +- 사면 높이 1 m 미만 깎기는 뺌. 윗면 = 비탈 끝 바깥 max(높이, 5 m) 원지반 평균 오르막(사면 경사 − 1° 까지). +- 지속성은 표시만 하고 안전율 · 판정에 안 넣음. +- 전도는 기하 판정만 함(Goodman-Bray 블록 전도 안전율 없음). +- 평면 우기 물: 지식DB 03 의 「균열 없음 · ½ 수위」 식(U = ¼ γw H A)은 이 화면 수위 비 1 과 같은 꼴임. 기본 0.5 는 그 반 수두 — 설계 목적에 맞게 수위 비를 정할 것. diff --git a/resources/help/E07/00_설명서.md b/resources/help/E07/00_설명서.md new file mode 100644 index 000000000..ed45bdf69 --- /dev/null +++ b/resources/help/E07/00_설명서.md @@ -0,0 +1,76 @@ +# 광역 위험 설명서 + +## 이 화면에서 하는 일 + +노선 띠(중심선 좌우 일정 폭) 안 자연 비탈의 얕은 산사태(표층 붕괴) 위험을 지도로 그림. +지형 격자 칸마다 **무한사면 안전율 Fs** 와 **SINMAP 안정 지수 SI** 를 셈 → SI 로 여섯 등급 색칠 → 측점마다 위험 정도(낮음 · 보통 · 높음)를 매김. + +- 지형 = 복사한 원지형(노선 공사 전 땅). 노선 위 · 아래 자연 비탈을 봄. +- 깎기 · 쌓기 비탈 자체는 2D 해석(E03) · 암반 해석(E06) 몫. + +## 작업 순서 + +1. 좌측 **토층 물성** 카드에서 물성(E02 지반 조건)을 고름. 고르면 γt · γsat · c · φ 칸이 채워짐(기본 = 붕적토). +2. 필요하면 뿌리 점착 · 토층 두께를 고침. +3. **시나리오 · 포화** 카드에서 시나리오를 고름 — 표준(SINMAP 습윤지수) 또는 최악(완전 포화). +4. **노선 띠 · 격자 · 측점 등급** 카드에서 띠 폭 · 격자 · 측점 문턱 둘을 확인함. +5. [해석] 을 누름. 진행 막대가 끝나면 지도 · 결과가 나옴. +6. 우측 **측점별 위험** 표에서 측점을 누르면 지도가 그 측점으로 옮겨 감. + +## 단추 + +| 단추 | 자리 | 하는 일 | +| --- | --- | --- | +| [기본값] | 좌 아래 | 모든 칸을 기본값으로 되돌림(해석은 안 함) | +| [다시 해석] | 좌 아래 | 같은 조건이라도 처음부터 다시 셈 | +| [해석] | 좌 아래 | 조건이 지난 결과와 같으면 「같은 조건의 결과가 있습니다.」 뒤 그 결과를 보임 · 다르면 새로 셈 | +| [등급 (SI)] [안전율 Fs] | 가운데 위 | 지도 색을 SI 등급 · 안전율로 바꿈 | + +- 칸 값은 이 탭 안에만 기억됨. 저장되는 것은 [해석] 한 결과(조건 포함) 하나뿐 — 새로 해석하면 지난 결과를 덮음. +- 보기만 허용된 프로젝트는 [해석] 이 잠김. + +## 결과 읽는 법 + +**가운데 · 지도** — 휠 = 확대 · 끌기 = 옮김 · 두 번 누름 = 전체 맞춤. 옅은 띠 = 노선 띠 · 굵은 선 = 중심선 · 점 = 측점 · 오른쪽 위 = 북 · 오른쪽 아래 = 축척. +칸 위에 마우스를 올리면 등급 · SI · Fs · 경사 · 포화비 m · 가까운 측점이 보임. + +**범례 (등급 SI)** — 밑에 해석한 시나리오 이름이 붙음. + +| 색 | 등급 | SI | +| --- | --- | --- | +| 진초록 | 안정 | 1.5 이상 | +| 연두 | 보통 안정 | 1.25 ~ 1.5 | +| 연노랑 | 준안정 | 1.0 ~ 1.25 | +| 노랑 | 위험 하한 | 0.5 ~ 1.0 | +| 주황 | 위험 상한 | 0 초과 ~ 0.5 | +| 빨강 | 불안정 | 0 | + +- 위험 = 위험 하한 · 위험 상한 · 불안정(SI < 1). + +**범례 (안전율 Fs)** — 빨강 1.0 미만 · 주황 1.0 ~ 1.2 · 노랑 1.2 ~ 1.5 · 연두 1.5 ~ 2.0 · 초록 2.0 이상. 가장 나쁜 쪽(c · φ 아래 · 가장 젖음) 값임. + +**우측 · 광역 결과** + +- 요약 — 시나리오 · 띠 안 최소 Fs · 위험 면적(SI < 1) · 측점 등급(낮음 · 보통 · 높음 수 / 전체 측점) · 지형 있는 띠 / 띠 면적 · 해석 걸린 시간과 때. +- 등급별 면적 — 여섯 등급 면적(m²) · 비율(%). +- 측점별 위험 — 측점 · 최소 Fs · SI<1 비율(%) · 측점 등급 · 위험 m². 높음 줄은 강조됨. + +**측점 등급** — 측점 앞뒤 ½ 간격 × 띠 폭(영향 구역) 안 칸 중 SI < 1 칸 비율. + +| 측점 등급 | 기본 문턱 | +| --- | --- | +| 낮음 | 5 % 미만 | +| 보통 | 5 % 이상 20 % 미만 | +| 높음 | 20 % 이상 | + +문턱 둘은 좌측 「측점 보통 문턱」 · 「측점 높음 문턱」 칸에서 바꿈. + +**보고서(E05) 광역요약 시트** — E05 [보고서 갱신] 때 이 화면 저장 결과로 채움: 해석 조건(띠 · 물성 · 시나리오 · 해석 때) · 등급별 면적 · 측점 등급 표 · 보통 · 높음 측점 줄(측점 · 누가거리 · 최소 Fs · 최소 SI · 등급과 비율 · 위험 면적 · 최대 경사). 결과가 없으면 「광역 해석 전」. + +## 알아 둘 것 + +- **문헌 추정치 · 현장 시험 없음.** 물성 · T/R · 뿌리 점착 · 토층 두께 · 측점 문턱은 근거 후보 값임. 사용자 확정 전 값은 `30_사용자_확정_전_값` 참고. +- 위험 지도는 넓은 범위에서 「어디를 먼저 볼지」 고르는 용도임. 측점 단면 안전율(E03)을 대신하지 않음. +- 지형 격자 끝 밖 상류는 집수면적에 안 들어감 — 띠 가장자리는 실제보다 마르게(안전하게) 나올 수 있음. +- 「엔진이 바뀌어 결과가 옛것입니다」가 뜨면 [다시 해석] 할 것. +- 최악(완전 포화)은 모든 칸이 물에 찬 극한 강우 가정 — 대부분 측점이 높음으로 나옴. 비교용으로 쓸 것. diff --git a/resources/help/E07/10_칸_뜻.md b/resources/help/E07/10_칸_뜻.md new file mode 100644 index 000000000..4f1a8a36a --- /dev/null +++ b/resources/help/E07/10_칸_뜻.md @@ -0,0 +1,56 @@ +# 칸 뜻 + +범위 밖 값으로 [해석] 을 누르면 까닭이 알림으로 뜨고 해석하지 않음. 「위」 칸은 「아래」 칸보다 작으면 안 됨(c · φ · T/R) · 높음 문턱은 보통 문턱보다 작으면 안 됨. + +## 토층 물성 (좌 · 첫 카드) + +토층 = 기반암 위에 덮인 흙. 무한사면 식이 쓰는 값. + +| 칸 | 뜻 | 범위 | 기본 | +| --- | --- | --- | --- | +| 물성(E02 지반 조건) | 지반 조건(E02) 물성 목록에서 고름 · 고르면 아래 여섯 칸을 채움(이름표일 뿐 · 값은 아래 칸) | - | 붕적토 | +| γt (kN/m³) | 젖지 않은 흙 단위중량 | 0 초과 ~ 30 | 17.5 | +| γsat (kN/m³) | 물에 찬 흙 단위중량 | 9.81 초과 ~ 30 | 18.5 | +| c 아래 (kPa) | 점착력 범위 아래 끝 | 0 ~ 500 | 5 | +| c 위 (kPa) | 점착력 범위 위 끝(물성을 고르면 아래 + 5) | 0 ~ 500 | 10 | +| φ 아래 (°) | 내부 마찰각 범위 아래 끝 | 0 ~ 60 | 27 | +| φ 위 (°) | 내부 마찰각 범위 위 끝(물성을 고르면 아래 + 3) | 0 ~ 60 | 30 | +| 뿌리 점착 (kPa) | 나무뿌리가 흙을 붙잡는 힘 · c 에 더함 · 나지 · 절성토면 = 0 | 0 ~ 50 | 1 | +| 토층 두께 (m) | 미끄러질 수 있는 흙 두께(지표에서 수직) | 0.1 ~ 10 | 1.5 | + +- 범위(아래 ~ 위)는 SI 계산에 씀. Fs 는 아래 끝 값(보수 쪽)으로 셈. + +## 시나리오 · 포화 (좌 · 둘째 카드) + +| 칸 | 뜻 | 범위 | 기본 | +| --- | --- | --- | --- | +| 시나리오 | 표준 — SINMAP 습윤지수 (T/R 범위) · 최악 — 완전 포화 (m = 1 · 강우 극한) | - | 표준 | +| T/R 아래 (m · 젖은 쪽) | 투수량계수 T ÷ 유효 강우 R · 작을수록 물이 잘 고임 | 1 ~ 100,000 | 2,000 | +| T/R 위 (m · 마른 쪽) | 같은 값의 범위 위 끝 | 1 ~ 100,000 | 3,000 | + +- T/R 두 칸은 표준일 때만 보임. +- 포화비 m = 토층 두께 중 물에 찬 비율(0 = 마름 · 1 = 지표까지 참). + +## 노선 띠 · 격자 · 측점 등급 (좌 · 셋째 카드) + +| 칸 | 뜻 | 범위 | 기본 | +| --- | --- | --- | --- | +| 띠 폭 ± (m) | 중심선에서 좌우로 볼 거리 · 지도 옅은 띠가 바로 바뀜 | 10 ~ 500 | 100 | +| 격자 (m) | 계산 칸 한 변 · 작을수록 촘촘하고 오래 걸림 | 1 ~ 10 | 2 | +| 측점 보통 문턱 (SI<1 비율 %) | 영향 구역 안 SI < 1 칸 비율이 이 값 이상이면 보통 | 0 초과 ~ 100 | 5 | +| 측점 높음 문턱 (SI<1 비율 %) | 이 값 이상이면 높음 | 0 초과 ~ 100 | 20 | + +## 결과 칸 (우측) + +| 칸 | 뜻 | +| --- | --- | +| 띠 안 최소 Fs | 띠 안 모든 칸 중 가장 낮은 안전율 | +| 위험 면적 (SI < 1) | 위험 하한 · 위험 상한 · 불안정 등급 면적 합 | +| 지형 있는 띠 / 띠 | 지형 자료가 있는 띠 면적 / 띠 전체 면적 · 차이 = 지형 밖이라 못 본 곳 | +| 최소 Fs (측점 표) | 그 측점 영향 구역 안 가장 낮은 안전율 | +| SI<1 비율 (%) | 영향 구역 칸 중 SI < 1 칸 비율 | +| 위험 m² | 영향 구역 안 SI < 1 면적 | +| 툴팁 m | 그 칸 포화비(가장 젖은 쪽) · 최악 시나리오는 1 | + +- 영향 구역 = 띠 안 칸을 가장 가까운 중심선 누가거리로 나눈 뒤, 이웃 측점과 가운데에서 끊은 몫(측점 앞뒤 ½ 간격 × 띠 폭). +- 영향 구역에 지형이 없는 측점은 값이 「-」. diff --git a/resources/help/E07/20_쓰인_방법과_근거.md b/resources/help/E07/20_쓰인_방법과_근거.md new file mode 100644 index 000000000..a3af805f3 --- /dev/null +++ b/resources/help/E07/20_쓰인_방법과_근거.md @@ -0,0 +1,69 @@ +# 쓰인 방법과 근거 + +## 근거 문서 + +- 지식DB `예정노선/02` §1.1 무한사면 안전율 식(포화비 · 뿌리 점착 포함) · §2 ① 지형습윤지수 + 정상류 무한사면(SINMAP · SHALSTAB). +- Pack 외(1998) SINMAP 안정 지수 방법 · SINMAP 2 설명서 기본 보정(T/R 2,000 ~ 3,000 m) — 식만 따름 · 원 프로그램은 쓰지 않음. +- 지식DB `안정성평가/04` · `07` — 붕적토 물성 범위(지반 조건 E02 기본값의 출처). +- 국내 적용 연구 — 뿌리 점착(산림 0 ~ 5 kPa · 우면산 1 kPa). + +## 계산 차례 + +1. 원지형 격자를 「격자」 간격으로 다시 고름. +2. 칸마다 경사 β — 이웃 3 × 3 칸으로 구함(Horn 방법). +3. 칸마다 단위 집수면적 a — 웅덩이를 채운 뒤 물이 가장 가파른 이웃으로 흐른다고 보고(D8) 위쪽에서 모여드는 칸 수 × 칸 크기. 배수유역(B04)과 같은 흐름 계산. +4. 칸마다 포화비 m(시나리오별) → 안전율 Fs · 안정 지수 SI → 등급. +5. 노선 띠 안 칸만 남겨 등급별 면적 · 측점 표를 만듦. + +## 포화비 m (시나리오) + +- **표준 — SINMAP 습윤지수**: m = (R ÷ T) × a ÷ sinβ, 단 1 을 넘으면 1. + - 위쪽 모이는 넓이 a 가 크고 경사가 완만할수록 잘 젖음(골짜기 · 비탈 아래). + - T/R 범위 안에서 바뀜 · Fs 지도는 가장 젖은 쪽(T/R 아래)으로 셈. +- **최악 — 완전 포화**: 모든 칸 m = 1(지표까지 물에 참). 극한 강우 비교용. + +## 무한사면 안전율 Fs + +비탈과 나란한 얇은 흙층이 통째로 미끄러진다고 보는 식. + +안전율 = 버티는 힘 ÷ 미는 힘 +- 버티는 힘 = (c + 뿌리 점착) + [γt × z × (1 − m) + (γsat − γw) × m × z] × cos²β × tanφ +- 미는 힘 = [γt × z × (1 − m) + γsat × m × z] × sinβ × cosβ +- z = 토층 두께 · γw = 물 단위중량 9.81 kN/m³. +- 물이 차면(m 이 커지면) 흙을 누르는 힘이 줄어 마찰이 약해짐 → Fs 가 낮아짐. +- 거의 평평한 칸은 미끄러지지 않는다고 봄(Fs · SI 무한대 = 안정). + +## 안정 지수 SI + +c · φ · T/R 을 정확히 모르니 범위(아래 ~ 위) 안에서 고르게 퍼져 있다고 보고 셈. + +- 가장 나쁜 조합(c · φ 아래 · 가장 젖음)에서도 Fs ≥ 1 → SI = 그 Fs(1 이상 · 클수록 안정). +- 가장 좋은 조합(c · φ 위 · 가장 마름)에서도 Fs < 1 → SI = 0(불안정). +- 그 사이 → SI = Fs > 1 일 확률(0 ~ 1). 예: SI 0.7 = 범위 안 조합의 70 % 가 버팀. +- 최악 시나리오는 m = 1 고정이라 c · φ 범위만 봄. + +| 등급 | SI | 쉬운 말 | +| --- | --- | --- | +| 안정 | 1.5 이상 | 나쁜 조합에서도 넉넉히 버팀 | +| 보통 안정 | 1.25 ~ 1.5 | 나쁜 조합에서도 버팀 | +| 준안정 | 1.0 ~ 1.25 | 나쁜 조합에서 겨우 버팀 | +| 위험 하한 | 0.5 ~ 1.0 | 조합 절반 이상은 버팀 | +| 위험 상한 | 0 초과 ~ 0.5 | 조합 절반 넘게 무너짐 | +| 불안정 | 0 | 좋은 조합에서도 무너짐 | + +등급 경계 = SINMAP 원 방법 그대로. + +## 측점 등급 + +- 영향 구역 = 측점 앞뒤 ½ 간격 × 띠 폭(띠 칸을 가장 가까운 중심선 누가거리로 나눔). +- 영향 구역 칸 중 SI < 1(위험 하한 이상) 칸 비율로 낮음 · 보통 · 높음(문턱 기본 5 % · 20 %). +- 한 칸이라도 위험이면 위험으로 잡던 방식은 거의 모든 측점이 위험으로 나와 변별력이 없어 비율 방식을 씀. + +## 한계 + +- 문헌 추정치 · 현장 시험 없음. 토층 두께 · 물성 · T/R 이 띠 전체에 한 값임(칸마다 다르지 않음). +- 얕은 평행 미끄러짐만 봄. 깊은 원호 활동 · 암반 무너짐 · 토석류 흘러감은 안 봄. +- 지형 = 원지형. 깎기 · 쌓기로 바뀐 땅은 반영 안 됨. +- 지형 격자 끝 밖 상류는 모름 — 띠 가장자리 칸은 집수면적이 작게 나와 실제보다 마르게 셈. +- 강우량(mm) 직접 입력 없음 — 젖는 정도는 T/R 범위로만 넣음. +- 산림청 위험지도 등급 비율 공개 자료가 없어 그와 대조하지 못함. 시험 프로젝트 위험(SI < 1) 비율 11.1 % 가 국내 SINMAP 적용 사례(약 7.5 ~ 16 %) 범위 안임만 확인함. diff --git a/resources/help/E07/30_사용자_확정_전_값.md b/resources/help/E07/30_사용자_확정_전_값.md new file mode 100644 index 000000000..df1a785b9 --- /dev/null +++ b/resources/help/E07/30_사용자_확정_전_값.md @@ -0,0 +1,20 @@ +# 사용자 확정 전 값 + +아래 값은 문헌 · 연구에서 고른 근거 후보임. 화면에서 바꿀 수 있고, 기본값으로 굳힐지는 사용자 협의로 정함. 바꾸면 그 값으로 [해석] 하면 됨 — 기본값 자체는 바뀌지 않음. + +| 값 | 지금 기본값 | 출처 | 상태 | +| --- | --- | --- | --- | +| 뿌리 점착 | 1 kPa | 국내 적용 연구 — 산림 0 ~ 5 kPa · 우면산 1 kPa · 나지 · 절성토면 0 | 사용자 확정 전 | +| 측점 보통 문턱 | SI<1 비율 5 % | 개발 쪽에서 정함 · 시험 프로젝트 측점 SI<1 비율 분포(중앙 약 10 %)를 보고 고름 | 사용자 확정 전 | +| 측점 높음 문턱 | SI<1 비율 20 % | 위와 같음 | 사용자 확정 전 | +| 토층 물성 | E02 붕적토 — γt 17.5 · γsat 18.5 kN/m³ · c 5 kPa · φ 27° | 지식DB `안정성평가/07` 붕적토(γt 17 ~ 18 · c 0 ~ 10 · φ 25 ~ 28) · E02 기본값 | 문헌 추정치 · 사용자 확정 전 | +| c · φ 범위 폭 | c + 5 kPa · φ + 3° (c 5 ~ 10 · φ 27 ~ 30) | 지식DB `안정성평가/04` 붕적토 범위 폭의 반 | 사용자 확정 전 | +| T/R 범위 | 2,000 ~ 3,000 m | SINMAP 2 설명서 기본 보정 | 문헌 기본 · 현장 보정 없음 | +| 토층 두께 | 1.5 m | 지식DB `예정노선/02` §1 표층 붕괴 토층 1 ~ 3 m | 사용자 확정 전 | +| 노선 띠 폭 | 중심선 ± 100 m | 요구 분석(노선 좌우 100 m 예) | 사용자 확정 전 | +| 격자 | 2 m | 프로그램 기본값 · 근거 문서 없음 | 사용자 확정 전 | +| 기본 시나리오 | 표준(SINMAP 습윤지수) | SINMAP 표준 방법 · 최악(완전 포화)은 선택지 | 정함 | + +- 물성 기본은 그 프로젝트 지반 조건(E02)의 붕적토 값을 따름 — E02 에서 붕적토를 고치면 이 화면 기본값도 바뀜. +- 화면 좌측 카드 아래 안내 글(기본값 = 근거 후보 …)에 같은 출처가 한 줄로 적혀 있음. +- 등급 경계(SI 1.5 · 1.25 · 1.0 · 0.5 · 0)는 SINMAP 원 방법 값이라 이 표에 넣지 않음. diff --git a/resources/tester/test_54_2_help_files.py b/resources/tester/test_54_2_help_files.py index 1bc48b728..b5ae4fc75 100644 --- a/resources/tester/test_54_2_help_files.py +++ b/resources/tester/test_54_2_help_files.py @@ -1,5 +1,6 @@ """54-2 [?] 설명서 — 서버가 resources/help/<페이지>/*.md 를 부를 때마다 읽음(고치면 바로 바뀜).""" +import re import tempfile from pathlib import Path @@ -28,15 +29,30 @@ def test_title_order_and_live_edit(): assert "고친 글" in read_help("B05", tmp_path)[1]["text"] -@pytest.mark.parametrize("page", ["B01", "B10", "../B05", "b05", "D05", "E06", "C01"]) +@pytest.mark.parametrize("page", ["B01", "B10", "../B05", "b05", "D05", "E08", "C01"]) def test_bad_page_refused(page): with pytest.raises(HTTPException): read_help(page) def test_529_1_D_E_pages_open_empty(tmp_path): - assert read_help("D02", tmp_path) == [] and read_help("E05", tmp_path) == [] + assert read_help("D02", tmp_path) == [] and read_help("E07", tmp_path) == [] def test_root_is_repo_resources(): assert HELP_ROOT.parts[-2:] == ("resources", "help") + + +@pytest.mark.parametrize( + "page", ["D01", "D02", "D03", "D04", "E01", "E02", "E03", "E04", "E05", "E06", "E07"] +) +def test_d_e_pages_have_manual(page): + items = read_help(page) + assert items and items[0]["key"] == "00_설명서" + assert len(items[0]["text"]) > 400 + for item in items: # 명사형 종결 — 합쇼체 · 해요체 · 한다체 금지 + for line in item["text"].splitlines(): + assert not re.search(r"(합니다|습니다|해요|세요|한다|된다|있다|없다)[.!]?\s*$", line), ( + page, + line, + )