Add eMagLS for EMA and extensive project updates

[HaHeho]

TODOs before merge:

• Perform merge of Tommi's changes into this branch
• Cleanup leftovers functions from preliminary EMA implementations
• Add ambisonic encoding toolbox as git-submodule (for getEMagLsFiltersEMAinSH())
• Add headers with documentation and literature references to all new functions
• Update headers in all existing functions
• Add reference to EMA publication to README
• Move Changelog from README to separate file
• Discuss keeping the getMagLsArrayDiffuseFilter.m and getMagLsSphericalHeadFilter.m functions
• Discuss keeping the complex implementations in all filter functions
• Discuss keeping the optional shDefinition and shFunction parameters in all filter functions
• Update the example file not to specify the shDefinition and shFunction parameters (i.e. use the default values)
• Update the filter functions to use the default value "false" for the applyDiffusenessConst parameter
• Update the example file not to specify the applyDiffusenessConst parameter (i.e. use the default value)
• @thomasdeppisch validate the updated rendering filters against the currently published implementation (the filters should be very similar with minor differences due to numerical precision)
• Update example to remove download and re-add audio source file
• Update function headers to the year 2023

TODOs after merge:

• Rename master into main branch
• Update all function headers and documentation referencing the LICENSE file with the updated main URL
• Add git tags to some milestone stages of the repository and its updates
• Add GitHub releases according to the chosen tags

[HaHeho]

PR is merged. :) @thomasdeppisch, I think only you can rename the default branch of the repository to main. This would be good to do directly in the repository settings according to https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/renaming-a-branch.

Afterward, I will add a few release tags and perform the remaining steps.

[thomasdeppisch]

Great, many thanks for your efforts! :) I'll look into the renaming now

[thomasdeppisch]

I just renamed the master to main and cloned the repo and everything works as expected :)
We could think about adding an EMA rendering example to show how that works.

[HaHeho]

I just renamed the master to main and cloned the repo and everything works as expected :) We could think about adding an EMA rendering example to show how that works.

Nice. Yes and EMA rendering example would be nice to have as well. We will need a source audio recording for that. Ideally, we could even have the same scenario captured with an SMA and an EMA. Maybe something from the latest TU Berlin data set?

[thomasdeppisch]

I just renamed the master to main and cloned the repo and everything works as expected :) We could think about adding an EMA rendering example to show how that works.

Nice. Yes and EMA rendering example would be nice to have as well. We will need a source audio recording for that. Ideally, we could even have the same scenario captured with an SMA and an EMA. Maybe something from the latest TU Berlin data set?

That’s a great idea!