Skip to main content

simetuc: Simulating Energy Transfer and Upconversion

Project description

simetuc
=======

Simulating Energy Transfer and Upconversion

--------------

|License| |Python version| |Pypi version| |Anaconda version| |Build
Status| |Coverage Status|

Installation
------------

Python 3.5 or 3.6 is required. Installing
`Anaconda <https://www.continuum.io/downloads>`__ is recommended; it
works with Windows (64/32 bits), Linux (64/32 bits) and Mac (64 bits).

After installing Anaconda execute the following command at the command
prompt (cmd.exe for Windows, shell for Linux and Mac):

::

conda config --add channels conda-forge
conda config --add channels pedvide
conda install simetuc
(The first two commands add packages repositories with up-to-date versions of all needed packages.)

or

::

pip install simetuc

That will download and install all necessary files.

Note: Some OSX users report problems using conda, if after installing
you can't use the program (i.e., ``simetuc -h`` fails because simetuc
wasn't recognized as a command), use ``pip install simetuc``

Update
~~~~~~

If you installed it using conda, update with:

::

conda update -c pedvide simetuc

If you installed it with pip, update with:

::

pip install -U simetuc

Features
--------

- Command line interface program.

- Run with: ``simetuc config_file.txt [options]``
- See all options below and with: ``simetuc -h``

- The simulations are controlled by a configuration text file that the
user can edit with the parameters adequate to its system of study. It
includes:

- Information about the host lattice.
- Energy states labels.
- Absorption and excitation (including ESA).
- Decay (including branching ratios).
- Energy transfer.
- Other settings for the power and concentration dependence or
optimization.

- simetuc works with any sensitizer and activator ion kind.

- The examples are given for the Yb-Tm system.

- All kinds of energy transfer processes are supported:

- Energy migration.
- Upconversion (ETU).
- Downconversion.
- Cross-relaxation.
- Cooperative processes.
- Energy transfer from sensitizers to activators.
- Back transfer from activators to sensitizers.

- See the example `configuration file <https://github.com/pedvide/simetuc/blob/master/simetuc/config_file.cfg>`__ in
the simetuc folder.
- Add decay experimental data as two column text data, separated by
tabs or spaces.
- Different options:

- Create the lattice.
- Simulate the dynamics (rise and decay).
- Optimize the energy transfer parameters.

- Minimize the deviation between experiment and simulation.

- Simulate the steady state.
- Simulate the power dependence of each emission.
- Simulate the concentration dependence of the dynamics or the
steady state.

- All results are plotted and saved in the .hdf5 format.
- For all options ``--average`` uses standard average rate equations
instead of microscopic ones.

Documentation
-------------

See the `manual <https://github.com/pedvide/simetuc/blob/master/docs/manual/simetuc_user_manual.pdf>`__.

TODO
----

- [ ] Add pressure dependence option: Change the distances of the
lattice and simulate dynamics or steady-state.
- [ ] Read experimental data in more formats.
- [x] Add cooperative sensitization (work in progress).
- [ ] Include pulse frequency for steady state simulations using a non
cw laser

Bugs/Requests
-------------

Please use the `GitHub issue
tracker <https://github.com/pedvide/simetuc/issues>`__ to submit bugs or
request features.

Publications
------------

This software has been described and used in these publications:

- Villanueva-Delgado, P.; Krämer, K. W. & Valiente, R. `Simulating
Energy Transfer and Upconversion in β-NaYF4: Yb3+,
Tm3+ <http://pubs.acs.org/doi/10.1021/acs.jpcc.5b06770>`__
- Villanueva-Delgado, P.; Krämer, K. W.; Valiente, R.; de Jong, M. &
Meijerink, A. `Modeling Blue to UV Upconversion in β-NaYF4:
Tm3+ <http://pubs.rsc.org/en/Content/ArticleLanding/2016/CP/C6CP04347J#!divAbstract>`__

If you use this software in a scientific publication, please cite the
appropriate articles above.

Acknowledgments
---------------

The financial support of the EU FP7 ITN LUMINET (Grant agreement No.
316906) is gratefully acknowledged.

This work was started at the University of Cantabria under Prof. Rafael
Valiente and continued at the University of Bern under PD Dr. Karl
Krämer.

License
-------

Copyright Pedro Villanueva Delgado, 2016-2017.

Distributed under the terms of the `MIT <https://github.com/pedvide/simetuc/blob/master/LICENSE.txt>`__ license,
simetuc is free and open source software.

.. |License| image:: https://img.shields.io/github/license/pedvide/simetuc.svg
:target: https://github.com/pedvide/simetuc/blob/master/LICENSE.txt
.. |Python version| image:: https://img.shields.io/pypi/pyversions/simetuc.svg
:target: https://pypi.python.org/pypi/simetuc
.. |Pypi version| image:: https://img.shields.io/pypi/v/simetuc.svg
:target: https://pypi.python.org/pypi/simetuc
.. |Anaconda version| image:: https://anaconda.org/pedvide/simetuc/badges/version.svg
:target: https://anaconda.org/pedvide/simetuc
.. |Build Status| image:: https://travis-ci.org/pedvide/simetuc.svg?branch=master
:target: https://travis-ci.org/pedvide/simetuc
.. |Coverage Status| image:: https://coveralls.io/repos/github/pedvide/simetuc/badge.svg?branch=master
:target: https://coveralls.io/github/pedvide/simetuc?branch=master


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

simetuc-1.2.0.tar.gz (52.3 kB view details)

Uploaded Source

Built Distribution

simetuc-1.2.0-py3-none-any.whl (55.9 kB view details)

Uploaded Python 3

File details

Details for the file simetuc-1.2.0.tar.gz.

File metadata

  • Download URL: simetuc-1.2.0.tar.gz
  • Upload date:
  • Size: 52.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for simetuc-1.2.0.tar.gz
Algorithm Hash digest
SHA256 c2d60c0d3b611aeb4de0f53fc98bad78670706af7238f18b5d45a30568a3f9a0
MD5 e6c51e49e328aa4bce45b1becb2ecee1
BLAKE2b-256 7b5322a35e009df7738c766b1fb7813cfb032b96045e691a96e3b132ad4f9489

See more details on using hashes here.

File details

Details for the file simetuc-1.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for simetuc-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c403f8426e4e809301389d5d0cd3854ff4954eb649a8ca20df86d2cbd4721a05
MD5 f19825cdc13f3e018a13e13c795c741c
BLAKE2b-256 7bd2a5874ef6b6f68a8b11363e3bc85e94281f3e6697c1e79a3c6659aea8539c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page