{"repo":"SeanWong17/building-sunlight-simulator","free":true,"listed":false,"github":"https://github.com/SeanWong17/building-sunlight-simulator","clone":"git clone https://github.com/SeanWong17/building-sunlight-simulator.git","description":"纯前端楼盘采光模拟工具链：规划图标注 → 3D 阴影可视化 | Frontend-only building sunlight simulator: plan annotation to 3D shadow visualization","language":"JavaScript","stars":467,"topics":["3d","apartment","architecture","building","daylight","house","javascript","real-estate","shadows","simulation"],"license":"MIT","category":"game-templates","readme_excerpt":"English 简体中文 🏢 Building Sunlight Simulator 建筑采光模拟工具 · 轻量级楼盘日照分析解决方案 👉 点击查看在线演示 (Live Demo) 👈 注：在线演示仅展示默认数据，如需自定义规划图请参考下文“本地使用”。 --- 📋 项目简介 Building Sunlight Simulator 是一套基于 Web 技术的楼盘规划与采光模拟工具。 它允许用户直接在浏览器中通过规划图（JPG/PNG）绘制建筑轮廓，生成 3D 场景，并结合项目位置和太阳轨迹算法，对目标建筑进行日照遮挡可视化估算。项目纯前端实现，运行依赖已随仓库发布，无后端和联网依赖。 --- ✨ 核心特性 模块 功能描述 ------ ---------- 部署 浏览器静态版 + Tauri 原生桌面版；桌面版不依赖 Node.js 运行时 编辑 2D 平面图转 3D 模型，支持 JSON/底图拖放导入、楼栋选择移动、撤销编辑和可视化分户配置 计算 基于球面三角学计算太阳轨迹，内置 50+ 城市经纬度与 IANA 时区数据 可视 4096px 高精度阴影贴图，支持按半球显示的冬至/夏至/春分/秋分及自定义日期，06:00-18:00 当地民用时间实时调节，配备专业罗盘指南针 量化 每户累计日照估算与热力图展示（淡黄到深橙色阶），支持单户详情、可配置参考时长及分析结果导入复用 交互 支持 PC 端及移动端触控、文件拖放，可过滤非本小区建筑且保留当前相机视角 多语言 支持中英文切换，界面右上角可自由切换语言 📊 日照时长量化分析 采光检测点计算 ：对每栋本小区建筑（ isThisCommunity: true ），按分户轴将所有外墙片段映射到各户，并在每层窗高位置生成检测点。同一户可能对应多个外墙片段，户级统计取这些片段中日照时长的最大值。 日照时长计算 ：从当地民用时间 6:00 到 18:00，按 6 分钟区间的中点进行射线检测，并结合经度、时区和均时差换算真太阳时。如果该区间太阳方向的射线未被任何建筑物遮挡，则累计该区间的日照。 热力图显示 ：计算完成后可开启热力图模式，在实际外墙采样片段上显示彩色方块。采用温暖色系，从淡黄色（0小时）渐变到深橙色（8小时及以上）。 交互功能 ：开启热力图后点击任意户型方块，可查看该户的详细信息（楼层、户号、累计日照与参考值状态）。参考时长可在分析前调整，默认 2 小时。 适用边界 ：结果是按 6 分钟离散区间累计、并取同户多个外墙采样片段最大值的方案可视化估算，不是通用行业合规结论。不同地区对检测日期、检测点和连续日照时长的要求不同，正式判断应按当地规则复核。 🧭 专业罗盘指南针 地面配备专业3D罗盘，清晰标注东南西北方位，北方用红色突出显示，替代传统简单箭头，提供更专业的方位指示。 --- 🚀 快速开始 本项目包含两个核心文件： editor.html （数据生产）和 index.html （数据消费）。 1. 获取项目 2. 运行方式 浏览器版本不依赖构建工具，选择以下任一方式打开： 直接打开 ：双击文件夹中的 editor.html 或 index.html 即可在浏览器运行。 本地服务（可选） ：如果需要热更新或解决跨域限制，可使用 live-server 或 python -m http.server 。 3. 桌面版开发与构建 桌面版使用 Tauri 2 封装同一套前端和日照算法。Tauri 只提供原生窗口和安装包，不引入 Electron 的完整 Chromium 运行时，因此发行","default_branch":null,"files":null,"tree":[],"storefront":"/r/SeanWong17","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/SeanWong17/building-sunlight-simulator/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}