GeoPyTool can be used as a module inside Python, and can also run as a standalone application.
Packed up executable files are temporarily only provided for Windows and MacOS platform.
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.
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.
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.
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 an
api-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.
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
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.
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.
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:
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
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.
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