PyUNIxMD is an object-oriented Python program for molecular dynamics simulations involving multiple electronic states. It is mainly for studying the nonadiabatic dynamics of excited molecules.
When you publish a work using any part of PyUNIxMD code, please cite the following publication:
- PyUNIxMD: A Python-based excited state molecular dynamics package. J. Comp. Chem. 2021, DOI: 10.1002/jcc.26711
- Python 3.6 or later
- Numpy
- Cython https://cython.org
You can easily install the latest Numpy and Cython via Python's pip command.
$ pip install --upgrade numpy Cython
You can build PyUNIxMD by the following command.
$ python3 setup.py build_ext -b ./src/build
Without the aid of external QM programs, You can test the PyUNIxMD package with model systems. The corresponding examples are:
- $PYUNIXMDHOME/examples/qm/Eh-Shin_Metiu
- $PYUNIXMDHOME/examples/qm/SHXF-SAC
- $PYUNIXMDHOME/examples/qm/SHXF-Shin_Metiu
$PYUNIXMDHOME is the top-level directory where this file belongs.
In each directory, you can find the running script named run.py.
Before running test jobs, add the path of the PyUNIxMD package to your Python path.
$ export PYTHONPATH=$PYUNIXMDHOME/src:$PYTHONPATH
Then execute run.py as follows.
$ python3 run.py >& log
PyUNIxMD provides other Python scripts to analyze results of dynamics calculations. To use the scripts, you need to add the path of the scripts.
$ export PYTHONPATH=$PYUNIXMDHOME/util:$PYTHONPATH
If you have Sphinx, you can locally build the manual of PyUNIxMD by the following command.
$ cd docs $ make html