Skip to content

Download, Install and Update

Jump to bottom
joaomcteixeira edited this page Dec 13, 2018 · 15 revisions 
Updated: December 2018
Farseer-NMR version: +1.3.0

Index

  1. Support
  2. Download
  3. Install
  4. Update
  5. Troubleshooting
  6. Running Farseer-NMR

Support

Farseer-NMR is fully supported for GNU/Linux 32 and 64-bits and MacOS 64-bits with high resolution screens, and partially for Windows 64-bits.

Note for Windows users: after installation you may wish to read here to understand how to run Farseer-NMR on Windows. It's very easy but non-obvious.

Farseer-NMR has been built in its entirety using Python libraries and we try to keep it up-to-date with the Python community. For additional support please contact us at [email protected].

Download

  • Download the latest version of Farseer-NMR here.
  • View the GitHub repository here - for developers.
  • If you specifically require an older version, please go through the release page here - older versions may not necessarily follow this installation tutorial.

Install

The installer of Farseer-NMR is compatible with Python 2.7 and 3.x series - it is expected to work in any system with one of these Python versions installed. Avoid using space named paths: use my_folder instead of my folder, this can hinders Farseer-NMR installation.

Simply run the command bellow and follow the given instructions:

python install_farseernmr.py

There are two installation routines: automatic and manual.

  • The automatic (recommended) option will install a Miniconda distribution in the Farseer-NMR folder with all the required Python libraries, this Miniconda installation will not conflict with your system's Python installation. Also, the executable files will be configured accordingly.
  • The manual installation will create TEMPLATE executable files. You should manually configure all the required Python libraries for Farseer-NMR as well as the compatibility between the executable files and those Python libraries, for example via shebangs. You can use the farseernmr.yml file inside the install folder to guide you in the required Python dependencies.

The installation option will create an install.log file. If you have doubts to not hesitate in contacting us to [email protected] and provide the install.log file.

Update

If the installation process completes successfully, a farseer_update file will be created inside the bin folder. Simply run this executable file to update Farseer-NMR to the latest version.

If the updater fails please mail us ([email protected]) with the update.log file. At any time you can remove the Farseer-NMR folder and reinstall Farseer-NMR again following the Download and Installation sections.

Troubleshooting

GUI displaying badly

The current GUI was optimized to high resolution screens. It will fail to display properly on low resolution screens.

Some MacOSX users have experienced bad GUI display on small sized yet high resolution retina screens.

We are very thankful for your patient and we are working hard to solve this GUI issue as soon as possible.

PyQt GUI not launching

Some Linux users have experienced the following error:

This application failed to start because it could not find or load the Qt platform plugin "xcb"
in "".

Available platform plugins are: minimal, offscreen, xcb.

Reinstalling the application may fix this problem.

Solution: add the following to the beginning of your .bashrc file or terminal env:

"LD_LIBRARY_PATH=/usr/lib"

Running Farseer-NMR

Now that you have installed Farseer-NMR, checkout here how to run it ;-).

Clone this wiki locally