owl-base

OCaml Scientific and Engineering Computing - Base
README

Owl is a dedicated system for scientific and engineering computing in the
functional programming language OCaml.

This software is currently maintained by Komposio, a
Helsinki-based software consulting company.

Visit the project website at ocaml.xyz

Optional features

You can enable optional features by setting the following variables to 1
before compilation:

  • OWL_ENABLE_EXPMODE=1: turn on experiment features like -flto

  • OWL_ENABLE_DEVMODE=1: turn on all the warnings in development

  • OWL_ENABLE_OPENMP=1: turn on OpenMP support in core module and
    the automatic parameter tuning (AEOS)

  • OWL_CFLAGS allows to change the default flags passed to the C targets,
    it defaults to

    OWL_CFLAGS="-g -O3 -Ofast -march=native -mfpmath=sse -funroll-loops -ffast-math -DSFMT_MEXP=19937 -msse2 -fno-strict-aliasing -Wno-tautological-constant-out-of-range-compare"`
    
  • OWL_AEOS_CFLAGS allows to change the default flags passed to the C targets
    when compiling AEOS. It defaults to

    OWL_AEOS_CFLAGS="-g -O3 -Ofast -march=native -funroll-loops -ffast-math -DSFMT_MEXP=19937 -fno-strict-aliasing"
    
  • OWL_DISABLE_LAPACKE_LINKING_FLAG=1 disables the -llapacke flag in the
    linking options. This is useful when you have lapacke installed on
    non-standard localtion.

If you are not using opam, you should run make clean before recompiling
the library after having changed any of those environment variables.

For examples of use of this feature, you can refer to the Docker.ubuntu
and Docker.ubuntu.arm docker files, or to the snippet in
https://github.com/owlbarn/owl/issues/394#issuecomment-471364916
(which also shows how to use it within esy).

Troubleshooting

A common source of frustration when installing owl is the possible appearence of linking errors (see for example https://github.com/owlbarn/owl/issues/450).
This usually happens when installing owl on ubuntu (where it depends on how openblas is complied and packaged), but could happen in other distributions (see for example https://discuss.ocaml.org/t/owl-undefined-symbols-after-standard-installation/4186/13).
The only way we could solve those issues is to recompile openblas and install it manually. You can see how we do it by looking at the Docker files in the repository: https://github.com/owlbarn/owl/blob/master/docker/Dockerfile.ubuntu

Statistics

-------------------------------------------------------------------------------
Language                     files          blank        comment           code
-------------------------------------------------------------------------------
OCaml                          357          31341          17275         130905
C                              140           5783           9874          69686
C/C++ Header                    91           4897           2784          36291
make                             2              6              5             34
Markdown                         1              6              0             16
-------------------------------------------------------------------------------
SUM:                           591          42033          29938         236932
-------------------------------------------------------------------------------
Install
Published
05 Mar 2020
Authors
Sources
owl-0.9.0.tbz
sha256=1f47c9c447b008e65cbd2a8b3495fcf5ad3de701206be4e6a43aa61f473b795c
sha512=db0ce524073f9c3ec420ca5de2991db56888eb880220ce8fecca85cad5e41537b2e3115cc5f645dbde03dc99eef3fe8582a25d09c5f6efaa0dc088ddc76d3a9c
Dependencies
Reverse Dependencies
gobba
>= "0.4.2"
owl
= "0.9.0"
owl-ode-base
!= "0.3.0"