https://github.com/excoffierleonard/fib-rs
A highly optimized Fibonacci number calculator for Rust that efficiently computes arbitrarily large Fibonacci numbers.
https://github.com/excoffierleonard/fib-rs
algorithm fib fib-rs fibonacci math rust
Last synced: 3 months ago
JSON representation
A highly optimized Fibonacci number calculator for Rust that efficiently computes arbitrarily large Fibonacci numbers.
- Host: GitHub
- URL: https://github.com/excoffierleonard/fib-rs
- Owner: excoffierleonard
- License: mit
- Created: 2025-03-31T18:56:33.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-05-24T02:35:18.000Z (5 months ago)
- Last Synced: 2025-06-14T00:03:30.399Z (4 months ago)
- Topics: algorithm, fib, fib-rs, fibonacci, math, rust
- Language: Rust
- Homepage: https://crates.io/crates/fib-rs
- Size: 185 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# fib-rs
[](https://crates.io/crates/fib-rs)
[](https://crates.io/crates/fib-rs)
[](https://docs.rs/fib-rs)
[](LICENSE)
A highly optimized Fibonacci number calculator for Rust that efficiently computes arbitrarily large Fibonacci numbers.
**[Try the web demo](https://excoffierleonard.github.io/fib-rs/)**
## Table of Contents
- [Features](#features)
- [Installation](#installation)
- [Usage](#usage)
- [Performance](#performance)
- [Algorithm Details](#algorithm-details)
- [Web Demo](#web-demo)
- [License](#license)
- [Contributing](#contributing)
## Features
- **Fast doubling algorithm**: Calculates Fibonacci numbers in O(log n) time
- **Handles massive inputs**: Compute Fibonacci numbers up to F(10,000,000) and beyond
- **Range calculation**: Generate sequences of consecutive Fibonacci numbers with parallel processing
- **CLI application**: Simple command-line interface for quick calculations of single values or ranges
## Installation
### Library
To use as a dependency in your project:
```bash
cargo add fib-rs --no-default-features
```
### CLI Tool
To install the command-line tool:
```bash
cargo install fib-rs
```
## Usage
### As a library
```rust
use fib_rs::Fib;
// Calculate F(100)
let n = 100;
let result = Fib::single(n);
// Print the result
println!("F({}) = {}", n, result);
// Calculate a range of Fibonacci numbers (F(3) through F(10))
let start = 3;
let end = 10;
let results = Fib::range(start, end);
// Print the results
(start..=end)
.zip(results.iter())
.for_each(|(i, result)| println!("F({}) = {}", i, result));
```
### Command-line application
#### Single
```bash
fib single 100
```
```bash
F(100) = 354224848179261915075
```
#### Range
```bash
fib range 6 10
```
```bash
F(6) = 8
F(7) = 13
F(8) = 21
F(9) = 34
F(10) = 55
```
## Performance
Specifications:
- 15-inch MacBook Air (2025)
- M4 Chip, 10C CPU, 10C GPU
- 32GB Unified Memory
- macOS Sequoia 15.4
| Single | Computation Time |
|---------------|------------------|
| F(1,000) | ~876ns |
| F(10,000) | ~8μs |
| F(100,000) | ~332μs |
| F(1,000,000) | ~10ms |
| F(10,000,000) | ~326ms |
| Range | Computation Time |
|----------------------|------------------|
| F(0) -> F(1,000) | ~57.6μs |
| F(0) -> F(10,000) | ~729μs |
| F(0) -> F(100,000) | ~45ms |
## Algorithm Details
### Single Fibonacci Number
For computing a single Fibonacci number, this implementation uses the fast doubling algorithm with logarithmic time complexity:
For even n: F(2k) = F(k) *(2*F(k+1) - F(k))
For odd n: F(2k+1) = F(k+1)^2 + F(k)^2
This divide-and-conquer approach is vastly more efficient than naive recursive or iterative methods for large inputs.
### Fibonacci Range
The range implementation combines two approaches for optimal performance:
1. **Parallel processing**: Divides the requested range into optimal chunks based on available CPU threads
2. **Smart initialization**: Uses the fast doubling algorithm to efficiently find the starting values for each chunk
3. **Iterative calculation**: After finding starting values, computes subsequent Fibonacci numbers iteratively within each chunk
This hybrid approach provides excellent performance for generating sequences of consecutive Fibonacci numbers, especially for large ranges, by leveraging multi-core processing while maintaining mathematical efficiency.
## Web Demo
Try the interactive [web demo](https://excoffierleonard.github.io/fib-rs/) to calculate Fibonacci numbers directly in your browser. The demo showcases the library's performance and capabilities through a WebAssembly implementation.
## License
This project is licensed under the [MIT License](LICENSE).
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.