Skip to content
/ tvlsim Public

The Travel Market Simulator project aims at providing reference implementation, mainly in C++, of a travel market simulator.

License

Notifications You must be signed in to change notification settings

airsim/tvlsim

Repository files navigation

C++ Simulated Travel-Oriented Distribution System Library

Summary

The Travel Market Simulator project aims at providing reference implementation, mainly in C++, of a travel market simulator, focusing on revenue management (RM) for airlines. It is intended to be used for applied research activities only: it is by no way intended to be used by production systems. It is a new breed of software and aims to become the new generation PODS (http://podsresearch.com/), which was instrumental in the inception of the Travel Market Simulator project.

Over a dozen components have been implemented and are fully functional, encompassing for instance (but not limited to) traveller demand generation (booking requests), travel distribution (GDS/CRS), low fare search (LFS), price calculation and inventory availability calculation), customer choice modelling (CCM), revenue management (RM), schedule and inventory management, revenue accounting (RA).

The Travel Market Simulator can used in either batch or hosted mode. It is the main component of the Travel Market Simulator: https://travel-sim.org

That project makes an extensive use of existing open-source libraries for increased functionality, speed and accuracy. In particular the Boost (C++ Standard Extensions: https://www.boost.org) library is used.

The TvlSim component itself aims at providing a clean API and a simple implementation, as a C++ library, of a travel market simulator, focusing on revenue management (RM) for airlines. That library uses the Standard Airline IT C++ object model (https://github.com/airsim/stdair).

Installation

On Fedora/CentOS/RedHat distribution

Just use DNF:

$ dnf -y install tvlsim-devel tvlsim-doc

You can also get the RPM packages (which may work on Linux distributions like Novel Suse and Mandriva) from the Fedora repository (e.g., for Fedora Rawhide, https://fr2.rpmfind.net/linux/RPM/fedora/devel/rawhide/x86_64/)

Building the library and test binary from Git repository

The Git repository may be cloned as following:

$ git clone git@github.com:airsim/tvlsim.git tvlsimgit # through SSH
$ git clone https://github.com/airsim/tvlsim.git # if the firewall filters SSH
$ cd tvlsimgit

Then, you need the following packages (Fedora/RedHat/CentOS names here, but names may vary according to distributions):

  • cmake
  • gcc-c++
  • boost-devel / libboost-dev
  • python-devel / python-dev
  • gettext-devel / gettext-dev
  • sqlite3-devel / libsqlite3-dev
  • readline-devel / readline-dev
  • ncurses-devel
  • soci-mysql-devel, soci-sqlite3-devel
  • stdair-devel / libstdair-dev
  • sevmgr-devel / libsevmgr-dev
  • airrac-devel / libairrac-dev
  • rmol-devel / librmol-dev
  • airinv-devel / libairinv-dev
  • simfqt-devel / libsimfqt-dev
  • airtsp-devel / libairtsp-dev
  • doxygen, ghostscript, graphviz
  • tetex-latex (optional)
  • rpm-build (optional)

Building the library and test binary from the tarball

The latest stable source tarball (tvlsim*.tar.gz or .bz2) can be found here: https://github.com/airsim/tvlsim/releases

To customise the following to your environment, you can alter the path to the installation directory:

export INSTALL_BASEDIR="${HOME}/dev/deliveries"
export TVLSIM_VER="1.01.7"
if [ -d /usr/lib64 ]; then LIBSUFFIX="64"; fi
export LIBSUFFIX_4_CMAKE="-DLIB_SUFFIX=$LIBSUFFIX"

Then, as usual:

  • To configure the project, type something like:
  mkdir build && cd build
  cmake -DCMAKE_INSTALL_PREFIX=${INSTALL_BASEDIR}/tvlsim-$TVLSIM_VER \
   -DWITH_STDAIR_PREFIX=${INSTALL_BASEDIR}/stdair-stable \
   -DWITH_TRADEMGEN_PREFIX=${INSTALL_BASEDIR}/trademgen-stable \
   -DWITH_SEVMGR_PREFIX=${INSTALL_BASEDIR}/sevmgr-stable \
   -DWITH_TRAVELCCM_PREFIX=${INSTALL_BASEDIR}/travelccm-stable \
   -DWITH_AIRTSP_PREFIX=${INSTALL_BASEDIR}/airtsp-stable \
   -DWITH_AIRRAC_PREFIX=${INSTALL_BASEDIR}/airrac-stable \
   -DWITH_RMOL_PREFIX=${INSTALL_BASEDIR}/rmol-stable \
   -DWITH_AIRINV_PREFIX=${INSTALL_BASEDIR}/airinv-stable \
   -DWITH_SIMFQT_PREFIX=${INSTALL_BASEDIR}/simfqt-stable \
   -DWITH_SIMCRS_PREFIX=${INSTALL_BASEDIR}/simcrs-stable \
   -DCMAKE_BUILD_TYPE:STRING=Debug -DENABLE_TEST:BOOL=ON -DINSTALL_DOC:BOOL=ON \
   -DRUN_GCOV:BOOL=OFF ${LIBSUFFIX_4_CMAKE} ..
  • To build the project, type:
  make
  • To test the project, type:
 make check
  • To install the library (libtvlsim*.so*) and the binary (tvlsim), just type:
  make install
  cd ${INSTALL_BASEDIR}
  rm -f tvlsim-stable && ln -s tvlsim-${TVLSIM_VER} tvlsim-stable
  cd -
  • To package the source files, type:
  make dist
  • To package the binary and the (HTML and PDF) documentation:
  make package
  • To browse the (just installed, if enabled) HTML documentation:
  midori file://${INSTALL_BASEDIR}/tvlsim-$TVLSIM_VER/share/doc/tvlsim/html/index.html
  • To browse the (just installed, if enabled) PDF documentation:
  evince ${INSTALL_BASEDIR}/tvlsim-$TVLSIM_VER/share/doc/tvlsim/html/refman.pdf
  • To run the local binary version:
  ./tvlsim/tvlsim -b
  • To run the installed version:
  ${INSTALL_BASEDIR}/tvlsim-$TVLSIM_VER/bin/tvlsim -b

simulate binary:

The simulate executable requires a MySQL/MariaDB relational database. Also, the StdAir package contains helper scripts in order to create:

  • a database user, namely tvlsim;
  • as well as a database, namely sim_tvlsim. Some data need to be loaded into a specific table, namely airlines.

Following is a sequence of commands allowing to initialise the MySQL database correctly:

$ /usr/libexec/stdair/create_tvlsim_user.sh
# Then, enter the credentials of an admin MySQL account.
# Launch with the '-h' option to see how to change the hostname and/or port.
$ /usr/libexec/stdair/create_tvlsim_db.sh
# Then, enter the credentials of an admin MySQL account.
# Launch with the '-h' option to see how to change the hostname and/or port.
$ /usr/libexec/stdair/load_tvlsim_data.sh
# Launch with the '-h' option to see how to change the hostname and/or port.
$ simulate
$ less simulate.log

TvlSimServer binary:

Same as for the simulate executable. A command-line (test) client exists in Python (appserver/django/tvlsimClient.py).

$ TvlSimServer &
$ wget https://raw.github.com/airsim/tvlsim/trunk/appserver/django/tvlsimClient.py
$ python tvlsimClient.py
$ kill %1
$ less tvlsimServer.log

Note that a Django-based Web application server also exists, but it has not been packaged yet.

Denis Arnaud