Balsa is a collection of functions and tools for Python to facilitate travel demand forecasting applications and analyses. It is designed to work the the “scientific stack” of Python, namely NumPy, Pandas, and Matplotlib; which are optimized for speed and usability. Most of balsa consists of standalone functions - for input/output, for analysis, etc. - as well as a few lightweight class-based data structures for specific applications.
Balsa documentation is available here
- I/O routines to convert from binary matrix formats (INRO, OMX, and more) to Pandas DataFrames and Series
- Matrix operations such as balancing, dis/aggregation, triple-indexing, and bucket rounding
- Plotting functions such a Trip Length Frequency Distributions
- Pretty Logging utilities for use in program applications
- and more!
Balsa is compatible with Python 3.7+
For TRESO v1.4 (and older) users: TRESO is only compatible with the
v0.6.1
release of Balsa, which can only be installed directly from GitHub usingpip
.
Balsa can be installed with conda by running the following command:
conda install -c wsp_sap wsp-balsa
Balsa can be installed directly from GitHub using pip
by running the following command:
pip install git+https://github.com/wsp-sag/balsa.git
Windows Users: It is recommended to install Balsa from inside an activated Conda environment. Balsa uses several packages (NumPy, Pandas, etc.) that will otherwise not install correctly from
pip
otherwise. For example:
C:\> conda activate base
(base) C:\> pip install git+https://github.com/wsp-sag/balsa.git
...