This project use cmake in order to generate any type of projects (Makefile, Visual Studio, Eclipse, CLion, etc.).
AFF3CT depends on some other Git repositories (or submodules). It is highly recommended to get those submodules before trying to do anything else. Here is the command to get all the required submodules:
$ git submodule update --init --recursive
Open a shell and type (from the AFF3CT root folder):
$ mkdir build
$ cd build
$ cmake .. -G"Unix Makefiles" -DCMAKE_CXX_COMPILER=g++ -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_FLAGS="-funroll-loops -march=native -DMULTI_PREC"
$ make -j4
This command will use the generated Makefile.
Here is an example of run. You can skip the computations of the current SNR point with the ctrl+c combination on the keyboard.
If you use ctrl+c twice in a small time-step (500ms), the program will stop.
Open a shell and type (from the $ROOT_AFF3CT/build/ folder):
$ ./bin/aff3ct -C POLAR -m 1 -M 4 -s 0.25 -K 1755 -N 2048 --crc-poly 32-GZIP --dec-type ASCL
Expected output:
# -------------------------------------------------
# ---- A FAST FORWARD ERROR CORRECTION TOOL >> ----
# -------------------------------------------------
# Parameters :
# * Simulation ------------------------------------
# ** Type = BFER
# ** Type of bits = int32
# ** Type of reals = float32
# ** Date (UTC) = 2017-10-19 09:54:56
# ** Git version = v1.3.0
# ** Code type (C) = POLAR
# ** SNR min (m) = 1.000000 dB
# ** SNR max (M) = 4.000100 dB
# ** SNR step (s) = 0.250000 dB
# ** Seed = 0
# ** Statistics = off
# ** Debug mode = off
# ** Multi-threading (t) = 4 thread(s)
# ** SNR type = EB
# ** Coset approach (c) = no
# ** Coded monitoring = no
# ** Bad frames tracking = off
# ** Bad frames replay = off
# ** Bit rate = 0.841309
# ** Inter frame level = 1
# * Source ----------------------------------------
# ** Type = RAND
# ** Info. bits (K_info) = 1723
# * CRC -------------------------------------------
# ** Type = FAST
# ** Name = 32-GZIP
# ** Polynomial (hexadecimal) = 0x4c11db7
# ** Size (in bit) = 32
# * Codec -----------------------------------------
# ** Type = POLAR
# ** Info. bits (K) = 1755
# ** Codeword size (N_cw) = 2048
# ** Frame size (N) = 2048
# ** Code rate = 0.856934
# * Encoder ---------------------------------------
# ** Type = POLAR
# ** Systematic = yes
# Frozen bits generator ------------------------
# ** Type = GA
# ** Sigma = adaptive
# * Decoder ---------------------------------------
# ** Type (D) = ASCL
# ** Implementation = FAST
# ** Systematic = yes
# ** Max num. of lists (L) = 8
# ** Adaptative mode = full
# ** Polar node types = {R0,R0L,R1,REP,REPL,SPC}
# * Modem -----------------------------------------
# ** Type = BPSK
# ** Bits per symbol = 1
# ** Sampling factor = 1
# ** Sigma square = on
# * Channel ---------------------------------------
# ** Type = AWGN
# ** Complex = off
# ** Add users = off
# * Monitor ---------------------------------------
# ** Frame error count (e) = 100
# * Terminal --------------------------------------
# ** Type = STD
# ** Enabled = yes
# ** Frequency (ms) = 500
#
# The simulation is running...
# ----------------------------------------------------------------------||---------------------
# Bit Error Rate (BER) and Frame Error Rate (FER) depending || Global throughput
# on the Signal Noise Ratio (SNR) || and elapsed time
# ----------------------------------------------------------------------||---------------------
# -------|-------|----------|----------|----------|----------|----------||----------|----------
# Es/N0 | Eb/N0 | FRA | BE | FE | BER | FER || SIM_THR | ET/RT
# (dB) | (dB) | | | | | || (Mb/s) | (hhmmss)
# -------|-------|----------|----------|----------|----------|----------||----------|----------
0.25 | 1.00 | 103 | 15522 | 103 | 8.75e-02 | 1.00e+00 || 2.37 | 00h00'00
0.50 | 1.25 | 103 | 14705 | 103 | 8.29e-02 | 1.00e+00 || 5.04 | 00h00'00
0.75 | 1.50 | 103 | 13801 | 103 | 7.78e-02 | 1.00e+00 || 5.26 | 00h00'00
1.00 | 1.75 | 103 | 12988 | 103 | 7.32e-02 | 1.00e+00 || 5.22 | 00h00'00
1.25 | 2.00 | 103 | 12072 | 103 | 6.80e-02 | 1.00e+00 || 5.20 | 00h00'00
1.50 | 2.25 | 103 | 10801 | 103 | 6.09e-02 | 1.00e+00 || 5.12 | 00h00'00
1.75 | 2.50 | 106 | 8266 | 103 | 4.53e-02 | 9.72e-01 || 5.23 | 00h00'00
2.00 | 2.75 | 138 | 6789 | 102 | 2.86e-02 | 7.39e-01 || 6.09 | 00h00'00
2.25 | 3.00 | 182 | 4777 | 103 | 1.52e-02 | 5.66e-01 || 7.12 | 00h00'00
2.50 | 3.25 | 497 | 3751 | 102 | 4.38e-03 | 2.05e-01 || 11.76 | 00h00'00
2.75 | 3.50 | 2445 | 2723 | 100 | 6.46e-04 | 4.09e-02 || 19.59 | 00h00'00
3.00 | 3.75 | 18817 | 2552 | 100 | 7.87e-05 | 5.31e-03 || 26.25 | 00h00'01
3.25 | 4.00 | 174249 | 1910 | 100 | 6.36e-06 | 5.74e-04 || 28.97 | 00h00'10
# End of the simulation.
See the AFF3CT Wiki.