-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathinstallation.html
333 lines (291 loc) · 19.3 KB
/
installation.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
<!DOCTYPE html>
<html class="no-js" lang="zh">
<head>
<title>GeoPyTool</title>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0">
<link rel="stylesheet" id="responsive-style-css" href='/theme/css/style.css' type="text/css" media="all" />
<link rel="stylesheet" id="responsive-style-css" href='/theme/css/highlight.css' type="text/css" media="all" />
<link href="/feeds/all.atom.xml" type="application/atom+xml" rel="alternate" title="GeoPyTool Full Atom Feed" />
<link href="/feeds/doc.atom.xml" type="application/atom+xml" rel="alternate" title="GeoPyTool Categories Atom Feed" />
</head>
<body id="index" class="blog">
<div id="container" class="hfeed">
<header id="header" >
<div id="logo">
<h1><img src="/theme/image/default-logo.png" width="300" height="100" alt="ChinaGeology" />
GeoPyTool</h1>
</div> <!-- /#logo-->
<nav id="menu" class="main-nav"><ul class="menu">
<li class="active"><a href="http://geopytool.com">Homepage</a></li>
<li class="active"><a href="http://geopytool.com/about.html">About</a></li>
<li class="active"><a href="http://geopytool.com/archives.html">Archives</a></li>
<li class="active"><a href="https://zhuanlan.zhihu.com/python-kivy">ZhiHu</a></li>
<li class="active"><a href="https://github.com/GeoPyTool/GeoPyTool">Github</a></li>
</ul></nav><!-- /#menu -->
</header>
<section id="wrapper" class="clearfix">
<section id="content" class="grid col-620" >
<section class="breadcrumb-list">
<a href="">Blog</a> ›<a href="category/doc.html">Doc</a> ›Installation
</section>
<section id="post" class="post hentry">
<header>
<h2 class="post-title" >Installation</h2>
<div class="post-meta">
<span class="meta-prep">Post in</span>
<abbr class="date" title="2017-11-15T00:00:00+08:00">
<a href="/archive/2017/11/index.html">三 15 十一月 2017 </a>
</abbr>
<span class="meta-prep"> |Tags</span>
<a href="/tag/doc.html">Doc</a>
<a href="/tag/english.html">English</a>
<a href="/tag/chinese.html">Chinese</a>
<!-- TOBE COMMENTS -->
</div>
</header>
<div class="post-entry">
<h2>Installation</h2>
<p>GeoPyTool can be used as a module inside Python, and can also run as a standalone application.</p>
<h2>Standalone Application</h2>
<p>Packed up executable files are temporarily only provided for Windows and MacOS platform.</p>
<p><a href="https://github.com/GeoPyTool/GeoPyTool/blob/master/Download.md">Click here to get Download links.</a></p>
<h3>Mac APP</h3>
<p>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.</p>
<p><img alt="User Interface of the APP on macOS." src="https://raw.githubusercontent.com/GeoPyTool/GeoPyTool/master/img/MacOSScreenShot.png"></p>
<h3>Mac APP Update</h3>
<p>Go to the location inside the app file, <code>GeoPyTool.app/Contents/Resources/UpDateGeoPytool</code>.Double click on this file neamed UpDateGeoPytool at <code>GeoPyTool.app/Contents/Resources/</code>. 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.</p>
<p><img alt="Update the APP on macOS." src="https://raw.githubusercontent.com/GeoPyTool/GeoPyTool/master/img/OSXUpdate.png"></p>
<h3>Windows Pack</h3>
<h4>Windows 8/8.1/10 Users</h4>
<p>On these modern Windows platforms, everything is also extremely easy to use GeoPyTool. Just download and unzip the file, then double click on the <strong>Rungeopytool.bat</strong> 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.</p>
<p><img alt="" src="https://raw.githubusercontent.com/GeoPyTool/GeoPyTool/master/img/RunWin.jpg"></p>
<p><img alt="User Interface of the EXE on Windows." src="https://raw.githubusercontent.com/GeoPyTool/GeoPyTool/master/img/ScreenShot.png"></p>
<h4>Windows 7 Users</h4>
<p>Of corse, you must find that the screen shot above is actrually from a Windows 7 virtual machine.</p>
<p>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 <code>Visual C++ Redistributable 2015</code>. If you are using Windows 7 without the SP1 package installed, there might comes an<code>api-ms-win-crt</code>related error. So believe me my friend, just install these patched below, they won't harm you after all.</p>
<p>The SP1 package of Windows 7 can be found at <a href="https://support.microsoft.com/en-us/help/15090/windows-7-install-service-pack-1-sp1">here, the official website of MicroSoft</a>.</p>
<p>The installation packages of KB2999226 and the <code>Visual C++ Redistributable 2015</code> are already contained in the Zip file of GeoPyTool for Windows, and can also be found here: <a href="https://pan.baidu.com/s/1kVwSQ95">32 bit Windows7 </a>，<a href="https://pan.baidu.com/s/1qY34ocW">64 bit WInodws7 </a>.
I am really a sweet guy, isn't it?
So if you encounter any <code>api-ms-win-crt</code>related errors, please check those installations first.</p>
<h4>Windows XP or Vista Users</h4>
<p>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.</p>
<h3>Windows EXE Update</h3>
<p>Double click on the <strong>Update.bat</strong> 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.</p>
<p><img alt="Update the EXE on Windows." src="https://raw.githubusercontent.com/GeoPyTool/GeoPyTool/master/img/WinUpdate.png"></p>
<h1>Attention！ If you already download the packed up APP, just egnore the parts below and READ CAREFULLY PLEASE!!!!!!</h1>
<h2>Use as a Python Module</h2>
<p>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.</p>
<h3>Install Python First</h3>
<p>The first thing to do is to install Python, newer than 3.5, which can be download from <a href="https://www.python.org/downloads/">Python Website</a> or <a href="https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/">Tsinghua Tuna</a>.</p>
<p>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.</p>
<h5>Useful links for Windows users to install GeoPyTool with PIP:</h5>
<p>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.</p>
<h6>32bit：</h6>
<table>
<thead>
<tr>
<th>Item</th>
<th>Address</th>
</tr>
</thead>
<tbody>
<tr>
<td>Anaconda</td>
<td>https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/Anaconda3-4.4.0-Windows-x86.exe</td>
</tr>
</tbody>
</table>
<h6>64bit：</h6>
<table>
<thead>
<tr>
<th>Item</th>
<th>Address</th>
</tr>
</thead>
<tbody>
<tr>
<td>Anaconda</td>
<td>https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/Anaconda3-4.4.0-Windows-x86_64.exe</td>
</tr>
</tbody>
</table>
<h3>Install GeoPyTool with PIP</h3>
<p>After installation of Python, you might think that finally you can install GeoPyTool.</p>
<p><strong>NO!</strong> 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).</p>
<p>So use the following commands in your <strong>terminal</strong> to install these modules.</p>
<p>You don't know what a Terminal is? For Windows, it can be the mighty <strong>CMD</strong> or PowerShell. For other systems including macOS, it should be the <strong>BASH</strong> ore just labeled as <strong>Terminal</strong> 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.</p>
<h4>Notice</h4>
<div class="highlight"><pre><span></span>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.
</pre></div>
<p>So paste the following commands in your <strong>terminal</strong> as their sequence to install these modules in order.</p>
<div class="highlight"><pre><span></span>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
</pre></div>
<p>The installation of scikit-learn might require <a href="http://landinghub.visualstudio.com/visual-cpp-build-tools">Microsoft Visual C++ Build Tools</a>, another solution is to use conda to install scipy and scikit-learn.</p>
<p>We install conda with pip first:</p>
<div class="highlight"><pre><span></span>pip install requests
pip install pyopengl
pip install pyqtgraph
pip install conda
</pre></div>
<p>Then we use conda to install some other packages:</p>
<div class="highlight"><pre><span></span>python3 -m conda install cython numpy pandas scipy scikit-learn sympy
</pre></div>
<p>After the installation of those packages above, you can use this similar command also in the <strong>terminal</strong> to install the GeoPyTool.</p>
<div class="highlight"><pre><span></span>pip install geopytool
</pre></div>
<p>If there comes no error message, everything should have been done successfully.</p>
<h3>Update an existing GeoPyTool</h3>
<p>If you installed GeoPyTool as a module in Python, you can use this similar command also in the <strong>terminal</strong> to update to the latest version of GeoPyTool.</p>
<div class="highlight"><pre><span></span>pip install geopytool --update --no-cache-dir
</pre></div>
<h3>Launch GeoPyTool form a Python interpreter</h3>
<p>After the installation step above, GeoPyTool now becomes available in Python interpreter. The <strong>IPython</strong> interpreter is recommended because it is much friendly than the buildin interpreter of Python. <strong>IPython</strong> can be also installed with pip:</p>
<div class="highlight"><pre><span></span>pip install ipython
</pre></div>
<p>Then you can run ipython in <strong>terminal</strong> with the following command:</p>
<div class="highlight"><pre><span></span>ipython
</pre></div>
<p>Then you can simply use <strong>GeoPyTool</strong> by type the following commands in your Python interpreter:</p>
<div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">geopytool</span> <span class="kn">as</span> <span class="nn">gp</span>
<span class="n">gp</span><span class="o">.</span><span class="n">main</span><span class="p">()</span>
</pre></div>
<p>You would see the GUI of <strong>GeoPyTool</strong>, which is under development for now. So it is a good idea to update <strong>GeoPyTool</strong> with pip everytime before you use it:</p>
<div class="highlight"><pre><span></span>pip install --upgrade geopytool
</pre></div>
<h2>Marker/Color/Style</h2>
<p>All these details in GeoPyTool are the same as those in Matplotlib becasue that is what GeoPyTool used to visualize data.</p>
<p>Markers of Points can be reffered from here:
http://matplotlib.org/api/markers_api.html</p>
<p>Colors can be reffered from here:
http://matplotlib.org/api/colors_api.html</p>
<p>Here is a picture of Line Styles and Point Markers form <a href="http://www.labri.fr/perso/nrougier/teaching/matplotlib/">nrougier</a>:</p>
<p><img alt="" src="https://raw.githubusercontent.com/GeoPyTool/GeoPyTool/master/img/LIneStylesMarkers.png"></p>
<h2>Need Further Help?</h2>
<p>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.</p>
<h2>Appendix</h2>
<p>The New Zircon Ce function need Data template file named as <a href="https://github.com/GeoPyTool/GeoPyTool/blob/master/DataFileSamples/ZirconCe.xlsx">ZirconCe.xlsx</a></p>
<p><img alt="" src="https://raw.githubusercontent.com/GeoPyTool/GeoPyTool/master/img/NewZirconCe.png"></p>
<p>The New TAS, REE and Trace Elements functions share a same Data template files:
<a href="https://github.com/GeoPyTool/GeoPyTool/blob/master/DataFileSamples/Data.xlsx">Data.xlsx</a></p>
<p><img alt="" src="https://raw.githubusercontent.com/GeoPyTool/GeoPyTool/master/img/NewTAS.png">
<img alt="" src="https://raw.githubusercontent.com/GeoPyTool/GeoPyTool/master/img/NewTrace.png"></p>
<p>The New StereoNet Projection and the RoseMap function need Data template file named as <a href="https://github.com/GeoPyTool/GeoPyTool/blob/master/DataFileSamples/Structure.xlsx">Structure.xlsx</a></p>
<p><img alt="" src="https://raw.githubusercontent.com/GeoPyTool/GeoPyTool/master/img/Rose.png"></p>
<p><img alt="" src="https://raw.githubusercontent.com/GeoPyTool/GeoPyTool/master/img/LoadPNG.png"></p>
</div><!-- /.entry-content -->
<footer class="post-meta">
<span class="meta-prep">Category:</span>
<abbr class="category">
<a href="/category/doc.html">Doc</a>
</abbr>
</footer>
<section id="respond">
<div id="disqus_thread">
<script type="text/javascript">
var disqus_identifier = "installation.html";
(function() {
var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
dsq.src = 'http://cycleuser.disqus.com/embed.js';
(document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
})();
</script>
</div>
<script id='nodebb-comments-script' ourl="https://v2mm.tech" ocid="53" blogger='cycleuser' src="https://v2mm.tech/plugins/nodebb-plugin-blog-comments2/lib/simple-pelican.js"></script>
</section>
</section>
</section><!-- #content -->
<section id="widgets" class="grid col-300 fit" >
<!--
<section id="widget-search" class="widget-wrapper widget_search">
<form id="searchform" action="http://www.google.com/search" method="get">
<input id="q" class="field" type="text" placeholder="Search Blog" name="q" ></input>
<input id="ie" name="ie" type="hidden" value="utf-8" ></input>
<input id="oe" name="oe" type="hidden" value="utf-8" ></input>
<input id="channel" name="channel" type="hidden" value="suggest" ></input>
<input id="searchsubmit" class="submit" type="submit" value="">
</form>
</section>
-->
<section id="widget-links" class="widget-wrapper widget_archive">
<div class="widget-title">
Links
</div>
<ul>
<li><a href="http://geopytool.com/about.html">About</a></li>
<li><a href="http://geopytool.com/functions.html">Functions</a></li>
<li><a href="http://geopytool.com/milestones.html">Milestones</a></li>
<li><a href="http://geopytool.com/installation.html">Installation</a></li>
<li><a href="http://geopytool.com/demonstration.html">Demonstration</a></li>
<li><a href="http://geopytool.com/download.html">Download</a></li>
<li><a href="http://geopytool.com/archives.html">Archives</a></li>
<li><a href="http://geopytool.com/about.html">简要介绍</a></li>
<li><a href="http://geopytool.com/gong-neng-lie-biao.html">功能列表</a></li>
<li><a href="http://geopytool.com/kai-fa-ji-lu.html">开发记录</a></li>
<li><a href="http://geopytool.com/an-zhuang-zhi-nan.html">安装指南</a></li>
<li><a href="http://geopytool.com/yan-shi-shi-pin.html">功能演示</a></li>
<li><a href="http://geopytool.com/download.html">下载链接</a></li>
<li><a href="http://geopytool.com/archives.html">存档整理</a></li>
</ul>
</section>
<section id="widget-category" class="widget-wrapper widget_archive">
<div class="widget-title">
Category
</div>
<ul>
<li><a href="/category/doc.html" >Doc </a></li>
<li><a href="/category/python.html" >Python </a></li>
</ul>
</section>
<section id="widget-tagcloud" class="widget-wrapper widget_archive">
<div class="widget-title">
Tagcloud
</div>
<div>
<span><a href="/tag/wen-dang.html">文档</a></span>
<span><a href="/tag/doc.html">Doc</a></span>
<span><a href="/tag/chinese.html">Chinese</a></span>
<span><a href="/tag/zhong-wen.html">中文</a></span>
<span><a href="/tag/english.html">English</a></span>
</div>
</section>
</section><!-- widgets -->
</section><!-- /#wrapper -->
<footer id="footer" class="clearfix"><section class="footer-wrapper">
<div class="grid col-940" >
<div class="grid col-540"></div>
<div class="grid col-380 fit" >
<ul class="social-icons">
<!-- TO BE CONTINUED -->
</ul>
</div>
</div>
<div class="grid col-300 copyright" >
<a href="http://creativecommons.org/licenses/by-nc-sa/3.0/" rel="license">
<img src="http://i.creativecommons.org/l/by-nc-sa/3.0/88x31.png" style="border-width:0" alt="知识共享许可协议"></img>
</a>
</div>
<div class="grid col-300 ">
</div>
<div class="grid col-300 fit powered">
Powered by <a href="http://getpelican.com/">Pelican</a> <br />
which takes great advantage of <a href="http://python.org">Python</a>
</div>
</section></footer>
</div>
</body>
</html>