a16289b204
e81a11d Merge pull request #25 from daiyl0320/master 35c3b37 add retry mechanism to ConnectTracker and modify Listen backlog to 128 in rabit_traker.py c71ed6f try deply doxygen 62e5647 try deply doxygen 732f1c6 try 2fa6e02 ok 0537665 minor 7b59dcb minor 5934950 new doc f538187 ok 44b6049 new doc 387339b add more 9d4397a chg 2879a48 chg 30e3110 ok 9ff0301 add link translation 6b629c2 k 32e1955 ok 8f4839d fix 93137b2 ok 7eeeb79 reload recommonmark a8f00cc minor 19b0f01 ok dd01184 minor c1cdc19 minor fcf0f43 try rst cbc21ae try 62ddfa7 tiny aefc05c final change 2aee9b4 minor fe4e7c2 ok 8001983 change to subtitle 5ca33e4 ok 88f7d24 update guide 29d43ab add code fe8bb3b minor hack for readthedocs 229c71d Merge branch 'master' of ssh://github.com/dmlc/rabit 7424218 ok d1d45bb Update README.md 1e8813f Update README.md 1ccc990 Update README.md 0323e06 remove readme 679a835 remove theme 7ea5b7c remove numpydoc to napoleon b73e2be Merge branch 'master' of ssh://github.com/dmlc/rabit 1742283 ok 1838e25 Update python-requirements.txt bc4e957 ok fba6fc2 ok 0251101 ok d50b905 ok d4f2509 ok cdf401a ok fef0ef2 new doc cef360d ok c125d2a ok 270a49e add requirments 744f901 get the basic doc 1cb5cad Merge branch 'master' of ssh://github.com/dmlc/rabit 8cc07ba minor d74f126 Update .travis.yml 52b3dcd Update .travis.yml 099581b Update .travis.yml 1258046 Update .travis.yml 7addac9 Update Makefile 0ea7adf Update .travis.yml f858856 Update travis_script.sh d8eac4a Update README.md 3cc49ad lint and travis ceedf4e fix fd8920c fix win32 8bbed35 modify 9520b90 Merge pull request #14 from dmlc/hjk41 df14bb1 fix type f441dc7 replace tab with blankspace 2467942 remove unnecessary include 181ef47 defined long long and ulonglong 1582180 use int32_t to define int and int64_t to define long. in VC long is 32bit e0b7da0 fix git-subtree-dir: subtree/rabit git-subtree-split: e81a11dd7ee3cff87a38a42901315821df018bae
40 lines
2.4 KiB
Markdown
40 lines
2.4 KiB
Markdown
## rabit: Reliable Allreduce and Broadcast Interface
|
|
[](https://travis-ci.org/dmlc/rabit)
|
|
[](http://rabit.readthedocs.org/)
|
|
|
|
rabit is a light weight library that provides a fault tolerant interface of Allreduce and Broadcast. It is designed to support easy implementations of distributed machine learning programs, many of which fall naturally under the Allreduce abstraction. The goal of rabit is to support ***portable*** , ***scalable*** and ***reliable*** distributed machine learning programs.
|
|
|
|
* [Tutorial](guide)
|
|
* [API Documentation](http://homes.cs.washington.edu/~tqchen/rabit/doc)
|
|
* You can also directly read the [interface header](include/rabit.h)
|
|
* [Distributed Machine Learning Tools](https://github.com/dmlc/wormhole)
|
|
- Rabit is one of the backbone library to support wormhole machine learning tools
|
|
|
|
Features
|
|
====
|
|
All these features comes from the facts about small rabbit:)
|
|
* Portable: rabit is light weight and runs everywhere
|
|
- Rabit is a library instead of a framework, a program only needs to link the library to run
|
|
- Rabit only replies on a mechanism to start program, which was provided by most framework
|
|
- You can run rabit programs on many platforms, including Yarn(Hadoop), MPI using the same code
|
|
* Scalable and Flexible: rabit runs fast
|
|
* Rabit program use Allreduce to communicate, and do not suffer the cost between iterations of MapReduce abstraction.
|
|
- Programs can call rabit functions in any order, as opposed to frameworks where callbacks are offered and called by the framework, i.e. inversion of control principle.
|
|
- Programs persist over all the iterations, unless they fail and recover.
|
|
* Reliable: rabit dig burrows to avoid disasters
|
|
- Rabit programs can recover the model and results using synchronous function calls.
|
|
|
|
Use Rabit
|
|
====
|
|
* Type make in the root folder will compile the rabit library in lib folder
|
|
* Add lib to the library path and include to the include path of compiler
|
|
* Languages: You can use rabit in C++ and python
|
|
- It is also possible to port the library to other languages
|
|
|
|
Contributing
|
|
====
|
|
Rabit is an open-source library, contributions are welcomed, including:
|
|
* The rabit core library.
|
|
* Customized tracker script for new platforms and interface of new languages.
|
|
* Tutorial and examples about the library.
|