TDEFNODE 安装与入门：从源码编译到成功跑通案例（超详细避坑指南）

TDEFNODE 安装与入门从源码编译到成功跑通案例超详细避坑指南一、前言TDEFNODE 是一个用于地壳形变建模的经典科研程序常用于 GNSS 速度场反演、块体运动分析以及断层滑动研究。但与常见软件不同TDEFNODE 不是图形界面软件也不是双击安装的软件。它必须在 Linux / Ubuntu 环境中通过源码编译运行。很多初学者在安装阶段就会卡住比如make: command not foundgfortran未安装relocation truncated to fit报错不会运行案例不知道结果在哪本文提供一套从 0 到跑通案例的完整流程。二、环境说明适用环境UbuntuWindows WSL在 WSL 中Ctrl Alt T通常打不开终端。建议使用以下方式打开 Ubuntu开始菜单 → UbuntuWindows TerminalWin R→ 输入wsl三、软件下载与参考网址1. TDEFNODE官网https://robmccaffrey.github.io/TDEFNODE/手册https://robmccaffrey.github.io/TDEFNODE/manual/tdefnode_manual.html2. GNSS 数据参考https://yangleir.github.io/2021/04/04/GNSS-V/3. GMT绘图工具https://www.generic-mapping-tools.org/四、核心流程TDEFNODE 不是普通意义上的“安装软件”它的实际流程是源码 → 解压 → 安装环境 → 修改 Makefile → 编译 → 跑案例 → 看结果也就是说你真正要完成的是准备源码包配置 Ubuntu 环境安装编译器和工具链修改配置文件编译生成可执行文件用输入文件运行案例五、源码放置位置错误做法是把源码放到根目录/。正确做法是放到当前用户主目录~。例如源码压缩包推荐放在~/TDEFNODE.tar.gz可以先检查cd ~ ls如果能看到TDEFNODE.tar.gz说明位置没问题。六、解压源码执行mkdir ~/TDEFNODE tar -xzvf TDEFNODE.tar.gz -C ~/TDEFNODE然后进入目录查看cd ~/TDEFNODE ls正常情况下应该能看到类似文件Makefile tdefnode.f tdefavail.c tdefcom1.h tdefcom2.h tdefcom3.h README如果这些核心文件都在说明源码解压正常。七、安装编译环境很多人会直接执行make然后报错Command make not found这通常说明 Ubuntu 环境里还没有安装编译工具。因此先安装环境sudo apt update sudo apt install make gfortran安装完成后用下面命令检查make --version gfortran --version只要都能正常显示版本号说明环境已经准备好。八、一个关键认知make和gfortran并不是安装在~/TDEFNODE目录里的它们是系统工具通常位于/usr/bin/可以验证which make which gfortran所以你要区分两件事~/TDEFNODE是源码目录make和gfortran是系统工具九、检查头文件先检查ls tdefcom1*可能出现两种情况。情况 1存在tdefcom1.h.tmp执行mv tdefcom1.h.tmp tdefcom1.h情况 2已经存在tdefcom1.h那就不用改名直接继续。十、第一次编译进入源码目录后执行cd ~/TDEFNODE make编译完成后检查ls -l tdefnode如果出现可执行文件tdefnode说明编译成功。十一、常见报错relocation truncated to fit这是安装过程中最典型的一个报错之一。原因通常是因为程序中静态数组太大默认内存模型不够链接阶段失败也就是说不是源码坏了而是默认编译参数不适合当前程序。十二、修改 Makefile关键步骤打开Makefilenano Makefile将前面的关键几行改成如下形式FC gfortran FFLAGS -gdwarf-2 -w -mcmodellarge CC gcc LD gfortran CFLAGS -mcmodellarge LDFLAGS -mcmodellarge这里的重点是FFLAGS要改CFLAGS要改LDFLAGS也要改不能只改其中一个。修改完成后保存退出Ctrl O回车Ctrl X十三、重新编译重新编译前先删除旧文件rm -f *.o tdefnode make如果编译输出中已经出现-mcmodellarge说明新的配置已经生效。十四、目录结构建议推荐把程序目录和案例目录分开~/TDEFNODE ~/tdefnode_test其中~/TDEFNODE源码和编译后的程序~/tdefnode_test案例文件这样做的好处是路径清晰不容易混乱。十五、运行案例假设你已经具备~/TDEFNODE/tdefnode~/tdefnode_test/cr_test.tdfn那么运行方式是cd ~/tdefnode_test ../TDEFNODE/tdefnode cr_test.tdfn这句命令的逻辑是当前目录在案例目录调用上一级中的程序输入当前目录中的控制文件十六、成功标志如果案例运行成功终端输出末尾通常会出现DONE - NORMAL FINISH只要看到这句就基本说明程序已经正常跑通。十七、输出文件说明常见输出文件包括crc0.out crc0_vphi.pdf costa_rica.svs一般可以这样理解crc0.out主结果文件crc0_vphi.pdf结果图costa_rica.svs绘图脚本十八、查看结果1. 查看图件直接查看crc0_vphi.pdf2. 查看文本结果less crc0.out3. 如果要用 GMT 重新绘图先安装 GMTsudo apt install gmt然后运行gmt costa_rica.svs十九、结果图怎么读通常可以先这样理解元素含义红色箭头观测值黑色箭头模型预测椭圆误差彩色区域锁固或耦合程度比例尺速度尺度mm/yr最简单的判断标准是红色箭头和黑色箭头越一致说明模型拟合越好。二十、常见坑总结安装和运行过程中最容易踩的坑包括把 TDEFNODE 当成 GUI 软件把源码放到根目录/没装make没装gfortran只改了FFLAGS没改LDFLAGSLinux 路径大小写混乱没有输入文件就直接运行程序二十一、最短流程建议收藏如果你只想看最短步骤可以直接按下面做1. 解压源码mkdir ~/TDEFNODE tar -xzvf TDEFNODE.tar.gz -C ~/TDEFNODE2. 安装环境sudo apt update sudo apt install make gfortran3. 修改 Makefilenano ~/TDEFNODE/Makefile把关键参数改成FFLAGS -gdwarf-2 -w -mcmodellarge CFLAGS -mcmodellarge LDFLAGS -mcmodellarge4. 编译cd ~/TDEFNODE make5. 运行案例cd ~/tdefnode_test ../TDEFNODE/tdefnode xxx.tdfn二十二、总结TDEFNODE 最大的难点不在模型本身而在第一次环境搭建。一旦你完成了以下几件事编译成功跑通案例能查看结果能理解基本输出后续使用就会顺畅很多。所以最稳妥的策略永远是先把一个案例完整跑通再进入下一步。二十三、参考链接TDEFNODE 官网https://robmccaffrey.github.io/TDEFNODE/TDEFNODE 手册https://robmccaffrey.github.io/TDEFNODE/manual/tdefnode_manual.htmlGMT 官网https://www.generic-mapping-tools.org/GNSS 数据参考https://yangleir.github.io/2021/04/04/GNSS-V/