基于网络的全栈平台Timverse:用于策展重型木结构连接实验数据的开源软件

《SoftwareX》:Timverse: Web-based software for curating experimental data on mass timber connections

【字体: 大 中 小 】 时间:2026年09月22日 来源:SoftwareX 1.9

编辑推荐:

  Timverse是一个开放获取的全栈网络平台,用于策展重型木结构连接性能的实验证据。v2.4.0版本包含522条已批准的连接组记录,代表从已发表研究中收集的2048个独立试验试件。该平台基于React/TypeScript、FastAPI和PostgreSQL

  
Timverse是一个开放获取的全栈网络平台,用于策展重型木结构连接性能的实验证据。v2.4.0版本包含522条已批准的连接组记录,代表从已发表研究中收集的2048个独立试验试件。该平台基于React/TypeScript、FastAPI和PostgreSQL构建,支持公开搜索、过滤、可视化、比较和导出数据,包括几何尺寸、材料描述符、榫卯与紧固件分类、加载条件、力-位移响应、延性(ductility)和破坏观察。经认证的贡献者可通过受审核的审查工作流提交新记录或提出修订建议。该软件将分散的实验记录转化为可复用的数据,用于文献综合、连接比较、模型标定、试验规划和数据驱动的研究。

重型木结构连接实验证据的数字化策展:Timverse平台的研究解读

一、研究背景与问题

重型木结构(mass timber construction)正越来越多地被用于支撑低碳、预制化和模块化建筑的发展。与传统混凝土和钢结构体系相比,木结构建筑的设计与结构行为存在显著差异。木结构建筑的整体性能不仅取决于木材材料本身——通常被认为在大体上保持弹性——更关键地取决于连接各面板、梁及其他构件的连接节点。变形、能量耗散和损伤主要集中于这些连接部位。一个木结构连接节点的响应取决于榫卯类型、紧固件或连接器类型、加载方向、几何尺寸、材料属性、试验设置和破坏模式等多种因素。因此,连接节点最好通过一种结构化记录来描述,该记录需捕捉与力学、装配和制造相关的定性与定量特征。
尽管已有大量实验文献存在,但证据分散于期刊论文、会议论文、技术报告、补充数据文件、电子表格、CSV文件、本地档案、静态PDF文件以及个人或本地数据仓库中。不同研究中,相似的连接类型可能被赋予不同标签;响应量可能采用不同方法报告或推导;破坏模式可能使用不一致的术语描述;相关的材料、几何或试验信息可能不完整。这些差异阻碍了跨研究比较,常常迫使研究人员在比较连接家族、标定数值模型或识别实验证据缺口之前,必须先重建数据集。
现有的数字资源虽覆盖了重型木结构信息版图的不同部分,但各有局限。FPInnovations木材结构设计、建模与分析数据库侧重于提供设计和建模输入,而非支持持续的实验策展和跨研究比较。加拿大自然资源部维护的加拿大重型木结构现状平台以建筑项目和制造设施为观察单位,不包含实验连接配置、加载条件、力学响应指标或破坏观察,因此无法支持连接性能比较。基于此,仍需要一种以同行评审出版物中的木结构连接行为实验证据为核心的可维护、多用户数字资源。Timverse正是为填补这一空白而开发的。

二、研究内容与平台架构

研究人员开发了Timverse,一个基于网络的木结构连接实验研究数据管理平台,公开部署于https://timverse.ca。v2.4.0版本包含522条已批准实验数据记录,源自Heidari等人编制的数据集,代表2048个独立试验试件。每条实验数据记录对应一次物理连接试验,捕获几何、材料、力学、制造和装配描述符。该平台并非用于替代工程设计、实验室测试或结构分析,不执行规范校核、基于物理的模拟或自动设计优化,其科学范围仅限于木结构连接试验数据。
访问已批准数据集无需账户。注册向公众开放,但提交新记录或提议修改需经过验证的账户。所有贡献均以待审核提交形式存储,经管理员审查后方可加入已批准数据集。
Timverse采用三层网络架构:前端负责用户交互、表单状态、可视化和展示,基于React、TypeScript和Vite构建,使用Tailwind CSS和shadcn/ui;后端负责验证、授权、工作流执行和持久化,使用Python FastAPI实现;数据库提供持久化结构化存储,使用SQLModel进行数据库交互、Pydantic进行验证、PostgreSQL进行关系存储。部署采用Docker容器配合Docker Compose协调,PostgreSQL存储数据,后端提供API,前端构建为静态文件由nginx服务,Traefik将公共流量路由至前后端服务。PostgreSQL数据库存储在服务器卷上并自动备份,每日备份保留七天,每次部署前创建单独备份并保留最近五次。发布和部署通过GitHub Actions自动化。
数据模型的核心实体是已批准的连接组记录,界面中称为试件记录。每条记录代表一种实验连接配置,可聚合多个重复试验试件。记录包含出版物DOI、重复试验信息、销钉和连接器指示符、装配类型、实践分类、连接描述、构件尺寸、紧固件数量、含水率、木材类型、材料和力学性能描述、加载信息、屈服点确定方法、刚度(滑移模量)、屈服状态强度及其对应变形、最大强度及对应变形、极限力及对应变形、延性和定性破坏描述。DOI记录、榫卯分类、子榫卯分类、加载方向、紧固件类型和破坏模式构成试件的周边词汇表。数据库模型通过共享分类避免重复自由文本输入,关系结构使数据比平面电子表格更易于搜索和比较。
架构的关键在于分离公共数据访问、经认证的贡献和管理员审查。访问已批准数据集无需认证,注册后平台发送验证链接至邮箱,验证后账户激活。已验证用户可贡献数据,审查和其他管理操作通过基于角色的授权限制。新记录和提议修正以待审核提交形式存储,管理员审查后可批准或拒绝。若批准,数据纳入已批准试件数据库;若拒绝,决定被记录而不改变已批准记录。数据验证在提交进入已批准数据集前进行,前端帮助用户完成表单并捕获常见输入错误,后端独立执行关键验证规则,包括榫卯与子榫卯选择的一致性、销钉相关字段、连接器相关字段和破坏模式选择的一致性。

三、关键技术方法

研究人员构建Timverse平台采用了以下主要技术方法:前端使用React/TypeScript框架配合Vite构建工具,结合Tailwind CSS和shadcn/ui组件库实现用户界面;后端采用Python FastAPI框架提供Web API,使用SQLModel进行数据库对象关系映射,Pydantic负责数据验证;数据库选用PostgreSQL关系型数据库,通过Alembic迁移管理数据库模式变更;部署采用Docker容器化配合Docker Compose编排,nginx服务前端静态文件,Traefik负责流量路由;持续集成与部署通过GitHub Actions自动化实现。初始数据来源于Heidari等人编制的已发表研究数据集。

四、研究结果

4.1 试件提交

贡献者从导航菜单中选择添加试件,提交界面将所需信息组织为逻辑分区,包括出版物信息、试件标识符、榫卯分类、紧固件详情、加载条件、材料属性、几何描述符、力学响应量和定性破坏观察。前端执行初步验证确保必填字段完成并捕获常见输入错误,后端在提交后执行额外验证以核实相关字段间的关系并确保与数据库存储的受控词汇表一致。提交信息保存为待审核试件记录,防止未审核数据出现在公共数据集中。

4.2 审查工作流

提交后,待审核试件进入管理审查队列。管理员检查拟议记录,将提交值与现有参考数据比较,判断是否符合质量和完整性标准。如需修订,管理员可拒绝提交并提供审查意见说明必要修正。由于提交保持待审核状态,贡献者可修改并重新提交而不影响已批准数据库。当提交满足审查要求时,管理员批准待审核试件,后端将提交提升至已批准试件集合,可通过平台的搜索、过滤、可视化、比较和导出功能使用。

4.3 提交历史与可追溯性

管理审查后,Timverse保留每条贡献试件关联的提交历史。批准后不删除待审核提交,而是将其保留为策展记录的一部分。已批准试件与原始提交记录保持关联,提供数据集随时间演变的透明历史。贡献者可查看先前提交的状态,管理员保留批准决定和审查意见的记录。若提交被拒绝,贡献者可更新待审核记录并重新提交。维持提交历史为策展实验数据提供轻量审计追踪,允许未来用户区分已批准记录与提交修订,在支持持续完善的同时保持策展数据的稳定性。

五、讨论与结论

Timverse的影响力最强之处在于重型木结构连接的实验定量与定性观察被整合并转化为建模假设、设计参数或未来试验证据的节点。在木结构连接研究中,这一转化往往难以验证,因为每个重用值都隐含着关于试件可比性、试验配置、破坏机制和报告惯例的选择。Timverse通过将连接试验转化为可审查的试件级证据,使这些选择变得明确。
这种组织方式使更广泛的跨研究问题得以探究。研究人员可从询问单一连接是否表现良好,转向询问某一连接家族存在多少证据、跨研究报告的刚度和强度值是否可比、哪些破坏模式主导现有证据、文献在哪些方面过于薄弱而无法支持可靠的建模假设。这些问题对全球性能依赖连接行为的重型木结构体系至关重要,但难以仅从孤立的出版物回答。Timverse帮助研究人员识别哪些连接类型已被广泛研究、哪些仍代表性不足。
Timverse还通过减少证据收集阶段的不确定性来改进现有研究问题。模型标定、文献综合和试验规划都依赖于底层数据集的质量。通过提供跨榫卯和紧固件类型的刚度、强度、延性和破坏模式的已审查可扩展证据库,平台减少了重复的手动数据重建工作,使所选参数的来源更易于辩护,并支持为结构模拟透明选择代表性连接属性,包括简化的非线性连接模型。
该平台以开放获取网络服务形式部署,使用Google Analytics监控使用情况。目前未产生商业产品或衍生公司,其当前影响以研究为中心,未来对需要可追溯重型木结构连接行为证据的实验室、设计事务所、制造商和规范制定团体具有潜在价值。
研究结论指出,Timverse通过将每条试件表示为结构化记录,使实验证据更易于维护、验证、比较和复用。平台结合React和TypeScript前端、FastAPI后端和PostgreSQL关系数据库,其工作流支持试件提交、审核审查、已批准数据管理、搜索、可视化、比较和导出。Timverse通过改善用于文献综合、连接比较、模型参数选择和试验规划的证据库,为重型木结构研究做出贡献。其当前角色以研究为导向,未来发展方向包括扩大数据库覆盖范围、报告使用指标、改进分析工具,以及加强试件级证据与系统级建模工作流之间的联系。
相关新闻
生物通微信公众号
微信
新浪微博
  • 搜索
  • 国际
  • 国内
  • 人物
  • 产业
  • 热点
  • 科普

热点排行

    今日动态 | 人才市场 | 新技术专栏 | 中国科学人 | 云展台 | BioHot | 云讲堂直播 | 会展中心 | 特价专栏 | 技术快讯 | 免费试用

    版权所有 生物通

    Copyright© eBiotrade.com, All Rights Reserved

    联系信箱:

    粤ICP备09063491号