basis/math/blas/config/config-docs.factor

   1 USING: alien.fortran help.markup help.syntax math.blas.config ;
   2 IN: math.blas.config
   3
   4 ARTICLE: "math.blas.config" "Configuring the BLAS interface"
   5 "The " { $link "math.blas-summary" } " chooses the underlying BLAS interface to use based on the values of the following global variables:"
   6 { $subsection blas-library }
   7 { $subsection blas-fortran-abi }
   8 "The interface attempts to set default values based on the ones encountered on the Factor project's build machines. If these settings don't work with your system's BLAS, or you wish to use a commercial BLAS, you may change the global values of those variables in your " { $link "factor-rc" } ". For example, to use AMD's ACML library on Windows with " { $snippet "math.blas" } ", your " { $snippet "factor-rc" } " would look like this:"
   9 { $code """
  10 USING: math.blas.config namespaces ;
  11 "X:\\path\\to\\acml.dll" blas-library set-global
  12 intel-windows-abi blas-fortran-abi set-global
  13 """ }
  14 "To take effect, the " { $snippet "blas-library" } " and " { $snippet "blas-fortran-abi" } " variables must be set before any other " { $snippet "math.blas" } " vocabularies are loaded."
  15 ;
  16
  17 HELP: blas-library
  18 { $description "The name of the shared library containing the BLAS interface to load. The value of this variable must be a valid shared library name that can be passed to " { $link add-fortran-library } ". To take effect, this variable must be set before any other " { $snippet "math.blas" } " vocabularies are loaded. See " { $link "math.blas.config" } " for details and examples." } ;
  19
  20 HELP: blas-fortran-abi
  21 { $description "The Fortran ABI used by the BLAS interface specified in the " { $link blas-library } " variable. The value of " { $snippet "blas-fortran-abi" } " must be one of the " { $link "alien.fortran-abis" } " that can be passed to " { $link add-fortran-library } ". To take effect, this variable must be set before any other " { $snippet "math.blas" } " vocabularies are loaded. See " { $link "math.blas.config" } " for details and examples." } ;
  22
  23 ABOUT: "math.blas.config"