• R/O
  • HTTP
  • SSH

Repository summary

No Tags

Frequently used words (click to add to your profile)

javaandroidc++linuxc#objective-ccocoa誰得qtrubypythonwindowsphpgamebathyscaphegui翻訳comegattwitterframeworkbtronvb.net計画中(planning stage)testdomarduinodirectxpreviewerゲームエンジン


Recent Commits RSS

Rev. Time Author Message
591720d 2020-04-09 03:19:40 dyknon master deb/1.3.0-1+dyknon2 change package architecture to all
3aa6e4e 2020-04-09 02:14:46 dyknon add cargo test
aab60a2 2020-04-09 02:12:01 dyknon deb-crateinfo - improve cfg(...) processing
64fc0a1 2020-04-08 06:36:26 dyknon deb/1.3.0-1 update copyright file
f28ea4c 2020-04-08 06:35:28 dyknon debian files
2770e89 2020-04-07 20:54:24 dyknon pristine-tar pristine-tar data for rust-rayon_1.3.0.orig.tar.gz
834ae29 2020-04-07 20:54:23 dyknon upstream upstream/1.3.0 New upstream version 1.3.0
7ffaf34 2019-12-22 00:20:40 bors[bot] Merge #716 716: Release rayon 1.3.0 / rayon-core 1.7.0 ...
163003e 2019-12-21 23:56:44 Josh Stone bump the release date
f7d7553 2019-12-20 05:40:12 Josh Stone Release rayon 1.3.0 / rayon-core 1.7.0

Recently edited Tags

Name Rev. Time Author
deb/1.3.0-1+dyknon2 591720d 2020-04-09 03:20:41 dyknon
deb/1.3.0-1 64fc0a1 2020-04-08 09:29:42 dyknon
upstream/1.3.0 834ae29 2020-04-07 20:54:24 dyknon


Name Rev. Time Author Message
master 591720d 2020-04-09 03:19:40 dyknon change package architecture...
pristine-tar 2770e89 2020-04-07 20:54:24 dyknon pristine-tar data for rust-...
upstream 834ae29 2020-04-07 20:54:23 dyknon New upstream version 1.3.0



Rayon crate Rayon documentation Travis Status Appveyor status //gitter.im/rayon-rs/Lobby

Rayon is a data-parallelism library for Rust. It is extremely lightweight and makes it easy to convert a sequential computation into a parallel one. It also guarantees data-race freedom. (You may also enjoy this blog post about Rayon, which gives more background and details about how it works, or this video, from the Rust Belt Rust conference.) Rayon is available on crates.io, and API Documentation is available on docs.rs.

Parallel iterators and more

Rayon makes it drop-dead simple to convert sequential iterators into parallel ones: usually, you just change your foo.iter() call into foo.par_iter(), and Rayon does the rest:

use rayon::prelude::*;
fn sum_of_squares(input: &[i32]) -> i32 {
    input.par_iter() // <-- just change that!
         .map(|&i| i * i)

Parallel iterators take care of deciding how to divide your data into tasks; it will dynamically adapt for maximum performance. If you need more flexibility than that, Rayon also offers the join and scope functions, which let you create parallel tasks on your own. For even more control, you can create custom threadpools rather than using Rayon's default, global threadpool.

No data races

You may have heard that parallel execution can produce all kinds of crazy bugs. Well, rest easy. Rayon's APIs all guarantee data-race freedom, which generally rules out most parallel bugs (though not all). In other words, if your code compiles, it typically does the same thing it did before.

For the most, parallel iterators in particular are guaranteed to produce the same results as their sequential counterparts. One caveat: If your iterator has side effects (for example, sending methods to other threads through a Rust channel or writing to disk), those side effects may occur in a different order. Note also that, in some cases, parallel iterators offer alternative versions of the sequential iterator methods that can have higher performance.

Using Rayon

Rayon is available on crates.io. The recommended way to use it is to add a line into your Cargo.toml such as:

rayon = "1.1"

To use the Parallel Iterator APIs, a number of traits have to be in scope. The easiest way to bring those things into scope is to use the Rayon prelude. In each module where you would like to use the parallel iterator APIs, just add:

use rayon::prelude::*;

Rayon currently requires rustc 1.31.0 or greater.


Rayon is an open source project! If you'd like to contribute to Rayon, check out the list of "help wanted" issues. These are all (or should be) issues that are suitable for getting started, and they generally include a detailed set of instructions for what to do. Please ask questions if anything is unclear! Also, check out the Guide to Development page on the wiki. Note that all code submitted in PRs to Rayon is assumed to be licensed under Rayon's dual MIT/Apache2 licensing.

Quick demo

To see Rayon in action, check out the rayon-demo directory, which includes a number of demos of code using Rayon. For example, run this command to get a visualization of an nbody simulation. To see the effect of using Rayon, press s to run sequentially and p to run in parallel.

> cd rayon-demo
> cargo run --release -- nbody visualize

For more information on demos, try:

> cd rayon-demo
> cargo run --release -- --help

Other questions?

See the Rayon FAQ.


Rayon is distributed under the terms of both the MIT license and the Apache License (Version 2.0). See LICENSE-APACHE and LICENSE-MIT for details. Opening a pull requests is assumed to signal agreement with these licensing terms.