Differences

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

--- software:grainspotter [2018/07/13 15:10] – matthias
+++ software:grainspotter [2026/08/10 10:28] (current) – smerkel
@@ Line 13: / Line 13: @@
 ==== Installation ====
-You have basically two options for getting GrainSpotter. One is with the help of Anaconda, the other one I forgot. However, Anaconda is the more convenient one, anyway. So first of all, get yourself Anaconda: [[https://www.anaconda.com/download/#linux]]
+You have basically two options for getting GrainSpotter. One is with the help of Anaconda, or from the source.
-Then go to the [[https://anaconda.org/|Anaconda Cloud]] with your browser and search the cloud for //grainspotter//. Then click on //Files// and download the Linux version. Unpack it to a directory of your choice.
+=== Installation with Anaconta ===
-Go back to your browser and click on //Conda//. There is a short code which is necessary to install GrainSpotter. It should be something like this:
+First of all, get yourself Anaconda: [[https://www.anaconda.com/download/#linux]]
-  conda install -c fable grainspotter
+Then go to the [[https://anaconda.org/|Anaconda Cloud]] with your browser and search the cloud for //grainspotter//. Then click on //Files// and download the Linux version. Unpack it to a directory of your choice.
+Go back to your browser and click on //Conda//. There is a short code which is necessary to install GrainSpotter. It should be something like ''conda install -c fable grainspotter''
 Copy the code to your Konsole and follow the installation instructions.
+=== Installation from the source code ===
+The installation requires a C compiler installed in your system.
+  - 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'',
+  - Log-in as administrator (root) and type ''make install''.
+It should work out of the box.
+On some machines, the compiling fails because of an undefined function ''my_atan'' in ''src/index/pseudodata.c''. In such case
+  * open the code for ''src/index/pre_calculation.c''
+  * copy the code for the ''my_atan'' function, between lines 39 and 50
+  * replace line 20 in ''src/index/pseudodata.c'' with the lines you copied just above
+  * re-run the ''make''
+  * it should work.
 ===== Running the software =====
@@ Line 34: / Line 53: @@
 The algorithm produces a //.log// file, a //.spe// file and a //.gve// file.
+===== Manual =====
+There is a brief manual online at [[https://sourceforge.net/p/fable/code/HEAD/tree/GrainSpotter/trunk/doc/]].
+Otherwise, you should have a look at the following pages
+  * [[processing:indexing_with_grainspotter|Grain indexing with GrainSpotter]]
+  * [[processing:complex-multi-phase|In the works: indexing a complex dataset with many phases]]