diff --git a/CHANGELOG.md b/CHANGELOG.md index be321d29cef3b8450488352a44e17f9d2a60b6c1..b3af79ac6824d400956ad777d0869b8039c28692 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,8 @@ -# Changelog of postpic +Changelog of postpic +==================== -## current master +current master +-------------- **Highlights** @@ -30,7 +32,9 @@ field[:, KeepDim(0.0), :].shape == (x,1,z) * New convenience method `Field.copy` -## v0.4 +v0.4 +---- + 2019-01-14 **Highlights** @@ -80,12 +84,17 @@ new: `ms = ms.filter('gamma > 2')` * k-space reconstruction from EPOCH dumps has greatly improved accuracy due to a new algorithm correctly incorporating the frequency response of the implicit linear interpolation performed by EPOCH's half-steps * `plotter_matplotlib.plotField` allows to override `aspect` option to `imshow` -## v0.3.1 +v0.3.1 +------ + 2017-10-03 Only internal changes. Versioning is handled by [versioneer](https://github.com/warner/python-versioneer). -## v0.3 + +v0.3 +---- + 2017-09-28 Many improvements in terms of speed and features. Unfortunately some changes are not backwards-compatible to v0.2.3, so you may have to adapt your code to the new interface. For details, see the corresponding section below. @@ -117,9 +126,9 @@ In case you find particle scalar that you use regularly which is not in the list * Lots of fixes +v0.2.3 +------ - -## v0.2.3 2017-02-17 This release brings some bugfixes and various new features. @@ -135,6 +144,7 @@ This release brings some bugfixes and various new features. * Lots of performance improvemts: particle data will be much less copied in memory now. -## v0.2.2 and earlier +v0.2.2 and earlier +------------------ There hasnt been any changelog. Dont use those versions anymore. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 9acb994e6c6e0651aee6478ee2a6f5948a61f148..5a9d1192bfedcb987d94bc4ca99933171ec1cfe6 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -19,7 +19,8 @@ For any coding you need to be familiar with [git](http://git-scm.com/). Its a di One of the most comprehensive guides is probably [this book](http://git-scm.com/doc). Just start reading from the beginning. It is worth it! -## The Workflow +The Workflow +------------ Adding a feature is often triggered by the personal demand for it. Thats why production ready features should propagte to master as fast as possible. Everything on master is considered to be production ready. We follow the [github-flow](http://scottchacon.com/2011/08/31/github-flow.html) describing this very nicely. @@ -44,15 +45,17 @@ In short: * ensure early feedback on your work -## Coding and general remaks +Coding and general remaks +------------------------- - * Make sure, that the `run-tests.py` script exits without error on EVERY commit. To do so, it is HIGHLY RECOMMENDED to add the `pre-commit` script as the git pre-commit hook. For instructions see [pre-commit](../master/pre-commit). + * Make sure, that the `run-tests.py` script exits without error on EVERY commit. To do so, it is HIGHLY RECOMMENDED to add the `pre-commit` script as the git pre-commit hook. For instructions see [pre-commit](../master/pre-commit). * The Coding style is according to slightly simplified pep8 rules. This is included in the `run-tests.py` script. If that script runs without error, you should be good to <del>go</del> commit. * Add the GPLv3+ licence notice on top of every new file. If you add a new file you are free to add your name as a author. This will let other people know that you are in charge if there is any trouble with the code. This is only useful if the file you provide adds functionality like a new datareader. Thats why the `__init__.py` files typically do not have a name written. In doubt, the git revision history will always show who added which line. +What to contribute? +------------------- -## What to contribute? Here is a list for your inspiration: diff --git a/doc/source/apidoc/postpic.datareader.rst b/doc/source/apidoc/postpic.datareader.rst index 7ef889edc916994d5ac5bf82ec49aa21f84452ba..623717e4713a33c7c6d53d595f65bb6a0ffcf1f9 100644 --- a/doc/source/apidoc/postpic.datareader.rst +++ b/doc/source/apidoc/postpic.datareader.rst @@ -1,52 +1,50 @@ -postpic\.datareader package -=========================== +postpic.datareader package +========================== .. automodule:: postpic.datareader - :members: - :undoc-members: - :show-inheritance: + :members: + :undoc-members: + :show-inheritance: Submodules ---------- -postpic\.datareader\.datareader module --------------------------------------- +postpic.datareader.datareader module +------------------------------------ .. automodule:: postpic.datareader.datareader - :members: - :undoc-members: - :show-inheritance: + :members: + :undoc-members: + :show-inheritance: -postpic\.datareader\.dummy module ---------------------------------- +postpic.datareader.dummy module +------------------------------- .. automodule:: postpic.datareader.dummy - :members: - :undoc-members: - :show-inheritance: + :members: + :undoc-members: + :show-inheritance: -postpic\.datareader\.epochsdf module ------------------------------------- +postpic.datareader.epochsdf module +---------------------------------- .. automodule:: postpic.datareader.epochsdf - :members: - :undoc-members: - :show-inheritance: + :members: + :undoc-members: + :show-inheritance: -postpic\.datareader\.openPMDh5 module -------------------------------------- +postpic.datareader.openPMDh5 module +----------------------------------- .. automodule:: postpic.datareader.openPMDh5 - :members: - :undoc-members: - :show-inheritance: + :members: + :undoc-members: + :show-inheritance: -postpic\.datareader\.vsimhdf5 module ------------------------------------- +postpic.datareader.vsimhdf5 module +---------------------------------- .. automodule:: postpic.datareader.vsimhdf5 - :members: - :undoc-members: - :show-inheritance: - - + :members: + :undoc-members: + :show-inheritance: diff --git a/doc/source/apidoc/postpic.io.rst b/doc/source/apidoc/postpic.io.rst index 74903397c474c3d8266dfbb2cb974fdaeccedf57..b35ca05ee6cc3c4e0afd71939a18f9788e6c8121 100644 --- a/doc/source/apidoc/postpic.io.rst +++ b/doc/source/apidoc/postpic.io.rst @@ -1,44 +1,50 @@ -postpic\.io package -=================== +postpic.io package +================== .. automodule:: postpic.io - :members: - :undoc-members: - :show-inheritance: + :members: + :undoc-members: + :show-inheritance: Submodules ---------- -postpic\.io\.common module --------------------------- +postpic.io.common module +------------------------ .. automodule:: postpic.io.common - :members: - :undoc-members: - :show-inheritance: + :members: + :undoc-members: + :show-inheritance: -postpic\.io\.csv module ------------------------ +postpic.io.csv module +--------------------- .. automodule:: postpic.io.csv - :members: - :undoc-members: - :show-inheritance: + :members: + :undoc-members: + :show-inheritance: -postpic\.io\.npy module +postpic.io.image module ----------------------- -.. automodule:: postpic.io.npy - :members: - :undoc-members: - :show-inheritance: +.. automodule:: postpic.io.image + :members: + :undoc-members: + :show-inheritance: -postpic\.io\.vtk module ------------------------ +postpic.io.npy module +--------------------- -.. automodule:: postpic.io.vtk - :members: - :undoc-members: - :show-inheritance: +.. automodule:: postpic.io.npy + :members: + :undoc-members: + :show-inheritance: +postpic.io.vtk module +--------------------- +.. automodule:: postpic.io.vtk + :members: + :undoc-members: + :show-inheritance: diff --git a/doc/source/apidoc/postpic.particles.rst b/doc/source/apidoc/postpic.particles.rst index 7bda0e7463544b131d7c4b77ad81c4dbb5f8af0e..19f0c3280cde48a501965ff38d97d82628b91d15 100644 --- a/doc/source/apidoc/postpic.particles.rst +++ b/doc/source/apidoc/postpic.particles.rst @@ -1,28 +1,26 @@ -postpic\.particles package -========================== +postpic.particles package +========================= .. automodule:: postpic.particles - :members: - :undoc-members: - :show-inheritance: + :members: + :undoc-members: + :show-inheritance: Submodules ---------- -postpic\.particles\.particles module ------------------------------------- +postpic.particles.particles module +---------------------------------- .. automodule:: postpic.particles.particles - :members: - :undoc-members: - :show-inheritance: + :members: + :undoc-members: + :show-inheritance: -postpic\.particles\.scalarproperties module -------------------------------------------- +postpic.particles.scalarproperties module +----------------------------------------- .. automodule:: postpic.particles.scalarproperties - :members: - :undoc-members: - :show-inheritance: - - + :members: + :undoc-members: + :show-inheritance: diff --git a/doc/source/apidoc/postpic.plotting.rst b/doc/source/apidoc/postpic.plotting.rst index 200f3ffb5447faa7d2b8d4251a63635303289b9e..a8246c9ed3048f8dc8a1669ae3e246380be612dc 100644 --- a/doc/source/apidoc/postpic.plotting.rst +++ b/doc/source/apidoc/postpic.plotting.rst @@ -1,20 +1,18 @@ -postpic\.plotting package -========================= +postpic.plotting package +======================== .. automodule:: postpic.plotting - :members: - :undoc-members: - :show-inheritance: + :members: + :undoc-members: + :show-inheritance: Submodules ---------- -postpic\.plotting\.plotter\_matplotlib module ---------------------------------------------- +postpic.plotting.plotter\_matplotlib module +------------------------------------------- .. automodule:: postpic.plotting.plotter_matplotlib - :members: - :undoc-members: - :show-inheritance: - - + :members: + :undoc-members: + :show-inheritance: diff --git a/doc/source/apidoc/postpic.rst b/doc/source/apidoc/postpic.rst index b663b18a6750c64cacfe5299255ebaa6d6b7fcdc..46c4386dbd3002423d7a3064ffeac92c5196ea59 100644 --- a/doc/source/apidoc/postpic.rst +++ b/doc/source/apidoc/postpic.rst @@ -2,45 +2,52 @@ postpic package =============== .. automodule:: postpic - :members: - :undoc-members: - :show-inheritance: + :members: + :undoc-members: + :show-inheritance: Subpackages ----------- .. toctree:: + :maxdepth: 4 - postpic.datareader - postpic.io - postpic.particles - postpic.plotting + postpic.datareader + postpic.io + postpic.particles + postpic.plotting Submodules ---------- -postpic\.datahandling module ----------------------------- +postpic.datahandling module +--------------------------- .. automodule:: postpic.datahandling - :members: - :undoc-members: - :show-inheritance: + :members: + :undoc-members: + :show-inheritance: -postpic\.experimental module ----------------------------- +postpic.experimental module +--------------------------- .. automodule:: postpic.experimental - :members: - :undoc-members: - :show-inheritance: + :members: + :undoc-members: + :show-inheritance: -postpic\.helper module ----------------------- +postpic.helper module +--------------------- .. automodule:: postpic.helper - :members: - :undoc-members: - :show-inheritance: + :members: + :undoc-members: + :show-inheritance: +postpic.helper\_fft module +-------------------------- +.. automodule:: postpic.helper_fft + :members: + :undoc-members: + :show-inheritance: