Installation

Installation

GeoPyTool can be used as a module inside Python, and can also run as a standalone application.

Standalone Application

Packed up executable files are temporarily only provided for Windows and MacOS platform.

Click here to get Download links.

Mac APP

On macOS, everything is extremely easy to use GeoPyTool. Just download and unzip the file, then double click on the GeoPyTool.app file, you will find the APP available as the following picture shows.

User Interface of the APP on macOS.

Mac APP Update

Go to the location inside the app file, GeoPyTool.app/Contents/Resources/UpDateGeoPytool.Double click on this file neamed UpDateGeoPytool at GeoPyTool.app/Contents/Resources/. It will update the GeoPyTool inside your GeoPyTool.app file. Remember that never modify any files directly under the same folder unless you are an expert on dealing with Python.

Update the APP on macOS.

Windows Pack

Windows 8/8.1/10 Users

On these modern Windows platforms, everything is also extremely easy to use GeoPyTool. Just download and unzip the file, then double click on the Rungeopytool.bat file, and make sure that you don't delete any file form the unziped folder because they are all required by the program, then you will find the APP available as the following picture shows.

User Interface of the EXE on Windows.

Windows 7 Users

Of corse, you must find that the screen shot above is actrually from a Windows 7 virtual machine.

That's right, you can obviously use GeoPyTool on Windows 7, on which some system patches need to be installed. You need to install the SP1 of Windows and then install KB2999226 and the Visual C++ Redistributable 2015. If you are using Windows 7 without the SP1 package installed, there might comes anapi-ms-win-crtrelated error. So believe me my friend, just install these patched below, they won't harm you after all.

The SP1 package of Windows 7 can be found at here, the official website of MicroSoft.

The installation packages of KB2999226 and the Visual C++ Redistributable 2015 are already contained in the Zip file of GeoPyTool for Windows, and can also be found here: 32 bit Windows7 64 bit WInodws7 . I am really a sweet guy, isn't it? So if you encounter any api-ms-win-crtrelated errors, please check those installations first.

Windows XP or Vista Users

I failed many times on both XP and Vista, and I think there might not be a lot users of these two antique systems. If you are using one or both of them, please be good to yourself to update you old PC to at least Windows 7 SP1 or try Linux on your antique computers. My advice is that we should not waste our life on those systems that are not even supported by their developers and manufacturer. So, if you still want to run GeoPyTool on those two old systems, good luck and good bye.

Windows EXE Update

Double click on the Update.bat file to run update. It will update the GeoPyTool inside your GeoPyTool folder. Remember that never modify any files directly under the same folder unless you are an expert on dealing with Python.

Update the EXE on Windows.

Attention! If you already download the packed up APP, just egnore the parts below and READ CAREFULLY PLEASE!!!!!!

Use as a Python Module

Users of other Operating Systems, such as Debian Linux, Ubuntu Linux, Fedora Linux, FreeBSD or GNU/Hurd, please try to use GeoPyTool in Python, which is also recommended to all the users including those who use macOS or Windows 10, because the latest version of GeoPyTool can be installed with pip easilier and faster than using standalone executable files.

Install Python First

The first thing to do is to install Python, newer than 3.5, which can be download from Python Website or Tsinghua Tuna.

Anaconda3-4.0.0 and other newer versions of Anaconda3 are recommended. Because they already contain useful modules such as cython, numpy, pandas, matplotlib, and the powerful ipython.

Useful links for Windows users to install GeoPyTool with PIP:

In fact, you guys can easily find instructions on how to install Python and PIP on the Internet. So I will just cast some links for newbie using Python on Windows.

32bit:
Item Address
Anaconda https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/Anaconda3-4.4.0-Windows-x86.exe
64bit:
Item Address
Anaconda https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/Anaconda3-4.4.0-Windows-x86_64.exe

Install GeoPyTool with PIP

After installation of Python, you might think that finally you can install GeoPyTool.

NO! In fact you need to install some used packages first, even you are using Anaconda. Because some packages used to build the Graphic User Interface of GeoPyTool still need to be installed, and this is also a good chance for you to update all the modules to the latest version (OR not).

So use the following commands in your terminal to install these modules.

You don't know what a Terminal is? For Windows, it can be the mighty CMD or PowerShell. For other systems including macOS, it should be the BASH ore just labeled as Terminal in the built-in applications list. Still don't know how to launch a terminal? Google it dude, we can't do that hand by hand for you.

Notice

Here we use pip as we assume that your default version of Python is Python 3.X and the pip will refer to the PIP under Python3. If you installed both Python 2.X and Python 3.X, you might need to try to use **pip3** instead of **pip** in all the following commands to call the PIP of Python 3.

So paste the following commands in your terminal as their sequence to install these modules in order.

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

The installation of scikit-learn might require Microsoft Visual C++ Build Tools, another solution is to use conda to install scipy and scikit-learn.

We install conda with pip first:

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

Then we use conda to install some other packages:

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

After the installation of those packages above, you can use this similar command also in the terminal to install the GeoPyTool.

pip install geopytool

If there comes no error message, everything should have been done successfully.

Update an existing GeoPyTool

If you installed GeoPyTool as a module in Python, you can use this similar command also in the terminal to update to the latest version of GeoPyTool.

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

Launch GeoPyTool form a Python interpreter

After the installation step above, GeoPyTool now becomes available in Python interpreter. The IPython interpreter is recommended because it is much friendly than the buildin interpreter of Python. IPython can be also installed with pip:

pip install ipython

Then you can run ipython in terminal with the following command:

ipython

Then you can simply use GeoPyTool by type the following commands in your Python interpreter:

import geopytool as gp
gp.main()

You would see the GUI of GeoPyTool, which is under development for now. So it is a good idea to update GeoPyTool with pip everytime before you use it:

pip install --upgrade geopytool

Marker/Color/Style

All these details in GeoPyTool are the same as those in Matplotlib becasue that is what GeoPyTool used to visualize data.

Markers of Points can be reffered from here: http://matplotlib.org/api/markers_api.html

Colors can be reffered from here: http://matplotlib.org/api/colors_api.html

Here is a picture of Line Styles and Point Markers form nrougier:

Need Further Help?

Visit our BBS https://github.com/GeoPyTool/GeoPyTool/issues and write a post to describe your problems in detail. We will response as soon as we can.

Appendix

The New Zircon Ce function need Data template file named as ZirconCe.xlsx

The New TAS, REE and Trace Elements functions share a same Data template files: Data.xlsx

The New StereoNet Projection and the RoseMap function need Data template file named as Structure.xlsx

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