xoshiro512p

Documentation

Overview

Package xoshiro512p implements xoshiro512+ 1.0, our generator for floating-point numbers with increased state size. We suggest to use its upper bits for floating-point generation, as it is slightly faster than xoshiro512**. It passes all tests we are aware of except for the lowest three bits, which might fail linearity tests (and just those), so if low linear complexity is not considered an issue (as it is usually the case) it can be used to generate 64-bit outputs, too.

We suggest to use a sign test to extract a random Boolean value, and right shifts to extract subsets of bits.

The state must be seeded so that it is not everywhere zero. If you have a 64-bit seed, we suggest to seed a splitmix64 generator and use its output to fill s.

Index

• type Source
  • func New(state [8]uint64) *Source
  • func (s *Source) Int63() int64
  • func (s *Source) Seed(seed int64)
  • func (s *Source) Uint64() uint64

Examples

• Source

Types

type Source

type Source struct {
	// contains filtered or unexported fields
}

Source is a random source using xoshiro512+ algorithm.

Go port of http://prng.di.unimi.it/xoshiro512plus.c

Example

package main

import (
	"fmt"
	"math/rand"

	"github.com/shogo82148/randsrc/xoshiro512p"
)

func main() {
	src := xoshiro512p.New([8]uint64{1})
	r := rand.New(src)
	for i := 0; i < 10; i++ {
		fmt.Println(r.Int63())
	}
}

Output:
0
1
0
1025
2048
1024
3147777
2199028498432
4611688217453789185
4611688221751377920

func New

func New(state [8]uint64) *Source

New create a new source.

func (*Source) Int63

func (s *Source) Int63() int64

Int63 implements math/rand.Source.

func (*Source) Seed

func (s *Source) Seed(seed int64)

Seed implements math/rand.Source.

func (*Source) Uint64

func (s *Source) Uint64() uint64

Uint64 implements math/rand.Source64