Skip to content

Commit d5e22d9

Browse files
committed
docs(README): Adding information on the contest
1 parent aa70cda commit d5e22d9

File tree

2 files changed

+44
-1
lines changed

2 files changed

+44
-1
lines changed

README.md

Lines changed: 44 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,46 @@
1-
# 1 Billion Row Challenge
1+
# 1️⃣🐝🏎️ The One Billion Row Challenge in Object Pascal
22

33
This is the repository that will coordinate the 1 Billion Row Challenge for Object Pascal.
4+
5+
The One Billion Row Challenge (1BRC) is a fun exploration of how far modern Object Pascal can be pushed for aggregating one billion rows from a text file.
6+
Grab all your threads, reach out to SIMD, or pull any other trick, and create the fastest implementation for solving this task!
7+
8+
<img src="img/1brc.png" alt="1BRC" style="display: block; margin-left: auto; margin-right: auto; margin-bottom:1em; width: 50%;">
9+
10+
The text file contains temperature values for a range of weather stations. Each row is one measurement in the format `<string: station name>;<double: measurement>``, with the measurement value having exactly one fractional digit.
11+
The following shows ten rows as an example:
12+
13+
```
14+
Hamburg;12.0
15+
Bulawayo;8.9
16+
Palembang;38.8
17+
St. John's;15.2
18+
Cracow;12.6
19+
Bridgetown;26.9
20+
Istanbul;6.2
21+
Roseau;34.4
22+
Conakry;31.2
23+
Istanbul;23.0
24+
```
25+
26+
The task is to write an Object Pascal program which reads the file, calculates the min, mean, and max temperature value per weather station, and emits the results on `STDOUT` like this (i.e. sorted alphabetically by station name, and the result values per station in the format `<min>/<mean>/<max>``, rounded to one fractional digit):
27+
28+
```
29+
{Abha=-23.0/18.0/59.2, Abidjan=-16.2/26.0/67.3, Abéché=-10.0/29.4/69.0, Accra=-10.1/26.4/66.4, Addis Ababa=-23.7/16.0/67.0, Adelaide=-27.8/17.3/58.5, ...}
30+
```
31+
32+
Submissions will be, preferably, as a `GIT` `submodule`
33+
34+
Submit your implementation and become part of the leader board!
35+
36+
## Results
37+
38+
These are the results from running all entries into the challenge on my personal computer:
39+
- Ryzen 9 5950x 16 core
40+
- 32GB RAM
41+
- 250GB SSD
42+
- 1TB HDD
43+
44+
| # | Result (m:s.ms): SSH | Result (m:s.ms): HDD | Submitter | Notes | Certificates |
45+
|---|----------------------|----------------------|---------------|-----------|--------------|
46+
|?|?|?|?|?|?|

img/1brc.png

243 KB
Loading

0 commit comments

Comments
 (0)