normal.h File Reference

Normally-distributed random numbers. More...

#include <stdint.h>
#include <stdbool.h>
#include <stdfix.h>
#include "stdfix-full-iso.h"
#include "assert.h"

Go to the source code of this file.

Macros
#define	norminv_fx(f)
	This function takes a uniformly distributed PRNG value, f, and returns a normally distributed s1615 PRNG.

Functions
int	__norminv_rbits (int x)
	This function takes a uniformly distributed 16-bit PRNG value, x, and returns a normally distributed s16.15 in int representation.
static int	__norminv_t_bits (int x)
	This function takes a uniformly distributed 16-bit PRNG value, x, and returns a normally distributed 16-bit PRNG in int representation.
static int	__norminv_b_bits (int x)
	This function takes a uniformly distributed 16-bit PRNG value, x, and returns a normally distributed 16-bit PRNG in int representation.
static s1615	norminv_urb (unsigned int x)
	This function takes a uniformly distributed 16-bit PRNG value, x, and returns a normally distributed s1615 PRNG.
static s1615	norminv_urt (unsigned int x)
	This function takes a uniformly distributed 16-bit PRNG value, x, and returns a normally distributed s1615 PRNG.
static s1615	norminv_ur (u016 x)
	This function takes a uniformly distributed 16-bit PRNG value, x, and returns a normally distributed s1615 PRNG.
s1615	norminv_ulr (u032 x)
	This function takes a uniformly distributed 16-bit PRNG value, x, and returns a normally distributed s1615 PRNG.

Detailed Description

Normally-distributed random numbers.

Macro Definition Documentation

norminv_fx

#define norminv_fx

(

f

)

Value:

    _Generic((f), \
    u016:     norminv_ur(f), \
    u032:     norminv_ulr(f), \
    default:  __builtin_trap() \
    )

This function takes a uniformly distributed PRNG value, f, and returns a normally distributed s1615 PRNG.

Parameters

[in]

f

A uniformly distributed unsigned u016 or u032.

Returns

A normally distributed s1615 PRNG.

Function Documentation

__norminv_rbits()

int __norminv_rbits

(

int

x

)

This function takes a uniformly distributed 16-bit PRNG value, x, and returns a normally distributed s16.15 in int representation.

Given an 16-bit signed integer value, representing p - 0.5, return the cumulative normal value associated with that probability.

Parameters

[in]

x

A uniformly distributed 16-bit PRNG, in the bottom 16 bits of x.

Returns

A normally distributed int representation of an s16.15 PRNG.

__norminv_t_bits()

static int __norminv_t_bits ( int  x )

inlinestatic

This function takes a uniformly distributed 16-bit PRNG value, x, and returns a normally distributed 16-bit PRNG in int representation.

Parameters

[in]

x

A uniformly distributed 16-bit PRNG, in the top 16 bits of x.

Returns

A normally distributed int representation of an s16.15 PRNG.

__norminv_b_bits()

static int __norminv_b_bits ( int  x )

inlinestatic

This function takes a uniformly distributed 16-bit PRNG value, x, and returns a normally distributed 16-bit PRNG in int representation.

Parameters

[in]

x

A uniformly distributed 16-bit PRNG, in the bottom 16 bits of x.

Returns

A normally distributed int representation of an s16.15 PRNG.

norminv_urb()

static s1615 norminv_urb ( unsigned int  x )

inlinestatic

This function takes a uniformly distributed 16-bit PRNG value, x, and returns a normally distributed s1615 PRNG.

Parameters

[in]

x

A uniformly distributed 16-bit PRNG, in the bottom 16 bits of x.

Returns

A normally distributed s1615 PRNG.

norminv_urt()

static s1615 norminv_urt ( unsigned int  x )

inlinestatic

This function takes a uniformly distributed 16-bit PRNG value, x, and returns a normally distributed s1615 PRNG.

Parameters

[in]

x

A uniformly distributed 16-bit PRNG, in the top 16 bits of x.

Returns

A normally distributed s1615 PRNG.

norminv_ur()

static s1615 norminv_ur ( u016  x )

inlinestatic

This function takes a uniformly distributed 16-bit PRNG value, x, and returns a normally distributed s1615 PRNG.

Parameters

[in]

x

A uniformly distributed unsigned u016.

Returns

A normally distributed s1615 PRNG.

norminv_ulr()

s1615 norminv_ulr

(

u032

x

)

This function takes a uniformly distributed 16-bit PRNG value, x, and returns a normally distributed s1615 PRNG.

Parameters

[in]

x

A uniformly distributed unsigned u032.

Returns

A normally distributed s1615 PRNG.