owl - GitLite

KO | EN

gitlite — search

#javascript #python #react #golang #machine-learning #rust #deep-learning #docker #nodejs #windows #cli #vue #security #ios

owl

(★ 1,350)

Owl - OCaml Scientific Computing @ https://ocaml.xyz

파일 탐색기

최종 버전 다운로드 (.zip)

파일 수가 많아 일부만 표시됩니다. 전체 파일은 위 다운로드 버튼으로 확인해 주세요.

- - deploy_docker.yml
  - mac.yml
  - main.yml
  - os.yml
- FUNDING.yml
- Dockerfile.archlinux
- Dockerfile.debian
- Dockerfile.fedora
- Dockerfile.openblas
- Dockerfile.ubuntu.arm
- Makefile
- - highlight.pack.js
  - katex.min.css
  - katex.min.js
  - odoc.css
  - odoc_search.js
- index.html
.gitattributes
.gitignore
.gitmodules
.ocamlformat
.travis.yml
ACKNOWLEDGEMENT.md
CHANGES.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
Dockerfile
INSTALL.md
INSTALL_WINDOWS.md
LETTER.md
LICENSE.md
Makefile
README.md
TODO.md
VERSION

🚀 설치 가이드

1. 코드 내려받기

git clone https://github.com/owlbarn/owl

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd owl

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Docker

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.

docker build -t owl .

Dockerfile을 기반으로 실행 가능한 이미지를 빌드합니다.

docker run -p 8080:80 owl

빌드된 이미지를 실제 컨테이너로 실행합니다.

✅ 터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.

3. Make

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

make

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Owl - OCaml Scientific Computing 
[![build](https://github.com/owlbarn/owl/actions/workflows/main.yml/badge.svg)](https://github.com/owlbarn/owl/actions/workflows/main.yml)
[![build](https://github.com/owlbarn/owl/actions/workflows/deploy_docker.yml/badge.svg)](https://github.com/owlbarn/owl/actions/workflows/deploy_docker.yml)

Owl is a dedicated system for scientific and engineering computing. The system is developed in OCaml and licensed under MIT. The project is originated by [Liang Wang](https://liang.ocaml.xyz) and currently led by [Jianxin Zhao](https://jianxin.ocaml.xyz). The history of the project can be seen on the [Wikipedia](https://en.wikipedia.org/wiki/Owl_Scientific_Computing) page.

## Functionalities

Owl provides a wide range of scientific computing functionalities:

- mathematical function, from the basic `log`, `sin` etc., to special functions such as the Beta and Gamma functions
- integration; interpolation and extrapolation
- statistics and probability; e.g. generation of random number and various distributions 
- various computation on n-dimensional arrays (tensors), including advanced slicing and broadcasting 
- linear algebra
- ordinary differential equations 
- discrete Fourier Transform algorithms for signal processing 
- algorithmic differentiation, or automatic differentiation
- various optimization algorithms
- regression algorithms
- deep neural network and natural language processing with the optional support of computation graph optimization
- dataframe processing
- visualization (with the help of external package `owl-plot`)

## Installation

Please follow the [tutorial](https://ocaml.xyz/tutorial/chapters/introduction.html) about installing Owl. You can also start by trying the [docker images](https://hub.docker.com/r/matrixanger/owl).

## Mission

Our mission is to push the frontier of high-performance scientific computing, provide both researchers and industry programmers a powerful framework to write concise, fast and safe analytical code. The system aims to serve as the de-facto tool for computation intensive tasks in OCaml.
Owl is the de-facto scientific computing library in OCaml. Currently we aim to actively maintain it and keep it stable, utilizing the limited time and human resource we have.

The current code base is designed to be concise and self-contained. 
We encourage anyone who would like to build up their own tools based on Owl to create new repositories in the [Owlbarn](https://github.com/owlbarn) organization.

## Owl Code Structure

To help potential developers to understand the structure of Owl, here we briefly describe its overall design. More detailed description can be found in the [documentation](https://ocaml.xyz/docs/) and the Owl [books](https://ocaml.xyz/).

![Owl architecture 1](https://raw.githubusercontent.com/owlbarn/owl/main/examples/owl-structure1.svg)

Owl provides a basic data structure for modern numerical computing: n-dimensional array (Ndarray). It is based on the mathematics, linear algebra, and statistics functions, which are built on both OCaml and C functions and libraries.

![Owl architecture 2](https://raw.githubusercontent.com/owlbarn/owl/main/examples/owl-structure2.svg)

Sharing the same set of interface with Ndarray is the `base` system data architecture, which is implemented in pure OCaml. It is also based on modules that are implemented in OCaml. However, though it is sufficient for daily use for normal computing, the base version Ndarray does not implement some advanced functions as in the previous Owl version Ndarray, and its performance is understandably much slower.

![Owl architecture 3](https://raw.githubusercontent.com/owlbarn/owl/main/examples/owl-structure3.svg)

Besides these two types of Ndarray, another type is CGraph-Ndarray, which can be used to support symbolic style computing like TensorFlow v1. It facilitate building computation graph and computation optimization. 
The CGraph-Ndarray can be built up by wrapping up either of the previous two types of Ndarray, which are used for actual execution of computing.
All three types of Ndarray can be used to support advanced computing modules, including algorithmic differentiation, optimization, and neural networks.

## Code of Contributing

In principle any change to the code base is made via a GitHub Pull Request (PR). Pull requests must be reviewed and approved by at least two key developers in the Owl Team.

Team members are responsible for the issues and PRs concerning the domain aspects they claim, and are also responsible for fixing the problems caused by accepting such PRs.

If a PR is large or involves significant update or changes to the code structure, an issue should be submitted for the community and team members to discuss, and it then can be decided by the corresponding team member and project leader.

If an issue or PR does not belong to any team member's domain aspect, the response will also be on a best-effort basis with no guaranteed response time.

Please check the full [contributing rules](CONTRIBUTING.md) and [code of conduct](CODE_OF_CONDUCT.md) of the Owl project for more detail.

## Community

The Owl community is based on the [OCaml Discourse](https://discuss.ocaml.org/) and [Owl Slack channel](https://owl-dev-team.slack.com/).  All participants in the community are encouraged to provide support for new users within the project management infrastructure. Those seeking technical support should also recognize that all support activities within the project is voluntary and is therefore provided as and when time permits.