Skip to content
GitLab
An error occurred while loading the file. Please try again.
Switch branch/tag
Find file BlameHistoryPermalink
INSTALL 4.09 KiB
Open in Web IDE
1 
Installing the software
2 
***********************
3
4 
Hardware requirements
5 
=====================
6
7 
PSFEx runs in (ANSI) text-mode from a shell. A window system is
8 
not necessary for basic operation.
9
10 
When it comes to memory usage, the amount required by SExtractor depends
11 
mostly on the size of the input images and especially on the presence of
12 
the so-called "check images". But in most cases it is less than one
13 
gigabyte.
14
15
16 
Obtaining SExtractor
17 
====================
18
19 
For Linux users, the simplest way to have SExtractor up and running is
20 
to install the standard binary package that comes with your Linux
21 
distribution. Run, e.g., "apt-get sextractor" (on Debian) or
22 
"dnf install sextractor" (Fedora) and SExtractor, as well as all its
23 
dependencies, will automatically be installed. If you decided to install
24 
the package this way you're all set!
25 
However if SExtractor is not available in your distribution, or to
26 
obtain the most recent version, the SExtractor source package can be
27 
downloaded from the official GitHub repository. One may choose one of
28 
the stable releases, or for the fearless, a copy of the current master
29 
development branch.
30
31
32 
Software requirements
33 
=====================
34
35 
SExtractor has been developed on GNU/Linux machines and should compile
36 
on any POSIX-compliant system (this includes Apple OS X and Cygwin
37 
on Microsoft Windows, at the price of some difficulties with the
38 
configuration), provided that the development packages of the
39 
following libraries have been installed:
40
41 
* ATLAS V3.6 and above [2],
42
43 
* FFTw V3.0 and above [3],
44
45 
On Fedora/Redhat distributions for instance, the development packages
46 
above are available as "atlas-devel" and "fftw-devel".
47 
ATLAS and FFTw are not necessary if SExtractor is linked with
48 
Intel's MKL (Math Kernel Library) library.
49
50
51 
Installation
52 
============
53
54 
To install from the GitHub source package, you must first uncompress
55 
the archive:
56
57 
   $ unzip sextractor-<version>.zip
58
59 
A new directory called "sextractor-<version>" should now appear at the
60 
current location on your disk. Enter the directory and generate the
61 
files required by the autotools, which the package relies on:
62
63 
   $ cd sextractor-<version>
64 
   $ sh autogen.sh
65
66 
A "configure" script is created. This script has many options, which
67 
may be listed with the "--help" option:
68
69 
   $ ./configure --help
70
71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124
No options are required for compiling with the default GNU C compiler ("gcc") if all the required libraries are installed at their default locations: $ ./configure Compared to "gcc" and the librairies above, the combination of the Intel compiler ("icc") and the MKL (Math Kernel Library) libraries can give the SExtractor executable a significant boost in performance, thanks to better vectorized code, and reduced memory usage. If "icc" and the MKL (Math Kernel Library) are installed on your system [4], you can take advantage of those using instead $ ./configure --enable-mkl Additionally, if the SExtractor binary is to be run on a different machine that does not have "icc" and the MKL (Math Kernel Library) installed (e.g., a cluster computing node), you must configure a partially statically linked executable using $ ./configure --enable-mkl --enable-auto-flags --enable-best-link In all cases, SExtractor can now be compiled with $ make -j An "src/sex" executable is created. For system-wide installation, run the usual $ sudo make install You may now check that the software is properly installed by simply typing in your shell: $ sex (note that some shells require the "rehash" command to be run before making a freshly installed executable accessible in the execution path). [1] Mac OS X ".dmg" packages should be available soon. [2] Use the "--with-atlas" and/or "--with-atlas-incdir" options of the SExtractor "configure" script to specify the ATLAS library and include paths if ATLAS files are installed at unusual locations. [3] Make sure that FFTw has been compiled with "configure" options "--enable-threads --enable-float". [4] The Linux versions of the Intel compiler and MKL (Math Kernel Library) are available for free to academic researchers, students, educators and open source contributors.