devito Devito compiler tutorials

Devito compiler tutorials

Open jkwashbourne opened this issue 4 years ago • 1 comments

[x] Where to find descriptions of operator options like dle='noop'
[ ] Could the generated code have a comment at the top of the structs to define what the members are (size, npsize, dsize, hsize, hofs, oofs). Yeah, I know it isn't really for human reading ... I suppose I would see those used once dle/mpi does something.
[ ] Suggest removing the deprecated padding stuff
[ ] Suggest adding the same disclaimer about dle='noop' as in 02_indexification.ipynb: ... we disable all performance-related optimizations, to maximize the simplicity of the ... generated code.

[ ] What happens when save is an integer less than the total times asked for in a computation?
[ ] It is unclear what trying to do with cells 9,10. Suggest using "!=" and evaluating to true instead.

[ ] The use of indexify in cell 2 is a tiny bit confusing, as I was looking carefully at that list. Is this only to generate [] instead of ()? Suggest removing. I suppose that cell is just a demonstration so it doesn't really matter.
[ ] I would like more clarification for DummyEq: "An IET Expression wraps a SymPy equation. Below, DummyEq is a subclass of sympy.Eq with some metadata attached.", suggest adding "with no iteration or data", and possibly describing a use case for DummyEq. I think when you add/use a class it it worth a description of what/how.

[ ] In the API docs, could you generate a (re-usable) section on the options available to the staggered keyword, and add to the various Function derived classes
[ ] Publish the OPT tutorials

[ ] We need a notebook describing "clustering" and in particular how a list of Eqs -- the input to an Operator -- gets lowered into a series of loops, which lies at the heart of the Devito compiler