owl-plplot

OCaml Scientific and Engineering Computing
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
29 Feb 2020
Authors
Sources
owl-0.8.0.tbz
sha256=862af251e2a3e7a6b79724a4020a0c9308b36f12c85cd0a52385c4df82132c66
sha512=c1dabbf467a587757b11a28b9c6e8f68a86ce799d07c7ab5f2afa92d20145ba9e4282975aeb269b7324f5ba90d1576db156006f4d58177a860def773f9d974f2
Dependencies
owl
= version
dune
>= "2.0.0"
ocaml
>= "4.06.0"
Reverse Dependencies
cviode
>= "0.0.4"
owl-ode
>= "0.1.0" & != "0.2.0"
owl-ode-sundials
< "0.1.0" | >= "0.3.0"