Installation: Difference between revisions

Jump to navigation Jump to search
→‎macOS: explain Intel Mac versus Silicon Mac
(→‎macOS: continued)
Tags: Mobile edit Mobile web edit Advanced mobile edit
(→‎macOS: explain Intel Mac versus Silicon Mac)
Tags: Mobile edit Mobile web edit Advanced mobile edit
Line 81: Line 81:
== macOS ==
== macOS ==


Become familiar with the concept and ways to run commands as "root" (administrator) - google "mac osx become root". All the installation tasks that are run in a Terminal window require root privileges, since some of the programs and their links are written to /usr/local/bin. (As an alternative that does not require root for installation, one may create a directory $HOME/bin and use that for the programs and links. That would also require modification of the $PATH, by a one-time  
Become familiar with the concept and ways to run commands as "root" (administrator) - google "mac osx become root". All the installation tasks that are run in a Terminal window require root privileges, since some of the programs and their links are written to /usr/local/bin.  
 
Therefore, if /usr/local/bin does not yet exist, prepare the following steps by opening the Terminal window, and then
sudo mkdir /usr/local/bin
 
As an alternative that does not require root for installation, one may create a directory $HOME/bin and use that for the programs and links. Also, this requires modification of the $PATH, by a one-time  
mkdir $HOME/bin
  echo 'export PATH=$PATH:$HOME/bin' >> ~/.profile
  echo 'export PATH=$PATH:$HOME/bin' >> ~/.profile
  echo 'export PATH=$PATH:$HOME/bin' >> ~/.zprofile</code>
  echo 'export PATH=$PATH:$HOME/bin' >> ~/.zprofile</code>
)


If /usr/local/bin does not yet exist, prepare the following steps by opening the Terminal window, and then
=== [[XDS]] package for Intel Macs ===
sudo mkdir /usr/local/bin
 
=== [[XDS]] package ===
If you are an academic user,
If you are an academic user,


Line 99: Line 101:
  # release root permissions:
  # release root permissions:
  exit
  exit
 
(If you don't have root permissions, only the curl and ln commands have to be run in $HOME/bin)
Starting with macOS Catalina, you may also need
Starting with macOS Catalina, you may also need
  sudo xattr -dr XDS-OSX_64/*
  sudo xattr -dr XDS-OSX_64/*
if you get a security error popup (google "xattr com.apple.quarantine catalina").
if you get a security error popup (google "xattr com.apple.quarantine catalina").


Then make sure that the binaries are in the search path for executables, as explained in https://xds.mr.mpg.de/html_doc/downloading.html .
Then make sure that the binaries are in the search path for executables, as also explained in https://xds.mr.mpg.de/html_doc/downloading.html .


If you want to process .h5 files written by Eiger detectors on a Mac with Intel CPU, use the [https://{{SERVERNAME}}/pub/mac_bin/durin-plugin.so Durin plugin for Intel Mac processors] (source code [https://github.com/DiamondLightSource/durin available]) or the [https://{{SERVERNAME}}/pub/mac_bin/dectris-neggia.so Dectris-Neggia plugin for Intel Mac processors] (source code [https://github.com/dectris/neggia available]). The latter may be faster, but does not work on data collected at Diamond Light Source. The former should in principle work for all HDF5 data. See [[Installation#other_programs:_XDS-viewer,_XDSSTAT,_XDSCC12,_XDSGUI,_XSCALE_ISOCLUSTER,_generate_XDS.INP|below]] for installation of these .so files.
If you want to process .h5 files written by Eiger detectors on a Mac with Intel CPU, use the [https://{{SERVERNAME}}/pub/mac_bin/durin-plugin.so Durin plugin for Intel Mac processors] (source code [https://github.com/DiamondLightSource/durin available]) or the [https://{{SERVERNAME}}/pub/mac_bin/dectris-neggia.so Dectris-Neggia plugin for Intel Mac processors] (source code [https://github.com/dectris/neggia available]). The latter may be faster, but does not work on data collected at Diamond Light Source. The former should in principle work for all HDF5 data. See [[Installation#other_programs:_XDS-viewer,_XDSSTAT,_XDSCC12,_XDSGUI,_XSCALE_ISOCLUSTER,_generate_XDS.INP|below]] for installation of these .so files.
Line 112: Line 114:
See [[Installation#other_programs:_XDS-viewer,_XDSSTAT,_XDSCC12,_XDSGUI,_XSCALE_ISOCLUSTER,_generate_XDS.INP|below]] for installation of these .so files.
See [[Installation#other_programs:_XDS-viewer,_XDSSTAT,_XDSCC12,_XDSGUI,_XSCALE_ISOCLUSTER,_generate_XDS.INP|below]] for installation of these .so files.


==== considerations for a macOS machine with Apple M1 or M2 processor ====
==== XDS package for Macs with Apple M processors ====
 
The Intel Mac XDS programs also work on the Apple Silicon machines, but the libraries for e.g. reading data from Eiger detectors don't, and the native binaries are faster.


Change the above <code>curl</code> and <code>ln</code> commands to
Thus, change the above <code>curl</code> and <code>ln</code> commands to
  # become root (it will ask for your password):
  # become root (it will ask for your password):
  sudo su
  sudo su
2,684

edits

Cookies help us deliver our services. By using our services, you agree to our use of cookies.

Navigation menu