\(\renewcommand{\AA}{\text{Å}}\)

2.10. Troubleshooting

2.10.1. Testing if Python can launch LAMMPS

To test if LAMMPS is callable from Python, launch Python interactively and type:

>>> from lammps import lammps
>>> lmp = lammps()

If you get no errors, you’re ready to use LAMMPS from Python. If the second command fails, the most common error to see is

OSError: Could not load LAMMPS dynamic library

which means Python was unable to load the LAMMPS shared library. This typically occurs if the system can’t find the LAMMPS shared library or one of the auxiliary shared libraries it depends on, or if something about the library is incompatible with your Python. The error message should give you an indication of what went wrong.

If your shared library uses a suffix, such as liblammps_mpi.so, change the constructor call as follows (see Creating or deleting a LAMMPS object for more details):

>>> lmp = lammps(name='mpi')

You can also test the load directly in Python as follows, without first importing from the lammps module:

>>> from ctypes import CDLL
>>> CDLL("liblammps.so")

If an error occurs, carefully go through the steps in Installing the LAMMPS Python Module and Shared Library and on the Build_basics page about building a shared library.