PyLSD installation

Software dependencies

Download pyLSD

Package contents

The downloaded archive file contains three directories:

The defaults.py configuration file

The defaults.py configuration file, in the Variant directory, contains computer dependent file locations that must be adjusted in order to have the parts of PyLSD running together. A backup copy named defaults_orig.py has already been created. Defaults.py lines like self.xxx = yyy define the value of parameter xxx as equal to yyy. The user is supposed to run pyLSD from the command line, with Variant as current directory. File edition under Windows may be carried out with the Notepad tool, or alternatively with notepad++. The following lines may be changed:

Testing your installation

A new window with the two solutions of the breg57 problem should pop up on the computer screen.

First-aid

The resolution of the breg57.lsd problem generates files in the following order:

  1. base.txt: the list of all atom status known to pyLSD at the time it has been launched.
  2. ../Predict/breg57_C.txt: the pilot file for the chemical shift prediction and ranking.
  3. ../LSD/Data/breg57_1: the (only) input file for ../LSD/lsd.
  4. ../LSD/Data/breg57_1.sol: the solution file from ../LSD/Data/breg57_1, generated by ../LSD/lsd.
  5. ../LSD/Data/breg57_0.sol: the collection of all the solutions in a single solution file.
  6. ../Predict/breg57_0.sdf: SD file for the chemical shift prediction and ranking, from ../LSD/outlsd (option 10).
  7. ../Predict/breg57_R.txt: the file that contains the result of the chemical shift prediction and ranking, from java
  8. ../Predict/breg57_D.sdf: like ../Predict/breg57_0.sdf but ranked in the decreasing order of solution likelihood, from java. Unsued.
  9. ../LSD/Data/breg57_Ranked.sol: like ../LSD/Data/breg57_0.sol, but ranked according to ../Predict/breg57_R.txt.
  10. ../LSD/Data/breg57_0.coo: coordinate file from ../LSD/Data/breg57_Ranked.sol, generated by ../LSD/outlsd (option 6)
  11. ../LSD/Data/breg57_0.sdf: SD file from ../LSD/Data/breg57_Ranked.sol, generated by ../LSD/outlsd (option 7)
  12. ../LSD/Data/breg57_0.ps: Postscript file, from ../LSD/Data/breg57_0.coo, generated by ../LSD/genpos

The absence of some of these files might help to determine if prerequites are not met. A stop after step 3 means that the lsd executable file has not been found. A stop after step 5 means that the outlsd executable file has not been found. A stop after step 6 means that something went wrong with java or with the chemical shift predictor. A stop after step 11 means that something went wrong with genpos. If the .ps file is created after step 12 and is valid but if no window pops up, then the viewer is not accessible. The .coo, .sdf or .ps files may have been created but simply filled with only an error message.

Linux users might feel the need to recompile the LSD binaries from source. For this purpose, open a command line interpreter, change the current directory to "LSD", type make clean, and then sh install.sh.

Contact

jean.marc.nuzillard@gmail.com