Urbansim Downloads and Installation Instructions

NOTE: There is a new location for the UrbanSim and OPUS software repository. It is now located at https://svn.urbansim.org. If you are using subversion to synchronize with the UrbanSim repository, please read the notes on DownloadingSampleDataAndSourceCode.

The UrbanSim software is licensed under the GNU General Public License, which means it is free, open source, and any derived works are also covered under the license. The license prevents its commercialization and allows the software to remain freely shared. The intent of this approach is to avoid proprietary obstacles and costs, and to facilitate collaboration between researchers and practitioners. It is our intent to support the unrestricted development of improved tools for planning and policymaking in land use, transportation, and the environment.

We support two primary releases: the Latest Stable Release and the Development Version. We strive to keep the Latest Stable Release as bug free as possible. The Development Version links you to the latest code, and therefore has the most recently added features -- but is therefore also less thoroughly tested. When you run the installer on Windows, you will have an opportunity to select which of these two versions you want to install.

If you are upgrading from a previous version, you should check out the ReleaseNotes.

Installation Instructions

Windows

• To access the installer and instructions for Windows operating systems, go to: WindowsInstaller
• Running Opus/UrbanSim on 64 bit machines (using a manual installation of components)

Macintosh

• To access installation instructions for the Macintosh platform (sorry, no installer here), go to: MacintoshInstallation
• You may also need some helpful tips, available here: MacintoshInstallationHints

Linux

• Linux hackers can get their installation instructions here: LinuxInstallation
• Also see more detailed instructions for setting up on Ubuntu

Required and Optional Packages

The following pages provide a list of the required and optional packages for all platforms. (The installation pages for the different platforms, linked above, also have this information but not always with specific version numbers.)

• PythonPackagesVersion (What version of Python and packages to install)
• RequiredPackagesRelease42 (for release 4.2.2)
• RequiredPackagesDevVersion (for the current development version)

We also have a page specifically with directions for InstallingMySQL.

Downloading Sample Data and Source Code

To access sample data projects and the source code for UrbanSim, go to:

• Downloading the Opus/UrbanSim sample data and source code

Testing Your Installation

Once you have installed the software, you can test it to confirm that the install is correct. See TestingYourInstallation for details.

Additional Installation Instructions

If you will be extending or modifying the source code, an Interactive Development Environment is very useful. Here are directions for configuring Eclipse and Wing. (We typically use Eclipse for talking to subversion, Wing for debugging, and either for writing code.)

• ConfiguringEclipse
• ConfiguringWing

Finally, here are some additional instructions for particular situations.

• Writing and Formatting Opus/UrbanSim Documentation using Latex