-
Notifications
You must be signed in to change notification settings - Fork 0
/
.zenodo.json
100 lines (100 loc) · 19.6 KB
/
.zenodo.json
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
{
"title": "Enhancing the ReaxFF DFT database",
"version": "1.0.0",
"description": "<h1 id=\"enhancing-the-reaxff-dft-database\">Enhancing the ReaxFF DFT database</h1>\n\n<p>This repository contains the database used to re-parametrize the ReaxFF force field for LiF, an inorganic compound. The purpose of the database is to improve the accuracy and reliability of ReaxFF calculations for LiF. The results and method used were published in the article <a href=\"https://doi.org/10.1038/s41598-023-50978-5\">Enhancing ReaxFF for Molecular Dynamics Simulations of Lithium-Ion Batteries: An interactive reparameterization protocol</a>.</p>\n<p>This database was made using the simulation obtained using the protocol published in <a href=\"https://github.com/paolodeangelis/Enhancing_ReaxFF\">Enhancing ReaxFF repository</a>.</p>\n<h2 id=\"table-of-contents\">Table of Contents</h2>\n<ul>\n<li><a href=\"#installation\">Installation</a></li>\n<li><a href=\"#folder-structure\">Folder Structure</a></li>\n<li><a href=\"#interacting-with-the-database\">Interacting with the Database</a>\n<ul>\n<li><a href=\"#ase-db-command-line\">ASE db Command-line</a></li>\n<li><a href=\"#web-interface\">Web Interface</a></li>\n<li><a href=\"#ase-python-interface\">ASE Python Interface</a></li>\n</ul></li>\n<li><a href=\"#contributing\">Contributing</a></li>\n<li><a href=\"#how-to-cite\">How to Cite</a></li>\n<li><a href=\"#license\">License</a></li>\n<li><a href=\"#acknowledgments\">Acknowledgments</a></li>\n</ul>\n<h2 id=\"installation\">Installation</h2>\n<p>To use the database and interact with it, ensure that you have the following Python requirements installed:</p>\n<p><strong>Minimum Requirements:</strong></p>\n<ul>\n<li>Python 3.9 or above</li>\n<li>Atomic Simulation Environment (ASE) library</li>\n<li>Jupyter Lab</li>\n</ul>\n<p><strong>Requirements for Re-running or Performing New Simulations:</strong></p>\n<ul>\n<li>SCM (Software for Chemistry & Materials) Amsterdam Modeling Suite</li>\n<li>PLAMS (Python Library for Automating Molecular Simulation) library</li>\n</ul>\n<p>You can install the required Python packages using pip:</p>\n<pre class=\"shell\"><code>pip install -r requirements.txt</code></pre>\n<blockquote>\n<p><strong>Warning</strong></p>\n<p>Make sure to have the appropriate licenses and installations of SCM Amsterdam Modeling Suite and any other necessary software for running simulations.</p>\n</blockquote>\n<h2 id=\"folder-structure\">Folder Structure</h2>\n<p>The repository has the following folder structure:</p>\n<div class=\"sourceCode\" id=\"cb2\"><pre class=\"sourceCode bash\"><code class=\"sourceCode bash\"><a class=\"sourceLine\" id=\"cb2-1\" title=\"1\"><span class=\"ex\">.</span></a>\n<a class=\"sourceLine\" id=\"cb2-2\" title=\"2\">\u251c\u2500\u2500 <span class=\"ex\">CONTRIBUTING.md</span></a>\n<a class=\"sourceLine\" id=\"cb2-3\" title=\"3\">\u251c\u2500\u2500 <span class=\"ex\">CREDITS.md</span></a>\n<a class=\"sourceLine\" id=\"cb2-4\" title=\"4\">\u251c\u2500\u2500 <span class=\"ex\">LICENSE</span></a>\n<a class=\"sourceLine\" id=\"cb2-5\" title=\"5\">\u251c\u2500\u2500 <span class=\"ex\">README.md</span></a>\n<a class=\"sourceLine\" id=\"cb2-6\" title=\"6\">\u251c\u2500\u2500 <span class=\"ex\">requirements.txt</span></a>\n<a class=\"sourceLine\" id=\"cb2-7\" title=\"7\">\u251c\u2500\u2500 <span class=\"ex\">assets</span></a>\n<a class=\"sourceLine\" id=\"cb2-8\" title=\"8\">\u251c\u2500\u2500 <span class=\"ex\">data</span></a>\n<a class=\"sourceLine\" id=\"cb2-9\" title=\"9\">\u2502 \u251c\u2500\u2500 <span class=\"ex\">LiF.db</span></a>\n<a class=\"sourceLine\" id=\"cb2-10\" title=\"10\">\u2502 \u251c\u2500\u2500 <span class=\"ex\">LiF.json</span></a>\n<a class=\"sourceLine\" id=\"cb2-11\" title=\"11\">\u2502\u00a0\u00a0 \u2514\u2500\u2500 <span class=\"ex\">LiF.yaml</span></a>\n<a class=\"sourceLine\" id=\"cb2-12\" title=\"12\">\u251c\u2500\u2500 <span class=\"ex\">notebooks</span></a>\n<a class=\"sourceLine\" id=\"cb2-13\" title=\"13\">\u2502 \u251c\u2500\u2500 <span class=\"ex\">browsing_db.ipynb</span></a>\n<a class=\"sourceLine\" id=\"cb2-14\" title=\"14\">\u2502 \u2514\u2500\u2500 <span class=\"ex\">running_simulation.ipynb</span></a>\n<a class=\"sourceLine\" id=\"cb2-15\" title=\"15\">\u2514\u2500\u2500 <span class=\"ex\">tools</span></a>\n<a class=\"sourceLine\" id=\"cb2-16\" title=\"16\"> \u251c\u2500\u2500 <span class=\"ex\">db</span></a>\n<a class=\"sourceLine\" id=\"cb2-17\" title=\"17\"> \u251c\u2500\u2500 <span class=\"ex\">plams_experimental</span></a>\n<a class=\"sourceLine\" id=\"cb2-18\" title=\"18\"> \u2514\u2500\u2500 <span class=\"ex\">scripts</span></a></code></pre></div>\n<ul>\n<li><code>CONTRIBUTING.md</code>: This file provides guidelines and instructions for contributing to the repository. It outlines the contribution process, coding conventions, and other relevant information for potential contributors.</li>\n<li><code>CREDITS.md</code>: This file acknowledges and credits the individuals or organizations that have contributed to the repository.</li>\n<li><code>LICENSE</code>: This file contains the license information for the repository (CC BY 4.0). It specifies the terms and conditions under which the repository's contents are distributed and used.</li>\n<li><code>README.md</code>: This file.</li>\n<li><code>requirements.txt</code>: This file lists the required Python packages and their versions. (see <a href=\"#installation\">installation section</a>)</li>\n<li><code>assets</code>: This folder contains any additional assets, such as images or documentation, related to the repository.</li>\n<li><code>data</code>: This folder contains the data files used in the repository.\n<ul>\n<li><code>LiF.db</code>: This file is the SQLite database file that includes the DFT data used for the ReaxFF force field. Specifically, it contains data related to the inorganic compound LiF.</li>\n<li><code>LiF.json</code>: This file provides the database metadata in a human-readable format using JSON.</li>\n<li><code>LiF.yaml</code>: This file also contains the database metadata in a more human-readable format, still using YAML.</li>\n</ul></li>\n<li><code>notebooks</code>: This folder contains Jupyter notebooks that provide demonstrations and examples of how to use and analyze the database.\n<ul>\n<li><code>browsing_db.ipynb</code>: This notebook demonstrates how to handle, select, read, and understand the data points in the <code>LiF.db</code> database using the ASE database Python interface. It serves as a guide for exploring and navigating the database effectively.</li>\n<li><code>running_simulation.ipynb</code>: In this notebook, you will find an example of how to get a data point from the <code>LiF.db</code> database and use it to perform a new simulation. The notebook showcases how to utilize either the <a href=\"https://www.scm.com/doc/plams/index.html\">PLAMS</a> library or the <a href=\"https://www.scm.com/doc/plams/interfaces/amscalculator.html\">AMSCalculator</a> and ASE Python library to conduct simulations based on the retrieved data and then store it as a new data point in the <code>LiF.db</code> database. It provides step-by-step instructions and code snippets for a seamless simulation workflow.</li>\n</ul></li>\n<li><code>tools</code>: This directory contains a collection of Python modules and scripts that are useful for reading, analyzing, and re-running simulations stored in the database. These tools are indispensable for ensuring that this repository adheres to the principles of <strong>I</strong>nteroperability and <strong>R</strong>eusability, as outlined by the <a href=\"https://www.go-fair.org/fair-principles/\">FAIR principles</a>.\n<ul>\n<li><code>db</code>: This Python module provides functionalities for handling, reading, and storing data in the database.</li>\n<li><code>plasm_experimental</code>: This Python module includes the necessary components for using the <code>AMSCalculator</code> with PLASM and the SCM software package, utilizing the ASE API. It facilitates running simulations, and performing calculations.</li>\n<li><code>scripts</code>: This directory contains additional scripts for advanced usage scenarios of this repository.</li>\n</ul></li>\n</ul>\n<h2 id=\"interacting-with-the-database\">Interacting with the Database</h2>\n<p>There are three ways to interact with the database: using the ASE db command line, the web interface, and the ASE Python interface.</p>\n<h3 id=\"ase-db-command-line\">ASE db Command-line</h3>\n<p>To interact with the database using the ASE db terminal command, follow these steps:</p>\n<ol type=\"1\">\n<li><p>Open a terminal and navigate to the directory containing the <code>LiF.db</code> file.</p></li>\n<li><p>Run the following command to start the ASE db terminal:</p>\n<pre class=\"shell\"><code>ase db LiF.db</code></pre></li>\n<li><p>You can now use the available commands in the terminal to query and manipulate the database. More information can be found in the <a href=\"https://wiki.fysik.dtu.dk/ase/ase/db/db.html\">ASE database documentation</a>.</p></li>\n</ol>\n<h3 id=\"web-interface\">Web Interface</h3>\n<p>To interact with the database using the web interface, follow these steps:</p>\n<ol type=\"1\">\n<li><p>Open a terminal and navigate to the directory containing the <code>LiF.db</code> file.</p></li>\n<li><p>Run the following command to start the ASE db terminal:</p>\n<pre class=\"shell\"><code>ase db -w LiF.db</code></pre></li>\n<li><p>Open your web browser and connect to the local server at <a href=\"http://127.0.0.1:5000\" class=\"uri\">http://127.0.0.1:5000</a>.</p></li>\n</ol>\n\n<blockquote>\n<p><strong>Warning</strong></p>\n<p>To visualize the 3D structure of the system, you need to install the <a href=\"https://jmol.sourceforge.net/\">JMOL extension</a>. You can use the script <code>tools/scripts/install_jmol.py</code> to automatically download and install it:</p>\n<pre class=\"shell\"><code>cd tools/scripts/\npython install_jmol.py</code></pre>\n</blockquote>\n<h3 id=\"ase-python-interface\">ASE Python Interface</h3>\n<p>To interact with the database using the ASE Python interface, you can use the following example code:</p>\n<div class=\"sourceCode\" id=\"cb6\"><pre class=\"sourceCode python\"><code class=\"sourceCode python\"><a class=\"sourceLine\" id=\"cb6-1\" title=\"1\"><span class=\"im\">from</span> ase.db <span class=\"im\">import</span> <span class=\"ex\">connect</span></a>\n<a class=\"sourceLine\" id=\"cb6-2\" title=\"2\"></a>\n<a class=\"sourceLine\" id=\"cb6-3\" title=\"3\"><span class=\"co\"># Connect to the database</span></a>\n<a class=\"sourceLine\" id=\"cb6-4\" title=\"4\">db <span class=\"op\">=</span> <span class=\"ex\">connect</span>(<span class=\"st\">"LiF.db"</span>)</a>\n<a class=\"sourceLine\" id=\"cb6-5\" title=\"5\"></a>\n<a class=\"sourceLine\" id=\"cb6-6\" title=\"6\"><span class=\"co\"># Query the database</span></a>\n<a class=\"sourceLine\" id=\"cb6-7\" title=\"7\">results <span class=\"op\">=</span> db.select(<span class=\"st\">"success=True"</span>)</a>\n<a class=\"sourceLine\" id=\"cb6-8\" title=\"8\"></a>\n<a class=\"sourceLine\" id=\"cb6-9\" title=\"9\"><span class=\"co\"># Iterate over the results</span></a>\n<a class=\"sourceLine\" id=\"cb6-10\" title=\"10\"><span class=\"cf\">for</span> row <span class=\"kw\">in</span> results:</a>\n<a class=\"sourceLine\" id=\"cb6-11\" title=\"11\"> <span class=\"bu\">print</span>(<span class=\"ss\">f"ID: </span><span class=\"sc\">{</span>row<span class=\"sc\">.</span><span class=\"bu\">id</span><span class=\"sc\">}</span><span class=\"ss\">, Energy: </span><span class=\"sc\">{</span>row<span class=\"sc\">.</span>energy<span class=\"sc\">}</span><span class=\"ss\">"</span>)</a></code></pre></div>\n<p>For a more detailed example, refer to the notebook <code>notebooks/browsing_db.ipynb</code>. To learn how to perform a simulation, check the notebook <code>notebooks/running_simulation.ipynb</code>.</p>\n<h2 id=\"contributing\">Contributing</h2>\n<p>If you would like to contribute to the Enhancing ReaxFF DFT Database by performing new simulations and expanding the database, please follow the guidelines outlined in the <a href=\"CONTRIBUTING.md\">Contribution Guidelines</a>. You are welcome to submit pull requests or open issues in the repository. Your contributions are greatly appreciated!</p>\n<h2 id=\"how-to-cite\">How to Cite</h2>\n<p>If you use the database or the tools provided in this repository for your work, please cite it using the following BibTeX entries:</p>\n<div class=\"sourceCode\" id=\"cb7\"><pre class=\"sourceCode bibtex\"><code class=\"sourceCode bibtex\"><a class=\"sourceLine\" id=\"cb7-1\" title=\"1\"><span class=\"va\">@article</span>{<span class=\"ot\">deangelis2023enhancing</span>,</a>\n<a class=\"sourceLine\" id=\"cb7-2\" title=\"2\"> <span class=\"dt\">title</span>={Enhancing ReaxFF for molecular dynamics simulations of lithium-ion batteries: an interactive reparameterization protocol},</a>\n<a class=\"sourceLine\" id=\"cb7-3\" title=\"3\"> <span class=\"dt\">author</span>={De Angelis, Paolo and </a>\n<a class=\"sourceLine\" id=\"cb7-4\" title=\"4\"> Cappabianca, Roberta and </a>\n<a class=\"sourceLine\" id=\"cb7-5\" title=\"5\"> Fasano, Matteo and </a>\n<a class=\"sourceLine\" id=\"cb7-6\" title=\"6\"> Asinari, Pietro and </a>\n<a class=\"sourceLine\" id=\"cb7-7\" title=\"7\"> Chiavazzo, Eliodoro},</a>\n<a class=\"sourceLine\" id=\"cb7-8\" title=\"8\"> <span class=\"dt\">journal</span>={Scientific Reports},</a>\n<a class=\"sourceLine\" id=\"cb7-9\" title=\"9\"> <span class=\"dt\">volume</span>={14},</a>\n<a class=\"sourceLine\" id=\"cb7-10\" title=\"10\"> <span class=\"dt\">number</span>={1},</a>\n<a class=\"sourceLine\" id=\"cb7-11\" title=\"11\"> <span class=\"dt\">pages</span>={978},</a>\n<a class=\"sourceLine\" id=\"cb7-12\" title=\"12\"> <span class=\"dt\">year</span>={2024},</a>\n<a class=\"sourceLine\" id=\"cb7-13\" title=\"13\"> <span class=\"dt\">publisher</span>={Nature Publishing Group UK London}</a>\n<a class=\"sourceLine\" id=\"cb7-14\" title=\"14\">}</a></code></pre></div>\n<div class=\"sourceCode\" id=\"cb8\"><pre class=\"sourceCode bibtex\"><code class=\"sourceCode bibtex\"><a class=\"sourceLine\" id=\"cb8-1\" title=\"1\"><span class=\"co\">@dataset{EnhReaxFFdatabase,</span></a>\n<a class=\"sourceLine\" id=\"cb8-2\" title=\"2\"><span class=\"co\"> author = {De Angelis, Paolo and</span></a>\n<a class=\"sourceLine\" id=\"cb8-3\" title=\"3\"><span class=\"co\"> Cappabianca, Roberta and</span></a>\n<a class=\"sourceLine\" id=\"cb8-4\" title=\"4\"><span class=\"co\"> Fasano, Matteo and</span></a>\n<a class=\"sourceLine\" id=\"cb8-5\" title=\"5\"><span class=\"co\"> Asinari, Pietro and</span></a>\n<a class=\"sourceLine\" id=\"cb8-6\" title=\"6\"><span class=\"co\"> Chiavazzo, Eliodoro},</span></a>\n<a class=\"sourceLine\" id=\"cb8-7\" title=\"7\"><span class=\"co\"> title = {{Enhancing the ReaxFF DFT database}},</span></a>\n<a class=\"sourceLine\" id=\"cb8-8\" title=\"8\"><span class=\"co\"> month = may,</span></a>\n<a class=\"sourceLine\" id=\"cb8-9\" title=\"9\"><span class=\"co\"> year = 2023,</span></a>\n<a class=\"sourceLine\" id=\"cb8-10\" title=\"10\"><span class=\"co\"> publisher = {Zenodo},</span></a>\n<a class=\"sourceLine\" id=\"cb8-11\" title=\"11\"><span class=\"co\"> version = {1.0.0-beta},</span></a>\n<a class=\"sourceLine\" id=\"cb8-12\" title=\"12\"><span class=\"co\"> doi = {10.5072/zenodo.1204707},</span></a>\n<a class=\"sourceLine\" id=\"cb8-13\" title=\"13\"><span class=\"co\"> url = {https://doi.org/10.5281/zenodo.7959121}</span></a>\n<a class=\"sourceLine\" id=\"cb8-14\" title=\"14\"><span class=\"co\">}</span></a></code></pre></div>\n<h2 id=\"license\">License</h2>\n<p>The contents of this repository are licensed under the <a href=\"http://creativecommons.org/licenses/by/4.0/\">Creative Commons Attribution 4.0 International License</a>.</p>\n<h2 id=\"acknowledgments\">Acknowledgments</h2>\n<p>This project has received funding from the European Union's <a href=\"https://ec.europa.eu/programmes/horizon2020/en\">Horizon 2020 research and innovation programme</a> under grant agreement <a href=\"https://cordis.europa.eu/project/id/957189\">No 957189</a>. The project is part of <a href=\"https://battery2030.eu/\">BATTERY 2030+</a>, the large-scale European research initiative for inventing the sustainable batteries of the future.</p>\n<p>The authors also acknowledge that the simulation results of this database have been achieved using the <a href=\"https://prace-ri.eu/hpc-access/deci-access/\">DECI</a> resource <a href=\"https://www.archer2.ac.uk/\">ARCHER2</a> based in UK at <a href=\"https://www.epcc.ed.ac.uk/\">EPCC</a> with support from the <a href=\"https://prace-ri.eu/\">PRACE</a> aisbl.</p>\n\n<!-- [![CC BY 4.0][cc-by-image]][cc-by] -->\n",
"creators": [
{
"name": "De Angelis, Paolo",
"affiliation": "Department of Energy \u201cGalileo Ferraris\u201d, Politecnico di Torino, Corso Duca Degli Abruzzi 24 10129 Torino, Italy",
"orcid": "0000-0003-1866-2988"
},
{
"name": "Cappabianca, Roberta",
"affiliation": "Department of Energy \u201cGalileo Ferraris\u201d, Politecnico di Torino, Corso Duca Degli Abruzzi 24 10129 Torino, Italy",
"orcid": "0000-0002-3789-9676"
},
{
"name": "Fasano, Matteo",
"affiliation": "Department of Energy \u201cGalileo Ferraris\u201d, Politecnico di Torino, Corso Duca Degli Abruzzi 24 10129 Torino, Italy",
"orcid": "0000-0002-3997-3681"
},
{
"name": "Asinari, Pietro",
"affiliation": "Department of Energy \u201cGalileo Ferraris\u201d, Politecnico di Torino, Corso Duca Degli Abruzzi 24 10129 Torino, Italy",
"orcid": "0000-0003-1814-3846"
},
{
"name": "Chiavazzo, Eliodoro",
"affiliation": "Department of Energy \u201cGalileo Ferraris\u201d, Politecnico di Torino, Corso Duca Degli Abruzzi 24 10129 Torino, Italy",
"orcid": "0000-0001-6165-7434"
}
],
"upload_type": "dataset",
"access_right": "open",
"license": "cc-by-4.0",
"communities": [
{
"identifier": "bigmap-h2020"
}
],
"contributors": [
{
"name": "De Angelis, Paolo",
"type": "ProjectManager",
"orcid": "0000-0003-1866-2988"
},
{
"name": "Cappabianca, Roberta",
"type": "ProjectMember",
"orcid": "0000-0002-3789-9676"
},
{
"name": "Fasano, Matteo",
"type": "Supervisor",
"orcid": "0000-0002-3997-3681"
},
{
"name": "Asinari, Pietro",
"type": "Supervisor",
"orcid": "0000-0003-1814-3846"
},
{
"name": "Chiavazzo, Eliodoro",
"type": "Supervisor",
"orcid": "0000-0001-6165-7434"
}
],
"language": "eng",
"keywords": [
"Density Functional Theory",
"DFT",
"Force Field",
"FF",
"Lithium fluoride",
"LiF",
"Reaxtive Force Field",
"ReaxFF",
"Solid electrolyte interphase",
"SEI",
"Lithium-ion battery",
"LIB",
"Atomic Simulation Environment",
"ASE",
"BIG-MAP",
"Reproducible research",
"Protocols"
],
"related_identifiers": [
{
"scheme": "doi",
"identifier": "10.1038/s41598-023-50978-5",
"relation": "isSupplementTo",
"resource_type": "publication-article"
}
],
"grants": [
{
"id": "957189"
}
]
}