Installation

The basis of the program is a module called “plot_func.py” that contains all the necessary functions and classes. We provide a series of jupyter based work flow packages that guide the user through a series of typical tasks during the analysis of optical transient absorption data and that we strongly recommend. The files can be downloaded from the github directory https://github.com/erdzeichen/KiMoPack and manually installed (added to the path). Alternatively we recommend the usage of the usual python install commands “pip” or if the distribution is using the Anaconda package manager, The conda type installation. For both please open a command line (e.g. using “cmd” in windows) and execute the following commands. The Jupyter notebooks are copied during the install process. The notebooks can also be downloaded from the github server https://github.com/erdzeichen/KiMoPack.

Install using “pip”:

$ pip install KiMoPack

Upgrade if already installed:

$ pip install KiMoPack -U

Install and update using “conda” from the channel erdzeichen:

$ conda install -c erdzeichen kimopack

Workflow tools

While KiMoPack is a python library, we facilitate its use with Jupyter notebooks. For the typical analysis tasks we have developed a series of Notebooks that guide through the tasks.n These notebooks can be downloaded from https://github.com/erdzeichen/KiMoPack/tree/main/Workflow_tools or by command line.

To do that start any console (under windows e.g. type “cmd” and hit enter). In the console you then start python by typing “python” and hit enter, lastly you import Kimopack and run a function that downloads the files for you by typing “import KiMoPack.plot_func as pf; pf.download_all()” This downloads the notebooks and tutorials from github for you. If you instead use “import KiMoPack.plot_func as pf; pf.download_notebooks()” then only the workflow tools are downloaded. Please copy one of these notebooks into your data analysis folder and rename them to create a analysis log of your session. For more information please see the publication https://doi.org/10.1021/acs.jpca.2c00907, the tutorial videos, or the tutorial notebooks under https://github.com/erdzeichen/KiMoPack/tree/main/Tutorial_Notebooks_for_local_use.

Under windows this would be:

$ pip install nbopen

$ python -m nbopen.install_win

For more information on the use of these notebooks see the publication https://doi.org/10.1021/acs.jpca.2c00907, the tutorial videos, or the tutorial notebooks under https://github.com/erdzeichen/KiMoPack/tree/main/Tutorial_Notebooks_for_local_use.