(git:27c966b)
Loading...
Searching...
No Matches
hfx_compression_core_methods Module Reference

Contains routines for data compression: packing integers of Nbits bits each into a stream of 64-bit words, and unpacking them. Per number of bits, fypp generates a routine that assembles each packed word in a register from constant shifts and stores it once, for every group of 64 integers (which fills exactly Nbits words). Moreover, packing at a width per group of integers (the width the group needs), in 8 streams whose shifts are uniform over the lanes. More...

Functions/Subroutines

subroutine, public ints2bits_specific (nbits, ndata, packed_data, full_data)
 Packs integers into a stream of 64-bit words, Nbits bits per integer.
subroutine, public bits2ints_specific (nbits, ndata, packed_data, full_data)
 Unpacks integers from a stream of 64-bit words, Nbits bits per integer.
integer function, public ints2groups (nbits, ngroup, packed_data, full_data)
 Packs integers at a width per group, the width the group's largest magnitude needs: header bytes (the group size, then a width per group), then 8 interleaved streams (integer 8*c+l in stream l, all at the same bit position), so that every shift is uniform over the 8 lanes; a group is Ngroup/8 such columns at its width. The integers are signed, of Nbits bits (sign folded).
integer function, public groups2ints (packed_data, full_data)
 Unpacks integers that ints2groups packed (signed, the sign unfolded); the group size is read from the stream.

Detailed Description

Contains routines for data compression: packing integers of Nbits bits each into a stream of 64-bit words, and unpacking them. Per number of bits, fypp generates a routine that assembles each packed word in a register from constant shifts and stores it once, for every group of 64 integers (which fills exactly Nbits words). Moreover, packing at a width per group of integers (the width the group needs), in 8 streams whose shifts are uniform over the lanes.

History
04.2008 created [Manuel Guidon] 10.2026 generated by fypp instead of a generated source file [Hans Pabst]
Author
Manuel Guidon

Function/Subroutine Documentation

◆ ints2bits_specific()

subroutine, public hfx_compression_core_methods::ints2bits_specific ( integer, intent(in) nbits,
integer, intent(in) ndata,
integer(kind=int_8), dimension(*), intent(out) packed_data,
integer(kind=int_8), dimension(*), intent(in) full_data )

Packs integers into a stream of 64-bit words, Nbits bits per integer.

Parameters
Nbitsnumber of bits per integer (1 to 64); bits beyond them are ignored
Ndatanumber of integers
packed_datathe stream of bits, CEILING(Ndata*Nbits/64) words
full_datathe integers

Definition at line 39 of file hfx_compression_core_methods.F.

Here is the caller graph for this function:

◆ bits2ints_specific()

subroutine, public hfx_compression_core_methods::bits2ints_specific ( integer, intent(in) nbits,
integer, intent(in) ndata,
integer(kind=int_8), dimension(*), intent(in) packed_data,
integer(kind=int_8), dimension(*), intent(out) full_data )

Unpacks integers from a stream of 64-bit words, Nbits bits per integer.

Parameters
Nbitsnumber of bits per integer (1 to 64)
Ndatanumber of integers
packed_datathe stream of bits, CEILING(Ndata*Nbits/64) words
full_datathe integers

Definition at line 185 of file hfx_compression_core_methods.F.

Here is the caller graph for this function:

◆ ints2groups()

integer function, public hfx_compression_core_methods::ints2groups ( integer, intent(in) nbits,
integer, intent(in) ngroup,
integer(kind=int_8), dimension(:), intent(out), contiguous packed_data,
integer(kind=int_8), dimension(:), intent(in), contiguous full_data )

Packs integers at a width per group, the width the group's largest magnitude needs: header bytes (the group size, then a width per group), then 8 interleaved streams (integer 8*c+l in stream l, all at the same bit position), so that every shift is uniform over the 8 lanes; a group is Ngroup/8 such columns at its width. The integers are signed, of Nbits bits (sign folded).

Parameters
Nbitsnumber of bits per integer (1 to 64); bits beyond them are ignored
Ngroupnumber of integers per group, a multiple of 8 (8 to 248)
packed_datathe stream: words for 1+CEILING(n/Ngroup) header bytes, then at most 8*CEILING(((n+7)/8)*Nbits/64) words (n integers)
full_datathe integers
Returns
number of words written

Definition at line 17198 of file hfx_compression_core_methods.F.

Here is the caller graph for this function:

◆ groups2ints()

integer function, public hfx_compression_core_methods::groups2ints ( integer(kind=int_8), dimension(:), intent(in), contiguous packed_data,
integer(kind=int_8), dimension(:), intent(out), contiguous full_data )

Unpacks integers that ints2groups packed (signed, the sign unfolded); the group size is read from the stream.

Parameters
packed_datathe stream
full_datathe integers
Returns
number of words read

Definition at line 17259 of file hfx_compression_core_methods.F.

Here is the caller graph for this function: