blib/lib/Music/Voss.pm

filter: Statementstmt 85.0% 91 / 107 Branchbran 46.7% 29 / 62 Conditioncond 25.0% 14 / 56 MC/DCmcdc 2.7% 1 / 37 Subroutinesub 94.4% 17 / 18 Podpod 100% 4 / 4 totaltotal 54.9% 156 / 284 CC 55 SCAR 26.3
CC
55
Cov
60%
weierstrass
28.2
bitchange
19.9
powers_stateless
17.2
CRAP 13.9
↑ Summary
1 # -*- Perl -*-
2 #
3 # Functions for fractal noise generation functions.
4 #
5 # Run perldoc(1) on this file for additional documentation.
6  
7 package Music::Voss;
8  
9 5 ▶use 5.010000;
Subroutine BEGIN: called CC=1 SCAR=0.0
10 5 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
11 5 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
12 5 ▶use Carp qw(croak);
Subroutine BEGIN: called CC=1 SCAR=0.0
13 5 ▶use Exporter 'import';
Subroutine BEGIN: called CC=1 SCAR=0.0
14 5 ▶use List::Util ();
Subroutine BEGIN: called CC=1 SCAR=0.0
15 5 ▶use Math::Trig qw(pi);
Subroutine BEGIN: called CC=1 SCAR=0.0
16 5 ▶use Scalar::Util qw(looks_like_number);
Subroutine BEGIN: called CC=1 SCAR=0.0
17  
18 5 our $VERSION = '0.16';
19  
20 5 our @EXPORT_OK = qw(bitchange powers powers_stateless weierstrass);
21  
22 # This method derived from the "White and brown music, fractal curves
23 # and one-over-f fluctuations" article. Should also be possible with
24 # physical dice and a binary chart to show how the bits change between
25 # tries and thus which dice need be re-rolled for a particular try.
26 1 ▶sub bitchange {
Subroutine bitchange: called CC=10 SCAR=29.9
Pod documented
27 1 my (%params) = @_;
28 1 ▶ if ( !exists $params{rollers} ) {
Branch: 2 branches
BranchTrueFalseTotal
if (not exists $params{'rollers'}) { } 1 0 1
elsif (not defined $params{'rollers'} && &looks_like_number($params{'rollers'})) { } 0 0 0
29 1 $params{rollers} = 3;
30 ▶ } elsif ( !defined $params{rollers} or !looks_like_number $params{rollers} ) {
Condition0%0/3
defined $params{'rollers'} && &looks_like_number($params{'rollers'})
!ll&&!rl&&r
000
MC/DC0%0/2
defined $params{'rollers'} && &looks_like_number($params{'rollers'})
defined $params{'rollers'} &looks_like_number($params{'rollers'})
Truth table0%0/3
A && B
A= defined $params{'rollers'}B= &looks_like_number($params{'rollers'})
ABresult
0X0
100
111
31 0 croak "rollers must be a number";
32 } else {
33 0 $params{rollers} = int $params{rollers};
34 }
35 1 ▶ if ( !exists $params{roll} ) {
Branch: 2 branches
BranchTrueFalseTotal
if (not exists $params{'roll'}) { } 0 1 1
elsif (not defined $params{'roll'} or ref $params{'roll'} ne 'CODE') { } 0 1 1
36 0 ▶ $params{roll} = sub { int rand 6 };
Subroutine __ANON__: not called CC=1 SCAR=6.9
37 ▶ } elsif ( !defined $params{roll} or ref $params{roll} ne 'CODE' ) {
Condition33%1/3
not defined $params{"roll"} or ref $params{"roll"} ne "CODE"
l!l&&r!l&&!r
001
MC/DC0%0/2
not defined $params{"roll"} or ref $params{"roll"} ne "CODE"
not defined $params{"roll"} ref $params{"roll"} ne "CODE"
Truth table33%1/3
not(A) or B
A= not defined $params{"roll"}B= ref $params{"roll"} ne "CODE"
ABresult
1X1
011
000
38 0 croak "roll must be code reference";
39 }
40 1 ▶ if ( !exists $params{summer} ) {
Branch: 2 branches
BranchTrueFalseTotal
if (not exists $params{'summer'}) { } 1 0 1
elsif (not defined $params{'summer'} or ref $params{'summer'} ne 'CODE') { } 0 0 0
41 1 $params{summer} = \&List::Util::sum0;
42 ▶ } elsif ( !defined $params{summer} or ref $params{summer} ne 'CODE' ) {
Condition0%0/3
not defined $params{"summer"} or ref $params{"summer"} ne "CODE"
l!l&&r!l&&!r
000
MC/DC0%0/2
not defined $params{"summer"} or ref $params{"summer"} ne "CODE"
not defined $params{"summer"} ref $params{"summer"} ne "CODE"
Truth table0%0/3
not(A) or B
A= not defined $params{"summer"}B= ref $params{"summer"} ne "CODE"
ABresult
1X1
011
000
43 0 croak "summer must be code reference";
44 }
45 1 my @nums = map { $params{roll}->( undef, $_ ) } 0 .. $params{rollers} - 1;
46 1 my $prev;
47 10 ▶ return sub {
Subroutine __ANON__: called CC=6 SCAR=18.2
48 10 my ($n) = @_;
49 10 ▶ croak "input must be number" if !defined $n or !looks_like_number $n;
Branch: 1 branch
BranchTrueFalseTotal
unless defined $n and &looks_like_number($n) 0 10 10
Condition33%1/3
defined $n and &looks_like_number($n)
!ll&&!rl&&r
0010
MC/DC0%0/2
defined $n and &looks_like_number($n)
defined $n &looks_like_number($n)
Truth table33%1/3
A and B
A= defined $nB= &looks_like_number($n)
ABresult
0X0
100
111
50 10 ▶ if ( defined $prev ) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $prev) 9 1 10
51 9 for my $rnum ( 0 .. $params{rollers} - 1 ) {
52 27 ▶ if ( ( $n >> $rnum & 1 ) != ( $prev >> $rnum & 1 ) ) {
Branch: 1 branch
BranchTrueFalseTotal
if (($n >> $rnum & 1) != ($prev >> $rnum & 1)) 15 12 27
53 15 $nums[$rnum] = $params{roll}->( $n, $rnum );
54 }
55 }
56 }
57 10 $prev = $n;
58 10 return $params{summer}->(@nums);
59 1 };
60 }
61  
62 # "Musimathics, Vol 1" p.358 based function generator based on powers of
63 # (by default) 2, the supplied number, and a list of subroutines to
64 # (perhaps) run. (Was called "voss", orginally.)
65 2 ▶sub powers {
Subroutine powers: called CC=9 SCAR=28.1
Pod documented
66 2 my (%params) = @_;
67 croak "must be given list of calls"
68 if !$params{calls}
69 2 ▶ or ref $params{calls} ne 'ARRAY';
Branch: 1 branch
BranchTrueFalseTotal
if not $params{"calls"} or ref $params{"calls"} ne "ARRAY" 0 2 2
Condition33%1/3
not $params{"calls"} or ref $params{"calls"} ne "ARRAY"
l!l&&r!l&&!r
002
MC/DC0%0/2
not $params{"calls"} or ref $params{"calls"} ne "ARRAY"
not $params{"calls"} ref $params{"calls"} ne "ARRAY"
Truth table33%1/3
not(A) or B
A= not $params{"calls"}B= ref $params{"calls"} ne "ARRAY"
ABresult
1X1
011
000
70 2 ▶ if ( !exists $params{summer} ) {
Branch: 2 branches
BranchTrueFalseTotal
if (not exists $params{'summer'}) { } 0 2 2
elsif (not defined $params{'summer'} or ref $params{'summer'} ne 'CODE') { } 0 2 2
71 0 $params{summer} = \&List::Util::sum0;
72 ▶ } elsif ( !defined $params{summer} or ref $params{summer} ne 'CODE' ) {
Condition33%1/3
not defined $params{"summer"} or ref $params{"summer"} ne "CODE"
l!l&&r!l&&!r
002
MC/DC0%0/2
not defined $params{"summer"} or ref $params{"summer"} ne "CODE"
not defined $params{"summer"} ref $params{"summer"} ne "CODE"
Truth table33%1/3
not(A) or B
A= not defined $params{"summer"}B= ref $params{"summer"} ne "CODE"
ABresult
1X1
011
000
73 0 croak "summer must be code reference";
74 }
75 2 ▶ if ( !exists $params{e} ) {
Branch: 2 branches
BranchTrueFalseTotal
if (not exists $params{'e'}) { } 2 0 2
elsif (not defined $params{'e'} && &looks_like_number($params{'e'})) { } 0 0 0
76 2 $params{e} = 2;
77 ▶ } elsif ( !defined $params{e} or !looks_like_number $params{e} ) {
Condition0%0/3
defined $params{'e'} && &looks_like_number($params{'e'})
!ll&&!rl&&r
000
MC/DC0%0/2
defined $params{'e'} && &looks_like_number($params{'e'})
defined $params{'e'} &looks_like_number($params{'e'})
Truth table0%0/3
A && B
A= defined $params{'e'}B= &looks_like_number($params{'e'})
ABresult
0X0
100
111
78 0 croak "e must be a number";
79 }
80 2 my @nums = (0) x @{ $params{calls} };
81 3 ▶ return sub {
Subroutine __ANON__: called CC=5 SCAR=17.2
82 3 my ($n) = @_;
83 3 ▶ croak "input must be number" if !defined $n or !looks_like_number $n;
Branch: 1 branch
BranchTrueFalseTotal
unless defined $n and &looks_like_number($n) 0 3 3
Condition33%1/3
defined $n and &looks_like_number($n)
!ll&&!rl&&r
003
MC/DC0%0/2
defined $n and &looks_like_number($n)
defined $n &looks_like_number($n)
Truth table33%1/3
A and B
A= defined $nB= &looks_like_number($n)
ABresult
0X0
100
111
84 3 for my $k ( 0 .. $#{ $params{calls} } ) {
85 3 ▶ if ( $n % $params{e}**$k == 0 ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($n % $params{"e"} ** $k == 0) 3 0 3
86 3 $nums[$k] = $params{calls}->[$k]->( $n, $k );
87 }
88 }
89 3 return $params{summer}->(@nums);
90 2 };
91 }
92  
93 2 ▶sub powers_stateless {
Subroutine powers_stateless: called CC=9 SCAR=28.4
Pod documented
94 2 my (%params) = @_;
95 croak "must be given list of calls"
96 if !$params{calls}
97 2 ▶ or ref $params{calls} ne 'ARRAY';
Branch: 1 branch
BranchTrueFalseTotal
if not $params{"calls"} or ref $params{"calls"} ne "ARRAY" 0 2 2
Condition33%1/3
not $params{"calls"} or ref $params{"calls"} ne "ARRAY"
l!l&&r!l&&!r
002
MC/DC0%0/2
not $params{"calls"} or ref $params{"calls"} ne "ARRAY"
not $params{"calls"} ref $params{"calls"} ne "ARRAY"
Truth table33%1/3
not(A) or B
A= not $params{"calls"}B= ref $params{"calls"} ne "ARRAY"
ABresult
1X1
011
000
98 2 ▶ if ( !exists $params{summer} ) {
Branch: 2 branches
BranchTrueFalseTotal
if (not exists $params{'summer'}) { } 2 0 2
elsif (not defined $params{'summer'} or ref $params{'summer'} ne 'CODE') { } 0 0 0
99 2 $params{summer} = \&List::Util::sum0;
100 ▶ } elsif ( !defined $params{summer} or ref $params{summer} ne 'CODE' ) {
Condition0%0/3
not defined $params{"summer"} or ref $params{"summer"} ne "CODE"
l!l&&r!l&&!r
000
MC/DC0%0/2
not defined $params{"summer"} or ref $params{"summer"} ne "CODE"
not defined $params{"summer"} ref $params{"summer"} ne "CODE"
Truth table0%0/3
not(A) or B
A= not defined $params{"summer"}B= ref $params{"summer"} ne "CODE"
ABresult
1X1
011
000
101 0 croak "summer must be code reference";
102 }
103 2 ▶ if ( !exists $params{e} ) {
Branch: 2 branches
BranchTrueFalseTotal
if (not exists $params{'e'}) { } 2 0 2
elsif (not defined $params{'e'} && &looks_like_number($params{'e'})) { } 0 0 0
104 2 $params{e} = 2;
105 ▶ } elsif ( !defined $params{e} or !looks_like_number $params{e} ) {
Condition0%0/3
defined $params{'e'} && &looks_like_number($params{'e'})
!ll&&!rl&&r
000
MC/DC0%0/2
defined $params{'e'} && &looks_like_number($params{'e'})
defined $params{'e'} &looks_like_number($params{'e'})
Truth table0%0/3
A && B
A= defined $params{'e'}B= &looks_like_number($params{'e'})
ABresult
0X0
100
111
106 0 croak "e must be a number";
107 }
108 18 ▶ return sub {
Subroutine __ANON__: called CC=5 SCAR=16.5
109 18 my ($n) = @_;
110 18 ▶ croak "input must be number" if !defined $n or !looks_like_number $n;
Branch: 1 branch
BranchTrueFalseTotal
unless defined $n and &looks_like_number($n) 0 18 18
Condition33%1/3
defined $n and &looks_like_number($n)
!ll&&!rl&&r
0018
MC/DC0%0/2
defined $n and &looks_like_number($n)
defined $n &looks_like_number($n)
Truth table33%1/3
A and B
A= defined $nB= &looks_like_number($n)
ABresult
0X0
100
111
111 18 my @nums;
112 18 for my $k ( 0 .. $#{ $params{calls} } ) {
113 28 ▶ if ( $n % $params{e}**$k == 0 ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($n % $params{"e"} ** $k == 0) 23 5 28
114 23 push @nums, $params{calls}->[$k]->( $n, $k );
115 }
116 }
117 18 return $params{summer}->(@nums);
118 2 };
119 }
120  
121 # also from "Musimathics, Vol 1" around the same place as the above
122 2 ▶sub weierstrass {
Subroutine weierstrass: called CC=13 SCAR=33.4
Pod documented
123 2 my (%params) = @_;
124 2 ▶ if ( !defined $params{r} or !looks_like_number $params{r} ) {
Branch: 1 branch
BranchTrueFalseTotal
unless (defined $params{"r"} and &looks_like_number($params{"r"})) 0 2 2
Condition33%1/3
defined $params{"r"} and &looks_like_number($params{"r"})
!ll&&!rl&&r
002
MC/DC0%0/2
defined $params{"r"} and &looks_like_number($params{"r"})
defined $params{"r"} &looks_like_number($params{"r"})
Truth table33%1/3
A and B
A= defined $params{"r"}B= &looks_like_number($params{"r"})
ABresult
0X0
100
111
125 0 croak "r must be a number (0 < r <= 1)";
126 }
127 2 ▶ if ( !defined $params{H} or !looks_like_number $params{H} ) {
Branch: 1 branch
BranchTrueFalseTotal
unless (defined $params{"H"} and &looks_like_number($params{"H"})) 0 2 2
Condition33%1/3
defined $params{"H"} and &looks_like_number($params{"H"})
!ll&&!rl&&r
002
MC/DC0%0/2
defined $params{"H"} and &looks_like_number($params{"H"})
defined $params{"H"} &looks_like_number($params{"H"})
Truth table33%1/3
A and B
A= defined $params{"H"}B= &looks_like_number($params{"H"})
ABresult
0X0
100
111
128 0 croak "H must be a number (0 < H <= 1)";
129 }
130 2 ▶ if ( !defined $params{N} or !looks_like_number $params{N} ) {
Branch: 1 branch
BranchTrueFalseTotal
unless (defined $params{"N"} and &looks_like_number($params{"N"})) 0 2 2
Condition33%1/3
defined $params{"N"} and &looks_like_number($params{"N"})
!ll&&!rl&&r
002
MC/DC0%0/2
defined $params{"N"} and &looks_like_number($params{"N"})
defined $params{"N"} &looks_like_number($params{"N"})
Truth table33%1/3
A and B
A= defined $params{"N"}B= &looks_like_number($params{"N"})
ABresult
0X0
100
111
131 0 croak "N must be a number";
132 }
133 2 ▶ if ( !exists $params{phase} ) {
Branch: 2 branches
BranchTrueFalseTotal
if (not exists $params{'phase'}) { } 1 1 2
elsif (not defined $params{'phase'} or ref $params{'phase'} ne 'CODE') { } 0 1 1
134 1 ▶ $params{phase} = sub { 0 };
Subroutine __ANON__: called CC=1 SCAR=0.0
135 ▶ } elsif ( !defined $params{phase} or ref $params{phase} ne 'CODE' ) {
Condition33%1/3
not defined $params{"phase"} or ref $params{"phase"} ne "CODE"
l!l&&r!l&&!r
001
MC/DC0%0/2
not defined $params{"phase"} or ref $params{"phase"} ne "CODE"
not defined $params{"phase"} ref $params{"phase"} ne "CODE"
Truth table33%1/3
not(A) or B
A= not defined $params{"phase"}B= ref $params{"phase"} ne "CODE"
ABresult
1X1
011
000
136 0 croak "phase must be code reference";
137 }
138 2 ▶ if ( !exists $params{summer} ) {
Branch: 2 branches
BranchTrueFalseTotal
if (not exists $params{'summer'}) { } 2 0 2
elsif (not defined $params{'summer'} or ref $params{'summer'} ne 'CODE') { } 0 0 0
139 2 $params{summer} = \&List::Util::sum0;
140 ▶ } elsif ( !defined $params{summer} or ref $params{summer} ne 'CODE' ) {
Condition0%0/3
not defined $params{"summer"} or ref $params{"summer"} ne "CODE"
l!l&&r!l&&!r
000
MC/DC0%0/2
not defined $params{"summer"} or ref $params{"summer"} ne "CODE"
not defined $params{"summer"} ref $params{"summer"} ne "CODE"
Truth table0%0/3
not(A) or B
A= not defined $params{"summer"}B= ref $params{"summer"} ne "CODE"
ABresult
1X1
011
000
141 0 croak "summer must be code reference";
142 }
143 8 ▶ return sub {
Subroutine __ANON__: called CC=5 SCAR=16.6
144 8 my ( $t, $x ) = @_;
145 8 ▶ croak "input must be number" if !defined $t or !looks_like_number $t;
Branch: 1 branch
BranchTrueFalseTotal
unless defined $t and &looks_like_number($t) 0 8 8
Condition33%1/3
defined $t and &looks_like_number($t)
!ll&&!rl&&r
008
MC/DC0%0/2
defined $t and &looks_like_number($t)
defined $t &looks_like_number($t)
Truth table33%1/3
A and B
A= defined $tB= &looks_like_number($t)
ABresult
0X0
100
111
146 8 ▶ $x //= 0;
Condition100%2/2
$x //= 0
l!l
17
MC/DC100%1/1
$x //= 0
$x
Truth table100%2/2
A
A= $x
Aresult
11
00
147 8 my @nums;
148 8 for my $k ( 0 .. $params{N} - 1 ) {
149 push @nums,
150 $params{r}**( $k * $params{H} ) *
151 sin(
152 256 $t * pi * $params{r}**( -$k ) + $params{phase}->( $t, $x, $k, %params ) );
153 }
154 8 return $params{summer}->(@nums);
155 2 };
156 }
157  
158 5 1;
159 __END__
↑ Summary