Coder Social home page Coder Social logo

alexb67 / qmolview Goto Github PK

View Code? Open in Web Editor NEW
3.0 1.0 2.0 1.08 MB

An application for viewing normal modes, xyz and cml files. PSI4 and hfscf compatible.

License: GNU Lesser General Public License v3.0

CMake 1.98% C++ 98.02%
chemistry physics spectroscopy vibrational-analysis molecule qt3d qt psi4 hfscf normal

qmolview's Introduction

QMolView

QMolView is an application for viewing molecular xyz, cml and Molden Normal Mode files. Supported platforms are Linux and Windows 10 or later. Example files are included in the extras folder. Molden Normal Mode files can be generated with PSI4 https://psicode.org/ and hfscf https://github.com/AlexB67/hfscf.

Consult the manual in the extras/doc folder for more details.

Installation

Ready made installers for windows and Linux flatpak will be available soon. For now the only option is to build from source.

Building the software

Linux

The following packages are required:

  • cmake
  • Qt 5.15 or greater, but less than 6.0.0.
  • The following Qt5 components
    • 3DExtras
    • 3DRender
    • 3DCore
    • Widgets
    • Charts
  • GNU C++ compiler Supporting the C++17 standard.
  • Git, to clone the repository.

Install the above packages. To compile and build the application in a terminal issue the commands:

git clone https://github.com/AlexB67/QMolview.git
cd QMolview
mkdir build
cd build
cmake ..
make -j

Out of source tree builds work also if preferred.

Installation

Linux

Installations is not required. You can run the application directly from the build directory with the cammand

cd to_build_dir # path to your build directory
src/qmolview

Should you wish to install the application run the commands

cd to_build_dir # path to your build directory
sudo make install

The application can then be found in the Application list as "QMolView".

Uninstall

Linux

To remove the application run the commands

cd to_build_dir # path to your build directory
sudo xargs rm < install_manifest.txt

Linux flatpak

The benefit is that local libraries do not have to be installed, only flatpak sdks, which is easily done. The commands are also universal and work on all Linux distributions offering flatpak support.

You must have flatpak-builder and flatpak tools installed, and a compiler. The following packages are required (Note that if the hollowing Sdks are already installed, you'll be told and may skip that step, this is likely if you are already running KDE flatpaks). In the terminal type

flatpak install org.kde.sdk/5.15-21.08
flatpak install org.kde.platform/5.15-21.08

Say yes when prompted. The first download contains everything needed to compile the project. Assuming the git repo you downloaded is in MyProjects/QMolview, build the flatpak as follows where the current directory is MyProjects.

flatpak-builder ./flatpak --verbose QMolview/org.physchem.qmolview.json
flatpak-builder --install --force-clean --user ./flatpak QMolview/org.physchem.qmolview.json

clean up with

rm -rf flatpak          # be careful that you are in the right folder !
rm -rf .flatpak-builder # be careful that you are in the right folder !

QMolview is now installed and visible in the application menu of your desktop, but only available for the current user. Consult the manual for more details. Uninstall with the command

flatpak uninstall org.physchem.qmolview

Building the software

Windows

Perform a Qt installation using the Qt installer at https://www.qt.io/download

Install the MinGW compiler and the following components:

  • Qt 5.15 or greater, but less than 6.0.0.
  • The following Qt5 components
    • Qt3D
    • Widgets
    • Charts
    • Development tools Qt Creator

Use git to clone the repository or download the source tarball. The source code can then be imported as a CMake project in Qt Creator or vscode, or any IDE of your choice with CMake support.

Perform a build from within Qt Creator.

Consult the Qt website how to deploy a standalone application using windeployqt.

qmolview's People

Contributors

alexb67 avatar

Stargazers

 avatar  avatar  avatar

Watchers

 avatar

Forkers

chrinide on62

qmolview's Issues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.