[general]
name=Geo2020 地質剖面產製 (Geo2020 Geological Profile Builder)
qgisMinimumVersion=3.28
qgisMaximumVersion=4.99
description=由 Geo2020 工程地質探勘資料庫 (MDB) 批次產製地質剖面 QGIS 專案檔與 GeoPackage。Builds geological cross-section QGIS projects from Geo2020 borehole databases (MDB).
about=讀取經濟部地質調查及礦業管理中心 Geo2020「工程地質探勘資料庫」MDB 檔（內建純 Python Access 讀取器，免安裝 ODBC），在地圖上顯示鑽孔位置，並依剖面線、數值地形 (DEM 或等高線) 批次產生地質剖面 QGIS 專案檔 (.qgz)，所有圖層存入 GroProfile.gpkg。剖面包含鑽孔柱狀圖（依 2008 資料作業規範附錄B 工程地質圖元符號，內含全部 131 個圖元）、地形線、土岩界線、地下水位、RQD、SPT、不連續面，以及含圖例、比例尺、格線的版面配置。另提供岩心箱照片檢視工具：點選地層即顯示對應深度的岩心照片；以及 3D 剖面預覽與 3D 剖面成果圖：DEM 地形貼上平面圖，剖面圖（含技師修改後的剖面專案）立於剖面線位置。
 Reads Taiwan Geo2020 engineering-geology borehole databases (Access MDB, built-in pure-Python reader, no ODBC needed), shows borehole locations, and batch-generates one geological cross-section project per section line using a DEM or contour layer. Layers (strata columns with the official Geo2020 lithology patterns, terrain, soil/rock interface, groundwater, RQD, SPT, discontinuities) are stored in a single GeoPackage and each project includes a print layout. A core-box photo viewer shows the core photos of a clicked stratum, and a 3D preview / 3D result page shows the (edited) sections standing on the DEM terrain draped with the plan map.
version=1.5.0
author=Yoshi
email=yoshi.hml@gmail.com
homepage=https://github.com/yoshihuang/QGIS-Geo2020-Profile
repository=https://github.com/yoshihuang/QGIS-Geo2020-Profile
tracker=https://github.com/yoshihuang/QGIS-Geo2020-Profile/issues
category=Vector
icon=icon.png
tags=geology,3d,borehole,drilling,cross section,profile,geological section,mdb,access,geo2020,taiwan,geotechnical,地質剖面,鑽探
experimental=False
deprecated=False
hasProcessingProvider=no
supportsQt6=True
server=False
changelog=1.5.0
 - 3D section result: stratum interfaces built from the borehole contacts in the MDB (stratum tops, soil/rock interface, groundwater level; at least 3 holes), interpolated and extrapolated to the site boundary and clipped to it, kept below ground and in stratigraphic order; each surface can be switched on/off in the web page and they are exported to a GeoPackage PolygonZ layer (with a PointZ layer of the borehole contacts and a ready-made 2D/3D style).
 - 3D 剖面成果圖：新增地層界面——由 MDB 各鑽孔的地層界點（各地層頂面、土岩界面、地下水位面；至少 3 孔）內插並外推至計畫（基地）範圍後裁切，限地表以下並維持地層上下順序；網頁中各面可個別開關，並輸出成 GeoPackage PolygonZ 3D 面圖層（另含鑽孔界點 PointZ 圖層及預設 2D／3D 樣式）。
 - Confirmed interfaces: the surfaces can also be built from the stratum boundary lines of the (geologist-edited) 地形剖面 layer of each section project (soil/rock interface, rock contacts by their lower unit, groundwater), alone or together with the unconfirmed MDB ones; the mesh is refined along the control data so the surfaces follow the section lines, and each surface reports how well it fits its controls.
 - 確認版地層界面：可改由（技師修改後）各剖面專案「地形剖面」圖層中的地層界線（土岩界面、依下層區分的岩層界線、地下水位面）建立 3D 面，可單獨或與 MDB（未確認）界面並列；網格沿控制資料加密，面貼合剖面界線，並列出各面與控制點的吻合度。
 - Dialogs fit the screen (tabs scroll on small screens); groundwater surfaces are always drawn in aqua.
 - 設定視窗依螢幕大小調整（小螢幕時分頁可捲動）；3D 地下水位面固定為水藍色。
 1.4.0
 - New "3D section preview" button: builds a 3D model from the DEM, drapes the layers visible in the map canvas over the terrain and stands each generated section drawing on its section line (self-contained web page, three.js bundled, opens in the browser; requires a DEM layer).
 - 新增「3D 剖面預覽」按鈕：以 DEM 建立 3D 地形，地表貼上地圖畫面開啟的圖層，並將產出的剖面圖依剖面線位置立於 3D 剖面上（單一網頁、內含 three.js，以瀏覽器開啟；需有 DEM 圖層）。
 - 3D preview: plan and section legends; "cut terrain along section" works without facing a section first (uses the section nearest the view centre and follows the camera side).
 - 3D 預覽：新增平面與剖面圖例；「沿剖面切開地形」不需先正視剖面即可使用（切開最靠近畫面中心的剖面，並隨觀看方向切換切除側）。
 - 3D preview screenshot includes the title, a north arrow and the plan and section legends.
 - 3D 預覽「下載截圖」加入標題、指北針及平面、剖面圖例。
 - New "3D section result" tool: combines a plan-map project with the section projects as edited by the geologist into the same 3D web page (sections matched to section lines by stored name or file name).
 - 新增「3D 剖面成果圖」工具：選擇平面圖專案，結合地質技師修改後的各剖面立面圖專案，產生相同功能的 3D 網頁（依專案記錄的剖面名稱或檔名對應剖面線）。
 1.3.2
 - Call-out leader arrows now end inside the stratum they point to (last segment runs along the unit centre line).
 - Call-out 引線箭頭改落在該地層上下兩條界線之間（引線末段沿地層中線水平進入）。
 1.3.1
 - Stratum names: thin units get a smaller font; units too thin for 8 pt are labelled with a call-out instead of being omitted.
 - 版面地層名稱：較薄地層自動縮小字體，太薄時改以引線（call-out）標註，不再省略。
 1.3.0
 - Fix: with "use MDB measured dip", rock contacts, apparent-dip lines, symbols and the layout note all use the same apparent dip (mean of MDB bedding/cleavage/schistosity dips).
 - Fix: stratum names are placed between the unit's upper and lower boundary lines.
 - Layout note reads "dip direction (azimuth)/dip"; warnings show the project number when an MDB holds several projects.
 - 修正：勾選實測傾角時，岩層界線、地層視傾角線、符號與版面註記統一使用同一視傾角（MDB 實測傾角平均）。
 - 修正：版面地層名稱改標示在上下兩條地層界線之間。
 - 版面註記改為「傾向方位角/傾角」；MDB 含多個計畫時，警告訊息標示計畫編號。
 1.2.0
 - Fix: rock contacts are always extended at the apparent dip (direct correlation between adjacent boreholes is now optional).
 - Fix: joints, shear planes, fissures, tension cracks and veins, and all discontinuity symbols, are drawn at their apparent dip.
 - Layout note with section azimuth, attitudes and apparent dip; apparent-dip and fault lines are labelled with their angle.
 - Generated projects open zoomed to the terrain-profile layer.
 - 修正：岩層界線預設一律依視傾角延伸（相鄰孔直接對比改為選項）。
 - 修正：節理、剪力面、裂隙、張裂隙、岩脈的短線及所有不連續面符號，改依視傾角（實測傾角＋代表傾向）繪製。
 - 版面新增剖面方位、代表位態與視傾角註記；地層視傾角線、斷層線標示視傾角。
 - 產出的專案開啟時縮放至地形剖面圖層範圍。
 1.1.2
 - New check: warns when water_tables elevation differs from collar elevation minus water depth.
 - 新增檢查：water_tables 的水位高程與「井口高程 − 水位深度」不一致時提出警告。
 1.1.1
 - Fix: rock contacts stop at any borehole whose log they would cross without showing the contact.
 - New checks: duplicate borehole coordinates, overlapping columns in a section, gaps in core-photo coverage.
 - The borehole layer is saved into GroProfile.gpkg after a run, so it survives reopening the project.
 - 修正：岩層界線延伸時，碰到任何有鑽到該深度但沒有此界面的鑽孔即終止（原本只檢查相鄰鑽孔）。
 - 新增檢查：MDB 中座標相同的鑽孔、剖面上柱狀圖重疊（重疊鑽孔間不做地層對比）、岩心照片缺漏深度。
 - 鑽孔位置圖層於產製後存入 GroProfile.gpkg，重新開啟專案不會遺失。
 1.1.0
 - Representative rock and fault attitude inputs; apparent dip computed from the section azimuth decides which way strata dip.
 - Rock-to-rock contacts drawn and extended by apparent dip until a fault, the soil/rock interface, the ground surface, the section frame or a neighbouring borehole.
 - Fault lines, apparent-dip form lines (bedding, cleavage, ...) and every discontinuity class with data added to the terrain-profile layer; legend lists only types present.
 - Bedding/cleavage symbols rotated by apparent dip; fixed legend size estimation that caused overlaps.
 - 新增岩層／斷層代表位態輸入，依剖面方位計算視傾角並判定傾斜方向。
 - 地形剖面新增岩層間界線（鑽孔間對比連線，未對比者依視傾角延伸至斷層、土岩界面、地表、剖面邊界或鄰孔）。
 - 新增斷層線、地層視傾角線（層理／劈理等），以及節理、剪力面、裂隙、岩脈等各類不連續面；圖例只列出有資料的類別。
 - 層理／劈理符號依視傾角方向旋轉；地形剖面圖層新增終止原因等欄位。
 - 修正圖例尺寸估算偏小，避免圖例與剖面標示重疊。
 1.0.2
 - 程式碼品質：修正 Flake8 E741（變數命名）。
 1.0.1
 - 修正 Qt6 / QGIS 4 相容性（列舉值改用 scoped 寫法）；通過 Bandit 安全掃描（移除 subprocess 後備讀取器、不再靜默略過例外）。
 1.0.0
 - 初版：Geo2020 MDB 讀取、鑽孔位置圖層、DEM/等高線地形剖面、批次產製 QGZ + GroProfile.gpkg、131 個工程地質圖元、岩心照片檢視、程式說明。
