-
Notifications
You must be signed in to change notification settings - Fork 12
/
how_to_install.txt
110 lines (73 loc) · 4.95 KB
/
how_to_install.txt
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
How to install
==============
This page describes how to download, install and use the basic functionality of cclib.
Requirements
------------
Before you install cclib, you need to make sure that you have the following:
* Python (at least version 3.0 is recommended, although 2.7 is still tested)
* NumPy (at least version 1.5 is recommended)
Python is an open-source programming language available from http://www.python.org. It is available for Windows as well as being included in most Linux distributions. In Debian/Ubuntu it is installed as follows (as root):
.. code-block:: bash
apt-get install python python-dev
NumPy (Numerical Python) adds a fast array facility and linear algebra routines to Python. It is available from http://www.numpy.org. Windows users should use the most recent NumPy installation for the Python version they have (e.g. numpy-1.0.3.1.win32-py2.4.exe for Python 2.4). Linux users are recommended to find a binary package for their distribution rather than compiling it themselves. In Debian/Ubuntu it is installed as follows (as root):
.. code-block:: bash
apt-get install python-numpy
To test whether Python is on the PATH, open a command prompt window and type:
.. code-block:: bash
python
If Python is not on the PATH and you use Windows, add the full path to the directory containing it to the end of the PATH variable under Control Panel/System/Advanced Settings/Environment Variables. If you use Linux and Python is not on the PATH, put/edit the appropriate line in your .bashrc or similar startup file.
To test that Numpy is working, try importing it at the Python prompt. You should see something similar to the following:
.. code-block:: bash
$ python3
Python 3.2.3 (default, Feb 27 2014, 21:31:18)
[GCC 4.6.3] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import numpy
>>> numpy.__version__
'1.6.1'
>>>
(To exit, press CTRL+D in Linux or CTRL+Z,Enter in Windows)
Debian GNU/Linux systems
------------------------
If you're using `Debian GNU/Linux`_, `Ubuntu`_ or a similar distribution, there are official `cclib packages`_ that you can install in any package manager (should as synaptic) or with one simple command:
.. code-block:: bash
aptitude install cclib
There are in fact two packages, `python-cclib`_ containing the Python module, and `cclib`_ which installs just the user scripts. If you also need to also install the unittests and logfiles we distribute, you will need to install the `cclib-data`_ package from the non-free repositories (due to license issues).
.. _`Debian GNU/Linux`: http://www.debian.org
.. _`Ubuntu`: http://www.ubuntu.com
.. _`cclib packages`: http://packages.debian.org/src:cclib
.. _`python-cclib`: http://packages.debian.org/wheezy/python-cclib
.. _`cclib`: http://packages.debian.org/wheezy/cclib
.. _`cclib-data`: http://packages.debian.org/wheezy/cclib-data
Manual download and install
---------------------------
The source code of the newest release of cclib (version 1.5) is distributed as:
* A .zip file: https://github.com/cclib/cclib/releases/download/v1.5/cclib-1.5.post1.zip
* A .tar.gz file: https://github.com/cclib/cclib/releases/download/v1.5/cclib-1.5.post1.tar.gz
* Windows binary installers (see the `newest release page`_)
On Windows, if you choose to download the .exe files instead, you can install simply by doubleclicking on the file. To uninstall, use the "Add and Remove Programs" menu in the Control Panel.
None of these files include the tests and logfiles used for testing. In order to download all tests, we also provide source archives on the `newest release page`_.
If you are using the .zip or .tar.gz files, extract the contents of the file at an appropriate location, which we will call INSTALLDIR. Open a command prompt and change directory to INSTALLDIR. Next, run the following commands to install cclib:
.. code-block:: bash
python setup.py build
python setup.py install # (as root)
To test, trying importing '''cclib''' at the Python prompt. You should see something similar to the following:
.. code-block:: python
$ python3
Python 3.2.3 (default, Feb 27 2014, 21:31:18)
[GCC 4.6.3] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import cclib
>>> cclib.__version__
'1.1'
>>>
.. _`newest release page`: https://github.com/cclib/cclib/releases/tag/v1.5
What next?
----------
* Read the list and specifications of the `parsed data`_ and related `data notes`_
* Test the program using the test data files included in the full source distribution
* Run the unit and regression tests in the test directory (``testall.py`` and ``run_regressions.py``)
* Send any questions to the cclib-users mailing list at https://lists.sourceforge.net/lists/listinfo/cclib-users.
* Write some computational chemistry algorithms using information parsed from cclib and donate the code to the project
.. _`parsed data`: data.html
.. _`data notes`: data_notes.html