Metadata-Version: 2.2
Name: fretlabel
Version: 0.2.1
Summary: PyMOL plugin to interactively label nucleic acids with fluorophores in silico
Author-email: Fabio Steffen <fabio.steffen@chem.uzh.ch>, "Roland K.O. Sigel" <roland.sigel@chem.uzh.ch>, Richard Börner <richard.boerner@hs-mittweida.de>
License: GPL-3.0-or-later
Project-URL: Repository, https://github.com/RNA-FRETools/fretlabel
Project-URL: Documentation, https://rna-fretools.github.io/fretlabel/
Project-URL: Issues, https://rna-fretools.github.io/fretlabel/issues
Keywords: FRET,single-molecule,molecular dynamics,PDB,fluorescence labeling,AMBERDYES
Classifier: Programming Language :: Python
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Framework :: Jupyter
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pandas
Requires-Dist: biopandas
Provides-Extra: dev
Requires-Dist: bumpver; extra == "dev"
Provides-Extra: docs
Requires-Dist: lmfit; extra == "docs"
Requires-Dist: fretraj; extra == "docs"
Requires-Dist: jupyter-book; extra == "docs"
Requires-Dist: ipywidgets; extra == "docs"
Requires-Dist: matplotlib; extra == "docs"
Requires-Dist: seaborn; extra == "docs"

[![Build and deploy](https://github.com/RNA-FRETools/fretlabel/actions/workflows/build.yml/badge.svg)](https://github.com/RNA-FRETools/fretlabel/actions/workflows/build.yml)
[![Documentation](https://github.com/RNA-FRETools/fretlabel/actions/workflows/docs.yml/badge.svg)](https://github.com/RNA-FRETools/fretlabel/actions/workflows/docs.yml)
[![PyPI](https://img.shields.io/pypi/v/fretlabel)](https://pypi.org/project/fretlabel/)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.10963145.svg)](https://doi.org/10.5281/zenodo.10963145)

<img src="https://raw.githubusercontent.com/RNA-FRETools/fretlabel/master/docs/images/fretlabel_banner.png" width=750px>

*FRETlabel* is a **PyMOL plugin** to label nucleic acids with explicit fluorescent dyes. It aims to facilitate the workflow of setting up, running and evaluating **molecular dynamics simulations with explicit organic fluorophores** for *in silico* FRET calculations.

Specifically, *FRETlabel* includes the following features:
- **PyMOL plugin for fluorescent labeling**: Label your nucleic acid of interest with the click of a button. The PyMOL plugin extends the AMBERDYES package (Graen et al. *JCTC* 2014) geometries and force field parameters of common nucleic acid linker chemistries.
- **Build new fragments interactively**: Tutorials guide you step-by-step through the process of creating new base, linker and dye fragments by integrating with established pipelines for topology generation such as *Antechamber* and *Acpype*.
- **FRET prediction**: Calculate FRET distributions from MD simulation with all-atom organic dyes. *FRETlabel* integrates with *FRETraj* to compute photon bursts based on distance *R*<sub>DA</sub>(*t*) and orientation trajectories *κ*<sup>2</sup>(*t*) of the fluorophores. 

<img src="https://raw.githubusercontent.com/RNA-FRETools/fretlabel/master/docs/images/graphical_abstract.png" width=700px>

**Fig.** Schematic of *FRETlabel*: (i) A fluorescent dye (here Cy3) is coupled to a nucleic acid via a PyMOL plugin. (ii) An existing force field (e.g. AMBERDYES) is patched with parameters for linker fragments to enable MD simulations with explicit fluorophores (dots represent the spatial distribution of the dye).


## Installation and Documentation
Follow the instructions for your platform [here](https://rna-fretools.github.io/fretlabel/getting_started/installation)


## FRETlabel and FRETraj
*FRETlabel* attaches explicit fluorophores on a custom nucleic acid. If you instead like to use an implicit, geometrical dye model that relies on **accessible-contact volumes (ACV)** then have a look our sister project [*FRETraj*](https://rna-fretools.github.io/fretraj/intro.html) (Steffen, *Bioinformatics*, 2021)


## References
If you use *FRETlabel* in your work please refer to the following paper:

- F.D. Steffen, R.K.O. Sigel, R. Börner, *Phys. Chem. Chem. Phys.* **2016**, *18*, 29045-29055. [![](https://img.shields.io/badge/DOI-10.1039/C6CP04277E-blue.svg)](https://doi.org/10.1039/C6CP04277E)


### Additional readings
- T. Graen, M. Hoefling, H. Grubmüller, *J. Chem. Theory Comput.* **2014**, *10*, 5505-5512.
- B. Schepers, H. Gohlke, *J. Chem. Phys.* **2020**, *152*, 221103.
- R. Shaw, T. Johnston-Wood, B. Ambrose, T. D. Craggs, and J. G. Hill, *J. Chem. Theory Comput.*, **2020**, *16*, 7817–7824.
- M. Zhao, F.D. Steffen R. Börner, M. Schaffer, R.K.O. Sigel, E. Freisinger, *Nucleic Acids Res.* **2018**, *46*, e13.
- F.D. Steffen, R. Börner, E. Freisinger, R.K.O. Sigel, *CHIMIA* **2019**, *73*, 257-261.
- F.D. Steffen, R.K.O. Sigel, R. Börner, *Bioinformatics* **2021**, *37*, 3953–3955.

----

<sup><a name="pymol">1</a></sup> PyMOL is a trademark of Schrödinger, LLC.
