Advanced Windows Installation

<< Back to Install Roadrunner Home Page
Instructions to install without the recommended “click-through pre-packaged” installer, with all the dependencies.

Options:
A. Minimal GUI installer (short instructions)
B. Distutils command line installer – (new >=v1.1.0 – For developers – alpha versions)
C. Minimal GUI installer (Step-by-Step instructions)


A. Minimal GUI installer

The minimal installer will add pylibRoadRunner, just our python library, to your site-packages/ dir.

  1. Install Python 2.7.6numpy for python 2.7 and  matplotlib for python 2.7
  2. Download  libroadrunner-1.0.1-win32-minimal-setup.exe  from libroadrunner.sf.net
  3. Run (double click) libroadrunner-[version]-win32-minimal-setup.exe
    • The installer will try to find your Python installation, if it does not: choose your Python Lib/site-packages/ directory
  4. Start Python
  5. Simulate a model in your python console:
    import roadrunner
    import roadrunner.testing
    rr = roadrunner.RoadRunner(roadrunner.testing.getData('feedback.xml'))
    result = rr.simulate()
    roadrunner.plot(result)
  6. Follow Basic Tutorial in Python API documentation.
  7. (Optionally) We provide the full binary distribution, e.g. for users who are looking for C/C++ libraries, as a zip file libroadrunner-[version]-win32.zip from from libroadrunner.sf.net

B. Distutils command line installer

Instructions for developers to use the distutils command line installer
– introduced in pylibRoadRunner v1.1.0 – e.g. used to install alpha distribution versions

The distutils installer will add pylibRoadRunner, just our python library, to your site-packages/ dir.

  1. Install Python 2.7.6numpy for python 2.7 and  matplotlib for python 2.7
  2. Download pylibroadrunner-[version]-win_32.zip and unzip the file
  3. Start Menu> type cmd > press Enter
  4. On the command line, paste the following to install
    c:\Python27\python.exe setup.py install
  5. Simulate a model in your python console:
    import roadrunner
    import roadrunner.testing
    rr = roadrunner.RoadRunner(roadrunner.testing.getData('feedback.xml'))
    result = rr.simulate()
    roadrunner.plot(result)
  6. Follow Basic Tutorial in Python API documentation.
  7. (Optionally) We provide the full binary distribution, e.g. for users who are looking for C/C++ libraries, as a zip file libroadrunner-[version]-win32.zip

C. Minimal GUI installer (step-by-step)

Step-by-Step instructions to use the minimal GUI installer to install roadrunner without using the pre-packaged binary installer.

  1. Download  libroadrunner-[version]-win32-minimal-setup.exe
    from http://sourceforge.net/projects/libroadrunner/files
  2. Double click to run the libroadrunner-[version]-win32-minimal-setup.exe to install the Python bindings in c:\Python27\lib\site-packages.
    1. (Advanced: Alternatively to using the installer) You can manually copy the site-packages/roadrunner and bin/*.dll directory from the unziped file to your own site-packages. e.g. c:\Python27\lib\site-packages\roadrunner
      You can find the exact files in the source code installer/windows/libRoadRunner-win32-minimal-setup.iss
  3. Start Python and check if roadrunner is installed. In a command prompt you can just type python or run your favorite Python IDE e.g. Spyder2. Once on the python interpreter prompt type the command below. (If you do not have python yet get it here: Python 2.7.6 Windows Installer) If the command below comes back with out complaint then the installation is probably ok.
    >>> import roadrunner
    1. If you do not already have numpy for python 2.7 install it or get other versions here.
    2. If you do not have matplotlib for python 2.7 install it or get other versions here.
  4. To test that you have it running, type the following to get the version number
    >>> roadrunner.__version__
    '1.0.1; Compiler: Microsoft Visual Studio 2010; Date: Feb 14 2014, 14:04:17'
  5. Go to and Read the Python API documentation to learn howto use libRoadRunner in Python.
  6. (Optionally. For advanced users installing from the binary distribution.) You can run the RoadRunner standalone program in the Windows command prompt.  C/C++ libraries are also provided. For documentation see the C and C++ APIs. We recommend using libRoadrunner in Python, see next step.
    cd %HOMEPATH%\Downloads\libroadrunner-1.0.1-win32\bin
    rr.exe -m ..\models\test_1.xml

    A brief explanation of the Roadrunner Command Line Interface (CLI ) is provided.