Difference between revisions of "ATLAS"

From CBLFS
Jump to navigationJump to search
(Test change)
 
(15 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
{| style="text-align: left; background-color: AliceBlue;"
+
{|style="text-align: left; background-color: AliceBlue;"
 
|-
 
|-
 
!Download Source:
 
!Download Source:
−
| http://www.netlib.org/atlas/atlas{{BLAS-Version}}.tgz
+
|http://downloads.sourceforge.net/math-atlas/atlas{{ATLAS-Version}}.tar.bz2
 
|-
 
|-
−
!Download Source:
 
−
| http://www.netlib.org/blas/blas.tgz (F77 source files only, see below)
 
 
|}
 
|}
−
= Introduction to BLAS and LAPACK =
 
  
−
BLAS are '''B'''asic '''L'''inear '''A'''lgebra '''S'''ubprograms written in Fortran77.  There are Level 1 (scalar and vector operations), Level 2 (scalar-matrix operations) and Level 3 (matrix-matrix operations) subprograms.  They are available at [http://www.netlib.org/blas/ as tarballs] of F77 source files and are un-optimized for any particular architecture.  Use the second download source if you want or need these source files.
+
----
  
−
LAPACK is a '''L'''inear '''A'''lgebra '''PACK'''age that provides routines for solving systems of simultaneous linear equations, least-squares solutions of linear systems of equations, eigenvalue problems, and singular value problems.  LAPACK routines are written so that as much as possible of the computation is performed by calls to the BLAS.  The LAPACK libraries produced by ATLAS are not optimal.  Use the [[LAPACK]] package for optimal LAPACK libraries.
+
{{Package-Introduction|BLAS are '''B'''asic '''L'''inear '''A'''lgebra '''S'''ubprograms written in Fortran.  There are Level 1 (scalar and vector operations), Level 2 (scalar-matrix operations) and Level 3 (matrix-matrix operations) subprograms.  ATLAS (Automatically Tuned Linear Algebra Software) will provide C and FORTRAN interfaces to a BLAS implementation optimized for a specific machine architecture.  The ideal source of BLAS and LAPACK libraries are those provided by the microprocesor vendor such as AMD's [[ACML]]. However, these are not provided under a license that allows re-distribution without written consent from the vendor.|http://www.netlib.org/blas/}}
  
−
ATLAS (Automatically Tuned Linear Algebra Software) will provide C and FORTRAN interfaces to a BLAS and LAPACK implementation optimized for a specific machine architecture.  The ideal source of BLAS and LAPACK libraries are those provided by the microprocesor vendor such as AMD's [[ACML]].  However, these are not provided under a license that allows re-distribution without written consent from the vendor.
+
== Non-Multilib ==
  
−
== Dependencies ==
+
First, build the [[LAPACK]] libraries, then compile the package:
  
−
=== Optional ===
+
mkdir build &&
 +
cd build &&
 +
../configure --prefix=/usr \
 +
--with-netlib-lapack=$PWD/../../lapack-{{Lapack-Version}}/lapack_LINUX.a \
 +
-Fa alg -fPIC -b 32 &&
 +
sed -i "/RANLIB/s/echo/ranlib/" Make.inc &&
 +
make &&
 +
cd lib &&
 +
make shared &&
 +
make ptshared &&
 +
cd ..
 +
 
 +
Install the package:
  
−
* [[gcc-3.X.X]] Benchmarking by the ATLAS maintainers indicates that, with the exception of Core Duo and Pentium M, compiling ATLAS with gcc-3.X produces better x87 code than [http://gcc.gnu.org/bugzilla/show_bug.cgi?id=27827 gcc-4.X].
+
  make install &&
 +
  cp -v lib/*so /usr/lib
  
−
== Non-Multilib or Multilib ==
+
== Multilib ==
  
−
Compile the package:
+
=== 32Bit ===
  
−
  make
+
First, build the [[LAPACK]] libraries, then compile the package:
  
−
The configuration is interactive.  Simply follow the instructions presented on the screen.  If you've installed the FORTRAN provided by gcc-4.0.3 and later use '''gfortran''' when the configuration complains that the F77 version it finds is unsuitable.
+
mkdir build &&
 +
cd build &&
 +
CC="gcc ${BUILD32}" ../configure --prefix=/usr \
 +
  --with-netlib-lapack=$PWD/../../lapack-{{Lapack-Version}}/lapack_LINUX.a \
 +
  -Fa alg -fPIC -b 32 &&
 +
sed -i "/RANLIB/s/echo/ranlib/" Make.inc &&
 +
make &&
 +
cd lib &&
 +
make shared &&
 +
make ptshared &&
 +
cd ..
  
 
Install the package:
 
Install the package:
  
−
   make install arch=<TARGET> &&
+
   make install &&
−
   cp -v lib/<TARGET>/*.a /usr/lib
+
   cp -v lib/*so /usr/lib
 +
 
 +
=== N32 ===
  
−
If you are building BLAS libraries for more than one TARGET architecture, either place each set of libraries in a subdirectory of /usr/lib or give each set a unique name so as not to overwrite earlier versions.
+
First, build the [[LAPACK]] libraries, then compile the package:
  
−
Install the API and other documentation.
+
mkdir build &&
 +
cd build &&
 +
CC="gcc ${BUILDN32}" ../configure \
 +
--prefix=/usr --libdir=/usr/lib32 \
 +
--with-netlib-lapack=$PWD/../../lapack-{{Lapack-Version}}/lapack_LINUX.a \
 +
-Fa alg -fPIC &&
 +
sed -i "/RANLIB/s/echo/ranlib/" Make.inc &&
 +
make &&
 +
cd lib &&
 +
make shared &&
 +
make ptshared &&
 +
cd ..
  
−
  install -v -m755 -d /usr/share/doc/ATLAS-{{BLAS-Version}} &&
+
Install the package:
−
  for doc in doc/<TARGET>/*.{ps,txt}; do
 
−
    cp -v $doc /usr/share/doc/ATLAS-{{BLAS-Version}}
 
−
  done
 
  
−
Where <TARGET> will be displayed at the completion of the 'make' step.
+
  make install &&
 +
  cp -v lib/*so /usr/lib32
  
−
The ATLAS compilation and tuning produces several log files in bin/<TARGET>/INSTALL_LOGS.  These may be of interest or helpful if the BLAS libraries are found not to be optimal and you seek help from the ATLAS maintainers.  Install them as follows:
+
=== 64Bit ===
  
−
  install -v -m755 -d /usr/share/doc/ATLAS-{{BLAS-Version}}/INSTALL_LOGS &&
+
First, build the [[LAPACK]] libraries, then compile the package:
−
  for log in bin/<TARGET>/INSTALL_LOGS/*; do
 
−
    cp -v $log /usr/share/doc/ATLAS-{{BLAS-Version}}/INSTALL_LOGS
 
−
  done
 
  
 +
mkdir build &&
 +
cd build &&
 +
CC="gcc ${BUILD64}" ../configure \
 +
--prefix=/usr --libdir=/usr/lib64 \
 +
--with-netlib-lapack=$PWD/../../lapack-{{Lapack-Version}}/lapack_LINUX.a \
 +
-Fa alg -fPIC -b 64 &&
 +
sed -i "/RANLIB/s/echo/ranlib/" Make.inc &&
 +
make &&
 +
cd lib &&
 +
make shared &&
 +
make ptshared &&
 +
cd ..
 +
 +
Install the package:
 +
 +
  make install &&
 +
  cp -v lib/*so /usr/lib64
 +
 +
== Configuration Information ==
 +
 +
Create and install pkgconfig metadata files:
 +
 +
cat > blas.pc.in << "EOF"
 +
prefix=/usr
 +
exec_prefix=${prefix}
 +
libdir=/usr/<LIB>
 +
includedir=${prefix}/include
 +
 +
Name: blas
 +
Description: Automatically Tuned Linear Algebra Software F77 BLAS implementation
 +
Version: 3.8.0
 +
URL: http://math-atlas.sourceforge.net/
 +
Libs: -L${libdir} -latlas -lcblas -lf77blas -lptcblas -lptf77cblas
 +
Libs.private: -lm -lgfortran
 +
EOF
 +
 +
cat > lapack.pc.in << "EOF"
 +
prefix=/usr
 +
exec_prefix=${prefix}
 +
libdir=/usr/<LIB>
 +
includedir=${prefix}/include
 +
 +
Name: lapack
 +
Description: Linear Algebra PACKage
 +
Version: 3.8.0
 +
URL: http://math-atlas.sourceforge.net/
 +
Libs: -L${libdir} -latlas -llapack
 +
Libs.private: -lm -lgfortran
 +
Cflags: -I${includedir}
 +
EOF
 +
 +
=== Non-Multilib or 32-Bit ===
 +
 +
sed -i 's/<LIB>/lib/' blas.pc.in &&
 +
sed -i 's/<LIB>/lib/' lapack.pc.in &&
 +
cp -v blas.pc.in /usr/lib/pkgconfig/blas.pc &&
 +
cp -v lapack.pc.in /usr/lib/pkgconfig/lapack.pc
 +
 +
=== N32 ===
 +
 +
sed -i 's/<LIB>/lib32/' blas.pc.in &&
 +
sed -i 's/<LIB>/lib32/' lapack.pc.in &&
 +
cp -v blas.pc.in /usr/lib32/pkgconfig/blas.pc &&
 +
cp -v lapack.pc.in /usr/lib32/pkgconfig/lapack.pc
 +
 +
=== 64-Bit ===
 +
 +
sed -i 's/<LIB>/lib64/' blas.pc.in &&
 +
sed -i 's/<LIB>/lib64/' lapack.pc.in &&
 +
cp -v blas.pc.in /usr/lib64/pkgconfig/blas.pc &&
 +
cp -v lapack.pc.in /usr/lib64/pkgconfig/lapack.pc
 +
 
== Contents ==
 
== Contents ==
  
−
Installed Libraries: libatlas.a, libcblas.a, libf77blas.a, liblapack.a, libtstatlas.a
+
{|style="text-align: left"
 +
|-valign="top";
 +
!Installed Libraries:
 +
| libatlas.{a,so}, libcblas.{a,so}, libf77blas.{a,so}, libptcblas.{a, so} libptf77cblas.{a, so}, liblapack.{a, so}
 +
|}
 +
 
 +
=== Short Description ===
 +
 
 +
{|style="text-align: left"
 +
|-valign="top"
 +
!libatlas
 +
|is the main ATLAS library, providing low-level routines for all interface libraries.
 +
|-valign="top"
 +
!libcblas
 +
|is the C library with optimized BLAS functions.
 +
|-valign="top"
 +
!libf77blas
 +
|is the FORTRAN library with optimized BLAS functions.
 +
|-valign="top"
 +
!libptcblas
 +
|is the threaded C library with optimized BLAS functions.
 +
|-valign="top"
 +
!libptf77blas
 +
|is the threaded FORTRAN library with optimized BLAS functions.
 +
|-valign="top"
 +
!liblapack
 +
|is the LAPACK library.
 +
|}
 +
 
 +
[[Category:Science_Engineering]]

Latest revision as of 09:43, 20 March 2010

Download Source: http://downloads.sourceforge.net/math-atlas/atlas3.8.0.tar.bz2

Introduction to ATLAS

BLAS are Basic Linear Algebra Subprograms written in Fortran. There are Level 1 (scalar and vector operations), Level 2 (scalar-matrix operations) and Level 3 (matrix-matrix operations) subprograms. ATLAS (Automatically Tuned Linear Algebra Software) will provide C and FORTRAN interfaces to a BLAS implementation optimized for a specific machine architecture. The ideal source of BLAS and LAPACK libraries are those provided by the microprocesor vendor such as AMD's ACML. However, these are not provided under a license that allows re-distribution without written consent from the vendor.

Project Homepage: http://www.netlib.org/blas/

Non-Multilib

First, build the LAPACK libraries, then compile the package: 

mkdir build &&
cd build &&
../configure --prefix=/usr \
--with-netlib-lapack=$PWD/../../lapack-3.1.1/lapack_LINUX.a \
-Fa alg -fPIC -b 32 &&
sed -i "/RANLIB/s/echo/ranlib/" Make.inc &&
make &&
cd lib &&
make shared &&
make ptshared &&
cd ..

Install the package: 

 make install &&
 cp -v lib/*so /usr/lib

Multilib

32Bit

First, build the LAPACK libraries, then compile the package: 

mkdir build &&
cd build &&
CC="gcc ${BUILD32}" ../configure --prefix=/usr \
--with-netlib-lapack=$PWD/../../lapack-3.1.1/lapack_LINUX.a \
-Fa alg -fPIC -b 32 &&
sed -i "/RANLIB/s/echo/ranlib/" Make.inc &&
make &&
cd lib &&
make shared &&
make ptshared &&
cd ..

Install the package: 

 make install &&
 cp -v lib/*so /usr/lib

N32

First, build the LAPACK libraries, then compile the package: 

mkdir build &&
cd build &&
CC="gcc ${BUILDN32}" ../configure \
--prefix=/usr --libdir=/usr/lib32 \
--with-netlib-lapack=$PWD/../../lapack-3.1.1/lapack_LINUX.a \
-Fa alg -fPIC &&
sed -i "/RANLIB/s/echo/ranlib/" Make.inc &&
make &&
cd lib &&
make shared &&
make ptshared &&
cd ..

Install the package: 

 make install &&
 cp -v lib/*so /usr/lib32

64Bit

First, build the LAPACK libraries, then compile the package: 

mkdir build &&
cd build &&
CC="gcc ${BUILD64}" ../configure \
--prefix=/usr --libdir=/usr/lib64 \
--with-netlib-lapack=$PWD/../../lapack-3.1.1/lapack_LINUX.a \
-Fa alg -fPIC -b 64 &&
sed -i "/RANLIB/s/echo/ranlib/" Make.inc &&
make &&
cd lib &&
make shared &&
make ptshared &&
cd ..

Install the package: 

 make install &&
 cp -v lib/*so /usr/lib64

Configuration Information

Create and install pkgconfig metadata files: 

cat > blas.pc.in << "EOF"
prefix=/usr
exec_prefix=${prefix}
libdir=/usr/<LIB>
includedir=${prefix}/include

Name: blas
Description: Automatically Tuned Linear Algebra Software F77 BLAS implementation
Version: 3.8.0
URL: http://math-atlas.sourceforge.net/
Libs: -L${libdir} -latlas -lcblas -lf77blas -lptcblas -lptf77cblas
Libs.private: -lm -lgfortran
EOF

cat > lapack.pc.in << "EOF"
prefix=/usr
exec_prefix=${prefix}
libdir=/usr/<LIB>
includedir=${prefix}/include

Name: lapack
Description: Linear Algebra PACKage
Version: 3.8.0
URL: http://math-atlas.sourceforge.net/
Libs: -L${libdir} -latlas -llapack 
Libs.private: -lm -lgfortran
Cflags: -I${includedir}
EOF

Non-Multilib or 32-Bit

sed -i 's/<LIB>/lib/' blas.pc.in &&
sed -i 's/<LIB>/lib/' lapack.pc.in &&
cp -v blas.pc.in /usr/lib/pkgconfig/blas.pc &&
cp -v lapack.pc.in /usr/lib/pkgconfig/lapack.pc

N32

sed -i 's/<LIB>/lib32/' blas.pc.in &&
sed -i 's/<LIB>/lib32/' lapack.pc.in &&
cp -v blas.pc.in /usr/lib32/pkgconfig/blas.pc &&
cp -v lapack.pc.in /usr/lib32/pkgconfig/lapack.pc

64-Bit

sed -i 's/<LIB>/lib64/' blas.pc.in &&
sed -i 's/<LIB>/lib64/' lapack.pc.in &&
cp -v blas.pc.in /usr/lib64/pkgconfig/blas.pc &&
cp -v lapack.pc.in /usr/lib64/pkgconfig/lapack.pc

Contents

Installed Libraries: libatlas.{a,so}, libcblas.{a,so}, libf77blas.{a,so}, libptcblas.{a, so} libptf77cblas.{a, so}, liblapack.{a, so}

Short Description

libatlas is the main ATLAS library, providing low-level routines for all interface libraries.
libcblas is the C library with optimized BLAS functions.
libf77blas is the FORTRAN library with optimized BLAS functions.
libptcblas is the threaded C library with optimized BLAS functions.
libptf77blas is the threaded FORTRAN library with optimized BLAS functions.
liblapack is the LAPACK library.
Retrieved from "?title=ATLAS&oldid=19977"