diff chordtools/degree2interval.m @ 1:8973548174c1 tip

adding tools to repo
author christopherh
date Mon, 06 May 2013 14:43:47 +0100
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/chordtools/degree2interval.m	Mon May 06 14:43:47 2013 +0100
@@ -0,0 +1,84 @@
+%
+% DEGREE2INTERVAL
+% 
+% [interval,success,errormessage] = degree2interval(degree,accidentals,{verbose})
+% 
+% Converts a degree and accidental pair to an interval string.
+% 
+% Success = 1 if degree converted correctly, 0 otherwise.
+% 
+% If optional argument 'verbose' is 1, function prints any errormessage to 
+% the screen.
+% 
+% returns:  interval (string)
+%           success (boolean)
+%           errormessage (string)
+%
+% Author: Christopher Harte, March 2009
+% 
+% Copyright: Centre for Digital Music, Queen Mary University of London 2005 
+%
+% This file is part of the C4DM Chord Toolkit V2.0 
+%
+% The C4DM Chord Toolkit is free software; you can redistribute it and/or 
+% modify it under the terms of the GNU General Public License as published 
+% by the Free Software Foundation; either version 2 of the License, or
+% (at your option) any later version.
+%
+% The C4DM Chord Toolkit is distributed in the hope that it will be useful,
+% but WITHOUT ANY WARRANTY; without even the implied warranty of
+% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+% GNU General Public License for more details.
+%
+% You should have received a copy of the GNU General Public License
+% along with the C4DM Toolkit; if not, write to the Free Software
+% Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+
+%		
+function [interval,success,errormessage] = degree2interval(degree,accidentals, verbose)
+
+% set verbose default to 0
+if nargin < 3
+    verbose = 0;
+end
+
+errormessage = '';
+
+
+success = 1;
+interval = '';
+
+
+if accidentals >=1
+   % then the degree is either a natural or has a number of sharps 
+    if accidentals ~= 0
+        for index = 1:accidentals 
+            interval = [interval '#'];
+        end
+    end
+    
+else
+    % then the degree has a number of flats
+    
+    for index = 1:abs(accidentals) 
+   
+        interval = [interval 'b'];
+    end
+    
+end
+
+if isnumeric(degree)
+    
+    degreestring = num2str(degree);
+    interval = [interval degreestring];
+    
+else
+   success = 0;
+   errormessage = 'Error in degree2interval: incorrect degree';
+end
+    
+if (success == 0) && (verbose == 1)   
+    fprintf(1,errormessage);
+end  
+
+