User Tools

Site Tools


software:gettingstartedmax

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
software:gettingstartedmax [2023/12/09 22:25] smerkelsoftware:gettingstartedmax [2026/08/10 09:05] (current) smerkel
Line 1: Line 1:
-====== Getting started on a mac ======+====== Getting started with Anaconda ======
  
 A minimal set of data processing tools could include A minimal set of data processing tools could include
-  * [[software:fabian|Fabian]] : to look at diffraction images and median calculations+  * [[timeless_viewer|TIMEleSS Viewer]] : to look at diffraction images and median calculations
   * [[software:imaged11|ImageD11]]: script for peak search, experimental parameters refinement, peak assignment, can do grain indexing, and many others   * [[software:imaged11|ImageD11]]: script for peak search, experimental parameters refinement, peak assignment, can do grain indexing, and many others
   * [[software:grainspotter|GrainSpotter]]: grain indexing   * [[software:grainspotter|GrainSpotter]]: grain indexing
Line 8: Line 8:
  
 Those are themselves built against a suite of libraries and could be hard to get working. Those are themselves built against a suite of libraries and could be hard to get working.
 +
  
 ===== Step 1: Anaconda ===== ===== Step 1: Anaconda =====
  
-From the [[https://www.anaconda.com|Anaconda]] website,  +Anaconda is a wrapper the install programming environments that runs on Windows, macOS, and Linux. Conda should be able to quickly installrun, and update packages and their dependencies. It also easily creates, saves, loads, and switches between environments on your local computer.
-<WRAP center round help 60%> +
-Conda is an open-source package and environment management system that runs on Windows, macOS, and Linux. Conda quickly installsruns, and updates packages and their dependencies. It also easily creates, saves, loads, and switches between environments on your local computer. It was created for Python programs, but it can package and distribute software for any language. +
-</WRAP>+
  
-In fact, Anaconda is the easiest route to get multigrain data processing working on a macYou first step is hence to [[https://docs.anaconda.com/free/anaconda/install/mac-os/ | install Anaconda on your mac]].+In recent years, however, Anaconda has become very bloated. You need to pay for services, and it is challenging to use. The main author of this wiki hence does not recommend Anaconda anymore and recommends installing a [[processing:minimal_software_intallation|dedicated python environement]]. 
 + 
 +If you have Anaconda working and would like to use it. The instructions are below. 
 + 
 +==== Anaconda on a mac ==== 
 + 
 +You first step is hence to [[https://docs.anaconda.com/free/anaconda/install/mac-os/ | install Anaconda on your mac]].
  
 Once Anaconda is installed,  Once Anaconda is installed, 
Line 22: Line 26:
   * You should see something like ''Python 3.6.3 | Anaconda Inc. |''   * You should see something like ''Python 3.6.3 | Anaconda Inc. |''
   * At the Python REPL (the Python ''>>>'' prompt), exit out of the Python REPL using the command ''exit()''   * At the Python REPL (the Python ''>>>'' prompt), exit out of the Python REPL using the command ''exit()''
 +
 +===== Step 2: Getting started =====
  
 The following packages should be installed from anaconda to avoid compatibility issues The following packages should be installed from anaconda to avoid compatibility issues
Line 31: Line 37:
   * OpenPG: ''conda install  pyopenGL''   * OpenPG: ''conda install  pyopenGL''
  
-Then there are two packages with ended up conflicting when trying to install using conda. Resorting to pip instead:+Then there are two packages wich ended up conflicting when trying to install using conda. Resorting to pip instead:
   * fabio: ''python -m pip install fabio''   * fabio: ''python -m pip install fabio''
   * pyopengltk: ''python -m pip install pyopengltk''   * pyopengltk: ''python -m pip install pyopengltk''
  
-===== Step 2: Fable-3XRD packages with pip or automated install =====+You also need to install ''silx'', either with the ''conda'' command or ''pip'', whatever works. 
 + 
 +===== Step 3: Fable-3XRD packages with pip or automated install =====
  
 Python packages can be installed from source, downloading the source code from the original website, or through [[https://pip.pypa.io/en/stable/ | pip]]. Source download will always get you the latest version, with the latest developments. Installation with pip is much easier, but may not be the most up-to-date. Python packages can be installed from source, downloading the source code from the original website, or through [[https://pip.pypa.io/en/stable/ | pip]]. Source download will always get you the latest version, with the latest developments. Installation with pip is much easier, but may not be the most up-to-date.
Line 56: Line 64:
 Other packages are required but need to be installed from the [[https://github.com/FABLE-3DXRD | Fable-3DXRD source at github]]: Other packages are required but need to be installed from the [[https://github.com/FABLE-3DXRD | Fable-3DXRD source at github]]:
   * [[software:polyxsim|polyxsim]] (used by some of the TIMEleSS-tools)   * [[software:polyxsim|polyxsim]] (used by some of the TIMEleSS-tools)
-  * [[software:fabian|fabian]]+  * [[timeless_viewer|TIMEleSS Viewer]]
  
 For both, procedure is identical For both, procedure is identical
Line 68: Line 76:
  
 [[software:grainspotter|GrainSpotter]] is a C program which, on a mac, is not readily available in anaconda [[software:grainspotter|GrainSpotter]] is a C program which, on a mac, is not readily available in anaconda
-  * download the GrainSpotter source code from +  * Download the GrainSpotter source code from [[https://sourceforge.net/p/fable/code/HEAD/tree/GrainSpotter/trunk/]], 
 +  * Move into the folder with GrainSpotter and type ''make'', 
 +  * Copy ''GrainSpotter.0.90'' somewhere where you can access it easily. This is the executable.
  
 +It should work out of the box.
  
-By now, you should be done and have a minimal working installation on your mac.+By now, you should be done and have a minimal working installation on your system.
  
  
software/gettingstartedmax.1702157103.txt.gz · Last modified: by smerkel