- step class for LB phasefield generic enough to work with 3-phase and
  N-phase models
- cahn hilliard can either be solved by LBM or by finite differences
- 3 phase model can be solved with rho phase or without

- scaling interface width eta instead of surface tensions tau to correct
  interface profile & surface tensions

João Victor Tozatti Risso authored 7 years ago and Martin Bauer committed 7 years ago

Concept: Generate code involving the (un)packing of fields (from)to linear
(1D) arrays, i.e. (de)serialization of the field values for buffered
communication.

A linear index is generated for the buffer, by inferring the strides and
variables of the loops over fields in the AST. In the CPU, this information is
obtained through the makeLoopOverDomain function, in
pystencils/transformations/transformations.py. On CUDA, the strides of
the fields (excluding buffers) are combined with the indexing variables to infer
the indexing of the buffer.

What is supported:
    - code generation for both CPU and GPU
    - (un)packing of fields with all the memory layouts supported by
    pystencils
    - (un)packing slices of fields (from)into the buffer
    - (un)packing subsets of cell values from the fields (from)into the buffer

Limitations:

- assumes that only one buffer and one field are being operated within
each kernel, however multiple equations involving the buffer and the
field are supported.

- (un)packing multiple cell values (from)into the buffer is supported,
however it is limited to the fields with indexDimensions=1. The same
applies to (un)packing subset of cell values of each cell.

Changes in this commit:

- add the FieldType enumeration to pystencils/field.py, to mark fields
of various types. This is replaces and is a generalization of the
isIndexedField boolean flag of the Field class. For now, the types
supported are: generic, indexed and buffer fields.

- add the fieldType property to the Field class, which indicates the
type of the field. Modifications were also performed to the member
functions of the Field class to add this property.

- add resolveBufferAccesses function, which replaces the fields marked
as buffers with the actual field access in the AST traversal.

Miscelaneous changes:

- add blockDim and gridDim variables as CUDA indexing variables.

because boundary handling does its own flag management

- single function to create kernel for specified target
- data type creation from string - reuse numpy functionality
- bugfixes in dot display

Added LLVM: CodePrinter and a compiler
Updated data_types
Added tests
Added jupyter notebooks
Fixed bugs
Restructured transformation functions

- renaming because of clashes with types.py from other packages

previously the value was taken from the cell next to the boundary cell (i.e. the inner cell)

- abstraction layer for selecting CUDA block and grid sizes
  - line based (was implemented before)
  - block based (new, more flexible)
-  new conditional (if/else) ast node, which is necessary for indexing schemes (guarding if)

- this extension is necessary for more generic boundary treatment
- cells can now be structs, i.e. contain different data types
- instead of having numeric index dimensions, one can use the index per cell to adress struct elements

- use data type class consistently instead of strings (in TypedSymbol, Field and jit module)
- new datatype class is based on numpy types with additional specifier information (const and restrict)
- translation between data type class and other modules (numpy, ctypes)

Michael Kuron authored 8 years ago and Martin Bauer committed 8 years ago

This commit makes the Python code backwards compatible down to Python 2.7. Previously it would only run on Python 3.5 and up.

Problems fixed included:
- `time.perf_counter()` doesn't exist
- all classes need to be new-style
- `functools.lru_cache` doesn't exist
- only the last argument to a function call can be `*`-expanded
- the `nonlocal` keyword doesn't exist
- metaclasses are used with a different syntax
- `yield from` doesn't exist
- `tempdir.TemporaryDirectory` doesn't exist
- iterators need a `next()` method

- check that fixed size kernels are called with arrays of the correct size
- checks that layout of compilation matches runtime layout
- not allowed any more to mix fixed & and variable sized fields in a kernel

- version with weights in the entropy denominator

and not as a string.
Changed name of the file TypedSymbol to types.
Fixed usage of dtype accordingly, however i might not have found every
usage of dtype.