PyFraME: Python tools for Fragment-based Multiscale Embedding
Project description
# PyFraME: Python tools for Fragment-based Multiscale Embedding calculations
[](https://gitlab.com/FraME-projects/PyFraME/commits/master)
[](https://gitlab.com/FraME-projects/PyFraME/commits/master)
[](https://www.codacy.com/app/foeroyingur/PyFraME?utm_source=gitlab.com&utm_medium=referral&utm_content=FraME-projects/PyFraME&utm_campaign=Badge_Grade)
[](https://www.codacy.com/app/foeroyingur/PyFraME?utm_source=gitlab.com&utm_medium=referral&utm_content=FraME-projects/PyFraME&utm_campaign=Badge_Coverage)
Archived copy of current release ([0.1.0](https://gitlab.com/FraME-projects/PyFraME/tags/v0.1.0)): [](https://doi.org/10.5281/zenodo.293765)
## Description
PyFraME is a Python package that provides tools for setting up and running fragment-based multiscale embedding calculations.
The aim is to provide tools that can automatize the workflow of such calculations in a flexible manner.
The typical workflow is as follows:
1. a part of the total molecular system is chosen as the core region which is typically treated a high level of theory
2. the remainder is split into a number of regions each of which can be treated at different levels of theory
3. each region (except the core) is divided into fragments that consist of either
- small molecules
- or parts of larger molecules that have been fragmented into smaller computationally manageable fragments
4. a calculation is run on each fragment to obtain fragment parameters (if necessary)
5. all fragment parameters of all regions are assembled and constitute the embedding potential
6. a final calculation is run on the core region using the embedding potential to model the effect from the remainder of the molecular system
## How to cite
To cite PyFraME please use a format similar to the following
"J. M. H. Olsen, *PyFraME: Python tools for Fragment-based Multiscale Embedding (version 0.1.0)*, **2017**, https://doi.org/10.5281/zenodo.293765"
where the version and DOI should of course correspond to the actual version that was used. A possible BibTeX entry could be:
```
@misc{pyframe,
author = {Olsen, J. M. H.},
title = {{PyFraME}: {P}ython tools for {F}ragment-based {M}ultiscale {E}mbedding (version 0.1.0)},
year = {2017},
note = {https://doi.org/10.5281/zenodo.293765}}
```
Alternatively, BibTeX and other formats can be generated here: [](https://doi.org/10.5281/zenodo.293765)
## Requirements
To use PyFraME you need:
- [Python 3](http://www.python.org)
- [NumPy](http://www.numpy.org/)
- [Numba](https://numba.pydata.org)
For certain functionality you will need one or more of the following:
- [Dalton](http://www.daltonprogram.org)
- [LoProp for Dalton](https://github.com/vahtras/loprop)
- [Molcas 8](http://www.molcas.org)
To run the test suite you need (note that currently there are very few tests):
- [nose](http://nose.readthedocs.io/en/latest/)
## Installation
The source can be downloaded from [GitLab](https://gitlab.com/FraME-projects/PyFraME) or [Zenodo](https://doi.org/10.5281/zenodo.293765). Alternatively, it can be cloned from the repository
```
git clone https://gitlab.com/FraME-projects/PyFraME.git
```
The package is installed by running
```
python setup.py install
```
from the PyFraME root directory. Yu may wish to add `--user` in the last line if you do not have root access / sudo rights.
Note that this will install NumPy and Numba if they are not installed already (which can take a while).
If python3 is not your default python version, change the last command to:
```
python3 setup.py install
```
## Tests
To run the test suite type
```
nosetests
```
from the PyFraME root directory. If python3 is not your default python version, type:
```
nosetests3
```
or
```
nosetest-3
```
depending on your specific setup.
[](https://gitlab.com/FraME-projects/PyFraME/commits/master)
[](https://gitlab.com/FraME-projects/PyFraME/commits/master)
[](https://www.codacy.com/app/foeroyingur/PyFraME?utm_source=gitlab.com&utm_medium=referral&utm_content=FraME-projects/PyFraME&utm_campaign=Badge_Grade)
[](https://www.codacy.com/app/foeroyingur/PyFraME?utm_source=gitlab.com&utm_medium=referral&utm_content=FraME-projects/PyFraME&utm_campaign=Badge_Coverage)
Archived copy of current release ([0.1.0](https://gitlab.com/FraME-projects/PyFraME/tags/v0.1.0)): [](https://doi.org/10.5281/zenodo.293765)
## Description
PyFraME is a Python package that provides tools for setting up and running fragment-based multiscale embedding calculations.
The aim is to provide tools that can automatize the workflow of such calculations in a flexible manner.
The typical workflow is as follows:
1. a part of the total molecular system is chosen as the core region which is typically treated a high level of theory
2. the remainder is split into a number of regions each of which can be treated at different levels of theory
3. each region (except the core) is divided into fragments that consist of either
- small molecules
- or parts of larger molecules that have been fragmented into smaller computationally manageable fragments
4. a calculation is run on each fragment to obtain fragment parameters (if necessary)
5. all fragment parameters of all regions are assembled and constitute the embedding potential
6. a final calculation is run on the core region using the embedding potential to model the effect from the remainder of the molecular system
## How to cite
To cite PyFraME please use a format similar to the following
"J. M. H. Olsen, *PyFraME: Python tools for Fragment-based Multiscale Embedding (version 0.1.0)*, **2017**, https://doi.org/10.5281/zenodo.293765"
where the version and DOI should of course correspond to the actual version that was used. A possible BibTeX entry could be:
```
@misc{pyframe,
author = {Olsen, J. M. H.},
title = {{PyFraME}: {P}ython tools for {F}ragment-based {M}ultiscale {E}mbedding (version 0.1.0)},
year = {2017},
note = {https://doi.org/10.5281/zenodo.293765}}
```
Alternatively, BibTeX and other formats can be generated here: [](https://doi.org/10.5281/zenodo.293765)
## Requirements
To use PyFraME you need:
- [Python 3](http://www.python.org)
- [NumPy](http://www.numpy.org/)
- [Numba](https://numba.pydata.org)
For certain functionality you will need one or more of the following:
- [Dalton](http://www.daltonprogram.org)
- [LoProp for Dalton](https://github.com/vahtras/loprop)
- [Molcas 8](http://www.molcas.org)
To run the test suite you need (note that currently there are very few tests):
- [nose](http://nose.readthedocs.io/en/latest/)
## Installation
The source can be downloaded from [GitLab](https://gitlab.com/FraME-projects/PyFraME) or [Zenodo](https://doi.org/10.5281/zenodo.293765). Alternatively, it can be cloned from the repository
```
git clone https://gitlab.com/FraME-projects/PyFraME.git
```
The package is installed by running
```
python setup.py install
```
from the PyFraME root directory. Yu may wish to add `--user` in the last line if you do not have root access / sudo rights.
Note that this will install NumPy and Numba if they are not installed already (which can take a while).
If python3 is not your default python version, change the last command to:
```
python3 setup.py install
```
## Tests
To run the test suite type
```
nosetests
```
from the PyFraME root directory. If python3 is not your default python version, type:
```
nosetests3
```
or
```
nosetest-3
```
depending on your specific setup.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
PyFraME-0.1.0.tar.gz
(32.8 kB
view hashes)