Copyright | (c) OleksandrZhabenko 2020 |
---|---|
License | MIT |
Stability | Experimental |
Safe Haskell | None |
Language | Haskell2010 |
- Type synonyms with different semantics
- Work with notes (general)
- Work with enky (extension to octaves functionality)
- Combining intermediate files
- Working with files
- Work with overtones
- Use additional function as a parameter
- Use additional function and Ukrainian texts and generates melody
- 1G generalized functions with dB volume overtones adjustments
- 2G generalized functions with additional sound quality specifying
- Generalized functions with several functional parameters
- Working with OvertonesO and function f
- Functions to edit OvertonesO and function f (since 0.25.0.0)
Maintainer : olexandr543@yahoo.com
A program and a library to create experimental music from a mono audio and a Ukrainian text.
Synopsis
- type SoundsO = Vector (Double, Double)
- type OvertonesO = Vector (Double, Double)
- type NotePairs = Vector (Double, Double)
- notes :: Vector Double
- neighbourNotes :: Double -> Vector Double -> (Double, Double)
- closestNote :: Double -> Double
- pureQuintNote :: Double -> Double
- overTones :: Double -> OvertonesO
- nkyT :: Int -> NotePairs
- whichEnka :: Int -> Double -> Maybe Int
- enkuUp :: Int -> Double -> Double
- enkuDown :: Int -> Double -> Double
- liftInEnkuV :: Int -> Int -> Vector Double -> Vector Double
- liftInEnku :: Int -> Int -> Double -> Maybe Double
- octavesT :: NotePairs
- mixTest :: IO ()
- mixTest2 :: Int -> Int -> IO ()
- freqsFromFile :: FilePath -> Int -> IO (Vector Int)
- endFromResult :: IO ()
- overSoXSynth :: Double -> IO ()
- overSoXSynth2FDN :: (Double -> OvertonesO) -> (Double, Double) -> Int -> String -> IO ()
- overSoXSynth2FDN_B :: (Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> IO ()
- overSoXSynth2FDN_S :: (Double -> OvertonesO) -> (Double, Double) -> Int -> String -> IO ()
- overSoXSynth2FDN_Sf :: (Double -> OvertonesO) -> (Double, Double) -> Int -> String -> IO ()
- overSoXSynth2FDN_Sf3 :: (Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> IO ()
- overSoXSynthGen2FDN :: FilePath -> Int -> Int -> (Double -> OvertonesO) -> Double -> String -> String -> IO ()
- overSoXSynthGen2FDN_B :: FilePath -> Int -> Int -> (Double -> OvertonesO) -> Double -> Double -> String -> String -> IO ()
- overSoXSynthGen2FDN_S :: FilePath -> Int -> Int -> (Double -> OvertonesO) -> Double -> String -> String -> IO ()
- overSoXSynthGen2FDN_Sf :: FilePath -> Int -> Int -> (Double -> OvertonesO) -> Double -> String -> String -> IO ()
- overSoXSynthGen2FDN_Sf3 :: FilePath -> Int -> Int -> (Double -> OvertonesO) -> Double -> Double -> String -> String -> IO ()
- dNote :: Int -> Double -> Maybe Double
- overSoXSynth2FDN1G :: (Double -> OvertonesO) -> (Double, Double) -> Int -> String -> Vector Double -> IO ()
- overSoXSynth2FDN_B1G :: (Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> Vector Double -> IO ()
- overSoXSynth2FDN_S1G :: (Double -> OvertonesO) -> (Double, Double) -> Int -> String -> Vector Double -> IO ()
- overSoXSynth2FDN_Sf1G :: (Double -> OvertonesO) -> (Double, Double) -> Int -> String -> Vector Double -> IO ()
- overSoXSynth2FDN_Sf31G :: (Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> Vector Double -> IO ()
- partialTest_k1G :: OvertonesO -> Int -> String -> Vector Double -> IO ()
- overSoXSynth2FDN2G :: (Double -> OvertonesO) -> (Double, Double) -> Int -> String -> Vector Double -> String -> IO ()
- overSoXSynth2FDN_B2G :: (Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> Vector Double -> String -> IO ()
- overSoXSynth2FDN_S2G :: (Double -> OvertonesO) -> (Double, Double) -> Int -> String -> Vector Double -> String -> IO ()
- overSoXSynth2FDN_Sf2G :: (Double -> OvertonesO) -> (Double, Double) -> Int -> String -> Vector Double -> String -> IO ()
- overSoXSynth2FDN_Sf32G :: (Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> Vector Double -> String -> IO ()
- partialTest_k2G :: OvertonesO -> Int -> String -> Vector Double -> String -> IO ()
- soundGenF32G :: Vector (Double -> Double) -> Vector Double -> Vector Int -> (Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> Vector Double -> String -> IO ()
- overSoXSynthGen2FDN_SG2G :: FilePath -> Int -> Int -> (Double -> OvertonesO) -> Double -> String -> String -> ((Double -> OvertonesO) -> (Double, Double) -> Int -> String -> String -> IO ()) -> String -> IO ()
- overSoXSynthGen2FDN_Sf3G2G :: FilePath -> Int -> Int -> (Double -> OvertonesO) -> Double -> Double -> String -> String -> ((Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> String -> IO ()) -> String -> IO ()
- mixTest2G :: String -> IO ()
- mixTest22G :: Int -> Int -> String -> IO ()
- endFromResult2G :: String -> IO ()
- soundGenF3 :: Vector (Double -> Double) -> Vector Double -> Vector Int -> (Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> IO ()
- overSoXSynthGen2FDN_SG :: FilePath -> Int -> Int -> (Double -> OvertonesO) -> Double -> String -> String -> ((Double -> OvertonesO) -> (Double, Double) -> Int -> String -> IO ()) -> IO ()
- overSoXSynthGen2FDN_Sf3G :: FilePath -> Int -> Int -> (Double -> OvertonesO) -> Double -> Double -> String -> String -> ((Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> IO ()) -> IO ()
- soundGenF31G :: Vector (Double -> Double) -> Vector Double -> Vector Int -> (Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> Vector Double -> IO ()
- soxBasicParams :: String -> [String] -> [String]
- adjust_dbVol :: [String] -> Double -> [String]
- partialTest_k :: OvertonesO -> Int -> String -> IO ()
- prependZeroes :: Int -> String -> String
- nOfZeroesLog :: Int -> Maybe Int
- numVZeroesPre :: Vector a -> Int
- syllableStr :: Int -> String -> [Int]
- intervalsFromString :: String -> Vector Int
- vStrToVInt :: Vector String -> Vector Int
- strToInt :: String -> Int
- doubleVecFromVecOfDouble :: (Double -> OvertonesO) -> Double -> Vector (Maybe Double) -> Vector OvertonesO
- helpF1 :: Vector (Double -> Double) -> Vector Double -> Vector Int -> Vector (Maybe Double)
- helpF0 :: Int -> String
- maybeFFromStrVec :: Int -> Double -> String -> Maybe (Double, Double -> Vector (Double, Double))
- fVecCoefs :: Int -> Double -> String -> Vector Double
- showFFromStrVec :: Int -> Double -> String -> String
- renormF :: OvertonesO -> OvertonesO
- renormFD :: Double -> OvertonesO -> OvertonesO
- sameOvertone :: OvertonesO -> Bool
- sameOvertoneL :: [(Double, Double)] -> Bool
- sameFreqF :: Double -> (Double, Double) -> (Double -> OvertonesO) -> ((Double, Double) -> OvertonesO -> OvertonesO) -> OvertonesO
- sameFreqFI :: Double -> (Double, Double) -> (Double -> OvertonesO) -> ((Double, Double) -> OvertonesO -> OvertonesO) -> OvertonesO
- fAddFElem :: (Double, Double) -> Double -> (Double -> OvertonesO) -> ((Double, Double) -> Double -> (Double -> OvertonesO) -> OvertonesO) -> Double -> OvertonesO
- fRemoveFElem :: (Double, Double) -> Double -> (Double -> OvertonesO) -> ((Double, Double) -> Double -> (Double -> OvertonesO) -> OvertonesO) -> Double -> OvertonesO
- gAdd01 :: (Double, Double) -> Double -> (Double -> OvertonesO) -> OvertonesO
- gAdd02 :: Double -> (Double, Double) -> Double -> (Double -> OvertonesO) -> OvertonesO
- gAdd03 :: (Double, Double) -> Double -> (Double -> OvertonesO) -> OvertonesO
- gRem01 :: (Double, Double) -> Double -> (Double -> OvertonesO) -> OvertonesO
- gRem02 :: Double -> (Double, Double) -> Double -> (Double -> OvertonesO) -> OvertonesO
- fAddFElems :: OvertonesO -> Double -> (Double -> OvertonesO) -> (OvertonesO -> Double -> (Double -> OvertonesO) -> OvertonesO) -> Double -> OvertonesO
- fRemoveFElems :: OvertonesO -> Double -> (Double -> OvertonesO) -> (OvertonesO -> Double -> (Double -> OvertonesO) -> OvertonesO) -> Double -> OvertonesO
- freqsOverlapOvers :: OvertonesO -> OvertonesO -> Bool
- elemsOverlapOvers :: OvertonesO -> OvertonesO -> Bool
- gAdds01 :: OvertonesO -> Double -> (Double -> OvertonesO) -> OvertonesO
- gAdds02 :: Double -> OvertonesO -> Double -> (Double -> OvertonesO) -> OvertonesO
Type synonyms with different semantics
type SoundsO = Vector (Double, Double) Source #
Is used to represent a sequence of intervals, each note being a Double
value (its frequency in Hz).
type OvertonesO = Vector (Double, Double) Source #
Is used to represent a set of overtones for the single sound, the first Double
value is a frequency and the second one -- an amplitude.
type NotePairs = Vector (Double, Double) Source #
Is used to represent a set of pairs of notes for each element of which the Double
values (notes frequencies in Hz) are somewhat
musically connected one with another..
Work with notes (general)
neighbourNotes :: Double -> Vector Double -> (Double, Double) Source #
Function returns either the nearest two musical notes if frequency is higher than one for C0 and lower than one for B8 or the nearest note duplicated in a tuple.
closestNote :: Double -> Double Source #
Returns the closest note to the given frequency in Hz.
pureQuintNote :: Double -> Double Source #
Returns a pure quint lower than the given note.
overTones :: Double -> OvertonesO Source #
For the given frequency of the note it generates a Vector
of the tuples, each one of which contains the harmonics' frequency and amplitude.
Work with enky (extension to octaves functionality)
nkyT :: Int -> NotePairs Source #
Returns a Vector
of tuples with the lowest and highest frequencies for the notes in the sets consisting of n
consequential notes
(including semi-tones). An Int
parameter defines this n
. It can be 2, 3, 4, 6, 9, or 12 (the last one is for default octaves, see octavesT
).
So for different valid n
you obtain doubles, triples and so on. The function being applied returns a Vector
of such sets with
their respective lowest and highest frequencies.
Work with octaves
octavesT :: NotePairs Source #
Returns a Vector
of tuples with the lowest and highest frequencies for the notes in the octaves.
Combining intermediate files
Combines (mixes) all "test*" files in the given directory. The files should be similar in parameters and must be sound files for SoX to work on them properly. Afterwards, the function deletes these combined files.
mixTest2 :: Int -> Int -> IO () Source #
Combines (mixes) all "test*" files in the given directory. The files should be similar in parameters and must be sound files for SoX to work on them properly. Afterwards, the function deletes these combined files. The name of the resulting file depends on the first two command line arguments so that it is easy to produce unique names for the consequent call for the function.
Working with files
freqsFromFile :: FilePath -> Int -> IO (Vector Int) Source #
Gets Vector
of Int
frequencies from the given FilePath
using SoX. The frequencies are "rough" according to the SoX documentation and
the duration is too small so they can be definitely other than expected ones. Is used as a source of variable numbers (somewhat close each to another
in their order but not neccessarily). .
endFromResult :: IO () Source #
Gets an "end.wav" file from the intermediate "result*.wav" files in the current directory. If it is not successful, produces the notification message and exits without error. If you would like to create the file if there are too many intermediate ones, please, run "dobutokO2 8" or "dobutokO2 80" in the current directory.
Work with overtones
overSoXSynth :: Double -> IO () Source #
For the given frequency it generates a musical sound with a timbre. The main component of the sound includes the lower pure quint, which can be in the same octave or in the one with the number lower by one. Please, check before executing whether there is no "x.wav", "test*", "result*" and "end.wav" files in the current directory, because they can be overwritten.
Use additional function as a parameter
overSoXSynth2FDN :: (Double -> OvertonesO) -> (Double, Double) -> Int -> String -> IO () Source #
Similar to overSoXSynth2DN
but instead of overTones
function, it uses volatile function f::Double -> Vector (Double, Double)
with
somewhat sophisticated mechanism to normalize the resulting Vector
elements (Double, Double)
. The last one is an experimental feature, so
it is your responsibility to provide a function so that it does not lead to clipping. In such a case, the result of application of the
convertToProperUkrainian
to the String
parameter must not be empty
. Int
argument is an index of the element to be taken from
the intervalsFromString
applied to the String
argument. To obtain compatible with versions prior to 0.20.0.0 behaviour, use for the Int
0.
Be aware that the result can be rather unpredictable (the program can even obtain segmentation fault) for not very suitable function. But for a lot of functions this works well.
It is recommended to fully simplify the computation for "f" function before using it in the overSoXSynth2FDN
.
overSoXSynth2FDN_B :: (Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> IO () Source #
Similar to overSoXSynth2DN
but instead of overTones
function, it uses volatile function f::Double -> Vector (Double, Double)
with
somewhat sophisticated mechanism to normalize the resulting Vector
elements (Double, Double)
. The last one is experimental feature, so
it is your responsibility to provide a function so that it does not lead to clipping. In such a case, the result of application of the
convertToProperUkrainian
to the String
parameter must not be empty
. The function also tries to perform filtering to avoid possible beating.
The third Double
parameter in the tuple is used as a limit for frequencies difference in Hz to be filtered out from the resulting sound. It is
considered to be from the range [0.1..10.0]
. An Int
parameter is used to define the needed interval. To obtain compatible with versions prior
to 0.20.0.0 behaviour, use for the Int
0.
Be aware that the result can be rather unpredictable (the program can even obtain segmentation fault) for not very suitable function. But for a lot of functions this works well.
It is recommended to fully simplify the computation for "f" function before using it in the overSoXSynth2FDN_B
.
Just simple function application
overSoXSynth2FDN_S :: (Double -> OvertonesO) -> (Double, Double) -> Int -> String -> IO () Source #
Similar to overSoXSynth2FDN
but it does not make any normalizing transformations with the Vector
argument. To be used properly, it is needed
that every second element in the tuple in the Vector
argument must be in the range [-1.0..1.0] and every first element must be in between
16.351597831287414 and 7902.132820097988 (Hz). An Int
parameter is used to define an interval. To obtain compatible with versions prior to
0.20.0.0 behaviour, use for the Int
0.
Be aware that the result can be rather unpredictable (the program can even obtain segmentation fault) for not very suitable function. But for a lot of functions this works well.
It is recommended to fully simplify the computation for "f" function before using it in the overSoXSynth2FDN_S
.
With additional filtering
overSoXSynth2FDN_Sf :: (Double -> OvertonesO) -> (Double, Double) -> Int -> String -> IO () Source #
Similar to overSoXSynth2FDN_S
but additionally the program filters out from the resulting Vector
after "f" application values that are smaller
by absolute value than 0.001. An Int
parameter is used to define an interval. To obtain compatible with versions prior to
0.20.0.0 behaviour, use for the Int
0.
Be aware that the result can be rather unpredictable (the program can even obtain segmentation fault) for not very suitable function. But for a lot of functions this works well.
It is recommended to fully simplify the computation for "f" function before using it in the overSoXSynth2FDN_Sf
.
overSoXSynth2FDN_Sf3 :: (Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> IO () Source #
Similar to overSoXSynth2FDN_S
but additionally the program filters out from the resulting Vector
after "f" application values that are smaller
than the third Double
parameter by an absolute value in the triple of Double
's. An Int
parameter is used to define an interval. To obtain compatible
with versions prior to 0.20.0.0 behaviour, use for the Int
0.
Be aware that the result can be rather unpredictable (the program can even obtain segmentation fault) for not very suitable function. But for a lot of functions this works well.
It is recommended to fully simplify the computation for "f" function before using it in the overSoXSynth2FDN_Sf3
.
Use additional function and Ukrainian texts and generates melody
overSoXSynthGen2FDN :: FilePath -> Int -> Int -> (Double -> OvertonesO) -> Double -> String -> String -> IO () Source #
Uses additional Int
parameters. The first one is a number of enka (see nkyT
). The second one defines, to which n-th elements set
(see nkyT
) belongs the obtained higher notes in the intervals. To obtain reasonable results, please, use for the first one 2, 3, 4, 6, 9, or 12.
The first String
parameter is used to produce durations of the notes. The second one is used to define intervals. A Double
parameter is a
basic sound duration, it defines tempo of the melody in general.
overSoXSynthGen2FDN_B :: FilePath -> Int -> Int -> (Double -> OvertonesO) -> Double -> Double -> String -> String -> IO () Source #
Uses additional Int
parameters. The first one is a number of enka (see nkyT
). The second one defines, to which n-th elements set
(see nkyT
) belongs the obtained higher notes in the intervals. To obtain reasonable results, please, use for the first one 2, 3, 4, 6, 9, or 12.
The first String
parameter is used to produce durations of the notes. The second one is used to define intervals. The first Double
parameter is a
basic sound duration, it defines tempo of the melody in general. The second one is a limit for frequencies difference in Hz to be filtered out from the
resulting sound. It is considered to be from the range [0.1..10.0]
.
overSoXSynthGen2FDN_S :: FilePath -> Int -> Int -> (Double -> OvertonesO) -> Double -> String -> String -> IO () Source #
Similar to overSoXSynthGen2FDN
, but instead of overSoXSynth2FDN
uses overSoXSynth2FDN_S
function.
overSoXSynthGen2FDN_Sf :: FilePath -> Int -> Int -> (Double -> OvertonesO) -> Double -> String -> String -> IO () Source #
Similar to overSoXSynthGen2FDN_S
, but instead of overSoXSynth2FDN_S
uses overSoXSynth2FDN_Sf
function.
overSoXSynthGen2FDN_Sf3 :: FilePath -> Int -> Int -> (Double -> OvertonesO) -> Double -> Double -> String -> String -> IO () Source #
Similar to overSoXSynthGen2FDN_S
, but instead of overSoXSynth2FDN_S
uses overSoXSynth2FDN_Sf3
function.
1G generalized functions with dB volume overtones adjustments
overSoXSynth2FDN1G :: (Double -> OvertonesO) -> (Double, Double) -> Int -> String -> Vector Double -> IO () Source #
overSoXSynth2FDN_B1G :: (Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> Vector Double -> IO () Source #
overSoXSynth2FDN_S1G :: (Double -> OvertonesO) -> (Double, Double) -> Int -> String -> Vector Double -> IO () Source #
Generalized version of the overSoXSynth2FDN_S
with the additional volume adjustment in dB for overtones given by Vector
of Double
.
overSoXSynth2FDN_Sf1G :: (Double -> OvertonesO) -> (Double, Double) -> Int -> String -> Vector Double -> IO () Source #
Generalized variant of the overSoXSynth2FDN_Sf
with a possibility to adjust volume using adjust_dbVol
. Vector
of Double
is
used to specify adjustments in dB. For more information, please, refer to adjust_dbVol
.
overSoXSynth2FDN_Sf31G :: (Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> Vector Double -> IO () Source #
Generalized variant of the overSoXSynth2FDN_Sf3
function with a possibility to adjust volume using adjust_dBVol
. Vector
of Double
specifies the needed adjustments in dB.
partialTest_k1G :: OvertonesO -> Int -> String -> Vector Double -> IO () Source #
Generalized version of the partialTest_k
with the additional volume adjustment in dB given by Vector
of Double
.
2G generalized functions with additional sound quality specifying
overSoXSynth2FDN2G :: (Double -> OvertonesO) -> (Double, Double) -> Int -> String -> Vector Double -> String -> IO () Source #
Similar to overSoXSynth2FDN1G
, but additionally allows to specify by the second String
argument a quality changes to the generated files
(please, see soxBasicParams
).
overSoXSynth2FDN_B2G :: (Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> Vector Double -> String -> IO () Source #
Generalized version of the overSoXSynth2FDN_B1G
with a possibility to specify sound quality parameters using additional second String
argument. For more information, please, refer to soxBasicParams
.
overSoXSynth2FDN_S2G :: (Double -> OvertonesO) -> (Double, Double) -> Int -> String -> Vector Double -> String -> IO () Source #
Generalized version of the overSoXSynth2FDN_S1G
with a possibility to specify sound quality parameters using the second String
argument.
For more information, please, refer to soxBasicParams
.
overSoXSynth2FDN_Sf2G :: (Double -> OvertonesO) -> (Double, Double) -> Int -> String -> Vector Double -> String -> IO () Source #
Generalized variant of the overSoXSynth2FDN_Sf1G
with a possibility to specify sound quality using the second String
argument.
For more information, please, refer to soxBasicParams
.
overSoXSynth2FDN_Sf32G :: (Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> Vector Double -> String -> IO () Source #
Generalized variant of the overSoXSynth2FDN_Sf31G
with a possibility to specify sound quality using the second String
parameter.
For more information, please, refer to soxBasicParams
.
partialTest_k2G :: OvertonesO -> Int -> String -> Vector Double -> String -> IO () Source #
Generalized version of the partialTest_k1G
with a possibility to change sound quality parameters using the additional second String
argument.
For more information, please, refer to soxBasicParams
.
soundGenF32G :: Vector (Double -> Double) -> Vector Double -> Vector Int -> (Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> Vector Double -> String -> IO () Source #
Generalized variant of the soundGenF31G
with a possibility to specify sound quality using the second String
argument. For more information,
please, refer to soxBasicParams
.
2G generalized functions for melody producing
overSoXSynthGen2FDN_SG2G :: FilePath -> Int -> Int -> (Double -> OvertonesO) -> Double -> String -> String -> ((Double -> OvertonesO) -> (Double, Double) -> Int -> String -> String -> IO ()) -> String -> IO () Source #
Generalized variant of the overSoXSynthGen2FDN_SG
with a possibility to specify with the third String
argument sound quality parameters.
Besides, the second from the end argument (a function) needs to be one more argument -- just also String
.
For more information, please, refer to soxBasicParams
.
overSoXSynthGen2FDN_Sf3G2G :: FilePath -> Int -> Int -> (Double -> OvertonesO) -> Double -> Double -> String -> String -> ((Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> String -> IO ()) -> String -> IO () Source #
Generalized variant of the ovorSoXSynthGen2FDN_Sf3G
with a possibility to specify sound quality with the third String
argument.
Besides, the second from the end argument (a function) needs to be one more argument -- just also String
.
For more information, please, refer to soxBasicParams
.
2G generalized auxiliary functions
mixTest2G :: String -> IO () Source #
Similar to mixTest
, but allows to change the sound quality parameters for the resulting file. For more information, please, refer to
soxBasicParams
.
mixTest22G :: Int -> Int -> String -> IO () Source #
Similar to mixTest
, but allows to change the sound quality parameters for the resulting file. For more information, please, refer to
soxBasicParams
. The name of the resulting file depends on the first two command line
arguments so that it is easy to produce unique names for the consequent call for the function.
endFromResult2G :: String -> IO () Source #
Similar to endFromResult
, but uses additional String
argument to change sound quality parameters. For more information, please, refer to
soxBasicParams
.
Generalized functions with several functional parameters
soundGenF3 :: Vector (Double -> Double) -> Vector Double -> Vector Int -> (Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> IO () Source #
Can generate multiple notes with their respective overtones that are played simultaneously (e. g. it can be just one note with overtones, an interval with overtones, an accord with overtones etc.). This allows to get a rather complex or even complicated behaviour to obtain expressive and rich sound.
overSoXSynthGen2FDN_SG :: FilePath -> Int -> Int -> (Double -> OvertonesO) -> Double -> String -> String -> ((Double -> OvertonesO) -> (Double, Double) -> Int -> String -> IO ()) -> IO () Source #
Similar to overSoXSynthGen2FDN
, but instead of overSoXSynth2FDN
uses overSoXSynth2FDN_S
function.
overSoXSynthGen2FDN_Sf3G :: FilePath -> Int -> Int -> (Double -> OvertonesO) -> Double -> Double -> String -> String -> ((Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> IO ()) -> IO () Source #
Similar to overSoXSynthGen2FDN_S
, but instead of overSoXSynth2FDN_S
uses overSoXSynth2FDN_Sf3
function.
1G generalized function with db volume overtones adjustments and several functional parameters
soundGenF31G :: Vector (Double -> Double) -> Vector Double -> Vector Int -> (Double -> OvertonesO) -> (Double, Double, Double) -> Int -> String -> Vector Double -> IO () Source #
Generalized variant of the soundGenF3
with volume adjustment in dB given by the second Vector Double
for the overtones.
Auxiliary functions
soxBasicParams :: String -> [String] -> [String] Source #
Is used internally in the functions to specify different SoX parameters for the sound synthesis (rate, bit depth and file extension). Possible
file extensions are: ".wav" (a default one) and ".flac" (being lossless compressed); rates -- 8000, 11025, 16000, 22050 (a default one), 32000,
44100, 48000, 88200, 96000, 176400, 192000 Hz; bit depths -- 16 bits and 24 bits. The first two digits in a String
argument encodes rate,
the next one -- bit depth and the last symbol -- letter 'w' or 'f' -- file extension. Because of SoX uses FLAC optionally, before use it, please,
check whether your installation supports it.
adjust_dbVol :: [String] -> Double -> [String] Source #
Is used internally in the readProcessWithExitCode
to adjust volume for the sound with additional dB value given by Double
argument.
partialTest_k :: OvertonesO -> Int -> String -> IO () Source #
Creates part of the needed "test*.wav" files in the current directory.
numVZeroesPre :: Vector a -> Int Source #
syllableStr :: Int -> String -> [Int] Source #
Function is used to generate a rhythm of the resulting file 'end.wav' from the Ukrainian text and a number of sounds either in the syllables or in the words without vowels.
intervalsFromString :: String -> Vector Int Source #
Function is used to get numbers of intervals from a Ukrainian String
. It is used internally in the uniqOverSoXSynthN4
function.
doubleVecFromVecOfDouble :: (Double -> OvertonesO) -> Double -> Vector (Maybe Double) -> Vector OvertonesO Source #
Generates a Vector
of OvertonesO
that represents the sound.
helpF1 :: Vector (Double -> Double) -> Vector Double -> Vector Int -> Vector (Maybe Double) Source #
Working with OvertonesO and function f
maybeFFromStrVec :: Int -> Double -> String -> Maybe (Double, Double -> Vector (Double, Double)) Source #
Gets a function f::Double -> OvertonesO
that can be used further. Has two variants with usage of closestNote
(Int
argument is greater than 0)v
and without it (Int
argument is less than 0). For both cases String
must be in a form list of tuples of pairs of Double
to get somewhat
reasonable result. The function f
can be shown using a special printing function showFFromStrVec
. It is a simplest multiplicative (somewhat
acoustically and musically reasonable) form for the function that can provide such a result that fits into the given data.
let (y,f1) = fromJust (maybeFFromStrVec 1 3583.9783 "[(25.368,0.2486356),(37.259,0.6464867),(486.153,0.374618646),(789.563,0.463486461)]") in (y,f1 3583.9783) (3520.0,[(25.829079975681818,0.2486356),(37.936206670369316,0.6464867),(494.9891484317899,0.374618646),(803.9138234326421,0.463486461)]) let (y,f1) = fromJust (maybeFFromStrVec (-1) 3583.9783 "[(25.368,0.2486356),(37.259,0.6464867),(486.153,0.374618646),(789.563,0.463486461)]") in (y,f1 3583.9783) (3583.9783,[(25.368,0.2486356),(37.259,0.6464867),(486.153,0.374618646),(789.563,0.463486461)])
fVecCoefs :: Int -> Double -> String -> Vector Double Source #
Gets multiplication coefficients for f::Double -> Vector (Double,Double)
from the maybeFFromStrVec
with the same arguments.
showFFromStrVec :: Int -> Double -> String -> String Source #
Experimental show
for f::Double -> Vector (Double,Double)
that is used only for visualisation. It is correct only with maybeFFromStrVec
or
equivalent function. Because the shape of the f
is known the function can be defined.
showFFromStrVec (-1) 440 "[(25.358,0.3598),(489.35,0.4588962),(795.35,0.6853)]" "(440.00,(\t -> <(0.05763181818181818 * t, 0.3598),(1.112159090909091 * t, 0.4588962),(1.8076136363636364 * t, 0.6853)>))"
Functions to edit OvertonesO and function f (since 0.25.0.0)
renormF :: OvertonesO -> OvertonesO Source #
Renormalizes amplitudes for the frequencies so that the maximum one of them (if OvertonesO
is not empty
) is equal by the absolute value
to 1.0 and the mutual ratios of the amplitudes are preserved.
renormFD :: Double -> OvertonesO -> OvertonesO Source #
Renormalizes amplitudes for the frequencies so that the maximum one of them (if OvertonesO
is not empty
) is equal by the absolute value
to Double
argument and the mutual ratios of the amplitudes are preserved.
sameOvertone :: OvertonesO -> Bool Source #
Predicate to check whether all tuples in a Vector
have the same first element.
sameOvertoneL :: [(Double, Double)] -> Bool Source #
Similar to sameOvertone
, except that not the Vector
is checked but a corresponding list.
sameFreqF :: Double -> (Double, Double) -> (Double -> OvertonesO) -> ((Double, Double) -> OvertonesO -> OvertonesO) -> OvertonesO Source #
g :: (Double,Double) -> OvertonesO -> OvertonesO
is a function that defines how the new element is added to the OvertonesO
. It depends
only on the element being added and the actual OvertonesO
. It does not depend on the Double
argument for f :: Double -> OvertonesO
so for different Double
for f
it gives the same result.
sameFreqFI :: Double -> (Double, Double) -> (Double -> OvertonesO) -> ((Double, Double) -> OvertonesO -> OvertonesO) -> OvertonesO Source #
g :: (Double,Double) -> OvertonesO -> OvertonesO
is a function that defines how the new element is added to the OvertonesO
.
Variant of sameFreqF
where g depends only on the elements of the OvertonesO
, which first elements in the tuples equal to the first element
in the (Double,Double)
. It does not depend on the Double
argument for f :: Double -> OvertonesO
so for different Double
for f
it gives the same result.
fAddFElem :: (Double, Double) -> Double -> (Double -> OvertonesO) -> ((Double, Double) -> Double -> (Double -> OvertonesO) -> OvertonesO) -> Double -> OvertonesO Source #
gAdd :: (Double,Double) -> Double -> (Double -> OvertonesO) -> OvertonesO
is a function that defines how the element is added
to the OvertonesO
. Unlike for sameFreqF
, it depends also on the Double
argument for f :: Double -> OvertonesO
. fAddFElem
is
actually a functional or operator (in mathematical sense), it changes the function f
(in some point) and returns the new one.
gAdd
allows not only to insert an element if missing, but to change all the OvertonesO
system. So depending on the complexity,
it can reproduce rather complex behaviour.
fRemoveFElem :: (Double, Double) -> Double -> (Double -> OvertonesO) -> ((Double, Double) -> Double -> (Double -> OvertonesO) -> OvertonesO) -> Double -> OvertonesO Source #
gRem:: (Double,Double) -> Double -> (Double -> OvertonesO) -> OvertonesO
is a function that defines how the element is removed
from the OvertonesO
. Unlike for sameFreqF
, it depends also on the Double
argument for f :: Double -> OvertonesO
. fRemoveFElem
is
actually an operator (in mathematical sense), it changes the function f
(in some point) and returns the new one.
gRem
allows not only to delete an element if existing, but to change all the OvertonesO
system. So depending on the complexity,
it can reproduce rather complex behaviour.
gAdd01 :: (Double, Double) -> Double -> (Double -> OvertonesO) -> OvertonesO Source #
Example of the function gAdd for the fAddFElem
. If the frequency is already in the OvertonesO
then the corresponding amplitude is divided
equally between all the elements with the repeated given frequency from (Double, Double)
. Otherwise, it is just concatenated to the OvertonesO
.
gAdd02 :: Double -> (Double, Double) -> Double -> (Double -> OvertonesO) -> OvertonesO Source #
gAdd03 :: (Double, Double) -> Double -> (Double -> OvertonesO) -> OvertonesO Source #
Example of the function gAdd
. for the fAddFElem
. If the frequency is not already in the OvertonesO
then the corresponding element is added and
the OvertonesO
are renormed with renormF
. Otherwise, the element is tried to be inserted with a new frequency between the greatest by an absolute
values notes as an intermediate value with the respective amplitude, or if there is only one element, to produce two elements in
the resulting Vector
with two consequent harmonics.
gRem01 :: (Double, Double) -> Double -> (Double -> OvertonesO) -> OvertonesO Source #
Example of the function gRem for the fRemoveFElem
. If the element is already in the OvertonesO
then it is removed (if there are more than 5
elements already) and OvertonesO
are renormalized. Otherwise, all the same for the element already existing elements become less in an amlitude
for a numbers that in sum equal to amplitude of the removed element.
gRem02 :: Double -> (Double, Double) -> Double -> (Double -> OvertonesO) -> OvertonesO Source #
Can be used to produce an example of the function gRem
for the fRemoveFElem
. Similar to gRem01
, but uses its first argument
to renorm the result of the gRem01
so that its maximum by absolute value amplitude equals to the first argument.
Working with two OvertonesO
fAddFElems :: OvertonesO -> Double -> (Double -> OvertonesO) -> (OvertonesO -> Double -> (Double -> OvertonesO) -> OvertonesO) -> Double -> OvertonesO Source #
Similar to fAddFElem
, but instead of one element (Double,Double)
it deals with a Vector
of such elements that is OvertonesO
.
fRemoveFElems :: OvertonesO -> Double -> (Double -> OvertonesO) -> (OvertonesO -> Double -> (Double -> OvertonesO) -> OvertonesO) -> Double -> OvertonesO Source #
Similar to fRemoveFElem
, but instead of one element (Double,Double)
it deals with a Vector
of such elements that is OvertonesO
.
freqsOverlapOvers :: OvertonesO -> OvertonesO -> Bool Source #
Binary predicate to check whether two given OvertonesO
both have the elements with the same first element in the tuples. If True
then
this means that OvertonesO
are at least partially overlaped by the first elements in the tuples (meaning frequencies).
elemsOverlapOvers :: OvertonesO -> OvertonesO -> Bool Source #
Similar to freqsOverlapOvers
, but checks whether the whole tuples are the same instead of the first elements in the tuples are the same.
gAdds01 :: OvertonesO -> Double -> (Double -> OvertonesO) -> OvertonesO Source #
Example of the function gAdds
for the fAddFElems
.
gAdds02 :: Double -> OvertonesO -> Double -> (Double -> OvertonesO) -> OvertonesO Source #
Can be used to produce an example of the function gAdds
for the fAddFElems
. Similar to gAdds01
, but uses its first argument
to renorm the result of the gAdds01
so that its maximum by absolute value amplitude equals to the first argument.