liuhahayue / vampy

Python package implementing the 1D blood flow equations using the Lax-Wendroff method.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

VaMpy logo

An implementation of finite difference methods (FDM) to solve partial differential equations (PDE).

The first method to be implemented is Richtmyer's 2 step Lax-Wendroff method.

This is the README file for the project.


Journal paper

A paper on the VaMpy Python package has been published in the Journal of Open Research Software. Whenever using VaMpy for your research, please cite it as

Diem AK, Bressloff NW (2017) VaMpy: A Python Package to Solve 1D Blood Flow Problems. Journal of Open Research Software 5: 17, http://doi.org/10.5334/jors.159


Installation

The package is available on Github. To clone the package run

git clone https://github.com/akdiem/VaMpy.git

To ensure all package dependencies are met it is easiest to set up a new Anaconda environment for VaMpy. This step is optional. The file vampy.yml can be used for this by calling

conda env create -f vampy.yml
source activate vampy

The first command creates the Anaconda environment vampy which contains all required packages, whilst the second command sets the current terminal to use this environment. To install VaMpy run

python setup.py install

Running the example files

To execute one of the example files run

python bifurcation_example.py bifurcation.cfg

To plot the data created from the example run

python plot_example.py bifurcation.cfg

Issues fixed and features added since latest release


Module Documentation

The module documentation can be found on

http://akdiem.github.io/vampy/


Artery setup walkthrough

The module documentation also contains a section on setting up an artery simulation, explaining parameters in the configuration file and code used to set up a simulation.

About

Python package implementing the 1D blood flow equations using the Lax-Wendroff method.

License:BSD 3-Clause "New" or "Revised" License


Languages

Language:Python 56.8%Language:TeX 42.9%Language:Makefile 0.3%