快速安装

2021/10/29

# 依赖环境

系统环境

  操作系统:64 位 (amd64) WindowsLinux及以上

  内存:8 GB 及以上

注意:gma 目前不支持 MacOS 和其他平台。

Python 环境

  Windows: 3.8 ~ 3.11

  Linux: 3.9~3.11

  建议安装 Anaconda 创建 Python 环境。 Anaconda 是一个开源的 Python 发行版本,其包含了 180 多个科学包及其依赖项。

# 依赖库

  gma 的构建依赖 gdal 3.4.1 +,numpy 1.23.3 +,pandas 1.4.2 + 和 scipy1.7.3 + 等库,这些库是 gma 实现功能的基础。 gdal 需要手动编译或下载编译后相应版本的 whl 包手动安装。

  打开 Windows 终端(或CMD、PowerShell、conda 等且已配置系统变量),使用以下命令安装 gdal (默认 Python 环境):

pip install "X:\GDAL-3.4.1-cp39-cp39-win_amd64.whl"
1

   或使用 conda 安装:

conda install gdal
1

# 安装

  gma 已经发布至 pypi (opens new window),可以在终端输入以下命令安装:

pip install gma
1

  在安装 gma 时,依赖的 numpy,pandas 和 scipy 等库如果不存在则会自动安装(需联网)。

# 引用

  打开 Python 的 IDE(数据处理推荐 Spyder,工程开发推荐 Pycharm,分步测试推荐 Jupter Notebook)直接导入库。

import gma
1

   下一步,请试试 gma 的函数吧。

# 错误解决

  从 1.0.5 版本开始,gma 会对引用过程中出现的错误进行追踪标记。引用过程中出现的错误可参考下表解决(其中 XXX / YYY 为发生错误的包 / 模块):

错误类型 错误内容 解决方法
ModuleNotFoundError Missing GDAL library! See https://gdal.org/api/python_bindings.html 安装 gdal
ModuleNotFoundError The XXX library is missing, please install it with 'pip install XXX' in the terminal! 在终端输入 pip install XXX 安装
ImportError Currently installed GDAL is not supported, please update GDAL! 升级 gdal
ImportError The GDAL version is too low, the current version {gdalversion}, the minimum version is 3.4.1, please update GDAL! 升级 gdal