PoreMatMod

a find-and-replace tool for crystal structure models. implements (i) subgraph matching and (ii) point set alignment to search a parent crystal for a query fragment, then align and install a replacement fragment in its place.

https://github.com/simonensemble/porematmod.jl

Science Score: 64.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
  • DOI references
    Found 4 DOI reference(s) in README
  • Academic publication links
    Links to: acs.org
  • Committers with academic emails
    3 of 5 committers (60.0%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (6.5%) to scientific vocabulary
Last synced: 10 months ago · JSON representation ·

Repository

a find-and-replace tool for crystal structure models. implements (i) subgraph matching and (ii) point set alignment to search a parent crystal for a query fragment, then align and install a replacement fragment in its place.

Basic Info
  • Host: GitHub
  • Owner: SimonEnsemble
  • License: mit
  • Language: Julia
  • Default Branch: master
  • Homepage:
  • Size: 97.9 MB
Statistics
  • Stars: 18
  • Watchers: 2
  • Forks: 2
  • Open Issues: 16
  • Releases: 24
Created over 6 years ago · Last pushed almost 2 years ago
Metadata Files
Readme Contributing License Citation

README.md

logo.JPG

PoreMatMod.jl is a Julia package for (i) subgraph matching and (ii) modifying crystal structures such as metal-organic frameworks (MOFs).

Functioning as a "find-and-replace" tool on atomistic crystal structure models of porous materials, PoreMatMod.jl is useful for:

:hammer: subgraph matching to filter databases of crystal structures

:hammer: constructing hypothetical crystal structure models of functionalized structures

:hammer: introducing defects into crystal structures

:hammer: repairing artifacts of X-ray structure determination, such as missing hydrogen atoms, disorder, and guest molecules

N.b. while PoreMatMod.jl was developed for MOFs and other porous crystalline materials, its find-and-replace operations can be applied to discrete, molecular structures as well by assigning an arbitrary unit cell.

| Documentation | Build Status | Test Coverage | |:------------------------------------------------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:| | Docs Badge | CI Docs weekly | codecov Aqua QA |

Installation

PoreMatMod.jl is a registered Julia package and can be installed by entering the following line in the Julia REPL when in package mode (type ] to enter package mode):

pkg> add PoreMatMod

Gallery of examples

Link to examples here with raw Pluto notebooks here.

Citing

If you found PoreMatMod.jl useful, please cite our paper in J. Chem. Inf. Model. (ACS Editors' Choice) here [preprint here]. :point_down:

latex @article{Henle2022, doi = {10.1021/acs.jcim.1c01219}, url = {https://doi.org/10.1021/acs.jcim.1c01219}, year = {2022}, month = jan, publisher = {American Chemical Society ({ACS})}, volume = {62}, number = {3}, pages = {423--432}, author = {E. Adrian Henle and Nickolas Gantzler and Praveen K. Thallapally and Xiaoli Z. Fern and Cory M. Simon}, title = {{PoreMatMod}.jl: Julia Package for in Silico Postsynthetic Modification of Crystal Structure Models}, journal = {Journal of Chemical Information and Modeling} }

Contributing

We encourage feature requests and feedback on GitHub.

Owner

  • Name: Cory Simon
  • Login: SimonEnsemble
  • Kind: user

Assistant Professor of Chemical Engineering, Oregon State University

Citation (CITATION)

@article{Henle2022,
  doi = {10.1021/acs.jcim.1c01219},
  url = {https://doi.org/10.1021/acs.jcim.1c01219},
  year = {2022},
  month = jan,
  publisher = {American Chemical Society ({ACS})},
  volume = {62},
  number = {3},
  pages = {423--432},
  author = {E. Adrian Henle and Nickolas Gantzler and Praveen K. Thallapally and Xiaoli Z. Fern and Cory M. Simon},
  title = {{PoreMatMod}.jl: Julia Package for in Silico Postsynthetic Modification of Crystal Structure Models},
  journal = {Journal of Chemical Information and Modeling}
}

GitHub Events

Total
Last Year

Committers

Last synced: over 3 years ago

All Time
  • Total Commits: 466
  • Total Committers: 5
  • Avg Commits per committer: 93.2
  • Development Distribution Score (DDS): 0.075
Top Committers
Name Email Commits
eahenle e****e@g****m 431
Cory Simon c****n@o****u 19
Nickolas Gantzler n****r@g****m 11
CorySimon c****n@b****u 4
CorySimon C****n@b****u 1
Committer Domains (Top 20 + Academic)

Packages

  • Total packages: 1
  • Total downloads: unknown
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 25
juliahub.com: PoreMatMod

a find-and-replace tool for crystal structure models. implements (i) subgraph matching and (ii) point set alignment to search a parent crystal for a query fragment, then align and install a replacement fragment in its place.

  • Versions: 25
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 9.9%
Forks count: 28.1%
Average: 28.1%
Stargazers count: 35.6%
Dependent packages count: 38.9%
Last synced: 10 months ago

Dependencies

.github/workflows/CI_build.yml actions
  • actions/checkout master composite
  • actions/checkout v2 composite
  • codecov/codecov-action v2 composite
  • julia-actions/julia-buildpkg latest composite
  • julia-actions/julia-processcoverage v1 composite
  • julia-actions/setup-julia latest composite
.github/workflows/TagBot.yml actions
  • JuliaRegistries/TagBot v1 composite
.github/workflows/doc_deployment.yml actions
  • actions/checkout master composite
  • julia-actions/julia-buildpkg latest composite
  • julia-actions/setup-julia latest composite
.github/workflows/formatter.yml actions
  • actions/checkout main composite
  • julia-actions/setup-julia latest composite
  • mdecoleman/pr-branch-name 1.2.0 composite
  • peter-evans/create-pull-request v4 composite
  • thollander/actions-comment-pull-request v1 composite
.github/workflows/weekly.yml actions
  • actions/checkout master composite
  • julia-actions/julia-buildpkg latest composite
  • julia-actions/setup-julia latest composite