|
|
| Installing Opus | |
This section provides instructions for installing Opus, UrbanSim, as well as the external software required by Opus and UrbanSim.
Opus and UrbanSim are intended to be platform-independent. We have successfully installed and used the system under the Windows, Linux, and Macintosh operating systems. These installation directions have been tested with Windows XP, SuSe Linux, and Macintosh OS X Version 10.4.5 with both PPC and Intel processors.
Opus and UrbanSim rely on numerous other open-source systems, in particular Python, Traits and a non-trivial set of Python packages. Fortunately, on Windows, the Enthought Python Edition for Windows installs both Python and all of the Python packages needed by Opus and UrbanSim. For Linux and Macintosh, however , there is not (yet) such a bundled set of packages, so the process of installing all the supporting software on those systems can be a bit tedious, although hopefully straightforward.
Opus and UrbanSim work with Python 2.4 or 2.5. In general, we recommend you use the most recent snapshot of these external applications, though if you are have problems, try using one of the versions mentioned here. These instructions assume you are using Python 2.4.3. If you are using different versions, adjust the instructions accordingly.
To help illustrate how to setup UrbanSim for use by your own agency, these installation directions sometimes refer to a fictitious Atlantis Metropolitan Planning Organization (MPO). Where you see the word “atlantis” you may safely substitute the appropriate name for your application.
The installation steps vary according to the operating system being used:
Check the release notes for significant code or data changes. If you have your own Opus package or an existing baseyear database you may need to modify your code and data.
The result of an install will be a number of packages in the Python 'site-packages' directory for the supporting software, and a 'workspace' directory that holds Opus and UrbanSim. The workspace directory will look something like this on Windows (with an analogous structure on other platforms):
C:\opusworkspace
atlantis/
docs/
... (more directories and files) ... __init__.py opus_package_info.p opus_core/ urbansim/ ... (more Opus packages) ...
If you no longer wish to have Opus on your computer, just remove the workspace directory from your Python path, and delete that directory. (If you want to save space, you can also uninstall any supporting software that you downloaded just to use with Opus.)