安装指南

安装 GeoPyTool

GeoPyTool 有两种使用方法,可以作为独立的程序运行,也可以作为 Python 下的一个模块(module)来在 Python 解释器下调用。

作为独立程序使用 GeoPyTool

打包好的可执行文件,目前支持 Windows 和 macOS 两种平台。

点击这里查看程序文件的下载链接。

Mac 下的 APP

macOS 下面特别省心,因为开发者本身就用的这个系统。直接下载对应的压缩包,解压缩之后,双击 GeoPyTool.app 这个文件,就可以看到下面的图形界面了。

User Interface of the APP on macOS.

Mac APP 更新升级方法

进入到 GeoPyTool.app 文件内部,位置为 GeoPyTool.app/Contents/Resources/UpDateGeoPytool。双击这个个名为 UpDateGeoPytool的文件,就会更新到最新版本了。

Update the APP on macOS.

Windows 系统下的打包文件

Windows 8/8.1/10 用户

这几个比较新的 Windows 系统的用户也很省心,也是下载之后解压缩,然后在文件夹里面双击 Rungeopytool.bat 就可以了。记住一定不要删除解压出来的文件夹里面的任何文件,那都是程序用得上的,一旦删除了就可能导致程序无法运行了。

User Interface of the EXE on Windows.

Windows 7 用户

刚才上面那张图实际上是在 Windows7 系统上面运行 GeoPyTool 的截图。不过 Windows7 系统用户需要先安装几个补丁,才能运行 geopytool。

首先是一定要安装 Windows 7 SP1 这个补丁,然后要安装 KB2999226 和 Visual C++ Redistributable 2015。如果不按照 SP1 以及其他两个补丁,运行 GeoPyTool.exe 的时候就会出现错误提示,说什么api-ms-win-crt 无法定位之类的。总之遇到这样的情况时,先检查系统是不是安装了 SP1,然后将其他两个补丁安装试一试。

针对 Windows 7 的 SP1 补丁自然是可以在微软的官网这个地址里面找到的

其他两个安装包,包括 KB2999226 和Visual C++ Redistributable 2015 已经包含在 GeoPyTool 的压缩包里面了,也可以在下面这两个地址里面下载:32 bit Windows7 64 bit WInodws7 .

再次重复一遍,如果你遇到不能运行的情况,并且看到了 api-ms-win-crt 这样的字样,先检查上面的补丁是否安装了。

Windows XP 和 Vista 用户

我自己试了好几次都没弄成,我也懒得在这些老古董系统上面浪费时间精力。人生宝贵,所以建议你把电脑升级成 Windows7 SP1 以上的更新的操作系统,如果配置实在太差也可以用 Linux 操作系统。反正如果你非要纠结在 XP 这类连微软自己都抛弃的系统上,那就祝你好运以及再见!

Windows EXE 更新方法

双击解压目录下的 Update.bat 这个文件,就可以更新到最新版了。这个命令是调用 GeoPyTool 这个目录里面的 pip 来更新该目录下的 GeoPyTool 模块。千万别乱动这个文件同一目录下的任何其他内容,除非你很有信心能搞定哈,那样随你咯。

Update the EXE on Windows.

注意!如果你下载了打包的文件了,只要运行对应的脚本或者双击 APP 文件就可以了,下面的内容和你无关,无关!!!!!别再折腾去安装下面的内容了,弄不明白还浪费时间!!!!!!!注意阅读上文就可以了!!!!!

将 GeoPyTool 作为 Python 模块来使用

其他的所有操作系统,比如 Debian Linux, Ubuntu Linux, Fedora Linux, FreeBSD 甚至 GNU/Hurd,都可以将 GeoPyTool 作为一个 Python 模块来在 Python 解释器里面运行。实际上对于 macOS 和 Windows 用户,也建议这样使用,因为这样能够最快速更新到最新版本,下载安装都更加迅速。当然,操作起来稍微复杂点,反正不适合缺乏挑战精神和探索学习能力的人。

首先要安装 Python

你需要先安装 Python,geopytool 是用 Python3.5 写的,并且不兼容 Python2, 所以推荐你也用 3.5 或者更新的 Python。可以到 Python 官方网站 或者 清华 Tuna 去下载对应自己系统的安装包。

更推荐大家使用 Anaconda3-4.0.0 或者更新版本的 Anaconda3。因为在 Anaconda 中,包括 cython, numpy, pandas, matplotlib 等在内的很多必要的包都集成好了,安装时候省时间。

对于 Windows 用户的一些有用链接

实际上网上有很多很多指南,都给说明吧了要怎么安装 Python 以及激活 PIP。所以这里面就只放几个下载链接,自己探索吧哈,没探索精神搞个毛球学术对吧。

32bit:
项目 下载地址
Anaconda https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/Anaconda3-4.4.0-Windows-x86.exe
64bit:
项目 下载地址
Anaconda https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/Anaconda3-4.4.0-Windows-x86_64.exe

使用 PIP 安装 GeoPyTool

安装完了 Python 并且激活了 PIP 之后,你是不是想着马上就能安装 GeoPyTool 了?

然而并不行。你需要安装一些基础包,geopytool 就是基于这些包构建的。即便你用的是 Anaconda3,也还是需要安装一些包,比如 pyqt5,这是用来搭建 GeoPyTool 的 GUI 图形界面的模块。

所以要在终端里面输入一些命令来先安装这些基础包。

不知道终端是啥?好吧,这里我先不责怪你怎么不去百度或者谷歌自行搜索。

在 Windows 系统里面,现在的终端一般就是 CMD 或者 PowerShell。对于其他的操作系统,比如 macOS 或者各种 Linux 以及 BSD 操作系统,往往都是 Bash,在这些系统里面也往往能找到 终端 这个程序,一般就在开始菜单或者程序目录里面肯定有。

Windows 用户不知道怎么运行 CMD 或者 PowerShell?搜索去吧,不要做纯粹的伸手党,自己探索一下是有好处的。

注意

这里我用的命令都是 pip,这是假设你的 系统默认的 pip 就是 python3 的。而如果你同时安装了 Python2 和 Python3,那可能 pip 对应的未必是 Python3 的 pip 而是 Python2 的,这时候你可能就要把下面所有的 pip 替换成 pip3 来运行,应该就可以了。

接下来就把下面的命令逐条复制粘贴到终端里面来运行,安装依赖包吧。

pip install cython
pip install numpy
pip install pandas
pip install xlrd
pip install matplotlib
pip install BeautifulSoup4
pip install pyqt5
pip install scipy
pip install scikit-learn
pip install sympy
pip install requests
pip install pyopengl
pip install pyqtgraph

直接使用 pip 来安装 scikit-learn 可能会报错,需要安装 Microsoft Visual C++ Build Tools。所以还可以考虑用 conda 来安装 scipy 和 scikit-learn。这就需要先安装 conda:

pip install requests
pip install pyopengl
pip install pyqtgraph
pip install conda

然后我们用 conda 来安装其他的包:

python3 -m conda install cython numpy pandas scipy scikit-learn sympy

安装完成了上面这些依赖包之后,就可以输入下面的这个命令来安装 GeoPyTool 了。

pip install geopytool

如果没有发现什么出错信息,就是说明安装成功了。

更新已经安装的 GeoPyTool 模块

如果你之前安装了 geopytool,可以通过下面的命令来更新到最新版本。

pip install geopytool --update --no-cache-dir

在 Python 下启动 GeoPyTool

安装完了 geopytool,就可以在 Python 解释器里面启动了。不过这里要推荐一个替代原生解释器的 IPython,可以通过下面命令安装。

pip install ipython

安装好之后在终端中输入下面的命令启动 ipython。

ipython

然后在 ipython 或者原生 Python 解释器中输入下面两行命令,回车,就可以了。

import geopytool as gp
gp.main()

就能看到 GeoPyTool 的图形界面了。 例如下图就是在 Ubuntu 系统下的截图。

GeoPyTool in Ubuntu

每次运行 GeoPyTool 之前,更新一下是个好习惯。

pip install --upgrade geopytool

点型Marker/ 颜色Color/ 线型Style

GeoPyTool 可视化的部分使用 Matplotlib 来实现的,所以设置的这些项目也是相似的。

点型 Markers 的设置可以参考: http://matplotlib.org/api/markers_api.html

颜色 Colors 的设置可以参考: http://matplotlib.org/api/colors_api.html

下面的示意图来自nrougier:

需要更多帮助?

请访问我们的论坛 https://github.com/GeoPyTool/GeoPyTool/issues 来留言写清楚你使用的操作系统、安装方法、错误截图。我们会尽快给出反馈。

附录

锆石氧逸度计算的样例数据文件为 ZirconCe.xlsx

TAS/REE/微量元素、Pearce 图解和 Harker 图解的数据样例文件为 Data.xlsx

极射赤平投影和玫瑰花图的样例数据文件为 Structure.xlsx

捐助支持

如果你希望支持 GeoPyTool 的开发,可以扫描下面的二维码进行捐助。

Category: Doc
Category
Tagcloud
English 文档 中文 Doc Chinese