### Open Source Your Knowledge, Become a Contributor

Technology knowledge has to be shared and made accessible for free. Join the movement.

## SSE & AVX C++ Frameworks

### Intrinsics function complexity

Working directly with intrinsic functions can be complicated to code and to maintain. The problem is that intrinsic names are long, and arithmetic operations are written in function notation: `add(a,b)`

instead of `a+b`

.
The following code is hard to read:

```
x = _mm256_div_ps(_mm256_add_ps(b , _mm256_sqrt_ps(_mm256_sub_ps(_mm256_mul_ps(b , b) , _mm256_mul_ps(_mm256_mul_ps(a , c),_mm256_set1_ps(4.0f))))) , _mm256_mul_ps(a,_mm256_set1_ps(2.0f)));
```

Pretty simple, right?. On the other hand this wrapped version is very readable:

```
x = (b + sqrt( b*b - a*c*4.0f))/(a*2.0f);
```

It's like working with floats. You just need to remember that these variables are vectors. As you may notice, the wrapper allows arithmetic operations of a vector with a scalar (vector * scalar = vector).

### C++ Frameworks for SIMD computation

There are existing frameworks that wraps vector datatypes inside new classes. Then they overload arithmetic, logic and asignment operators to simplify calculations. Among others, you can use these two frameworks:

- Agner Fog's C++ vector class library. Complete and updated regularly. Includes trigonometric functions.
- Unified Multicore Environment. It's a more recent library. I haven't used it personally.

### Reduced size Frameworks

Unfortunately these two frameworks are huge in size, at least for competitive programming where code is limited to a hundred KBs or less. In cases where you have limitations in code size, you'll need to strip down a shorter version of one of these frameworks.

I have some vector wrappers reduced in size, just focused on one or two types (for example, __m256 8x float and __m128i 8x short, to work with a vector size of 8, both on floats and on integers).

Even being a reduced version, each vector datatype declaration takes up to 150 lines on average (plus some helper functions). Please use these wrappers as a reference for your own versions, as they may contains bugs.

Wrapper classes can add overhead to the calls, thus reducing performance. But in my opinion, working with intrinsic functions directly is hardly maintainable, cumbersome and prone to errors. From now on, I'll use wrapper classes to abstract the code from the underlying intrinsics.

In all vector Frameworks, you'll find some special functions. These special functions will be widely used in the following lessons. If you don't understand it at first glance, don't worry. You'll eventually understand the logic behind them.

**Blend-based functions**: Blend is the process of conditionally loading vector values based on a mask. This will be explained better in the following lessons. In both Agner Fog's wrapper and in my wrapper, the derived functions are:

`if_select`

`(mask,value_true,value_false)`

: Conditional load of a vector based on a mask. If the`mask`

is true for a vector component,`value_true`

is returned, or`value_false`

otherwise. It's a "fake"`if`

.`if_add`

`(mask,value,add_when_true)`

: Conditional addition. Returns`value + (mask? add_when_true:0)`

, for each vector component.: Similar to`if_sub`

,`if_mul`

,`if_div`

`if_add`

, just with a different arithmetic operation.

**Horizontal functions**: Horizontal means that these functions operate within a single vector variable, by calculating some logical or arithmetic value.

`horizontal_or`

`(mask)`

: If any vector component in the`mask`

is true. Returns a boolean.`horizontal_add`

`(vector)`

: Returns the sum of all components of the vector. The returned value is a number (either float, double or int, depending on the vector type).

NOTE:Agner Fog uses different classes for masks (with`b`

suffix), while I use the same vector classes for the sake of simplicity and code reduction.