blobmodel Documentation

blobmodel is a python package for creating numerical realizations of advecting and dissipating blobs in up to two spatial dimensions. This open source project is developed by the Complex Systems Modelling group at UiT The Arctic University of Norway.

blobmodel is developed openly on GitHub, where you can request a new feature, report a bug or contribute to the package by creating a pull request.

Mathematically, the model of \(K\) superposed blobs, \(\Phi_K\), can be expressed as

\[\Phi_K(x, y, t) = \sum_{k=1}^{K} \phi_k(x, y, t).\]

The blobs \(\phi_k\) consists of an amplitude \(a_k\) and a blob shape \(\varphi\) with a blob width in x and y, given by \(l_x\) and \(l_y\):

\[\phi(x, y, t) = a_k \varphi\left(\frac{x}{l_x}, \frac{y}{l_y}, t \right).\]

Each blob has an individual velocity in x and y, \(v_x\) and \(v_y\), and decreases in amplitude with the drainage time \(\tau\):

\[\frac{\partial \phi_k}{\partial t} + v_x \frac{\partial \phi_k}{\partial x} + v_y \frac{\partial \phi_k}{\partial y} + \frac{\phi_k}{\tau} = 0.\]

A 2D example of the model is shown below:

The model can also be reduced to one spatial dimension as shown in the following example:

The following sections provide detailed information about the package components. Alternatively, you can take a look at the examples gallery at blobmodel/examples/ for a quick overview of the package’s functionalities.

Contents

• Installing
• Getting Started
• Visualize Model
• Model Geometry
• Blob Shapes
• Parameter Distributions
• Blob labels
• Drainage Time
• Blob Alignment
• Contributor Guide

API reference

• blobmodel package
  • Submodules
  • blobmodel.blob_shape module
  • blobmodel.blobs module
  • blobmodel.geometry module
  • blobmodel.model module
  • blobmodel.plotting module
  • blobmodel.stochasticality module
  • Module contents

Indices and tables

• Index

• Module Index

• Search Page