systematic POLAR encoder for basic details see 'polar_common' class. More...
#include <gnuradio/fec/polar_encoder_systematic.h>
Public Member Functions | |
void | generic_work (void *in_buffer, void *out_buffer) |
double | rate () |
int | get_input_size () |
int | get_output_size () |
bool | set_frame_size (unsigned int frame_size) |
~polar_encoder_systematic () | |
![]() | |
int | unique_id () |
std::string | alias () |
virtual const char * | get_input_conversion () |
virtual const char * | get_output_conversion () |
generic_encoder (void) | |
generic_encoder (std::string name) | |
virtual | ~generic_encoder () |
![]() | |
polar_common (int block_size, int num_info_bits, std::vector< int > frozen_bit_positions, std::vector< char > frozen_bit_values) | |
~polar_common () | |
Static Public Member Functions | |
static generic_encoder::sptr | make (int block_size, int num_info_bits, std::vector< int > frozen_bit_positions) |
Additional Inherited Members | |
![]() | |
typedef boost::shared_ptr < generic_encoder > | sptr |
![]() | |
int | my_id |
std::string | d_name |
![]() | |
static int | base_unique_id |
![]() | |
const int | block_size () const |
const int | block_power () const |
const int | num_info_bits () const |
long | bit_reverse (long value, int active_bits) const |
void | print_packed_bit_array (const unsigned char *printed_array, const int num_bytes) const |
void | print_unpacked_bit_array (const unsigned char *bits, const unsigned int num_bytes) const |
void | setup_info_bit_positions_reversed () |
void | setup_volk_vectors () |
void | volk_encode (unsigned char *out_buf, const unsigned char *in_buf) |
void | volk_encode_block (unsigned char *out_buf, unsigned char *in_buf) |
![]() | |
gr::logger_ptr | d_logger |
![]() | |
std::vector< int > | d_frozen_bit_positions |
std::vector< char > | d_frozen_bit_values |
std::vector< int > | d_info_bit_positions |
std::vector< int > | d_info_bit_positions_reversed |
unsigned char * | d_volk_temp |
unsigned char * | d_volk_frozen_bit_mask |
unsigned char * | d_volk_frozen_bits |
systematic POLAR encoder for basic details see 'polar_common' class.
expects values with MSB first. It needs a full information word and encodes it in one pass. Output is a codeword of block_size.
Systematic encoding indicates that the info bit values are present in the codeword. 'info_bit_positions' may be obtained by ordering all non frozen_bit_positions in increasing order. One may extract them at their positions after a bit reversal operation. encoder -> decoder chain would need additional bit-reversal after encoding + before decoding. This is unnecessary.
gr::fec::code::polar_encoder_systematic::~polar_encoder_systematic | ( | ) |
|
virtual |
Implements gr::fec::generic_encoder.
|
inlinevirtual |
Returns the input size in items that the encoder object uses to encode a full frame. Often, this number is the number of bits per frame if the input format is unpacked. If the block expects packed bytes, then this value should be the number of bytes (number of bits / 8) per input frame.
The child class MUST implement this function.
Implements gr::fec::generic_encoder.
|
inlinevirtual |
Returns the output size in items that the encoder object produces after encoding a full frame. Often, this number is the number of bits in the outputted frame if the input format is unpacked. If the block produces packed bytes, then this value should be the number of bytes (number of bits / 8) per frame produced. This value is generally something like R*get_input_size() for a 1/R rate code.
The child class MUST implement this function.
Implements gr::fec::generic_encoder.
|
static |
Factory for a polar code encoder object.
block_size | defines the codeword size. It MUST be a power of 2. |
num_info_bits | represents the number of information bits in a block. Also called frame_size. |
frozen_bit_positions | is an integer vector which defines the position of all frozen bits in a block. Its size MUST be equal to block_size - num_info_bits. Also it must be sorted and every position must only occur once. Frozen bit values will be set to ZERO! |
|
inlinevirtual |
Returns the rate of the code. For every 1 input bit, there are r output bits, so the rate is 1/r. Used for setting things like the encoder block's relative rate.
This function MUST be reimplemented by the child class.
Implements gr::fec::generic_encoder.
|
inlinevirtual |
Updates the size of the frame to encode.
The child class MUST implement this function and interpret how the frame_size
information affects the block's behavior. It should also provide bounds checks.
Implements gr::fec::generic_encoder.