3. Conventions and Contributing

First off, thanks for taking the time to contribute! But please read here which standards we use for this project. We find coding standards extremely important - one of the most important things one can implement on a collaborative project.

3.1. Code Style

The Python code in this repo is meant to follow the PEP8 style guide (a stylized version http://pep8.org). Except for the line length, we stick to the Pep8 awards. Since we have set the line length to 100 in the …/LBM_for_Fluid_Simulations/setup.cfg you can test the code on Pep8 in all project directorys with the following command:

>>> pycodestyle .

Furthermore we use four spaces for a tab.

3.2. Before you push something please test:

  • is every class / function / codeblock well documented
  • system test
  • unittest
  • Pep 8 conformity
  • simulation speed.

The simulation speed is currently around 3M su / s on an Intel® Core ™ i7-4500U CPU @ 1.80GHz × 4. This value should not be far below.

3.3. The changelog file

The changelog format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)