A visualisation tool for chemical structures.

Navigation

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for ab5424 from gravatar.com ab5424 Avatar for michel_heinz from gravatar.com michel_heinz

Unverified details

These details have not been verified by PyPI
Meta
  • License: GNU General Public License v3 (GPLv3) (GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc...)
  • Author: Gereon Feldmann
  • Maintainer: Michel Heinz, Gereon Feldmann, Adrian Usler, Alexander Bonkowski
  • Tags analysis, science, structure, visualisation
  • Requires: Python >=3.10
  • Provides-Extra: doc, tests, dev, strict, compchem, crystal
Classifiers

Project description

inPsights Logo

Logo: Nicole Maser

PyPI version CI Status code coverage pre-commit.ci status Zenodo

Molara

Molara is an open-source program for the 3-dimensional visualization of molecules and crystal structures. These are some of its main features:

  1. Import of .xyz, .coord, and POSCAR files
  2. Export of rendered structures as raster graphics
  3. Tools for creating custom molecular and crystal structures
  4. Animation of trajectories
  5. Display of molecular orbitals from molden files (currently Orca, Molpro, and Terachem)
  6. Display of densities from cube files

New features will follow soon!

Installation

Simple User installation

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.

Developer installation

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).

Known issues

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.

Building the documentation locally

To generate the documentation, install molara as follows:

pip install -e . molara[doc]

then run

cd docs
make html

Supported by

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