This is the source codes of the fast x86 LDPC decoders whose description and optimization techniques are published in the IEEE TDPS journal:
B. Le Gal and C. Jégo. High-throughput multi-core LDPC decoders based on x86 processor. IEEE Transactions on Parallel and Distributed Systems, vol. 27 (5), pages 1373–1386, May 2016.
In this git repository we published the source code of a LDPC decoder implementation optimized for x86 target. This LDPC decoder implementation efficiently takes advantage of the SIMD and SPMT programming model. The approach used to achieve very high
Originally, this source code piece is part of a much larger project that enables us to experiment LDPC decoding algorithm, data format, etc. It explains why some piece of code are useless for you ;-)
In order to compile the LDPC decoder, you currently have to use Intel C++ compiler. Indeed, the ANWG channel model is implemented using the MKL library function.
Source code compilation: ########################
UNTIL NOW, THIS CODE WAS COMPILED ONLY MACOS WITH INTEL COMPILER (ICC). IF YOU GET ISSUES ON OTHER PLATFORMS, PLEASE CONTACT ME THROUGH THE FORUM OR BY E-MAIL (bertrand.legal@ims-bordeaux.fr)
In order to compile the LDPC decoders, just open a terminal and go in the "bin" directory.
cd source_path cd bin
Then compile the source codes using "make"
make
The output must look like this:
[C++] ../src/CBitGenerator/CBitGenerator.cpp [C++] ../src/CChanel/CChanel.cpp [C++] ../src/CChanel/CChanelAWGN_MKL.cpp [C++] ../src/CDecoder/template/CDecoder.cpp [C++] ../src/CDecoder/template/CDecoder_fixed.cpp [C++] ../src/CDecoder/template/CDecoder_fixed_AVX.cpp [C++] ../src/CDecoder/template/CDecoder_fixed_SSE.cpp [C++] ../src/CDecoder/OMS/CDecoder_OMS_fixed_SSE.cpp [C++] ../src/CDecoder/OMS/CDecoder_OMS_fixed_AVX.cpp [C++] ../src/CDecoder/NMS/CDecoder_NMS_fixed_SSE.cpp [C++] ../src/CDecoder/NMS/CDecoder_NMS_fixed_AVX.cpp [C++] ../src/CEncoder/CFakeEncoder.cpp [C++] ../src/CEncoder/Encoder.cpp [C++] ../src/CEncoder/GenericEncoder.cpp [C++] ../src/CErrorAnalyzer/CErrorAnalyzer.cpp [C++] ../src/CFixPointConversion/CFastFixConversion.cpp [C++] ../src/CFixPointConversion/CFixConversion.cpp [C++] ../src/CTerminal/CTerminal.cpp [C++] ../src/CTimer/CTimer.cpp [C++] ../src/CTools/CTools.cpp [C++] ../src/CTools/transpose_avx.cpp [C++] ../src/CTrame/CTrame.cpp [C++] ../src/main_p.cpp [LINKING] main.icc
The compilation of the 576x288 LDPC decoder (default configuration) was successful, the executable file is named "main.icc". To launch the LDPC decoder compiled (576x288), just execute "main.icc" with some parameters:
OMS decoder (offset = 1/8)
./main.icc -fixed -avx -OMS 1 -min 0.5 -max 4.0 -iter 20 ./main.icc -fixed -avx -OMS 1 -min 0.5 -max 4.0 -iter 20
NMS decoder (factor = 29/32)
./main.icc -fixed -avx -NMS 29 -min 0.5 -max 4.0 -iter 20 ./main.icc -fixed -avx -OMS 1 -min 0.5 -max 4.0 -iter 20
Air throughput measure: #######################
To measure the throughput performances, you have to use:
./main.icc -fixed -sse -NMS 29 -iter 20 -NMS 29 -fer 10000000 -timer 10 -thread 1
+> timer 10 : measure and average on 10 seconds, +> thread 1 : use one processor core only (1, 2, 4 values are supported),
The result looks like this:
(PERF) H. LAYERED 16 fixed, 576x288 LDPC code, 20 its, 1 threads (PERF) Kernel Execution time = 1638690 us for 229376 frames => 80.626 Mbps (PERF) SNR = 0.50, ITERS = 20, THROUGHPUT = 80.626 Mbps (PERF) LDPC decoder air throughput = 80.626 Mbps (II) THE SIMULATION HAS STOP DUE TO THE (USER) TIME CONTRAINT. (PERF1) LDPC decoder air throughput = 84.699 Mbps
[PERF] provides the throughput value when the execution time is measured in the simulation loop. [PERF1] provides the throughput of the decoder outside the simulation loop.
Extending the evaluation: #########################
To compile more LDPC decoders (code length, etc), execute the build.py script from the bin directory:
../scripts/build.py