### ROI_PAC安装指南
#### 一、简介
ROI_PAC是一个开源的干涉测量软件工具包,主要用于处理合成孔径雷达(SAR)数据。它能够进行差分干涉测量(DInSAR)分析,从而监测地表形变。本文档旨在提供一套详细的安装指南,帮助用户顺利完成该软件的安装过程。
#### 二、安装前准备
1. **硬件需求**:
- 内存:至少1GB或以上。官方文档建议至少512MB内存,但实际操作中,512MB可能无法满足需求。
- 硬盘空间:至少3GB以上的可用空间。虽然文档中提到3GB的空间,但实际上,更多的空间可以降低安装过程中的风险。
2. **所需文件**:
- `roi_pac_testdir.tar.gz`:用于软件测试的数据包。
- `ROI_PAC_3_0.tgz`:ROI_PAC的核心安装包。
- `mdx_NTR_35238_173_73.tar`:一个图像浏览软件mdx的安装包,非必要,但可以辅助数据查看。
3. **编译器检查**:
- 使用以下命令检查系统中是否已安装必要的编译器:
```
$ which ifort g95 f90 pgf95 f95 xlf gfortran cc gcc icc
```
- 常见支持的编译器包括:`f95`、`cc`、`gcc`、`gfortran`等。确保至少有一款C编译器和一款Fortran编译器可用。
#### 三、安装步骤
1. **准备阶段**
1. **解压缩安装包**:
- 使用以下命令解压`ROI_PAC_3_0.tgz`:
```
$ tar xvf ROI_PAC_3_0.tgz
```
- 将解压后的目录`ROI_PAC_3_0`移动至一个合适的路径,例如`~/Documents`。后续步骤中,将使用`ROOT`表示这一路径。
2. **进入安装目录**:
- 进入`ROI_PAC_3_0`目录:
```
$ cd ROOT/ROI_PAC_3_0
```
- 查看`AAREADME`文件,了解软件的概述信息。
3. **进入核心安装目录**:
- 进入`ROI_PAC`目录:
```
$ cd ROI_PAC
```
- 查看`AAREADME_BUILD_ROIPAC`文件,这是安装文档的主要部分。
4. **编译器检查**:
- 如前所述,确认系统中已安装至少一款C编译器和一款Fortran编译器。
2. **安装过程**
1. **文件标签更新**:
- 更新以下文件的时间标签:
```
$ touch aclocal.m4 Makefile.in configure
```
2. **安装FFTW库**:
- 执行安装脚本`install-fftw.sh`:
```
$ ./contrib/install-fftw.sh CC=cc
```
- 注意,官方提供的脚本默认安装FFTW的旧版本,可能与官网上的最新版本不一致。因此,需要修改脚本中的版本号以匹配最新版本。
3. **配置FFTW环境变量**:
- 设置环境变量指向FFTW的库文件和头文件目录:
```
$ export FFTW_LIB_DIR=ROOT/ROI_PAC_3_0/ROI_PAC/NetInst/fftw-071005-1457/lib
$ export FFTW_INC_DIR=ROOT/ROI_PAC_3_0/ROI_PAC/NetInst/fftw-071005-1457/include
```
- 确认上述路径中的文件存在,特别是`libfftw3f.a`和`fftw3.f`。
4. **正式安装**:
- 执行安装脚本:
```
$ ./contrib/multibuild.sh
```
- 此步骤将在`ROI_PAC`目录下创建一个类似`multibuild-xxxx`的新目录,用于存放安装后的文件。
3. **测试阶段**
1. **建立测试目录**:
- 创建并进入测试目录:
```
$ mkdir test-runs
$ cd test-runs
$ ulimit -s 65000
```
- 上述第三条命令用于预防MacOS系统的栈溢出问题。
2. **准备测试数据**:
- 复制并解压`roi_pac_testdir.tar.gz`文件:
```
$ cp roi_pac_testdir.tar.gz ./
$ gunzip roi_pac_testdir.tar.gz
```
- 解压后,`roi_pac_testdir.tar.gz`文件变为`roi_pac_testdir.tar`。
3. **执行测试脚本**:
- 运行测试脚本以验证安装是否成功:
```
$ ../contrib/test_roi_pac.sh
```
#### 四、总结
通过上述步骤,您应该已经完成了ROI_PAC的安装及初步测试。如果在安装过程中遇到任何问题,请参考官方文档或寻求社区支持。此外,考虑到软件版本更新和系统环境差异,建议定期检查ROI_PAC的最新文档以获得最准确的指导。
1