Metadata-Version: 2.2
Name: pybtls
Version: 1.0.1
Summary: A package for short-to-mid span bridge traffic loading simulation
Keywords: bridge,traffic,simulation
Author-Email: Colin Caprani <colin.caprani@monash.edu>, Ziyi Zhou <ziyi.zhou@monash.edu>, Akbar Rizqiansyah <akbar.rizqiansyah@monash.edu>
License: GNU GPL v3
Project-URL: Documentation, https://github.com/ccaprani/btls
Project-URL: Source, https://github.com/ccaprani/btls
Project-URL: Tracker, https://github.com/ccaprani/btls/issues
Requires-Python: >=3.10
Requires-Dist: matplotlib
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: scipy
Provides-Extra: test
Requires-Dist: pytest>=6.0; extra == "test"
Requires-Dist: pycba>=0.5; extra == "test"
Description-Content-Type: text/x-rst

.. figure:: https://raw.githubusercontent.com/ccaprani/btls/main/docs/source/images/logo/PyBTLS_logo.png
   :alt: PyBTLS logo
   :align: center
   :width: 320px

**********************************************
PyBTLS - Python Bridge Traffic Load Simulation
**********************************************

*PyBTLS* is a Python wrapper of the C++ based program bridge traffic load simulation (BTLS). 
It is tailored for traffic simulations on short-to-medium length bridges, 
where vehicles' lane-changing behaviors are considered negligible.

*PyBTLS* uses influence lines or surfaces to calculate the load effects on bridges. 
It integrates several built-in influence lines (check the docs), 
and more influence lines or surfaces can be defined by users. 

Installation
============

To install *PyBTLS* just do:

.. code-block:: bash

    pip install pybtls

Features
========

* Generate new traffic from historical traffic;
* Can get any load effect data, with additional Python bridge analysis packages (there are many) to define the IL/IS;
* Simulation runs efficiently, with C++ backend and Python multiprocessing support;
* Well-organized output data in pandas DataFrame; 
* Integrates block-maximum analysis, peak-over-threshold analysis, rainflow analysis, etc.

Getting started
===============
This `Documentation`_ provides all the information needed to install *PyBTLS* and conduct different simulations supported by *PyBTLS*. 
More detailed information about the input and output data can be found in the `Manual`_.

.. _`Documentation`: http://pybtls.github.io/pybtls/
.. _`Manual`: https://github.com/ccaprani/btls/tree/main/Manual

Credits & Copyright
===================
PyBTLS is based on BTLS by Colin Caprani; 
Modified by Ziyi Zhou; 
Also contributed by Akbar Rizqiansyah. 

* Copyright (c) 2001-2022 Colin Caprani;
* Copyright (c) 2022-2023 Colin Caprani, Ziyi Zhou, Akbar Rizqiansyah;
* Copyright (c) 2024 The PyBTLS developers (see contributors on GitHub). 

Main Reference
==============

OBrien, E., Nowak, A., & Caprani, C. (Eds.). (2021). Bridge traffic loading: From research to practice. CRC Press. `Link <https://books.google.com.au/books?hl=zh-CN&lr=&id=j9tKEAAAQBAJ&oi=fnd&pg=PP1&dq=Bridge+traffic+loading:+From+research+to+practice&ots=Pl6tyRIMb-&sig=NYrA_Docg2jJYymS-Z-w5x6lbRk#v=onepage&q=Bridge%20traffic%20loading%3A%20From%20research%20to%20practice&f=false>`_
