Skip to content

Commit

Permalink
Update the building instructions on Windows (#1200)
Browse files Browse the repository at this point in the history
  • Loading branch information
seisman authored Sep 13, 2023
1 parent 11f2df1 commit 4b7ab4b
Showing 1 changed file with 23 additions and 18 deletions.
41 changes: 23 additions & 18 deletions source/install/build-source-windows.rst
Original file line number Diff line number Diff line change
@@ -1,8 +1,13 @@
Windows 下编译 GMT 源码
=======================

这一节介绍如何在 Windows 系统(Windows 10、Windows 8.1 或 Windows 7)下
编译 GMT 源码。
:撰写: |田冬冬|
:审核: |刘珠妹|
:最近更新日期: 2023-09-13

----

这一节介绍如何在 Windows 系统下编译 GMT 源码,仅供需要自行编译 GMT 源码的读者参考。

安装编译工具
------------
Expand All @@ -12,22 +17,22 @@ Windows 下编译 GMT 源码
- `Visual Studio <https://visualstudio.microsoft.com/zh-hans/>`__ \(安装时需要勾选 Desktop development with C++ 相关工具)
- `Git <https://git-scm.com/downloads>`__
- `CMake <https://cmake.org/download/>`__
- `Ghostscript <https://www.ghostscript.com/>`__\ :生成 PDF、JPG 等格式的图片 [**必须**]
- `GraphicsMagick <http://www.graphicsmagick.org>`__\ :生成 GIF 格式的动画 [**可选**]
- `FFmpeg <http://www.ffmpeg.org/>`__\ :生成 MP4 格式的动画 [**可选**]
- `Ghostscript <https://www.ghostscript.com/>`__:生成 PDF、JPG 等格式的图片 [**必须**]
- `GraphicsMagick <http://www.graphicsmagick.org>`__\:生成 GIF 格式的动画 [**可选**]
- `FFmpeg <http://www.ffmpeg.org/>`__:生成 MP4 格式的动画 [**可选**]

安装 vcpkg 及依赖软件
---------------------

GMT 的编译及运行依赖于其他库文件,包括:

- `netCDF <https://www.unidata.ucar.edu/software/netcdf/>`__\ (>=4.0 且支持 netCDF-4/HDF5)[**必须**]
- `curl <https://curl.haxx.se/>`__\ :下载网络数据 [**必须**]
- `GDAL <https://www.gdal.org/>`__\ :读写多种格式的地理空间数据 [**推荐**]
- `PCRE <https://www.pcre.org/>`__\ :正则表达式支持 [**可选**]
- `FFTW <http://www.fftw.org/>`__\ :快速傅里叶变换库(>=3.3)[**可选**]
- LAPACK:快速矩阵反演库(macOS 下不需要)[**可选**]
- BLAS:快速矩阵运算库(macOS 下不需要)[**可选**]
- `netCDF <https://www.unidata.ucar.edu/software/netcdf/>`__(>=4.0 且支持 netCDF-4/HDF5)[**必须**]
- `curl <https://curl.haxx.se/>`__:下载网络数据 [**必须**]
- `GDAL <https://www.gdal.org/>`__:读写多种格式的地理空间数据 [**推荐**]
- `PCRE <https://www.pcre.org/>`__:正则表达式支持 [**可选**]
- `FFTW <http://www.fftw.org/>`__:快速傅里叶变换库(>=3.3)[**可选**]
- LAPACK:快速矩阵反演库 [**可选**]
- BLAS:快速矩阵运算库 [**可选**]

Windows 下可以通过 C++ 库管理器 `vcpkg <https://vcpkg.io>`__ 安装这些依赖软件。

Expand All @@ -42,11 +47,11 @@ Windows 下可以通过 C++ 库管理器 `vcpkg <https://vcpkg.io>`__ 安装这
.. note::

以下假定使用的是 64 位 Windows 系统。对于 32 位 Windows 系统,需要将
``x64-windows`` 改成 ``x86-windows``\
``x64-windows`` 改成 ``x86-windows``。

先打开一个 CMD 窗口,执行如下命令::

$ vcpkg install netcdf-c gdal pcre fftw3[core,threads] clapack openblas --triplet x64-windows
$ vcpkg install netcdf-c gdal[core,tools,default-features] pcre2 fftw3[core,threads] clapack openblas --triplet x64-windows
$ vcpkg integrate install

.. note::
Expand All @@ -71,7 +76,7 @@ Windows 下可以通过 C++ 库管理器 `vcpkg <https://vcpkg.io>`__ 安装这

$ git clone --depth 50 https://github.com/GenericMappingTools/gmt

其余操作与编译 GMT 正式版没有区别
其余操作与编译 GMT 正式版基本没有区别

安装 GMT
--------
Expand All @@ -90,7 +95,7 @@ Windows 下可以通过 C++ 库管理器 `vcpkg <https://vcpkg.io>`__ 安装这
# 切换到 gmt 源码目录下
$ cd gmt-6.4.0

打开 :file:`cmake` 目录,在其中创建文件 :file:`cmake/ConfigUser.cmake`\
打开 :file:`cmake` 目录,在其中创建文件 :file:`cmake/ConfigUser.cmake`,
并向文件中加入如下语句::

set (CMAKE_INSTALL_PREFIX "C:/programs/gmt6")
Expand All @@ -113,7 +118,7 @@ Windows 下可以通过 C++ 库管理器 `vcpkg <https://vcpkg.io>`__ 安装这

以下的 ``mkdir build`` 命令新建的 :file:`build` 文件夹位于 GMT 源码压缩包
解压出来的 :file:`gmt-6.4.0` 目录下。
不是 :file:`gmt-6.4.0/cmake` 目录下,更不是 :file:`/opt/GMT-6.4.0`\
不是 :file:`gmt-6.4.0/cmake` 目录下,更不是 :file:`/opt/GMT-6.4.0`。

::

Expand All @@ -128,7 +133,7 @@ Windows 下可以通过 C++ 库管理器 `vcpkg <https://vcpkg.io>`__ 安装这
在最后汇总输出检查结果。我们只需要关注检查结果是否正确即可。
正常情况下结果结果如下,若存在一些差异也没有问题。只要过程中不出现报错,即可。
如果出现报错,则需要检查之前的步骤是否有误,检查完成后删除原 build 目录再新建 build,
继续执行 ``cmake ..``\ ,直到出现类似的检查结果::
继续执行 ``cmake ..``,直到出现类似的检查结果::

*
* GMT Version: : 6.4.0
Expand Down

0 comments on commit 4b7ab4b

Please sign in to comment.