Geoist及相关软件的安装与环境配置

• 1. 下载安装python-3.7.8-amd64.exe，安装至D:\Programs\Python\Python37下,设置Path路径增加到环境变量中；
• 2. 安装完成后，在cmd中输入python，检查是否安装成功；
• 3. 卸载Pip20(如果有) python -m pip uninstall pip；切换到解压后文件夹，安装pip-19.2 python setup.py install，并添加环境变量，在path里添加D:\Programs\Python\Python37\Scripts\，输入pip检查安装是否成功
• 4. pip安装文件的时候使用: pip install -i参数+镜像地址
     pip install -i https://pypi.tuna.tsinghua.edu.cn/simple some-package
     不过，需要注意的是这种是临时配置。
     用下面命令可以保存配置：
     pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

额外内容
pip国内镜像
豆瓣 https://pypi.doubanio.com/simple/
阿里云 https://mirrors.aliyun.com/pypi/simple/
清华大学 https://pypi.tuna.tsinghua.edu.cn/simple/
清华大学 https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple/
中国科学技术大学 http://pypi.mirrors.ustc.edu.cn/simple/
华中科技大学 http://pypi.hustunique.com/
华中理工大学 http://pypi.hustunique.com/simple/
山东理工大学 http://pypi.sdutlinux.org/simple/

• 5. python环境下，在d:\programs\geoist\目录下编译geoist;
     pip install numpy
pip install cython
pip install . 注意，最后有个点号

额外内容
如果出现geoist安装出错，使用命令python setup.py install安装geoist
如果出现提示需要Microsoft Visual C++ 14.0，需自行下载安装。同时，安装gfortran

• 6. 安装vc++和gfortran(mingw-get-setup.exe)，如果已安装可忽略
• 7. 安装Anaconda3-2020.02-Windows-x86_64.exe（with python3.7，与上述python版本相同），选择只为“我这个用户安装”，不添加至环境变量。Anaconda Prompt中输入conda list，可以查看已经安装的包名和版本号。若结果可以正常显示，则说明安装成功。

额外内容
对Jupyter NB进行功能扩展
1）. 打开Anaconda Prompt
2）. 输入 pip install jupyter_contrib_nbextensions，然后按Enter键运行，安装jupyter_contrib_nbextensions模块
3）. 继续输入 jupyter contrib nbextension install --user， 然后按Enter键进行用户配置
4）. 启用 nbextensions jupyter nbextension enable codefolding/main
5）. 在Nbextensions内勾选Table of Contents(2)、Autopep8

• 8. 对conda的镜像配置
     conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
conda config --set show_channel_urls yes

额外内容
可以从国外的官方conda的下载地址安装包 conda-forge channel conda config --prepend channels conda-forge

• 9. 安装成功后，从D:\Programs\Python\Python37\Lib\site-packages中拷贝编译过的模块geoist和geoist-0+unknown-py3.7.egg-info 目录到D:\ProgramData\Anaconda3\Lib\site-packages中，确保在anaconda base环境可正常使用geoist;

额外内容
对于可能的兼容性问题，您可以在本地创建一个专用于GEOIST的虚拟环境 (这里假设虚拟环境名称为**geoist **当然您可以设置为任何您期望的名字):
conda create --name geoist python=3.6 pip numpy pandas xarray scipy numba h5py Cython matplotlib seaborn
激活创建好的Geoist的虚拟环境:
conda activate geoist
使用虚拟环境的好处是，安装GEOIST后不会影响您原系统的其它虚拟环境.

额外内容
另外，使用 pip 命令可以从远程直接下载安装:
pip install git+https://github.com/igp-gravity/geoist.git
如果网络速度较慢可以先下载项目代码到本地，再使用 pip:
git clone https://github.com/igp-gravity/geoist.git
cd geoist
pip install .

• 10. 在终端检查geoist，是否安装成功
      python
import geoist
print(geoist.USER_DATA_PATH)
print(geoist.TEMP_PATH)
print(geoist.DATA_PATH)
print(geoist.EXAMPLES_PATH)
• 11. 汉化spyder
      1）尽量升级Spyder到最新版本，在Anaconda环境下，使用conda update spyder，若不是最新版本，在控制台（cmd）会问你（y or n）升级，当然输入y回车
      2）下载汉化包Spyder_Simplified_Chinese-master，下载地址https://github.com/kingmo888/Spyder_Simplified_Chinese.git
      3）将其放置在某一路径下，解压，并切换到文件目录下，输入python main.py
      4）汉化方式选择2（自动寻找路径），python类别选择1（Anaconda），重启Spyder选择菜单栏中的Tools—Preferences—General—Advanced Settings—language-简体中文。
• 12. 另外可同时安装配置Pycharm，使用之前编译的geoist
      1）安装pycharm-community-2019.1.3.exe，安装至D:\Program Files\JetBrains\PyCharm Community Edition 2019.1.3
      2）设置pycharm python解释器为系统安装的Python3.7,确保可以调用步骤1-3安装编译的goist;
      具体步骤为：点击File –setting—project:test—project interpreter
• 13. GEOIST也支持Docker安装方式，直接可以运行 docker pull 拉取命令:
      docker pull registry.cn-beijing.aliyuncs.com/rular099/geoist:0.0.1
• 14. 使用PEP8规范编码
      PEP8是Python世界中非常流行的编码规范之一。好的代码编写习惯，可以增加代码的可读性。如果自己没有按照PEP8规范编码，也没关系，可以找个工具来完成。Autopep8就是一个这样的工具，它按照pep8规范来决定代码中的那部分需要被排版，Autopep8可以修复大部分pep8工具中报告的排版问题。
      安装方法如下：
      pip install autopep8
      运行方法（你的代码yourcode.py）：
      autopep8 --in-place --aggressive --aggressive yourcode.py

---

主要参考来源：
[1]. 常金龙写的Geoist安装说明https://www.jianshu.com/p/81717117dfde
[2]. 地学小哥的https://www.jianshu.com/u/428cb4e5c83f
[3]. GEOIST帮助文档https://cea2020.gitee.io/geoistdoc/install.html