From abb266b798ad7536aa3107d040061b671954dde3 Mon Sep 17 00:00:00 2001 From: jwang Date: Fri, 10 Jan 2020 05:42:57 +0000 Subject: [PATCH] update gonum README to highlight features --- gonum/README.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/gonum/README.md b/gonum/README.md index 62a8b68..7e52b99 100644 --- a/gonum/README.md +++ b/gonum/README.md @@ -4,7 +4,9 @@ ## What is this image? `clearlinux/gonum` is a Docker image with `gonum` running on top of the -[official clearlinux base image](https://hub.docker.com/_/clearlinux). +[official clearlinux base image](https://hub.docker.com/_/clearlinux). User +can deploy gonum apps on top of `clearlinux/gonum` container, and get better +performance via newlib interface which call clearlinux avx512 optimized CBLAS. > [Gonum](https://gonum.org/) Gonum is a set of numeric libraries for the Go programming language. @@ -51,6 +53,20 @@ Docker Hub. ``` docker run -it --rm -v "$PWD/test":/app -w /app clearlinux/gonum /bin/bash -c "go mod init app;go test -bench ." ``` + For gonum app development, use newlib interface for blas can bring significant performance gain over default blas + ``` + import ( + "gonum.org/v1/gonum/blas/gonum" + "gonum.org/v1/netlib/blas/netlib" + "gonum.org/v1/gonum/blas/blas64" + ... + ) + + func BenchmarkCBlas64(b *testing.B) { + blas64.Use(netlib.Implementation{}) + ... + } + ``` ## Build and modify: