Image

head

code

item

root

para

L<Examples| file:../examples/index.podlite>


L<Download |file:../download/index.podlite>


React

=begin React :component<HeaderCol> :id<menu> 
=para L<Documentation|/doc/introduction>
=para L<Modules| /mods>
=para L<Examples| file:../examples/index.podlite>
=para L<Download |file:../download/index.podlite>
=para L<About|file:../about/index.podlite>
=para 🔍 K<⌘K>/K<ctrl-K>
=end React


HEADER

FOOTER

README

use v6.c;

unit class Math::Libgsl::Random:ver<0.0.3>:auth<zef:FRITH>;

use Math::Libgsl::Raw::Random;
use Math::Libgsl::Exception;
use Math::Libgsl::Constants;
use NativeCall;

has gsl_rng $.r;

submethod BUILD(Int :$type?, gsl_rng :$r?) {
  with $r {
    $!r = $r
  } else {
    $!r = mgsl_rng_setup($type // DEFAULT)
  }
}
submethod DESTROY { gsl_rng_free($!r) }

method get(--> Int) { gsl_rng_get($!r) }
method get-uniform(--> Num) { gsl_rng_uniform($!r) }
method get-uniform-pos(--> Num) { gsl_rng_uniform_pos($!r) }
method get-uniform-int(Int $n --> Int) { gsl_rng_uniform_int($!r, $n) }
method seed(Int $seed) { gsl_rng_set($!r, $seed); self }

method name(--> Str) { gsl_rng_name($!r) }
method min(--> Int) { gsl_rng_min($!r) }
method max(--> Int) { gsl_rng_max($!r) }

method copy(Math::Libgsl::Random $src) {
  my $ret = gsl_rng_memcpy($!r, $src.r);
  fail X::Libgsl.new: errno => $ret, error => "Can't copy the generator" if $ret ≠ GSL_SUCCESS;
  self
}
method clone(--> Math::Libgsl::Random) { Math::Libgsl::Random.new: r => gsl_rng_clone($!r) }

method write(Str $filename!) {
  my $ret = mgsl_rng_fwrite($filename, $!r);
  fail X::Libgsl.new: errno => $ret, error => "Can't write the generator" if $ret ≠ GSL_SUCCESS;
  self
}
method read(Str $filename!) {
  my $ret = mgsl_rng_fread($filename, $!r);
  fail X::Libgsl.new: errno => $ret, error => "Can't read the generator" if $ret ≠ GSL_SUCCESS;
  self
}



[![Build Status](https://travis-ci.org/frithnanth/raku-Math-Libgsl-Random.svg?branch=master)](https://travis-ci.org/frithnanth/raku-Math-Libgsl-Random)


Math::Libgsl::Random - An interface to libgsl, the Gnu Scientific Library - Random Number Generation.


=begin code :lang<raku>

use Math::Libgsl::Random;

my Math::Libgsl::Random $r .= new;
$r.get-uniform.say for ^10;

=end code


Math::Libgsl::Random is an interface to the Random Number Generation routines of libgsl, the Gnu Scientific Library.


The constructor allows one optional parameter, the random number generator type. One can find an enum listing all the generator types in the Math::Libgsl::Constants module.


Returns the next random number as an Int.


Returns the next random number as a Num in the interval [0, 1).


Returns the next random number as a Num in the interval (0, 1).


This method returns an Int in the range [0, n - 1].


This method initializes the random number generator.
This method returns B<self>, so it can be concatenated to the B<.new()> method:


=begin code :lang<raku>

my $r = Math::Libgsl::Random.new.seed(42);
$r.get.say;

# or even

Math::Libgsl::Random.new.seed(42).get.say;

=end code


This method returns the name of the current random number generator.


This method returns the minimum value the current random number generator can generate.


This method returns the maximum value the current random number generator can generate.


This method copies the source generator B<$src> into the current one and returns the current object, so it can be concatenated.
The generator state is also copied, so the source and destination generators deliver the same values.


This method clones the current object and returns a new object.
The generator state is also cloned, so the source and destination generators deliver the same values.


=begin code :lang<raku>

my $r = Math::Libgsl::Random.new;
my $clone = $r.clone;

=end code


Writes the generator to a file in binary form.
This method can be chained.


Reads the generator from a file in binary form.
This method can be chained.


For more details on libgsl see L<https://www.gnu.org/software/gsl/>.
The excellent C Library manual is available here L<https://www.gnu.org/software/gsl/doc/html/index.html>, or here L<https://www.gnu.org/software/gsl/doc/latex/gsl-ref.pdf> in PDF format.


This module requires the libgsl library to be installed. Please follow the instructions below based on your platform:


=begin code
sudo apt install libgsl23 libgsl-dev libgslcblas0
=end code


That command will install libgslcblas0 as well, since it's used by the GSL.


libgsl23 and libgslcblas0 have a missing symbol on Ubuntu 18.04.
I solved the issue installing the Debian Buster version of those three libraries:


To install it using zef (a module management tool):


=begin code
$ zef install Math::Libgsl::Random
=end code


Fernando Santagata <nando.santagata@gmail.com>


Random

use v6.c;

unit class Math::Libgsl::QuasiRandom:ver<0.0.2>:auth<zef:FRITH>;

use Math::Libgsl::Raw::QuasiRandom;
use Math::Libgsl::Exception;
use Math::Libgsl::Constants;
use NativeCall;

has gsl_qrng $.q;
has Int      $.dimensions;

submethod BUILD(Int :$type?, Int :$dimensions?, gsl_qrng :$q?) {
  with $q {
    $!q = $q;
    $!dimensions = $dimensions;
  } else {
    $!q = mgsl_qrng_alloc($type // NIEDERREITER2, $dimensions);
    $!dimensions = $dimensions;
  }
}
submethod DESTROY { gsl_qrng_free($!q) }

method init() { gsl_qrng_init($!q) }
method get(--> List) {
  my $res = CArray[num64].allocate($!dimensions);
  my $ret = gsl_qrng_get($!q, $res);
  fail X::Libgsl.new: errno => $ret, error => "Error in get()" if $ret ≠ GSL_SUCCESS;
  return $res.list;
}
method name(--> Str) { gsl_qrng_name($!q) }
method copy(Math::Libgsl::QuasiRandom $src) {
  my $ret = gsl_qrng_memcpy($!q, $src.q);
  fail X::Libgsl.new: errno => $ret, error => "Can't copy the generator" if $ret ≠ GSL_SUCCESS;
  return self;
}
method clone(--> Math::Libgsl::QuasiRandom) {
  Math::Libgsl::QuasiRandom.new: :q(gsl_qrng_clone($!q)), :dimensions($!dimensions);
}



Math::Libgsl::QuasiRandom - An interface to libgsl, the Gnu Scientific Library - Quasi-Random Sequences.


=begin code :lang<raku>

use Math::Libgsl::QuasiRandom;
use Math::Libgsl::Constants;

my Math::Libgsl::QuasiRandom $q .= new: :type(SOBOL), :2dimensions;
$q.get».say for ^10;

=end code


Math::Libgsl::QuasiRandom is an interface to the Quasi-Random Sequences of libgsl, the Gnu Scientific Library.


The constructor allows two parameters, the quasi-random sequence generator type and the dimensions. One can find an enum listing all the generator types in the Math::Libgsl::Constants module.


Returns the next item in the sequence as a List of Nums.


This method returns the name of the current quasi-random sequence.


=begin code :lang<raku>

my $q = Math::Libgsl::QuasiRandom.new;
my $clone = $q.clone;

=end code


=begin code
$ zef install Math::Libgsl::QuasiRandom
=end code


This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.


QuasiRandom

The Raku Knowledge Base


=begin React :component<HeaderCol> :id<footer>  
=begin nested :!nested
=item1 B<Language>
    =item2 L<Get started|file:../getting-started/getting-started.podlite>
    =item2 L<Why Raku?|/doc/language/faq#Why-should-I-learn-Raku-What's-so-great-about-it>
    =item2 L<Try Raku|https://glot.io/new/raku>
    =item2 L<Raku cheat sheet|https://github.com/Raku/mu/blob/master/docs/Perl6/Cheatsheet/cheatsheet.txt>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<Raku on Exercism|https://exercism.org/tracks/raku>
    =item2 L<Wikipedia|https://en.wikipedia.org/wiki/Raku_(programming_language)>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=end nested
=begin nested :!nested

=item1 B<L<Documentation|/doc>>
    =item2 L<Getting started, Migration guides from other languages, & Tutorials | file:../doc/introduction.podlite>
    =item2 L<Language References|file:../doc/reference.podlite>
    =item2 L<Type Reference| file:../doc/types.podlite>
    =item2 L<Miscellaneous| file:../doc/miscellaneous.podlite>
    =item2 L<FAQs (Frequently Asked Questions)|/doc/language/faq>
    =item2 L<Community|/doc/language/community>
    =item2 L<The list of all documents|file:../doc/index.podlite>

=item1 B<Resources>
    =item2 L<The Raku Guide|https://raku.guide/>
    =item2 L<Books |https://perl6book.com/>
    =item2 L<Rosetta Code | https://www.raku.org/community/rosettacode>

=end nested
=begin nested :!nested

=item1 B<Resoures>
    =item2 L<Download | file:../download/index.podlite>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=item1 B<Learning>
    =item2 L<The Raku Guide|https://raku.guide/>
    =item2 L<Wikibook |https://en.wikibooks.org/wiki/Raku_Programming>
    =item2 L<Books |https://perl6book.com/>
    =item2 L<Rosetta Code | https://www.raku.org/community/rosettacode>
    =item2 L<Learn Raku in Y minutes|https://learnxinyminutes.com/docs/raku/>
    =item2 L<Golfing |https://github.com/AlexDaniel/raku-golf-cheatsheet>
=end nested
=begin nested :!nested

=item1 B<Explore>
    =item2 L<Raku Blog Aggregator|https://planet.raku.org/>
    =item2 L<Rakudo Weekly|https://rakudoweekly.blog/>
    =item2 L<The Weekly Challenge |https://perlweeklychallenge.org/>
    =item2 L<Raku Advent Calendar|https://raku-advent.blog/>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=end nested
=end React


=begin React :component<CookieConsent> :id<CookieConsent> :buttonCaption("Got it!")
=para
This website uses cookies for analytics.
=end React


README

NAME

SYNOPSIS

DESCRIPTION

new(Int :dimensions)

init()

get(--> List)

name(--> Str)

copy(Math::Libgsl::QuasiRandom $src)

clone(--> Math::Libgsl::QuasiRandom)

C Library Documentation

Prerequisites

Debian Linux and Ubuntu 20.04+

Ubuntu 18.04

Installation

AUTHOR

COPYRIGHT AND LICENSE

Math::Libgsl::QuasiRandom v0.0.2

Authors

License

Dependencies

Test Dependencies

Provides

Documentation