10
0
mirror of https://github.com/LCPQ/QUESTDB_website.git synced 2024-12-25 13:53:48 +01:00
QUESTDB_website/README.md

52 lines
2.7 KiB
Markdown
Raw Normal View History

2020-09-11 11:58:33 +02:00
# QUEST Website
## Introduction
2020-10-29 20:40:14 +01:00
The QUEST website has been designed to gather and analyze the highly-accurate vertical excitation energies produced by the [QUEST project](https://doi.org/10.1021/acs.jpclett.0c00014).
2020-11-16 09:19:32 +01:00
The QUEST database contains more than 470 accurate vertical excitation energies of various natures ($\pi \to \pi^{*}$, $n \to \pi^{*}$, double excitation, Rydberg, singlet, doublet, triplet, etc) for small- and medium-sized molecules.
2020-10-29 20:40:14 +01:00
These values have been obtained using a combination of high-order coupled cluster and selected configuration interaction calculations using increasingly large diffuse basis sets.
One of the key aspect of the QUEST dataset is that it does not rely on any experimental values, avoiding potential biases inherently linked to experiments and facilitating in the process theoretical cross comparisons.
2020-11-16 09:19:32 +01:00
Following this composite protocol, we have been able to produce theoretical best estimates (TBEs) with the aug-cc-pVTZ basis set, as well as basis set corrected TBEs (i.e., near the complete basis set limit) for each of these transitions.
2020-10-29 20:40:14 +01:00
Thanks to the present website, one can easily test and compare the accuracy of a given method with respect to various variables such as the molecule size or its family, the nature of the excited states, the size of the basis set, etc.
2020-09-11 11:58:33 +02:00
## Quick start
To clone this website and use it locally please run the following commands.
```bash
2020-10-29 18:34:10 +01:00
git clone --recurse-submodules https://github.com/mveril/QUESTDB_website/
2020-10-29 18:11:14 +01:00
cd QUESTDB_website
make serve
2020-09-11 11:58:33 +02:00
```
2020-11-16 09:19:32 +01:00
Now you can use your favorite browser to navigate to the website using the URL showed by Hugo in your terminal (normally http://localhost:1313)
2020-09-11 11:58:33 +02:00
## Repository content
### The website
2020-11-16 09:19:32 +01:00
The main part of this repository is the website. It is built using the [hugo](https://gohugo.io/) static website generator with the [beautifulhugo](https://themes.gohugo.io/beautifulhugo/) theme.
2020-09-11 11:58:33 +02:00
2020-10-29 18:31:27 +01:00
All the data are stored in the [data](static/data) directory.
2020-09-11 11:58:33 +02:00
### The tools.
The second part is the [tools](tools/) a series of python scripts used to generate data.
2020-09-11 11:58:33 +02:00
#### datafileBuilder
2020-10-29 18:31:27 +01:00
A python script to generate data from custom LaTeX input file see [examples](docs/examples).
2020-09-11 11:58:33 +02:00
#### metarecover
The `metarecover` python script is used to regenerate the metadata from the previous git history state.
2020-09-15 09:39:23 +02:00
So you can remove a data file to regenerate it from a LaTeX input file with `datafileBuilder` and recover the metadata from the previous version using `metarecover`.
2020-11-13 14:47:08 +01:00
#### ADC25generator
2020-09-15 09:39:23 +02:00
2020-11-16 09:19:32 +01:00
The `ADC25generator` is used to build `ADC(2.5)` data files from `ADC(2)` and `ADC(3)` data files.
2020-09-15 09:39:23 +02:00
### generate_data
The `generate_data` script is used to wrap all data file into one `database.json` file.