Installation instructions

If you like not to touch your Linux or MacOS installation, it is possible to run XDSAPP3 in an isolated Python environment with miniforge. To do so, install miniforge from https://github.com/conda-forge/miniforge. with miniforge you can avoid licensing problems that may occur with Anaconda (commercial licence). During the installation, chose not to modify your shell  startup script. Instead, create a file named xdsapp3.sh or similar with content:

example tcsh:

#!/bin/tcsh
# setup PATH to python3
set path_stored="$PATH"
setenv PATH /path/to/miniforge3/bin:$PATH
# to avoid OMP crash of XDS (Linux only)
setenv KMP_INIT_AT_FORK FALSE
# start xdsapp3
python /path/to/xdsapp3/xdsapp3.1.py $argv:q
#restore PATH
setenv PATH $path_stored

example bash:

#!/bin/bash
# setup PATH to python3
path_stored="$PATH"
export PATH=/path/to/miniforge3/bin:$PATH
# to avoid OMP crash of XDS (Linux only)
export KMP_INIT_AT_FORK=FALSE
# start xdsapp3
python /path/to/xdsapp3/xdsapp3.1.py $@
#restore PATH
export PATH $path_stored

If you like not to touch your Linux or MacOS installation, it is possible to run XDSAPP3 in an isolated Python environment with Anaconda. To do so, install the "Individual Edition" from the anaconda.com home page. If Anaconda is not an option for licensing reasons, see the miniforge tip. During the installation, chose not to modify your shell  startup script. Instead, create a file named xdsapp3.sh or similar with content:

example tcsh:

#!/bin/tcsh
# setup PATH to python3
set path_stored="$PATH"
setenv PATH /path/to/anaconda3/bin:$PATH
# to avoid OMP crash of XDS (Linux only)
setenv KMP_INIT_AT_FORK FALSE
# start xdsapp3
python /path/to/xdsapp3/xdsapp3.1.py $argv:q
#restore PATH
setenv PATH $path_stored

example bash:

#!/bin/bash
# setup PATH to python3
path_stored="$PATH"
export PATH=/path/to/anaconda3/bin:$PATH
# to avoid OMP crash of XDS (Linux only)
export KMP_INIT_AT_FORK=FALSE
# start xdsapp3
python /path/to/xdsapp3/xdsapp3.1.py $@
#restore PATH
export PATH $path_stored

There seems to be a bug in a multiprocessing library, which causes to crash xds_par (the parallel processing version of xds). A workaround is to set the environment variable KMP_INIT_AT_FORK to FALSE, e.g:
bash: export KMP_INIT_AT_FORK=FALSE
tcsh: setenv KMP_INIT_AT_FORK FALSE

macOS 10.13 (High Sierra)

Install Xcode including the Command Line Tools
install Qt5, PyQt5, and Python3, and Matplotlib:
with Anaconda3 (everything is included)
or
homebrew:
(this requires the previous installation of Xcode)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
Then the rest of the packages can be easily installed:
brew install qt (will install Qt5)
brew install pyqt
Copy the line
export PYTHONPATH=/usr/local/lib/python3.7/site-packages:$PYTHONPATH
into your ~/.bashrc or ~/.bash_profile file (for the bash shell) for
future uses of XDSAPP3.

install hdf5 with e.g.
brew install hdf5

 

MacOS 10.15 (Catalina) , 11.1 (Big Sur)

See MacOS 10.13. In addition:

On macOS Catalina many of the programs used by XDSAPP3 will not run
immediately because they were not written by an "identified developer".
Try this:
* delete a possible quarantine attribute: >xattr -d com.apple.quarantine program
* start a program from the command line, there will be a message
* open System Preferences
* go to Security & Privacy and select the General tab
* click the button "Open Anyway"
* run the program again and acknowledge the pop-up message

(For the adventurous:
in terminal, activate a hidden option in Security & Privacy:
sudo spctl --master-disable
This will show a "Anywhere" button in the General tab. To revert it
sudo spctl --master-enable
Be aware of the risk to install malware, if you leave this option active.

On macOS Catalina make sure you have PyQt 5.12.3 installed, PyQt 5.9.2 will crash when opening a file selection dialog.

On macOS Catalina sometimes the XDSAPP3 GUI will not respond, click in the desktop and then back to the GUI.

MacOS Big Sur on Apple Silicon M1 Macs

There are M1 native versions of XDS, the neggia plugin and the durin-plugin available on the XDS wiki page.