Skip to content

Commit 12d0b45

Browse files
allnesallnes
committed
update translations in RU locale: adjust point calculations and correct task descriptions
1 parent a791f0a commit 12d0b45

30 files changed

Lines changed: 3056 additions & 1329 deletions

‎README.md‎

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,46 @@ Coverage report is available [here](https://learning-process.github.io/parallel_
2121
* `oneAPI Threading Building Blocks (oneTBB)`
2222
* `Multithreading in C++ (std::thread)`
2323

24+
## Quickstart
25+
26+
Build
27+
-----
28+
- Configure: `cmake -S . -B build [-DENABLE_ADDRESS_SANITIZER=ON]`
29+
- Build: `cmake --build build -j`
30+
- Optional install: `cmake --install build --prefix install`
31+
32+
Run tests locally (preferred)
33+
-----------------------------
34+
Set environment and use the helper runner:
35+
36+
```
37+
export PPC_NUM_THREADS=4
38+
export PPC_NUM_PROC=2
39+
40+
# Shared-memory tests
41+
python3 scripts/run_tests.py --running-type threads --counts 1 2 4
42+
43+
# MPI tests
44+
python3 scripts/run_tests.py --running-type processes --counts 2 4
45+
46+
# Performance
47+
python3 scripts/run_tests.py --running-type performance
48+
```
49+
50+
Scoreboard generation
51+
---------------------
52+
- `pip install -r scoreboard/requirements.txt`
53+
- `python3 scoreboard/main.py -o scoreboard/out`
54+
55+
Docs
56+
----
57+
- `cmake -S . -B build -DUSE_DOCS=ON`
58+
- `cmake --build build -t docs_html`
59+
60+
Pre-commit
61+
----------
62+
- `pre-commit install && pre-commit run -a`
63+
2464
### Rules for submissions:
2565
1. You are not supposed to trigger CI jobs by frequent updates of your pull request. First you should test you work locally with all the scripts (code style).
2666
* Respect others time and don't slow down the job queue

‎docs/common_information/introduction.rst‎

Lines changed: 25 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,12 @@
11
Introduction
22
============
33

4+
Contacts
5+
~~~~~~~~
6+
7+
- Alexander Nesterov — nesterov.alexander@outlook.com
8+
- Arseniy Obolenskiy — me@gooddoog.ru
9+
410
Practice
511
~~~~~~~~
612

@@ -12,7 +18,9 @@ Practice
1218
- Test verification
1319

1420
- Task distribution is random for each student.
15-
- An example for each technology can be found in the corresponding directory: ``tasks/<all/omp/tbb/seq/stl/mpi>/example``.
21+
- Full automation of quality and performance checks; plagiarism checks are applied.
22+
- Deadlines are set per task. See the penalties and grading rules in ``Points``.
23+
- Examples are provided in ``tasks/example_threads`` and ``tasks/example_processes`` (and extended variations ``tasks/example_processes_2`` / ``tasks/example_processes_3``).
1624
- In each repository, the README.md contains a link to the course documentation (**read it fully!!!**).
1725
- Additionally, each repository includes an example of a properly formatted PULL REQUEST.
1826
- Submission of all tasks is mandatory to pass the course.
@@ -21,6 +29,22 @@ Practice
2129
All disabled tasks will result in a zero points result for those tasks at the end of the semester.
2230
It can be seen that your task is disabled due to the following reason: the directory of your task has been renamed
2331
from ``seq/nesterov_a_vector_sum`` to ``seq/nesterov_a_vector_sum_disabled``
32+
33+
Communication
34+
~~~~~~~~~~~~~
35+
36+
- Telegram channel — announcements and quick updates
37+
- GitHub Issues — repository problems and bug reports
38+
- Lessons — Q&A
39+
- Feedback form — critical issues
40+
- Email — non‑urgent matters
41+
42+
Next steps
43+
~~~~~~~~~~
44+
45+
- Practice 1 (intro): task distribution, brief talk on parallelism, MPI examples
46+
- Practice 2 (repo usage): repository checks and project structure walkthrough
47+
2448
- All resources for using the repository will be provided here:
2549

2650
- `Git for half an hour: A Beginner’s Guide <https://proglib.io/p/git-for-half-an-hour>`__

‎docs/common_information/points.rst‎

Lines changed: 119 additions & 150 deletions
Original file line numberDiff line numberDiff line change
@@ -1,153 +1,122 @@
11
Points
22
======
33

4-
- For “process parallelism” semester
5-
6-
- 1st MPI task
7-
8-
+----------+
9-
| Solution |
10-
+==========+
11-
| 10 |
12-
+----------+
13-
14-
- 2nd MPI task
15-
16-
======== ===========
17-
Solution Performance
18-
======== ===========
19-
15 5
20-
======== ===========
21-
22-
- 3rd MPI task
23-
24-
======== ===========
25-
Solution Performance
26-
======== ===========
27-
20 10
28-
======== ===========
29-
30-
- **Total : 60 points**
31-
32-
- For “thread parallelism” semester
33-
34-
- Sequential version
35-
36-
+----------+
37-
| Solution |
38-
+==========+
39-
| 4 |
40-
+----------+
41-
42-
- OpenMP version
43-
44-
======== ===========
45-
Solution Performance
46-
======== ===========
47-
6 3
48-
======== ===========
49-
50-
- TBB version
51-
52-
======== ===========
53-
Solution Performance
54-
======== ===========
55-
6 3
56-
======== ===========
57-
58-
- std::thread version
59-
60-
======== ===========
61-
Solution Performance
62-
======== ===========
63-
8 6
64-
======== ===========
65-
66-
- “MPI + threads” version (The threading technology is chosen
67-
randomly)
68-
69-
======== ===========
70-
Solution Performance
71-
======== ===========
72-
10 8
73-
======== ===========
74-
75-
- **Total : 54 points**
76-
77-
- The rule for earning performance points.
78-
79-
The ratio of efficiency percentage to points percentage, where the maximum points is 100% and the minimum points is 0%.
80-
81-
If the score is not an integer, it is rounded up.
82-
83-
+----------------+-------------------+
84-
| Efficiency (%) | Points percentage |
85-
+================+===================+
86-
| >= 50% | 100% |
87-
+----------------+-------------------+
88-
| [45, 50) | 90% |
89-
+----------------+-------------------+
90-
| [42, 45) | 80% |
91-
+----------------+-------------------+
92-
| [40, 42) | 70% |
93-
+----------------+-------------------+
94-
| [37, 40) | 60% |
95-
+----------------+-------------------+
96-
| [35, 37) | 50% |
97-
+----------------+-------------------+
98-
| [32, 35) | 40% |
99-
+----------------+-------------------+
100-
| [30, 32) | 30% |
101-
+----------------+-------------------+
102-
| [27, 30) | 20% |
103-
+----------------+-------------------+
104-
| [25, 27) | 10% |
105-
+----------------+-------------------+
106-
| < 25% | 0% |
107-
+----------------+-------------------+
108-
109-
- Report
110-
111-
+--------------+--------------+--------------------+-------+
112-
| Completeness | Text Quality | Formatting Quality | Total |
113-
+==============+==============+====================+=======+
114-
| 5 | 2.5 | 2.5 | 10 |
115-
+--------------+--------------+--------------------+-------+
116-
117-
- Conversion of points into exam assessment or pass/fail
118-
119-
- For 5-point grading system
120-
121-
============ =============== ============
122-
Points range Exam Assessment Student Pass
123-
============ =============== ============
124-
[87, 100] 5 Passed
125-
[70, 87) 4 Passed
126-
[50, 70) 3 Passed
127-
< 50 2 Not Passed
128-
============ =============== ============
129-
130-
- For 7-point grading system **(our current system)**
131-
132-
============ =============== ============
133-
Points range Exam Assessment Student Pass
134-
============ =============== ============
135-
[99, 100] 5.5 Passed
136-
[92, 99) 5 Passed
137-
[82, 92) 4.5 Passed
138-
[70, 82) 4 Passed
139-
[50, 70) 3 Passed
140-
< 50 2 Not Passed
141-
============ =============== ============
142-
143-
- Penalties:
144-
145-
- A deadline will be set for each version.
146-
- 1 point is deducted from the version’s score for each day of delay in submission.
147-
- The task is considered submitted when it is merged into the master/main branch.
148-
- The submission time is defined as the timestamp of the last commit that successfully passes the CI pipeline.
149-
150-
- Comments:
151-
152-
- It is forbidden to write the report if all tasks are not completed.
153-
- Please keep in mind that one week before the end of the semester, the repository will be closed for final assessment.
4+
Overview
5+
--------
6+
7+
- Total per semester (Practice): 70 points
8+
- Report points are distributed per task and sum to 10
9+
10+
Processes semester (MPI)
11+
------------------------
12+
13+
- Task 1 — Total: 12
14+
- Implementation: MPI 8 + Seq 2
15+
- Performance: 0
16+
- Report: 2
17+
18+
- Task 2 — Total: 23
19+
- Implementation: MPI 12 + Seq 3
20+
- Performance: 5
21+
- Report: 3
22+
23+
- Task 3 — Total: 35
24+
- Implementation: MPI 16 + Seq 4
25+
- Performance: 10
26+
- Report: 5
27+
28+
- Semester total: 70
29+
30+
Threads semester (OpenMP/TBB/std::thread)
31+
-----------------------------------------
32+
33+
- seq — Total: 5 (S 4, R 1)
34+
- omp — Total: 11 (S 6, A 3, R 2)
35+
- tbb — Total: 11 (S 6, A 3, R 2)
36+
- stl — Total: 16 (S 8, A 6, R 2)
37+
- all — Total: 21 (S 10, A 8, R 3)
38+
39+
- Semester total: 64
40+
41+
Performance points mapping
42+
--------------------------
43+
44+
The ratio of efficiency percentage to points percentage (max 100%, min 0%):
45+
46+
If the score is not an integer, it is rounded up.
47+
48+
+----------------+-------------------+
49+
| Efficiency (%) | Points percentage |
50+
+================+===================+
51+
| >= 50% | 100% |
52+
+----------------+-------------------+
53+
| [45, 50) | 90% |
54+
+----------------+-------------------+
55+
| [42, 45) | 80% |
56+
+----------------+-------------------+
57+
| [40, 42) | 70% |
58+
+----------------+-------------------+
59+
| [37, 40) | 60% |
60+
+----------------+-------------------+
61+
| [35, 37) | 50% |
62+
+----------------+-------------------+
63+
| [32, 35) | 40% |
64+
+----------------+-------------------+
65+
| [30, 32) | 30% |
66+
+----------------+-------------------+
67+
| [27, 30) | 20% |
68+
+----------------+-------------------+
69+
| [25, 27) | 10% |
70+
+----------------+-------------------+
71+
| < 25% | 0% |
72+
+----------------+-------------------+
73+
74+
Report
75+
------
76+
77+
+--------------+--------------+--------------------+-------+
78+
| Completeness | Text Quality | Formatting Quality | Total |
79+
+==============+==============+====================+=======+
80+
| 5 | 2.5 | 2.5 | 10 |
81+
+--------------+--------------+--------------------+-------+
82+
83+
Conversion to grade
84+
-------------------
85+
86+
- 5-point scale
87+
88+
============ =============== ============
89+
Points range Exam Assessment Student Pass
90+
============ =============== ============
91+
[87, 100] 5 Passed
92+
[70, 87) 4 Passed
93+
[50, 70) 3 Passed
94+
< 50 2 Not Passed
95+
============ =============== ============
96+
97+
- 7-point scale (current)
98+
99+
============ =============== ============
100+
Points range Exam Assessment Student Pass
101+
============ =============== ============
102+
[99, 100] 5.5 Passed
103+
[92, 99) 5 Passed
104+
[82, 92) 4.5 Passed
105+
[70, 82) 4 Passed
106+
[50, 70) 3 Passed
107+
< 50 2 Not Passed
108+
============ =============== ============
109+
110+
Penalties
111+
---------
112+
113+
- A deadline will be set for each version.
114+
- 1 point is deducted from the version’s score for each day of delay.
115+
- A task is considered submitted when it is merged into the default branch after a successful CI pipeline.
116+
- The submission time is defined as the timestamp of the last successful CI commit.
117+
118+
Comments
119+
--------
120+
121+
- It is forbidden to write the report if all tasks are not completed.
122+
- One week before the end of the semester, the repository is closed for final assessment.

0 commit comments

Comments
 (0)