Install

Biogeme is an open source Python package, that relies on the version 3 of Python. Make sure that Python 3.x is installed on your computer. If you have never used Python before, you may want to consider a complete platform such as Anaconda.

If Python is already installed on your computer, verify the version. Two versions of Python are distributed: version 2 and version 3. Biogeme works only with version 3.

Biogeme is distributed using the pip package manager. There are several tutorials available on the internet such as this one or this one.

Depending on your OS and the version of Python, pip will either directly install the executable (it is called a "wheel"), or attempt to compile the package from sources.

In the latter case, it requires a proper compiling environment. In general, it is readily available on Linux, and MacOSX (if Xcode has been installed). It may be more complicated on Windows.

Cython library not found

On Mac OSX, the following error is sometimes generated:

ImportError: dlopen(/Users/~/anaconda3/lib/python3.6/site-packages/biogeme/cbiogeme.cpython-36m-darwin.so, 2): Symbol not found: __ZNSt15__exception_ptr13exception_ptrD1Ev It is likely to be due to a conflict of versions of Python packages. The best way to deal with it is to reinstall Biogeme using the following steps:

First, make sure that you have the latest version of pip:

• pip install --upgrade pip

• Uninstall biogeme:

  pip uninstall biogeme

• Install cython:

  pip install —upgrade python

• Reinstall biogeme, without using the cache:

  pip install biogeme —no-cache-dir

Trying to compile

On Mac OSX and Windows, the installation is designed to install from binaries, not sources. If you get messages that look like the following, it means that pip is trying to compile from sources. And it will most certainly fail as the environment must be properly configured.

  Running setup.py install for biogeme ... error
  Complete output from command c:\users\willi\anaconda3\python.exe -u -c "import setuptools, tokenize;__file__='C:\\Users\\willi\\AppData\\Local\\Temp\\pip-install-iaflhasr\\biogeme\\setup.py';f=getattr(tokenize, 'open', open)(__file__);code=f.read().replace('\r\n', '\n');f.close();exec(compile(code, __file__, 'exec'))" install --record C:\Users\willi\AppData\Local\Temp\pip-record-v6_zn0ff\install-record.txt --single-version-externally-managed --compile:
  Using Cython
  Please put "# distutils: language=c++" in your .pyx or .pxd file(s)
  running install

It means that there is no binaries available for your version of Python. To check which versions are supported, go to the repository

pypi.org/project/biogeme/

If you select the "Download files", you will see the list of files available. What you need to look at are the "Wheel" files. For instance, the following files are available for version 3.1.2:

• biogeme-3.1.2-cp36-cp36m-macosx_10_7_x86_64.whl
• biogeme-3.1.2-cp37-cp37m-macosx_10_13_x86_64.whl
• biogeme-3.1.2-cp37-cp37m-win_amd64.whl

It means that you must use Python 3.6 or 3.7 on Mac OSX, and Python 3.7 on Windows.

To verify if biogeme is correctly installed, you can print the version of Biogeme. To do so, execute the following commands in Python:

• Import the package: import biogeme.version as ver
• Print the version information: print(ver.getText())

The result should look like the following:

	  
Python 3.7.0 (default, Aug 22 2018, 15:22:33)
[Clang 9.1.0 (clang-902.0.39.2)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import biogeme.version as ver
>>> print(ver.getText())
biogeme 3.1.0 [October 1, 2018]
Version entirely written in Python
Home page: http://biogeme.epfl.ch
Submit questions to https://groups.google.com/d/forum/biogeme
Michel Bierlaire, Transport and Mobility Laboratory, Ecole Polytechnique Fédérale de Lausanne (EPFL)