https://github.com/akabe/docker-ocaml-jupyter-datascience

Dockerfiles for data science in OCaml on Jupyter
https://github.com/akabe/docker-ocaml-jupyter-datascience
dataanalysis datascience docker dockerfile functional-programming jupyter-notebook machine-learning ocaml
Last synced: 24 days ago
JSON representation
Dockerfiles for data science in OCaml on Jupyter
Host: GitHub
URL: https://github.com/akabe/docker-ocaml-jupyter-datascience
Owner: akabe
License: mit
Created: 2017-08-01T11:49:15.000Z (almost 8 years ago)
Default Branch: master
Last Pushed: 2017-12-05T00:30:45.000Z (over 7 years ago)
Last Synced: 2025-04-10T05:14:24.145Z (24 days ago)
Topics: dataanalysis, datascience, docker, dockerfile, functional-programming, jupyter-notebook, machine-learning, ocaml
Language: Jupyter Notebook
Size: 2.27 MB
Stars: 43
Watchers: 6
Forks: 4
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project

README

        # [akabe/ocaml-jupyter-datascience](https://hub.docker.com/r/akabe/ocaml-jupyter-datascience/)

| Travis CI | MicroBadger |

| --- | --- |

| [![Build Status](https://travis-ci.org/akabe/docker-ocaml-jupyter-datascience.svg?branch=master)](https://travis-ci.org/akabe/docker-ocaml-jupyter-datascience) | [![Image Status](https://images.microbadger.com/badges/image/akabe/ocaml-jupyter-datascience.svg)](https://microbadger.com/images/akabe/ocaml-jupyter-datascience) |

A ready-to-use environment of [Jupyter](http://ipython.org/notebook.html) (IPython notebook) and [OCaml Jupyter](https://github.com/akabe/ocaml-jupyter) ([OCaml](https://ocaml.org/) kernel) with libraries for data science and machine learning.

## Getting started

First, launch a Jupyter server as follows.

```console

$ docker run -it -p 8888:8888 akabe/ocaml-jupyter-datascience

[I 15:38:04.170 NotebookApp] Writing notebook server cookie secret to /home/opam/.local/share/jupyter/runtime/notebook_cookie_secret

[W 15:38:04.190 NotebookApp] WARNING: The notebook server is listening on all IP addresses and not using encryption. This is not recommended.

[I 15:38:04.197 NotebookApp] Serving notebooks from local directory: /notebooks

[I 15:38:04.197 NotebookApp] 0 active kernels

[I 15:38:04.197 NotebookApp] The Jupyter Notebook is running at: http://[all ip addresses on your system]:8888/?token=4df0fee0719115f474c8dd9f9281abed28db140d25f933e9

[I 15:38:04.197 NotebookApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).

[W 15:38:04.198 NotebookApp] No web browser found: could not locate runnable browser.

[C 15:38:04.198 NotebookApp]

    Copy/paste this URL into your browser when you connect for the first time,

    to login with a token:

        http://localhost:8888/?token=4df0fee0719115f474c8dd9f9281abed28db140d25f933e9

```

Second, access to the URL at the above last line to your web browser, then

![Screenshot of Jupyter with OCaml](https://akabe.github.io/ocaml-jupyter/images/screenshot.png)

You can create OCaml notebooks!

Notebooks on your host machine can be mounted to a Docker container like

```

docker run -it -p 8888:8888 -v $PWD:/notebooks akabe/ocaml-jupyter-datascience

```

## Distributions

The default images are built on Debian 8:

| Tag | OCaml | OPAM | Command | Dockerfile |

| ------------ | ----- | ---- | ------- | ---------- |

| **latest** | 4.05.0 | 1.2.2 | `docker pull akabe/ocaml-jupyter-datascience` | [Dockerfile](dockerfiles/debian8_ocaml4.05.0/Dockerfile) |

| **4.04.1** | 4.04.1 | 1.2.2 | `docker pull akabe/ocaml-jupyter-datascience:4.04.1` | [Dockerfile](dockerfiles/debian8_ocaml4.04.1/Dockerfile) |

### CentOS

| Distribution | OCaml | OPAM | Command | Dockerfile |

| ------------ | ----- | ---- | ------- | ---------- |

| CentOS 7 | 4.05.0 | 1.2.2 | `docker pull akabe/ocaml-jupyter-datascience:centos7_ocaml4.05.0` | [Dockerfile](dockerfiles/centos7_ocaml4.05.0/Dockerfile) |

| CentOS 7 | 4.04.1 | 1.2.2 | `docker pull akabe/ocaml-jupyter-datascience:centos7_ocaml4.04.1` | [Dockerfile](dockerfiles/centos7_ocaml4.04.1/Dockerfile) |

### Debian

| Distribution | OCaml | OPAM | Command | Dockerfile |

| ------------ | ----- | ---- | ------- | ---------- |

| Debian 8 | 4.05.0 | 1.2.2 | `docker pull akabe/ocaml-jupyter-datascience:debian8_ocaml4.05.0` | [Dockerfile](dockerfiles/debian8_ocaml4.05.0/Dockerfile) |

| Debian 8 | 4.04.1 | 1.2.2 | `docker pull akabe/ocaml-jupyter-datascience:debian8_ocaml4.04.1` | [Dockerfile](dockerfiles/debian8_ocaml4.04.1/Dockerfile) |

## Pre-installed packages

### Standard libraries

The OCaml standard library is too small in practical use. The following packages provide popular data structures, a lot of frequently-used functions such as string operations, various iteration on collections, etc.

- **[Jane Street Core](https://janestreet.github.io/)** ([GitHub](https://github.com/janestreet/core), [API](https://ocaml.janestreet.com/ocaml-core/v0.9/doc/core/Core/)) — A huge extended standard library developed by Jane Street Capital. The library is actively maintained and reliable due to industrial use of Jane Street. Its interface is designed differently from the OCaml standard library.

- **[Batteries Included](http://batteries.forge.ocamlcore.org/)** ([GitHub](https://github.com/ocaml-batteries-team/batteries-included), [API](http://ocaml-batteries-team.github.io/batteries-included/hdoc2/)) — A famous extended standard library compatible with the OCaml standard library. It is smaller than Jane Street Core, but commonly-used functions are implemented.

### Numerical computation

- **[Lacaml](http://mmottl.github.io/lacaml/)** ([GitHub](https://github.com/mmottl/lacaml), [API](http://mmottl.github.io/lacaml/api/lacaml/)) — A binding to [BLAS](http://www.netlib.org/blas/) (Basic Linear Algebra Subprograms) and [LAPACK](http://www.netlib.org/lapack/) (Linear Algebra PACKage), traditional linear algebra libraries written in Fortran. This library supplies basic operations on vectors and matrices (e.g., addition, dot product, multiplication), LU, QR, SVD, least-square fitting, etc.

- **[SLAP](http://akabe.github.io/slap/)** ([GitHub](https://github.com/akabe/slap), [API](http://akabe.github.io/slap/api/)) — A high-level wrapper of Lacaml with type-based static size checks for vectors and matrices.

    - [notebooks/slap_two_layer_neural_network.ipynb](notebooks/slap_two_layer_neural_network.ipynb)

- **[GSL](http://mmottl.github.io/gsl-ocaml)** ([GitHub](https://github.com/mmottl/gsl-ocaml), [API](http://mmottl.github.io/gsl-ocaml/api/gsl/)) — A binding to [GNU Scientific Library (GSL)](http://www.gnu.org/software/gsl/), a rich numerical analysis library containing interface to BLAS. This library contains eigenproblem solvers, least square fitting, pseudo-random number generators (such as Mersenne Twister), FFT (fast Fourier transform), Monte-Carlo simulation, etc.

    - [notebooks/gaussian_random_walk.ipynb](notebooks/gaussian_random_walk.ipynb)

    - [notebooks/random_dataset_generation.ipynb](notebooks/random_dataset_generation.ipynb)

- **Owl** ([GitHub](https://github.com/ryanrhymes/owl), [API](http://www.cl.cam.ac.uk/~lw525/owl/)) — a general-purpose numerical library: dense and sparse matrix, linear algebra, regressions, maths and stats functions.

    - [notebooks/owl.ipynb](notebooks/owl.ipynb)

- **FFTW3** ([GitHub](https://github.com/Chris00/fftw-ocaml)) — A binding to [FFTW3](http://fftw.org/), a major fast Fourier transform library.

    - [notebooks/fftw3_example.ipynb](notebooks/fftw3_example.ipynb)

    - [notebooks/formant_estimation_by_AR.ipynb](notebooks/formant_estimation_by_AR.ipynb)

- **libsvm** ([BitBucket](https://bitbucket.org/ogu/libsvm-ocaml/), [API](https://ogu.bitbucket.io/libsvm-ocaml/api/)) — Support vector machine (SVM) is a powerful model in machine learning. This is a binding to [libsvm](https://www.csie.ntu.edu.tw/~cjlin/libsvm/), a library for SVMs.

- **TensorFlow** ([GitHub](https://github.com/LaurentMazare/tensorflow-ocaml)) — A binding to [TensorFlow](https://www.tensorflow.org/), a popular open-source neural network library developed by Google.

- **[L-BFGS](https://github.com/Chris00/L-BFGS-ocaml)** ([API](http://lbfgs.forge.ocamlcore.org/API.docdir/Lbfgs.html)) — A binding to [L-BFGS-B](http://users.iems.northwestern.edu/~nocedal/lbfgsb.html), a quasi-Newton library for bound-constrained optimization.

- **Ocephes** ([GitHub](https://github.com/rleonid/ocephes), [API](https://rleonid.github.io/ocephes/)) — A binding to [Ocephes](http://www.netlib.org/cephes/), a library of special math functions like Binominal, Gaussian, Gamma distributions, incomplete Beta integral.

- **[Oml](http://www.hammerlab.org/2015/08/11/introducing-oml-a-small-ocaml-library-for-numerical-computing/)** ([GitHub](https://github.com/hammerlab/oml), [API](http://www.hammerlab.org/oml/index.html)) — A small library for numerical computing on OCaml.

- **[GPR](https://mmottl.github.io/gpr/)** ([GitHub](https://github.com/mmottl/gpr), [API](http://mmottl.github.io/gpr/api/gpr/), [PDF](http://mmottl.github.io/gpr/gpr_manual.pdf)) — Efficient and scalable Gaussian Process Regression in OCaml.

- **[MeCab](https://akabe.github.io/ocaml-mecab/)** ([GitHub](https://github.com/akabe/ocaml-mecab), [API](https://akabe.github.io/ocaml-mecab/api/)) — an OCaml binding of [MeCab](http://taku910.github.io/mecab/), a part-of-speech and morphological analyzer. The following dictionaries are available:

    - ipadic at `/usr/lib/mecab/dic/mecab-ipadic`, and

    - [mecab-ipadic-NEologd](https://github.com/neologd/mecab-ipadic-neologd) at `/usr/lib/mecab/dic/mecab-ipadic-neologd`.

### Visualization

- **[Archimedes](http://archimedes.forge.ocamlcore.org/)** ([API](http://archimedes.forge.ocamlcore.org/API/Archimedes.html)) — A 2D plot library like matplotlib in Python. You can embed PNG images in Jupyter notebooks.

    - [notebooks/introduction.ipynb](notebooks/introduction.ipynb)

- **Cairo2** ([GitHub](https://github.com/Chris00/ocaml-cairo), [Tutorial](http://cairo.forge.ocamlcore.org/tutorial/index.html), [API](http://cairo.forge.ocamlcore.org/tutorial/Cairo.html)) — A binding to [Cairo](https://cairographics.org/), a 2D vector graphics library. This library is useful as a backend of Archimedes.

    - [notebooks/simple_image_filtering.ipynb](notebooks/simple_image_filtering.ipynb)

- **PLplot** ([GitHub](https://github.com/hcarty/ocaml-plplot)) — a binding to [PLplot](http://plplot.sourceforge.net/), a practical library for creating scientific charts.

    - [notebooks/plplot.ipynb](notebooks/plplot.ipynb)

### Data sources

- **[MySQL](http://ygrek.org.ua/p/ocaml-mysql/)** ([GitHub](https://github.com/ygrek/ocaml-mysql), [API](http://ygrek.org.ua/p/ocaml-mysql/api/index.html)) — A well-benchmarked MySQL client library providing blocking API.

- **MariaDB** ([GitHub](https://github.com/andrenth/ocaml-mariadb)) — [MariaDB](https://mariadb.org/) is a rich relational database management system compatible with MySQL. This client library provides blocking and nonblocking (Lwt and Async) interfaces that can connect both of MySQL and MariaDB.

- **[Postgresql](http://mmottl.github.io/postgresql-ocaml/)** ([GitHub](https://github.com/mmottl/postgresql-ocaml), [API](http://mmottl.github.io/postgresql-ocaml/api/)) — [PostgreSQL](https://www.postgresql.org/) is a popular relational database with many aggregate and window functions useful for data analysis.

- **[SQLite3](http://mmottl.github.io/sqlite3-ocaml/)** ([GitHub](https://github.com/mmottl/sqlite3-ocaml), [API](http://mmottl.github.io/sqlite3-ocaml/API.docdir/)) — A client library for SQLite3, a easy-to-use lightweight database.

- **Cohttp** ([GitHub](https://github.com/mirage/ocaml-cohttp), [API](http://mirage.github.io/ocaml-cohttp/)) — A very lightweight HTTP(s) client/server library using Async and Lwt. This library is useful to access to API servers or Web scraping. The [API](http://docs.mirage.io/uri/) documentation of [ocaml-uri](https://github.com/mirage/ocaml-uri) is also useful.

    - [notebooks/cohttp_lwt_DuckDuckGoAPI.ipynb](notebooks/cohttp_lwt_DuckDuckGoAPI.ipynb)

    - [notebooks/cohttp_async_DuckDuckGoAPI.ipynb](notebooks/cohttp_async_DuckDuckGoAPI.ipynb)

### Concurrent programming

- **[Jane Street Async](https://janestreet.github.io/)** ([GitHub](https://github.com/janestreet/async), [API](https://ocaml.janestreet.com/ocaml-core/v0.9/doc/async/Async/index.html)) — Jane Street Capital's library for concurrent programming.

- **[Lwt](https://ocsigen.org/lwt/manual/)** ([GitHub](https://github.com/ocsigen/lwt), [API](https://ocsigen.org/lwt/3.0.0/api/Lwt)) — A library of cooperative light-weight threads.

### Other packages

- **Re** ([GitHub](https://github.com/ocaml/ocaml-re)) — A fast and easy-to-use regular expression library for OCaml. This library supports Glob, POSIX, Perl, PCRE, and [OCaml-Str](https://caml.inria.fr/pub/docs/manual-ocaml/libref/Str.html)-style syntaxes.

- **[Camomile](http://camomile.sourceforge.net/)** ([GitHub](https://github.com/yoriyuki/Camomile), [API](http://camomile.sourceforge.net/dochtml/index.html)) — Camomile is a library for character encoding conversion and unicode utilities.

- **LambdaSoup** ([GitHub](https://github.com/aantron/lambda-soup), [API](http://aantron.github.io/lambda-soup/)) — Lambda Soup is a functional HTML scraping and manipulation library for OCaml aimed at being easy to use.

- **OCaml CSV** ([GitHub](https://github.com/Chris00/ocaml-csv), [API](https://math.umons.ac.be/anum/software/csv/)) — A library to read and write comma-separated-values (CSV) format files.

- **[ppx_sexp_conv](https://github.com/janestreet/ppx_sexp_conv)** — Automatic generation of converters between OCaml datatypes and S-expressions.

- **[ppx_deriving_yojson](https://github.com/whitequark/ppx_deriving_yojson)** — Automatic generation of converters between OCaml datatypes and JSONs.

- **[ppx_regexp](https://github.com/paurkedal/ppx_regexp)** — Pattern matching by PCRE-style regular expressions.

### CUI tools

- **[ImageMagick](https://www.imagemagick.org/script/index.php)** — ImageMagick is a program to create, edit, compose, or convert bitmap images. This supports many formats, e.g., PNG, JPEG, GIF, TIFF, PDF, etc.

- **[FFmpeg](https://ffmpeg.org/)** — FFmpeg is a powerful tool for converting audio and video files.

- **[PhantomJS](http://phantomjs.org/)** — PhantomJS is a headless WebKit scriptable with a JavaScript API. It has fast and native support for various web standards: DOM handling, CSS selector, JSON, Canvas, and SVG.

## Examples

```console

$ git clone https://github.com/akabe/docker-ocaml-jupyter-datascience.git

$ docker run -it -p 8888:8888 -v $PWD/docker-ocaml-jupyter-datascience/notebooks:/notebooks akabe/ocaml-jupyter-datascience

```

## Contribution

If you know a widely-used numerical library in OCaml, find a bug, or have an idea to improve this environment, please create an issue or pull-request your changes.
ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/akabe/docker-ocaml-jupyter-datascience

Awesome Lists containing this project

README
