CmePy was developed for Python 2.5, and depends upon the following packages:
- SciPy 0.7
- Numpy 1.2.1
- Matplotlib (required only to plot example results)
CmePy should be compatible with Python 2.6, provided SciPy 0.7 and Numpy 1.3 are used.
The easiest way to obtain CmePy is to download an archive of the master branch from CmePy’s GitHub repository:
Download CmePy now as a ZIP or TAR archive!
Alternatively, if you have the Git version control system installed, you may prefer to check out a copy of CmePy directly from GitHub, via:
git clone git://github.com/fcostin/cmepy.git
To test CmePy, simply run the test_all.py script:
python test_all.py
If one or more of the tests fail, check to see if all CmePy’s dependencies are correctly installed.
When the test_all.py script completes with all tests passed, then CmePy may be installed by running the setup.py script as follows:
python setup.py install
On linux, you will most likely need to use sudo to install CmePy globally:
sudo python setup.py install
If it is not possible or not desirable to install CmePy as a global package, there are a couple of ways to install CmePy locally. The first way is perhaps quicker to get started, but is a bit ugly, as it relies on messing about with environment variables,. The second way is to use the VirtualEnv package to create and manage a local, isolated working environment for CmePy.
If it is not possible to install CmePy to the Python’s global site_packages directory, CmePy may instead be installed locally to a user’s home directory. The following instructions assume you are using the bash shell.
First, ensure that the path ${HOME}/lib/python exists, and that the ${PYTHONPATH} environment variable includes ${HOME}/lib/python. Then, CmePy may be installed locally as follows:
python setup.py install --home=${HOME}
The VirtualEnv package is a tool to create isolated Python environments. This addresses the far more general problem of managing Python environments for multiple projects. VirtualEnv can be combined with Pip, Distribute, and VirtualEnvWrapper to create a very nice system for managing Python packages.
To learn more about these useful packages, visit their pages on the Python package index:
I strongly recommend using pip to install and uninstall Python packages. If pip is installed, then CmePy may be uninstalled via:
pip uninstall cmepy
Note
pip is unable to uninstall CmePy if CmePy has been installed locally using the environment variables method. In this case, CmePy may be uninstalled by manually removing CmePy’s directory from the path ${HOME}/lib/python.