Installation
Install by using
pip install aptrajectories
Example
For usage, see the example Notebook notebook.
Theory
$Robin-Rolland^{[1]}$ type simulations for APT trajectories.
Consider a perfect conductor isolated in space brought to electric potential $V_{a}$, as shown above.
$V_{p}$ be the electrostatic potential at point P on the surface. Coloumb's law makes it possible to write this potential from the distribution of charges in space (on the surface in this case):
$$V_{p} = \frac{1}{4\pi\varepsilon_{o}}\iint_{S^\prime}\frac{\sigma(P^\prime)}{|\vec{u}|},dS^\prime$$ $$ \vec{u} = \vec{P^{\prime}P}$$
When the point P is displaced infinitesimally displace along the unit surface normal $\vec{n_{P}}$, the variation in the potential $V_{P}$ is given by $$\frac{\partial{V_{P}}}{\partial{n_{P}}} = \frac{1}{4\pi\varepsilon_{o}}\iint_{S^\prime}\frac{\partial(1/|\vec{u}|)}{\partial{n_{P}}}\sigma(P^{\prime}),dS^\prime$$
$$\frac{\partial{1/|\vec{u}|}}{\partial{n_{P}}} = -\frac{1}{|\vec{u}|^2}\frac{\partial{|\vec{u}|}}{\partial{n_{P}}} = -\frac{\cos(\theta)}{|\vec{u}|^2} = -\frac{\vec{n_{P}}\cdot\vec{u}}{|\vec{u}|^3}$$
where, $\theta$ is the angle between vectors $\vec{n_{P}}$ and $\vec{u}$. Then:
$$\frac{\partial{V_{P}}}{\partial{n_{P}}} = -\frac{1}{4\pi\varepsilon_{o}}\iint_{S^\prime}\frac{\vec{n_{P}}\cdot\vec{u}}{|\vec{u}|^3}\sigma(P^{\prime}),dS^\prime$$
The surface electric field at point P is given by definition:
$$\vec{F_{P}} = -\vec{\nabla}({V_{p}}) = -\frac{\partial{V_{P}}}{\partial{n_{P}}}\vec{n_{P}}$$
The theory of electrostatics directly relates this field for the conductors to their charge surface density.
$$|\vec{F_{P}}| = \frac{\sigma({P^\prime})}{2 \varepsilon_{o}}$$
Combining the above two equations gives: $$\sigma(P) = \frac{1}{2\pi} \iint_{S^\prime}\frac{\vec{n_{P}}\cdot\vec{u}}{|\vec{u}|^3}\sigma(P^{\prime}),dS^\prime - (1)$$
The above integral equation called Robin's equation, connects the surface density of charges at a point on the surface to the distribution of the charge density on the rest of the surface of the conductor. It is possible to solve iteratively by introducing a series of functions $f_{n}$ defined by:
$$f_{n+1}(P) = \frac{1}{2\pi} \iint_{S^\prime}\frac{\vec{n_{P}}\cdot\vec{u}}{|\vec{u}|^3}f_{n}(P^{\prime}),dS^\prime$$
with $f_{o}$ as any function defined on a convex surface, Robin showed that this would converge to equation (1).
We consider surface as a series of fractional point charges ${q_{i}}{i=1,2,...,N}$ placed on each surface atom over a small surface $s{at}$ .
The electrostatic equilibrium of the conductor can then be described by a local Robin equation as given in equation (1):
$$\frac{q_{i}}{s_{at}} = \frac{1}{2\pi} \sum_{k=1,k\neq i}^{N} q_{k}\frac{\vec{n_i}\cdot\vec{r_{i,k}}}{|\vec{r_{i,k}}|^3}$$
For a point M infinitesimally close to point i, but inside the conductor. The field generated is given by the right-hand side of the above equation pointing outward, whereas the field induced by the atom i points inward, thereby canceling each other out.
Now a sequence of charges is introdued $q_{i,n}$ on atom i, as follows: $$\frac{q_{i,n+1}}{s_{at}} = \frac{1}{2\pi} \sum_{k=1,k\neq i}^{N} q_{k,n}\frac{\vec{n_i}\cdot\vec{r_{i,k}}}{|\vec{r_{i,k}}|^3}$$
where $q_{i,0}$ being an arbitary real positive number. the unit vector for $i^{th}$ atom depends on the theoretical P nearest neighbors:
$$\vec{n_{i}} = -\frac{\sum_{j=1}^{P}\delta {j} \vec{r{ji}}}{|\sum_{j=1}^{P}\delta {j} \vec{r{ji}}|}$$
Reference
[1] Rolland, N., Vurpillot, F., Duguay, S., & Blavette, D. (2015). A Meshless Algorithm to Model Field Evaporation in Atom Probe Tomography. Microscopy and Microanalysis, 21(6). https://doi.org/10.1017/S1431927615015184
Metadata
Release files for aptrajectories 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| aptrajectories-0.1.1.tar.gz | 15.8 kB | Without provenance | Details for aptrajectories-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| aptrajectories-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for aptrajectories-0.1.1-py3-none-any.whl |
Total release size: 31.8 kB
Release files / aptrajectories-0.1.1.tar.gz
| Download URL | aptrajectories-0.1.1.tar.gz |
|---|---|
| Size | 15.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1353fc1d2cbdc082497cba0692fcfc54e75cc0cb66e9cb31b0e349f2f8f6978f
|
|
BLAKE2b-256 checksum How to use checksums |
0da8fe7585cfdae342a25102003d36272d3ccc9f3ed561467a7f369aabf5d4b9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.8.0 CPython/3.11.8 Darwin/23.3.0
|
Release files / aptrajectories-0.1.1-py3-none-any.whl
| Download URL | aptrajectories-0.1.1-py3-none-any.whl |
|---|---|
| Size | 16.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ad114b6d4e428657308ade1c42aaa6d31af8f736ab0a746431f50f39181fe816
|
|
BLAKE2b-256 checksum How to use checksums |
ae3c785e9152115209146f837a672375f4a03082578ceaa23fad6e1f59333890
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.8.0 CPython/3.11.8 Darwin/23.3.0
|
Security for aptrajectories 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.