PRIMME 项目使用教程

1. 项目目录结构及介绍

PRIMME（PReconditioned Iterative MultiMethod Eigensolver）项目是一个用于求解对称/厄米矩阵特征值问题的预处理迭代多方法求解器。项目的目录结构如下：

• doc/：存放项目的文档。
• examples/：包含C、C++和F77语言的示例代码，部分示例使用了PETSc和MAGMA库。
• include/：包含项目所需的头文件。
• matlab/：MATLAB接口相关文件。
• python/：Python接口相关文件。
• R/：R语言接口相关文件。
• src/：源代码目录，包含C语言实现的核心功能。
• tests/：测试代码目录。
• Make_flags：编译器选项文件。
• README.rst：项目的README文件。
• README_for_developers.rst：针对开发者的README文件。
• COPYING.txt：项目许可证文件。
• makefile：项目的Makefile文件。

2. 项目的启动文件介绍

项目的启动文件主要是src/目录下的C语言源文件。以下是几个关键的启动文件：

• dprimme.c：包含求解特征值和特征向量的主要函数dprimme。
• dprimme_svds.c：包含求解奇异值和向量的主要函数dprimme_svds。

这些文件中定义了与PRIMME库交互的接口函数，用户可以根据自己的需求调用这些函数来执行相应的计算。

3. 项目的配置文件介绍

项目的配置文件主要是Make_flags和makefile。

• Make_flags：这个文件用于定义编译器选项，如编译器类型（例如gcc、clang或icc），编译器选项（例如-g或-O3），以及CUDA和MAGMA库的安装路径等。

• makefile：这是项目的Makefile文件，用于指导如何编译和链接项目。以下是makefile中的一些常用目标：

  • make lib：编译生成静态库libprimme.a。
  • make solib：编译生成共享库libprimme.so（或libprimme.dylib）。

用户可以通过修改Make_flags文件或直接在命令行中指定编译器选项来定制编译过程。

在配置好环境后，用户可以运行make命令来编译项目，并根据需要生成静态库或共享库。