XDSGUI: Difference between revisions

345 bytes removed ,  10 February 2021
Line 138: Line 138:
=== Installation ===
=== Installation ===


The program can be downloaded, by academic users, as Qt5 binary for Linux [https://{{SERVERNAME}}/pub/linux_bin/xdsgui 64bit] (compiled on RHEL6) and as Qt4 binary for [https://{{SERVERNAME}}/pub/xdsgui_qt4.dmg Mac] (works on OSX 10.6 and up). A Qt4 version is available for [https://{{SERVERNAME}}/pub/linux_bin/xdsgui.qt4 old Linux distributions] and a Qt5 version for [https://{{SERVERNAME}}/pub/mac_bin/xdsgui_qt5.dmg latest MacOS] is also available; these may have to be renamed.
The program can be downloaded, by academic users, as Qt5 binary for Linux [https://{{SERVERNAME}}/pub/linux_bin/xdsgui 64bit] (compiled on RHEL6) and as Qt4 binary for [https://{{SERVERNAME}}/pub/xdsgui_qt4.dmg Mac] (works on OSX 10.6 and up). A Qt4 version is available for [https://{{SERVERNAME}}/pub/linux_bin/xdsgui.qt4 old Linux distributions] and a Qt5 version for [https://{{SERVERNAME}}/pub/mac_bin/xdsgui_qt5.dmg latest MacOS] is also available.


Industrial users: pls contact me directly.
Industrial users: pls contact me directly.
Line 144: Line 144:
The easiest way to install XDSGUI, and all XDSGUI-related programs is documented in [[Installation]].
The easiest way to install XDSGUI, and all XDSGUI-related programs is documented in [[Installation]].


Alternatively, in case of '''Linux''', after downloading the binary file, its name should be changed to "xdsgui" and then be made executable ("chmod a+x xdsgui"). The binary may then be copied into e.g. the directory /usr/local/bin by the administrator, or to the $HOME/bin directory by the user. Any other directory should be suitable as long as it is in your $PATH. In case of a '''Mac''', the DMG file may be installed in the usual way, by double-clicking it and dragging the icon into the Applications folder. '''It is advantageous to place a symbolic link, like'''
If you want to install manually, in case of Linux, after downloading the binary file, its name should be changed to "xdsgui" and then be made executable ("chmod a+x xdsgui"). The binary may then be copied into e.g. the directory /usr/local/bin by the administrator, or to the $HOME/bin directory by the user. Any other directory should be suitable as long as it is in your $PATH. In case of MacOS, the DMG file may be installed in the usual way, by double-clicking it and dragging the icon into the Applications folder. It is advantageous to place a symbolic link, like
  sudo ln -s /Applications/xdsgui.app/Contents/MacOS/xdsgui /usr/local/bin/xdsgui
  sudo ln -s /Applications/xdsgui.app/Contents/MacOS/xdsgui /usr/local/bin/xdsgui
'''and to start the GUI from a terminal window, by typing xdsgui'''. In a similar way, XDS-viewer should be put into the $PATH under the name xds-viewer, e.g. using
'''and to start the GUI from a terminal window, by typing xdsgui'''. In a similar way, XDS-viewer should be put into the $PATH under the name xds-viewer, e.g. using
Line 150: Line 150:


==== Libraries and software that the program depends on ====
==== Libraries and software that the program depends on ====
In case of '''Fedora''' or Redhat Enterprise Linux ('''RHEL'''; same as CentOS) distributions, you may have to
 
yum install qt qt-x11
If on Linux you get an error message like
if you get the error message
  xdsgui: error while loading shared libraries: libQtGui.so.4: cannot open shared object file: No such file or directory
  xdsgui: error while loading shared libraries: libQtGui.so.4: cannot open shared object file: No such file or directory
or similar for libQtCore.so.4 or libQtOpenGL.so.4 .
or similar for libQtCore.so.4 or libQtOpenGL.so.4 , you may rather want to install the Qt5 version which is now the default.
 
RedHat Enterprise Linux 8 (CentOS 8) does not provide the needed libraries for the Qt4-based xdsgui binary. For such new distributions, you should install the new Qt5 xdsgui binary linked above.


'''Ubuntu''' needs the libglu1-mesa package if you get the error message
Procedures for identifying and installing missing libraries are shown in the [[Installation#tools_and_helper_programs_for_generate_XDS.INP_and_XDSGUI.2C_and_libraries|Installation]] article.
xdsgui: error while loading shared libraries: libGLU.so.1: cannot open shared object file: No such file or directory


On the '''Mac''' (e.g. Yosemite) one needs [https://itunes.apple.com/us/app/xcode/id497799835?ls=1&mt=12 Xcode] installed. Otherwise one may obtain a popup error “You can’t open the application because it is not supported on this type of Mac.” After installation of Xcode, run the <code>strings</code> command (once) and accept the license agreement!
On the '''Mac''' (e.g. Yosemite) one needs the (free) [https://itunes.apple.com/us/app/xcode/id497799835?ls=1&mt=12 Xcode] command line tools installed. Otherwise one may obtain a popup error like “You can’t open the application because it is not supported on this type of Mac.”


== Known bugs, problems and workarounds ==
== Known bugs, problems and workarounds ==
2,652

edits