Metadata-Version: 2.4
Name: spec2epsilon
Version: 1.0.0
Summary: Estimate dielectric constant from fluorescence spectra
Author-email: Leonardo Evaristo de Sousa <ledso@dtu.dk>
License: MIT License
        
        Copyright (c) 2024 Leonardo Sousa
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Homepage, https://github.com/LeonardoESousa/spec2epsilon
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy<2.0,>=1.23
Requires-Dist: pandas<2.0,>=1.5
Requires-Dist: scipy
Requires-Dist: streamlit[charts]
Dynamic: license-file

# spec2epsilon - Estimate dielectric constants from fluorescence spectra


[![made-with-python](https://img.shields.io/badge/Made%20with-Python-1f425f.svg?style=plastic)](https://www.python.org/)
[![maint](https://img.shields.io/maintenance/yes/2026?style=plastic)]()
[![commit](https://img.shields.io/github/last-commit/LeonardoESousa/suscs?style=plastic)]()


## Cite as

[Bueno, Fernando Teixeira, Pedro Henrique de Oliveira Neto, and Leonardo Evaristo de Sousa. "Determining Static Dielectric Constants from Fluorescence Spectra." The Journal of Physical Chemistry Letters (2026).](https://doi.org/10.1021/acs.jpclett.5c03806)

## How to install it?

`pip install spec2epsilon`

## How to use it?

Once installed, use the command:

`spec2epsilon`

The application will open in your browser.


## Input file

The application requires a .csv file in the format shown below:

```csv
Solvent,epsilon,nr,Molecule_name
CyH,2.0165,1.4262,440
Tol,2.3800,1.4969,463
Diox,2.2099,1.4224,485
EtOAc,6.2530,1.3724,539
THF,7.5800,1.4072,543
CHCl3,4.8100,1.4458,552
Ace,20.700,1.3586,597
DMF,37.219,1.4305,617
PS,,1.5500,465
PMMA,,1.5500,535
Zeonex,,1.5500,449
CBP,,1.5500,504
```

The **solvent** column identifies the solvents and materials where fluorescence has been measured.

The **epsilon** column contains the static dielectric constant for known solvents. 
Rows that include **epsilon** values are used for the characterization of the molecule (calculation of $E_{vac}$ and $\chi$).  
Rows where **epsilon** is missing are interpreted as materials for which the inference procedure will be applied.  

The **nr** column contains the refractive index of each sample.

The **Molecule_name** column contains the peak of fluorescence spectra as measured in the different solvents/environments. Values may be provided in eV or nm. The column name should identify the molecule.
It is also possible to include more than one **Molecule_name** column in the same file, allowing characterization or inference for multiple molecules in parallel.

Examples of input files can be found in here [here](https://github.com/LeonardoESousa/spec2epsilon/tree/main/examples)

The csv file can be uploaded to the application. Alternatively, one may use the api. A tutorial is provided [here](https://github.com/LeonardoESousa/spec2epsilon/tree/main/examples/tutorial.ipynb).

