simcert 1.7.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- simcert-1.7.0/LICENSE +21 -0
- simcert-1.7.0/PKG-INFO +166 -0
- simcert-1.7.0/README.md +115 -0
- simcert-1.7.0/pyproject.toml +90 -0
- simcert-1.7.0/setup.cfg +4 -0
- simcert-1.7.0/simcert/__init__.py +26 -0
- simcert-1.7.0/simcert/cli.py +344 -0
- simcert-1.7.0/simcert/meta_report.py +420 -0
- simcert-1.7.0/simcert/orchestrator.py +275 -0
- simcert-1.7.0/simcert.egg-info/PKG-INFO +166 -0
- simcert-1.7.0/simcert.egg-info/SOURCES.txt +16 -0
- simcert-1.7.0/simcert.egg-info/dependency_links.txt +1 -0
- simcert-1.7.0/simcert.egg-info/entry_points.txt +2 -0
- simcert-1.7.0/simcert.egg-info/requires.txt +23 -0
- simcert-1.7.0/simcert.egg-info/top_level.txt +1 -0
- simcert-1.7.0/tests/test_cli.py +18 -0
- simcert-1.7.0/tests/test_meta_report.py +188 -0
- simcert-1.7.0/tests/test_orchestrator.py +75 -0
simcert-1.7.0/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Andre Monreal-Hernández
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
simcert-1.7.0/PKG-INFO
ADDED
|
@@ -0,0 +1,166 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: simcert
|
|
3
|
+
Version: 1.7.0
|
|
4
|
+
Summary: Unified Quality-Control, Structure Validation, and Reproducibility Meta-Framework for Molecular Simulations & AI Models (MD, Docking, QM, Adsorption, AlphaFold, FEP, QSAR, Catalysis, NEB/Kinetics, Spectroscopy/DOS)
|
|
5
|
+
Author-email: Andrés Monreal-Hernández <andres.monreal@ues.mx>
|
|
6
|
+
License-Expression: MIT
|
|
7
|
+
Project-URL: Homepage, https://github.com/sircalch/simcert
|
|
8
|
+
Project-URL: Documentation, https://github.com/sircalch/simcert#readme
|
|
9
|
+
Project-URL: Repository, https://github.com/sircalch/simcert.git
|
|
10
|
+
Project-URL: Bug Tracker, https://github.com/sircalch/simcert/issues
|
|
11
|
+
Project-URL: Changelog, https://github.com/sircalch/simcert/blob/main/CHANGELOG.md
|
|
12
|
+
Keywords: molecular-dynamics,molecular-docking,quantum-chemistry,adsorption,alphafold,free-energy-perturbation,fep,qsar,heterogeneous-catalysis,nudged-elastic-band,chemical-kinetics,spectroscopy,td-dft,uv-vis,infrared-spectroscopy,d-band-center,simulation-quality-control,reproducibility,gromacs,orca,vasp,gaussian
|
|
13
|
+
Classifier: Development Status :: 5 - Production/Stable
|
|
14
|
+
Classifier: Intended Audience :: Science/Research
|
|
15
|
+
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
|
|
16
|
+
Classifier: Topic :: Scientific/Engineering :: Chemistry
|
|
17
|
+
Classifier: Topic :: Scientific/Engineering :: Physics
|
|
18
|
+
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
19
|
+
Classifier: Programming Language :: Python :: 3
|
|
20
|
+
Classifier: Programming Language :: Python :: 3.9
|
|
21
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
22
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
23
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
24
|
+
Classifier: Operating System :: OS Independent
|
|
25
|
+
Requires-Python: >=3.9
|
|
26
|
+
Description-Content-Type: text/markdown
|
|
27
|
+
License-File: LICENSE
|
|
28
|
+
Requires-Dist: mdcheck>=1.1.0
|
|
29
|
+
Requires-Dist: dockcert>=1.1.0
|
|
30
|
+
Requires-Dist: qmcert>=1.2.0
|
|
31
|
+
Requires-Dist: adsorpqc>=1.1.0
|
|
32
|
+
Requires-Dist: alphacert>=1.1.0
|
|
33
|
+
Requires-Dist: fepcert>=1.2.0
|
|
34
|
+
Requires-Dist: qsarcert>=1.2.0
|
|
35
|
+
Requires-Dist: catcert>=1.2.0
|
|
36
|
+
Requires-Dist: nebcert>=1.2.0
|
|
37
|
+
Requires-Dist: speccert>=1.2.0
|
|
38
|
+
Requires-Dist: numpy>=1.20.0
|
|
39
|
+
Requires-Dist: scipy>=1.7.0
|
|
40
|
+
Requires-Dist: pandas>=1.3.0
|
|
41
|
+
Requires-Dist: matplotlib>=3.5.0
|
|
42
|
+
Requires-Dist: jinja2>=3.0.0
|
|
43
|
+
Provides-Extra: dev
|
|
44
|
+
Requires-Dist: pytest>=7.0.0; extra == "dev"
|
|
45
|
+
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
|
|
46
|
+
Requires-Dist: black>=23.0.0; extra == "dev"
|
|
47
|
+
Requires-Dist: flake8>=6.0.0; extra == "dev"
|
|
48
|
+
Requires-Dist: build>=0.10.0; extra == "dev"
|
|
49
|
+
Requires-Dist: twine>=4.0.0; extra == "dev"
|
|
50
|
+
Dynamic: license-file
|
|
51
|
+
|
|
52
|
+
# SimCert
|
|
53
|
+
|
|
54
|
+
[](https://github.com/sircalch/simcert/actions)
|
|
55
|
+
[](https://pypi.org/project/simcert/)
|
|
56
|
+
[](https://pypi.org/project/simcert/)
|
|
57
|
+
[](https://opensource.org/licenses/MIT)
|
|
58
|
+
[](https://doi.org/10.5281/zenodo.22217591)
|
|
59
|
+
|
|
60
|
+
> **Unified Quality-Control, Structure Validation, and Reproducibility Meta-Framework for Molecular Simulations & AI Models (MD, Docking, QM, Adsorption, AlphaFold, FEP, QSAR, Catalysis, NEB / Kinetics).**
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
## Overview
|
|
65
|
+
|
|
66
|
+
**SimCert** is a high-level scientific umbrella meta-framework that connects, standardizes, and unifies automated quality control, convergence certification, and reproducibility reporting across **ten distinct computational simulation and modeling domains**:
|
|
67
|
+
|
|
68
|
+
```
|
|
69
|
+
┌─────────────────────────────────────────┐
|
|
70
|
+
│ SimCert │
|
|
71
|
+
│ (Umbrella Project Meta-Dashboard) │
|
|
72
|
+
└─────────────────────────────────────────┘
|
|
73
|
+
│
|
|
74
|
+
┌───────────────┬───────────────┬───────────────┬──────────┴────┬───────────────┬───────────────┬───────────────┬───────────────┬───────────────┐
|
|
75
|
+
│ │ │ │ │ │ │ │ │ │
|
|
76
|
+
▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼
|
|
77
|
+
┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐
|
|
78
|
+
│ MDCheck │ │ DockCert │ │ QMCert │ │ AdsorpQC │ │ AlphaCert │ │ FEPCert │ │ QSARCert │ │ CatCert │ │ NEBCert │ │ ... │
|
|
79
|
+
│ Tier 1 │ │ Tier 2 │ │ Tier 3 │ │ Tier 4 │ │ Tier 5 │ │ Tier 6 │ │ Tier 7 │ │ Tier 8 │ │ Tier 9 │ │ │
|
|
80
|
+
│ MD │ │ Docking │ │ DFT │ │ GCMC │ │ AlphaFold │ │ FEP / TI │ │ QSAR / ML │ │ Catalysis │ │ Kinetics │ │ │
|
|
81
|
+
└───────────┘ └───────────┘ └───────────┘ └───────────┘ └───────────┘ └───────────┘ └───────────┘ └───────────┘ └───────────┘ └───────────┘
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
## The 10 Computational Tiers
|
|
87
|
+
|
|
88
|
+
1. **Tier 1: Molecular Dynamics (`mdcheck`)**
|
|
89
|
+
- Autocorrelation time ($\tau_{\text{int}}$), effective sample size ($N_{\text{eff}}$), Chodera automated equilibration ($t_{\text{eq}}$), Geweke diagnostic, linear drift, multi-replica consistency ($R_1, R_2, R_3$).
|
|
90
|
+
2. **Tier 2: Molecular Docking & Screening (`dockcert`)**
|
|
91
|
+
- Exact analytical BEDROC ($\alpha=20.0, 80.5, 160.9$), RIE, EF1%, EF5%, EF10%, ROC-AUC, PR-AUC, optimal MCC, Hungarian algorithm symmetry-corrected heavy-atom RMSD, decoy property matching KS-tests.
|
|
92
|
+
3. **Tier 3: Quantum Chemistry & DFT (`qmcert`)**
|
|
93
|
+
- Stationary point certification (0 imaginary frequencies for minima, exactly 1 for transition states), spin contamination $\langle S^2 \rangle$, Grimme quasi-RRHO harmonic entropy correction for low modes ($\nu < 100\text{ cm}^{-1}$), simulated IR spectra.
|
|
94
|
+
4. **Tier 4: Adsorption in Nanoporous MOFs & GCMC (`adsorpqc`)**
|
|
95
|
+
- GCMC equilibration burn-in detection, loading drift lock, non-linear isotherm model fitting (Langmuir, Dual-site, Sips, Toth, Freundlich, BET), Henry constant $K_H$, isosteric heat $q_{\text{st}}$, IAST binary selectivity with bootstrap confidence intervals.
|
|
96
|
+
5. **Tier 5: AlphaFold / ESMFold Structure Confidence (`alphacert`)**
|
|
97
|
+
- Per-residue pLDDT categorization across 4 canonical bands ($>90, 70-90, 50-70, <50$), 2D Predicted Aligned Error (PAE) matrix domain decomposition, steric clashscore, Ramachandran dihedral distribution ($\phi, \psi$), certifications `DOCKING_READY` and `MD_READY`.
|
|
98
|
+
6. **Tier 6: Alchemical Free Energy & FEP (`fepcert`)**
|
|
99
|
+
- Phase space overlap matrix ($\Pi_{ij} \ge 3\%$), Thermodynamic Integration (TI), Bennett Acceptance Ratio (BAR), forward/reverse time convergence and dissipated work $W_{\text{diss}}$, thermodynamic cycle closure audit ($\oint \Delta\Delta G \approx 0$).
|
|
100
|
+
7. **Tier 7: QSAR & Molecular Machine Learning (`qsarcert`)**
|
|
101
|
+
- OECD Validation Principles, Hat matrix Applicability Domain ($h^* = \frac{3(p+1)}{n}$) and Williams plot, Tropsha-Golbraikh criteria, Y-randomization ($cR^2_p > 0.50$), train/test split leakage detection.
|
|
102
|
+
8. **Tier 8: Heterogeneous Catalysis & Surfaces (`catcert`)**
|
|
103
|
+
- Surface energy ($\gamma$) layer convergence, Fiorentini-Methfessel asymptotic regression, vacuum thickness and potential flatness $\bar{V}(z)$, physical work function ($\Phi$), dipole layer step ($|\Delta \Phi|$), and $E_{\text{ads}}$ dispersion audit.
|
|
104
|
+
9. **Tier 9: Reaction Pathways & NEB Kinetics (`nebcert`)**
|
|
105
|
+
- Nudged Elastic Band (NEB / CI-NEB) cubic spline MEP interpolation, Climbing Image residual force audit ($|F_\parallel| \le 0.05\text{ eV/\AA}$), transition state 1st-order saddle point imaginary frequency verification, Eyring TST rate constants $k(T)$, Arrhenius fitting, and asymmetric Eckart / Wigner quantum tunneling corrections.
|
|
106
|
+
10. **Tier 10: Spectroscopy & Electronic Structure (`speccert`)**
|
|
107
|
+
- TD-DFT UV-Vis, scaled IR/Raman spectra, VASP DOS parsing and d-band-center analysis with provenance-aware reporting.
|
|
108
|
+
|
|
109
|
+
---
|
|
110
|
+
|
|
111
|
+
## Installation
|
|
112
|
+
|
|
113
|
+
> **Note:** PyPI release pending. Until then, install from the tagged GitHub releases (SimCert depends on all ten certifiers):
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
pip install \
|
|
117
|
+
mdcheck==1.1.0 dockcert==1.1.0 qmcert==1.2.0 adsorpqc==1.1.0 \
|
|
118
|
+
alphacert==1.1.0 fepcert==1.2.0 qsarcert==1.2.0 catcert==1.2.0 \
|
|
119
|
+
nebcert==1.2.0 speccert==1.2.0
|
|
120
|
+
pip install "git+https://github.com/sircalch/simcert@v1.7.0"
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
## Quickstart (CLI)
|
|
126
|
+
|
|
127
|
+
```bash
|
|
128
|
+
# 1. Run full 10-tier multi-scale benchmark demonstration
|
|
129
|
+
simcert demo-all -o full_project_audit/
|
|
130
|
+
|
|
131
|
+
# 2. Delegate to any individual tier
|
|
132
|
+
simcert md assess -i trajectory.csv -o md_report/
|
|
133
|
+
simcert dock assess -i scores.csv -o dock_report/
|
|
134
|
+
simcert qm assess -i opt_freq.out -o qm_report/
|
|
135
|
+
simcert adsorp assess -i isotherm.csv -o adsorp_report/
|
|
136
|
+
simcert alpha assess -i model.pdb --pae model_pae.json -o alpha_report/
|
|
137
|
+
simcert fep assess -d gromacs_fep/ -o fep_report/
|
|
138
|
+
simcert qsar assess -i predictions.csv -o qsar_report/
|
|
139
|
+
simcert cat assess --layers-csv pt_layers.csv --area 27.60 -o cat_report/
|
|
140
|
+
simcert neb assess -i neb.dat --frequencies "-1250,150,300" -o neb_report/
|
|
141
|
+
|
|
142
|
+
# 3. View consolidated citations
|
|
143
|
+
simcert cite
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
---
|
|
147
|
+
|
|
148
|
+
## Citation
|
|
149
|
+
|
|
150
|
+
```bibtex
|
|
151
|
+
@software{monreal2026simcert,
|
|
152
|
+
author = {Monreal-Hern{\'a}ndez, Andre},
|
|
153
|
+
title = {{SimCert: A Unified Scientific Simulation Quality-Control and Reproducibility Meta-Framework}},
|
|
154
|
+
year = {2026},
|
|
155
|
+
version = {1.5.0},
|
|
156
|
+
publisher = {Zenodo},
|
|
157
|
+
url = {https://github.com/sircalch/simcert}
|
|
158
|
+
}
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
---
|
|
162
|
+
|
|
163
|
+
## License
|
|
164
|
+
|
|
165
|
+
This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
|
|
166
|
+
|
simcert-1.7.0/README.md
ADDED
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
# SimCert
|
|
2
|
+
|
|
3
|
+
[](https://github.com/sircalch/simcert/actions)
|
|
4
|
+
[](https://pypi.org/project/simcert/)
|
|
5
|
+
[](https://pypi.org/project/simcert/)
|
|
6
|
+
[](https://opensource.org/licenses/MIT)
|
|
7
|
+
[](https://doi.org/10.5281/zenodo.22217591)
|
|
8
|
+
|
|
9
|
+
> **Unified Quality-Control, Structure Validation, and Reproducibility Meta-Framework for Molecular Simulations & AI Models (MD, Docking, QM, Adsorption, AlphaFold, FEP, QSAR, Catalysis, NEB / Kinetics).**
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## Overview
|
|
14
|
+
|
|
15
|
+
**SimCert** is a high-level scientific umbrella meta-framework that connects, standardizes, and unifies automated quality control, convergence certification, and reproducibility reporting across **ten distinct computational simulation and modeling domains**:
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
┌─────────────────────────────────────────┐
|
|
19
|
+
│ SimCert │
|
|
20
|
+
│ (Umbrella Project Meta-Dashboard) │
|
|
21
|
+
└─────────────────────────────────────────┘
|
|
22
|
+
│
|
|
23
|
+
┌───────────────┬───────────────┬───────────────┬──────────┴────┬───────────────┬───────────────┬───────────────┬───────────────┬───────────────┐
|
|
24
|
+
│ │ │ │ │ │ │ │ │ │
|
|
25
|
+
▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼
|
|
26
|
+
┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐
|
|
27
|
+
│ MDCheck │ │ DockCert │ │ QMCert │ │ AdsorpQC │ │ AlphaCert │ │ FEPCert │ │ QSARCert │ │ CatCert │ │ NEBCert │ │ ... │
|
|
28
|
+
│ Tier 1 │ │ Tier 2 │ │ Tier 3 │ │ Tier 4 │ │ Tier 5 │ │ Tier 6 │ │ Tier 7 │ │ Tier 8 │ │ Tier 9 │ │ │
|
|
29
|
+
│ MD │ │ Docking │ │ DFT │ │ GCMC │ │ AlphaFold │ │ FEP / TI │ │ QSAR / ML │ │ Catalysis │ │ Kinetics │ │ │
|
|
30
|
+
└───────────┘ └───────────┘ └───────────┘ └───────────┘ └───────────┘ └───────────┘ └───────────┘ └───────────┘ └───────────┘ └───────────┘
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## The 10 Computational Tiers
|
|
36
|
+
|
|
37
|
+
1. **Tier 1: Molecular Dynamics (`mdcheck`)**
|
|
38
|
+
- Autocorrelation time ($\tau_{\text{int}}$), effective sample size ($N_{\text{eff}}$), Chodera automated equilibration ($t_{\text{eq}}$), Geweke diagnostic, linear drift, multi-replica consistency ($R_1, R_2, R_3$).
|
|
39
|
+
2. **Tier 2: Molecular Docking & Screening (`dockcert`)**
|
|
40
|
+
- Exact analytical BEDROC ($\alpha=20.0, 80.5, 160.9$), RIE, EF1%, EF5%, EF10%, ROC-AUC, PR-AUC, optimal MCC, Hungarian algorithm symmetry-corrected heavy-atom RMSD, decoy property matching KS-tests.
|
|
41
|
+
3. **Tier 3: Quantum Chemistry & DFT (`qmcert`)**
|
|
42
|
+
- Stationary point certification (0 imaginary frequencies for minima, exactly 1 for transition states), spin contamination $\langle S^2 \rangle$, Grimme quasi-RRHO harmonic entropy correction for low modes ($\nu < 100\text{ cm}^{-1}$), simulated IR spectra.
|
|
43
|
+
4. **Tier 4: Adsorption in Nanoporous MOFs & GCMC (`adsorpqc`)**
|
|
44
|
+
- GCMC equilibration burn-in detection, loading drift lock, non-linear isotherm model fitting (Langmuir, Dual-site, Sips, Toth, Freundlich, BET), Henry constant $K_H$, isosteric heat $q_{\text{st}}$, IAST binary selectivity with bootstrap confidence intervals.
|
|
45
|
+
5. **Tier 5: AlphaFold / ESMFold Structure Confidence (`alphacert`)**
|
|
46
|
+
- Per-residue pLDDT categorization across 4 canonical bands ($>90, 70-90, 50-70, <50$), 2D Predicted Aligned Error (PAE) matrix domain decomposition, steric clashscore, Ramachandran dihedral distribution ($\phi, \psi$), certifications `DOCKING_READY` and `MD_READY`.
|
|
47
|
+
6. **Tier 6: Alchemical Free Energy & FEP (`fepcert`)**
|
|
48
|
+
- Phase space overlap matrix ($\Pi_{ij} \ge 3\%$), Thermodynamic Integration (TI), Bennett Acceptance Ratio (BAR), forward/reverse time convergence and dissipated work $W_{\text{diss}}$, thermodynamic cycle closure audit ($\oint \Delta\Delta G \approx 0$).
|
|
49
|
+
7. **Tier 7: QSAR & Molecular Machine Learning (`qsarcert`)**
|
|
50
|
+
- OECD Validation Principles, Hat matrix Applicability Domain ($h^* = \frac{3(p+1)}{n}$) and Williams plot, Tropsha-Golbraikh criteria, Y-randomization ($cR^2_p > 0.50$), train/test split leakage detection.
|
|
51
|
+
8. **Tier 8: Heterogeneous Catalysis & Surfaces (`catcert`)**
|
|
52
|
+
- Surface energy ($\gamma$) layer convergence, Fiorentini-Methfessel asymptotic regression, vacuum thickness and potential flatness $\bar{V}(z)$, physical work function ($\Phi$), dipole layer step ($|\Delta \Phi|$), and $E_{\text{ads}}$ dispersion audit.
|
|
53
|
+
9. **Tier 9: Reaction Pathways & NEB Kinetics (`nebcert`)**
|
|
54
|
+
- Nudged Elastic Band (NEB / CI-NEB) cubic spline MEP interpolation, Climbing Image residual force audit ($|F_\parallel| \le 0.05\text{ eV/\AA}$), transition state 1st-order saddle point imaginary frequency verification, Eyring TST rate constants $k(T)$, Arrhenius fitting, and asymmetric Eckart / Wigner quantum tunneling corrections.
|
|
55
|
+
10. **Tier 10: Spectroscopy & Electronic Structure (`speccert`)**
|
|
56
|
+
- TD-DFT UV-Vis, scaled IR/Raman spectra, VASP DOS parsing and d-band-center analysis with provenance-aware reporting.
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
## Installation
|
|
61
|
+
|
|
62
|
+
> **Note:** PyPI release pending. Until then, install from the tagged GitHub releases (SimCert depends on all ten certifiers):
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
pip install \
|
|
66
|
+
mdcheck==1.1.0 dockcert==1.1.0 qmcert==1.2.0 adsorpqc==1.1.0 \
|
|
67
|
+
alphacert==1.1.0 fepcert==1.2.0 qsarcert==1.2.0 catcert==1.2.0 \
|
|
68
|
+
nebcert==1.2.0 speccert==1.2.0
|
|
69
|
+
pip install "git+https://github.com/sircalch/simcert@v1.7.0"
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
## Quickstart (CLI)
|
|
75
|
+
|
|
76
|
+
```bash
|
|
77
|
+
# 1. Run full 10-tier multi-scale benchmark demonstration
|
|
78
|
+
simcert demo-all -o full_project_audit/
|
|
79
|
+
|
|
80
|
+
# 2. Delegate to any individual tier
|
|
81
|
+
simcert md assess -i trajectory.csv -o md_report/
|
|
82
|
+
simcert dock assess -i scores.csv -o dock_report/
|
|
83
|
+
simcert qm assess -i opt_freq.out -o qm_report/
|
|
84
|
+
simcert adsorp assess -i isotherm.csv -o adsorp_report/
|
|
85
|
+
simcert alpha assess -i model.pdb --pae model_pae.json -o alpha_report/
|
|
86
|
+
simcert fep assess -d gromacs_fep/ -o fep_report/
|
|
87
|
+
simcert qsar assess -i predictions.csv -o qsar_report/
|
|
88
|
+
simcert cat assess --layers-csv pt_layers.csv --area 27.60 -o cat_report/
|
|
89
|
+
simcert neb assess -i neb.dat --frequencies "-1250,150,300" -o neb_report/
|
|
90
|
+
|
|
91
|
+
# 3. View consolidated citations
|
|
92
|
+
simcert cite
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
---
|
|
96
|
+
|
|
97
|
+
## Citation
|
|
98
|
+
|
|
99
|
+
```bibtex
|
|
100
|
+
@software{monreal2026simcert,
|
|
101
|
+
author = {Monreal-Hern{\'a}ndez, Andre},
|
|
102
|
+
title = {{SimCert: A Unified Scientific Simulation Quality-Control and Reproducibility Meta-Framework}},
|
|
103
|
+
year = {2026},
|
|
104
|
+
version = {1.5.0},
|
|
105
|
+
publisher = {Zenodo},
|
|
106
|
+
url = {https://github.com/sircalch/simcert}
|
|
107
|
+
}
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
---
|
|
111
|
+
|
|
112
|
+
## License
|
|
113
|
+
|
|
114
|
+
This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
|
|
115
|
+
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["setuptools>=61.0", "wheel"]
|
|
3
|
+
build-backend = "setuptools.build_meta"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "simcert"
|
|
7
|
+
version = "1.7.0"
|
|
8
|
+
description = "Unified Quality-Control, Structure Validation, and Reproducibility Meta-Framework for Molecular Simulations & AI Models (MD, Docking, QM, Adsorption, AlphaFold, FEP, QSAR, Catalysis, NEB/Kinetics, Spectroscopy/DOS)"
|
|
9
|
+
readme = "README.md"
|
|
10
|
+
authors = [
|
|
11
|
+
{ name = "Andrés Monreal-Hernández", email = "andres.monreal@ues.mx" }
|
|
12
|
+
]
|
|
13
|
+
license = "MIT"
|
|
14
|
+
keywords = [
|
|
15
|
+
"molecular-dynamics",
|
|
16
|
+
"molecular-docking",
|
|
17
|
+
"quantum-chemistry",
|
|
18
|
+
"adsorption",
|
|
19
|
+
"alphafold",
|
|
20
|
+
"free-energy-perturbation",
|
|
21
|
+
"fep",
|
|
22
|
+
"qsar",
|
|
23
|
+
"heterogeneous-catalysis",
|
|
24
|
+
"nudged-elastic-band",
|
|
25
|
+
"chemical-kinetics",
|
|
26
|
+
"spectroscopy",
|
|
27
|
+
"td-dft",
|
|
28
|
+
"uv-vis",
|
|
29
|
+
"infrared-spectroscopy",
|
|
30
|
+
"d-band-center",
|
|
31
|
+
"simulation-quality-control",
|
|
32
|
+
"reproducibility",
|
|
33
|
+
"gromacs",
|
|
34
|
+
"orca",
|
|
35
|
+
"vasp",
|
|
36
|
+
"gaussian"
|
|
37
|
+
]
|
|
38
|
+
classifiers = [
|
|
39
|
+
"Development Status :: 5 - Production/Stable",
|
|
40
|
+
"Intended Audience :: Science/Research",
|
|
41
|
+
"Topic :: Scientific/Engineering :: Bio-Informatics",
|
|
42
|
+
"Topic :: Scientific/Engineering :: Chemistry",
|
|
43
|
+
"Topic :: Scientific/Engineering :: Physics",
|
|
44
|
+
"Topic :: Scientific/Engineering :: Artificial Intelligence",
|
|
45
|
+
"Programming Language :: Python :: 3",
|
|
46
|
+
"Programming Language :: Python :: 3.9",
|
|
47
|
+
"Programming Language :: Python :: 3.10",
|
|
48
|
+
"Programming Language :: Python :: 3.11",
|
|
49
|
+
"Programming Language :: Python :: 3.12",
|
|
50
|
+
"Operating System :: OS Independent"
|
|
51
|
+
]
|
|
52
|
+
requires-python = ">=3.9"
|
|
53
|
+
dependencies = [
|
|
54
|
+
"mdcheck>=1.1.0",
|
|
55
|
+
"dockcert>=1.1.0",
|
|
56
|
+
"qmcert>=1.2.0",
|
|
57
|
+
"adsorpqc>=1.1.0",
|
|
58
|
+
"alphacert>=1.1.0",
|
|
59
|
+
"fepcert>=1.2.0",
|
|
60
|
+
"qsarcert>=1.2.0",
|
|
61
|
+
"catcert>=1.2.0",
|
|
62
|
+
"nebcert>=1.2.0",
|
|
63
|
+
"speccert>=1.2.0",
|
|
64
|
+
"numpy>=1.20.0",
|
|
65
|
+
"scipy>=1.7.0",
|
|
66
|
+
"pandas>=1.3.0",
|
|
67
|
+
"matplotlib>=3.5.0",
|
|
68
|
+
"jinja2>=3.0.0"
|
|
69
|
+
]
|
|
70
|
+
|
|
71
|
+
[project.optional-dependencies]
|
|
72
|
+
dev = [
|
|
73
|
+
"pytest>=7.0.0",
|
|
74
|
+
"pytest-cov>=4.0.0",
|
|
75
|
+
"black>=23.0.0",
|
|
76
|
+
"flake8>=6.0.0",
|
|
77
|
+
"build>=0.10.0",
|
|
78
|
+
"twine>=4.0.0"
|
|
79
|
+
]
|
|
80
|
+
|
|
81
|
+
[project.scripts]
|
|
82
|
+
simcert = "simcert.cli:main"
|
|
83
|
+
|
|
84
|
+
[project.urls]
|
|
85
|
+
Homepage = "https://github.com/sircalch/simcert"
|
|
86
|
+
Documentation = "https://github.com/sircalch/simcert#readme"
|
|
87
|
+
Repository = "https://github.com/sircalch/simcert.git"
|
|
88
|
+
"Bug Tracker" = "https://github.com/sircalch/simcert/issues"
|
|
89
|
+
Changelog = "https://github.com/sircalch/simcert/blob/main/CHANGELOG.md"
|
|
90
|
+
|
simcert-1.7.0/setup.cfg
ADDED
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
"""
|
|
2
|
+
SimCert: Unified Scientific Simulation Quality-Control and Reproducibility Meta-Framework.
|
|
3
|
+
"""
|
|
4
|
+
|
|
5
|
+
__version__ = "1.7.0"
|
|
6
|
+
__author__ = "Andres Monreal-Hernández"
|
|
7
|
+
__license__ = "MIT"
|
|
8
|
+
|
|
9
|
+
import mdcheck
|
|
10
|
+
import dockcert
|
|
11
|
+
import qmcert
|
|
12
|
+
import adsorpqc
|
|
13
|
+
|
|
14
|
+
from simcert.orchestrator import run_multiscale_audit, SimCertProjectReport
|
|
15
|
+
from simcert.meta_report import generate_simcert_meta_report
|
|
16
|
+
|
|
17
|
+
__all__ = [
|
|
18
|
+
"__version__",
|
|
19
|
+
"mdcheck",
|
|
20
|
+
"dockcert",
|
|
21
|
+
"qmcert",
|
|
22
|
+
"adsorpqc",
|
|
23
|
+
"run_multiscale_audit",
|
|
24
|
+
"SimCertProjectReport",
|
|
25
|
+
"generate_simcert_meta_report"
|
|
26
|
+
]
|