Molara is an open-source program for the 3-dimensional visualization of molecules and crystal structures. These are some of its main features:
- Import of .xyz, .coord, and POSCAR files
- Export of rendered structures as raster graphics
- Tools for creating custom molecular and crystal structures
- Animation of trajectories
- Display of molecular orbitals from molden files (currently Orca, Molpro, and Terachem)
New features will follow soon!
The easiest way to install Molara is from PyPi using pip.
pip install molara
After the installation, Molara can be started by calling molara
from the command line.
If you want to contribute to Molara, you should install the package directly from source. To this end, you need to clone the repository:
git clone <this repo>
cd Molara
Tip
It is advisable to install Molara in a virtual Python environment.
Create & activate virtual environment on Linux / Mac:
python -m venv ./venv
source ./venv/bin/activate
Create & activate virtual environment on Windows:
python -m venv .\venv
.\venv\Scripts\activate.bat
Subsequently, Molara may be installed as follows.
pip install -e .
Important
The installation from source with pip install -e .
involves a Cython build, for which it is required that a C compiler be installed on the system (a more detailed description can be found here).
Due to Apple's non existing support for OpenGL, displaying the indices of the atoms takes long for the first time. However after that it is instantaneous, even after restarting the program and rebooting the machine. As a solution we need to rework this routine with another strategy.
To generate the documentation, install molara as follows:
pip install -e . molara[doc]
then run
cd docs
make html