https://github.com/killiansheriff/warrencowleyparameters
OVITO Python modifier to compute the Warren-Cowley parameters.
Science Score: 36.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
○.zenodo.json file
-
✓DOI references
Found 2 DOI reference(s) in README -
○Academic publication links
-
✓Committers with academic emails
1 of 2 committers (50.0%) from academic institutions -
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (13.2%) to scientific vocabulary
Keywords
Repository
OVITO Python modifier to compute the Warren-Cowley parameters.
Basic Info
Statistics
- Stars: 29
- Watchers: 2
- Forks: 9
- Open Issues: 0
- Releases: 8
Topics
Metadata Files
README.md
WarrenCowleyParameters
OVITO Python modifier to compute the Warren-Cowley parameters, defined as:
$$\alpha{ij}^m = 1-\frac{p{ij}^m}{c_j},$$
where $m$ denotes the $m$-th nearest-neighbor shell, $p{ij}^m$ is the average probability of finding a $j$-type atom around an $i$-type atom in the $m$-th shell, and $cj$ is the average concentration of $j$-type atom in the system. A negative $\alpha_{ij}^m$ suggests the tendency of $j$-type clustering in the $m$-th shell of an $i$-type atom, while a positive value means repulsion.
Utilisation
Here is an example of how to compute the 1st and 2nd nearest neighbor shell Warren-Cowley parameters of the fcc.dump dump file. Note that in the fcc crystal structure, the 1st nearest neighbor shell has 12 atoms, while the second one has 6 atoms.
```python from ovito.io import import_file import WarrenCowleyParameters as wc
pipeline = importfile("fcc.dump") mod = wc.WarrenCowleyParameters(nneigh=[0, 12, 18], onlyselected=False) pipeline.modifiers.append(mod) data = pipeline.compute()
wcforshells = data.attributes["Warren-Cowley parameters"] print(f"1NN Warren-Cowley parameters: \n {wcforshells[0]}") print(f"2NN Warren-Cowley parameters: \n {wcforshells[1]}")
Alternatively, can see it as a dictionarry
print(data.attributes["Warren-Cowley parameters by particle name"])
The per-particle Warren-Cowley parameter are accessible as well
print("Per-particle 1NN Warren-Cowley parameters:\n", data.particles["Warren-Cowley parameter (shell=1)"][...]) print("Per-particle 2NN Warren-Cowley parameters:\n", data.particles["Warren-Cowley parameter (shell=2)"][...])
`
Example scripts can be found in theexamples/`` folder.

Installation
For a standalone Python package or Conda environment, please use:
bash
pip install --user WarrenCowleyParameters
For OVITO PRO built-in Python interpreter, please use:
bash
ovitos -m pip install --user WarrenCowleyParameters
If you want to install the lastest git commit, please replace WarrenCowleyParameters by git+https://github.com/killiansheriff/WarrenCowleyParameters.git.
Contact
If any questions, feel free to contact me (ksheriff at mit dot edu).
References & Citing
If you use this repository in your work, please cite:
@article{sheriffquantifying2024,
title = {Quantifying chemical short-range order in metallic alloys},
doi = {10.1073/pnas.2322962121},
journaltitle = {Proceedings of the National Academy of Sciences},
author = {Sheriff, Killian and Cao, Yifan and Smidt, Tess and Freitas, Rodrigo},
date = {2024-06-18},
}
and
@article{sheriff2024chemicalmotif,
title = {Chemical-motif characterization of short-range order with E(3)-equivariant graph neural networks},
DOI = {10.1038/s41524-024-01393-5},
journal = {npj Computational Materials},
author = {Sheriff, Killian and Cao, Yifan and Freitas, Rodrigo},
year = {2024},
month = sep,
}
Owner
- Name: Killian Sheriff
- Login: killiansheriff
- Kind: user
- Location: Cambridge, MA
- Company: MIT
- Twitter: KillianSheriff
- Repositories: 2
- Profile: https://github.com/killiansheriff
@MIT DMSE Ph.D. Student | @McGillUPhysics graduate | Doing Materials Science + AI research to better understand high-entropy alloys.
GitHub Events
Total
- Create event: 3
- Issues event: 2
- Release event: 5
- Watch event: 9
- Issue comment event: 7
- Push event: 7
- Pull request review event: 2
- Pull request event: 2
- Fork event: 3
Last Year
- Create event: 3
- Issues event: 2
- Release event: 5
- Watch event: 9
- Issue comment event: 7
- Push event: 7
- Pull request review event: 2
- Pull request event: 2
- Fork event: 3
Committers
Last synced: over 1 year ago
Top Committers
| Name | Commits | |
|---|---|---|
| Killian Sheriff | k****f@m****u | 81 |
| Daniel Utt | u****t@o****g | 6 |
Issues and Pull Requests
Last synced: 12 months ago
All Time
- Total issues: 2
- Total pull requests: 2
- Average time to close issues: 7 months
- Average time to close pull requests: about 3 hours
- Total issue authors: 2
- Total pull request authors: 1
- Average comments per issue: 4.0
- Average comments per pull request: 0.5
- Merged pull requests: 2
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 1
- Pull requests: 1
- Average time to close issues: about 2 hours
- Average time to close pull requests: about 4 hours
- Issue authors: 1
- Pull request authors: 1
- Average comments per issue: 3.0
- Average comments per pull request: 1.0
- Merged pull requests: 1
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- lichao505917586 (1)
- spriti523 (1)
Pull Request Authors
- nnn911 (3)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 96 last-month
- Total dependent packages: 0
- Total dependent repositories: 0
- Total versions: 10
- Total maintainers: 1
pypi.org: warrencowleyparameters
OVITO Python modifier to compute Warren-Cowley parameters.
- Documentation: https://warrencowleyparameters.readthedocs.io/
- License: MIT License
-
Latest release: 3.0.1
published about 1 year ago
Rankings
Maintainers (1)
Dependencies
- actions/checkout v2 composite
- rickstaa/action-black v1 composite
- numpy >= 1.22
- ovito >= 3.9.0.dev35
- actions/checkout v3 composite
- actions/setup-python v3 composite
- pypa/gh-action-pypi-publish 27b31702a0e7fc50959f5ad993c78deac1bdfc29 composite
- actions/checkout v3 composite
- actions/setup-python v4 composite