comb-model 1.0.1

A package to simulate Fractional Brownian walks on a comb-like structure.

.. |version| image:: https://img.shields.io/pypi/v/comb-model?style=plastic :alt: PyPI
:target: https://pypi.org/project/comb-model/
:scale: 100%
.. |license| image:: https://img.shields.io/github/license/lgaalves/combmodel?style=plastic :alt: GitHub
:target: https://github.com/lgaalves/CombMolde/blob/master/license.rst
:scale: 100%
.. |downloads| image:: https://img.shields.io/pypi/dm/comb-model?style=plastic :alt: PyPI - Downloads
:target: https://pypi.org/project/comb-model/
:scale: 100%
.. |docs| image:: https://readthedocs.org/projects/comb-model/badge/?version=latest
:target: https://comb-model.readthedocs.io/?badge=latest
:alt: Documentation Status
:scale: 100%


|version| |license| |downloads| |docs|


comb-model: A package to simulate Fractional Brownian walks on a comb-like structure.
==========================================================================================

This package simulate trajectories of the comb model via Langevin equations driven by fractional Gaussian noises (long-range correlated).

If you have used ``comb-model`` in a scientific publication, we would appreciate citations to the following reference [#ribeiro2014]_:

- Haroldo V. Ribeiro, Angel A. Tateishi, Luiz G. A. Alves, Rafael S. Zola, Ervin K Lenzi (2014). `Investigating the interplay between mechanisms of anomalous diffusion via fractional Brownian walks on a comb-like structure <http://dx.doi.org/10.1088/1367-2630/16/9/093050>`_. New Journal of Physics 16, 093050




.. figure:: https://raw.githubusercontent.com/lgaalves/combmodel/main/figures/featured.png
:height: 489px
:width: 633px
:scale: 80 %
:align: center


For more detailed information about the methods functions in ``comb-model``, please
consult its `documentation <https://comb-model.readthedocs.io/en/latest/index.html>`_.


Installation
-------------

The ``comb-model`` package is available on pypi and can be installed using pip

.. code-block:: shell

pip install comb-model

Dependencies
~~~~~~~~~~~~
* ``numpy``
* ``stochastic``
* ``tdqm``

Processes
---------

This package offers functions to simulate Fractional Brownian walks on a plane or Comb-like structures via via Langevin equations.


.. code-block:: python

# Fractional Brownian walks on a plane

import matplotlib.pyplot as plt
from combmodel import langevin_fbn

x,y=langevin_fbn(x0=0,y0=0,betax=1,betay=1,hurstx=0.5,hursty=0.5,tmax=1000,disable_tqdm=True)


f, ax = plt.subplots(nrows=1, ncols=1, figsize=(9.1,7))
ax.plot(x,y,color='#D62728',markersize=0,linewidth=2)
ax.set_xlabel(r'Position, $x(t)$')
ax.set_ylabel(r'Position, $y(t)$')

.. figure:: https://raw.githubusercontent.com/lgaalves/combmodel/main/figures/fbm.png
:height: 489px
:width: 633px
:scale: 80 %
:align: center


.. code-block:: python

# Fractional Brownian walks on a Comb-like structure

import matplotlib.pyplot as plt
from combmodel import comb_model

x, y = comb_model(x0=0,y0=0,betax=1,betay=1,hurstx=0.5,hursty=0.5,tmax=5000,eps=1,disable_tqdm=True)

f, ax = plt.subplots(nrows=1, ncols=1, figsize=(9.1,7))
ax.plot(x,y,color='#D62728',markersize=0,linewidth=2)
ax.set_xlabel(r'Position, $x(t)$')
ax.set_ylabel(r'Position, $y(t)$')

.. figure:: https://raw.githubusercontent.com/lgaalves/combmodel/main/figures/comb.png
:height: 489px
:width: 633px
:scale: 80 %
:align: center


References
==========

.. [#ribeiro2014] Haroldo V. Ribeiro, Angel A. Tateishi, Luiz G. A. Alves, Rafael S. Zola, Ervin K Lenzi (2014). `Investigating the interplay between mechanisms of anomalous diffusion via fractional Brownian walks on a comb-like structure <http://dx.doi.org/10.1088/1367-2630/16/9/093050>`_. New Journal of Physics 16, 093050