You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -25,7 +26,7 @@ The standard way of installing `ppafm` is:
25
26
pip install ppafm
26
27
```
27
28
28
-
This should install the package and all its dependencies.
29
+
This should install the package and all its dependencies including **CPU** and **GPU** version and fully working CLI:
29
30
30
31
The most up-to-date installation guide can be found on the [dedicated wiki page](https://github.com/Probe-Particle/ppafm/wiki/Install-ppafm).
31
32
@@ -73,46 +74,11 @@ Currently, modification of estimate geometry is random (Monte-Carlo), while late
73
74
*`examples/Generator` quickly generates a batch of simulated AFM images (resp. 3D data stacks) which can be further used for machine learning.
74
75
Especially in connection with (https://github.com/SINGROUP/ASD-AFM).
75
76
76
-
## ppafm simulation models and implementations
77
-
78
-
Since 2014 ppafm developed into the toolbox of various methodologies adjusted for a particular use case.
79
-
80
-
1.**CPU version:** - Original implementation using Python & C/C++.
81
-
It can simulate a typical AFM experiment (3D stack of AFM images) in a matter of a few minutes.
82
-
It is the base version for the development of new features and methodology.
83
-
All available simulation models are implemented in this version, including:
84
-
1.**Point charge electrostatics + Lennard-Jones:** Original fully classical implementation allows the user to set up calculation without any ab initio input by specifying atomic positions, types and (optionally) charges.
85
-
1.**Hartree-potential electrostatics + Lennard-Jones:** Electrostatics is considerably improved by using Hartree potential from DFT calculation and using the Quadrupole model for CO-tip.
86
-
We found this crucial to properly simulate polar molecules (e.g. H2O clusters, carboxylic acids, PTCDA) which exhibit strong electrostatic distortions of AFM images.
87
-
1.**Hartree-potential electrostatics + Density overlap:** Further accuracy improvement is achieved when Pauli repulsion between electron shells of atoms is modelled by the overlap between electron density of tip and sample.
88
-
This repulsive term replaces the repulsive part of Lennard-Jones while the attractive part (C6) remains.
89
-
This modification considerably improves especially the simulation of molecules with electron pairs (-NH-, -OH, =O group), triple bonds and other strongly concentrated electrons.
90
-
1.**GPU version:** - Version specially designed for the generation of training data for machine learning.
91
-
Implementation using `pyOpenCL` can parallelize the evaluation of forcefield and relaxation of probe-particle positions over hundreds or thousands of stream processors of the graphical accelerator.
92
-
The further speed-up is achieved by using hardware-accelerated trilinear interpolation of 3D textures available in most GPUs.
93
-
This allows simulating 10-100 AFM experiments per second on consumer-grade desktop GPU.
94
-
_GPU version is designed to work in collaboration with machine-learning software for AFM (https://github.com/SINGROUP/ASD-AFM) and use various generators of molecular geometry._
95
-
1.**GUI @ GPU** - The speed of GPU implementation enables interactive GUI where AFM images of molecules can be updated on the fly (<<0.1s) on a common laptop computer, while the user is editing molecular geometry or parameters of the tip.
96
-
This provides an invaluable tool, especially for experimentalists trying to identify and interpret the structure and configuration of molecules in experiments on the fly while running the experiment.
97
-
98
-
## Other branches
99
-
100
-
***master_backup** is the old `master` branch that was recently significantly updated and named `main`.
101
-
For users who miss the old master branch, we provided a backup copy.
102
-
However, this version is very old and its use is discouraged.
103
-
***PhotonMap** implements the latest developments concerning sub-molecular scanning probes combined with Raman spectroscopy (TERS) and fluorescent spectroscopy (LSTM).
104
-
***complex_tip** is a modification of the Probe-Particle Model with 2 particles that allows a better fit to experimental results at the cost of additional fitting parameters.
105
-
106
-
107
77
## For contributors
108
78
If you miss some functionality or have discovered issues with the latest release - let us know by creating [an issue](https://github.com/Probe-Particle/ppafm/issues/new).
109
79
If you would like to contribute to the development of the ppafm code, please read the [Developer's Guide](https://github.com/Probe-Particle/ppafm/wiki/For-Developers) wiki page.
110
80
Small improvements in the documentation or minor bug fixes are always welcome.
0 commit comments