deism 2.0__tar.gz

deism-2.0/LICENSE

@@ -0,0 +1,36 @@
+
+© Copyright (2022) Fraunhofer-Gesellschaft zur Förderung der angewandten Forschung e.V.
+
+1. INTRODUCTION
+The Fraunhofer Software which means any source code, object code or binary files provided by Fraunhofer excluding third party
+software and materials, is made available under this Software Copyright License.
+
+2. COPYRIGHT LICENSE
+Internal use of the Fraunhofer Software, in source and binary forms, with or without modification, is permitted without payment
+of copyright license fees for non-commercial purposes of evaluation, testing and academic research.
+No right or license, express or implied, is granted to any part of the Fraunhofer Software except and solely to the extent as
+expressly set forth herein. Any commercial use or exploitation of the Fraunhofer Software and/or any modifications thereto under
+this license are prohibited.
+For any other use of the Fraunhofer Software than permitted by this software copyright license You need another license from
+Fraunhofer. In such case please contact Fraunhofer under the CONTACT INFORMATION below.
+
+3. LIMITED PATENT LICENSE
+If Fraunhofer patents are implemented by the Fraunhofer Software and You use the Fraunhofer Software in Germany, the use of
+those Fraunhofer patents for purposes of testing, evaluating and research and development is permitted within the statutory
+limitations of German patent law. However, if You use the Fraunhofer Software in a country where the use of patents for research
+and development purposes is not permitted without a license, you must obtain an appropriate license from Fraunhofer. It is Your
+responsibility to check the legal requirements for any use of applicable patents.
+Fraunhofer provides no warranty of patent non-infringement with respect to the Fraunhofer Software.
+
+4. DISCLAIMER
+The Fraunhofer Software is provided by Fraunhofer "AS IS" and WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, including but
+not limited to the implied warranties of fitness for a particular purpose. IN NO EVENT SHALL FRAUNHOFER BE LIABLE for any
+direct, indirect, incidental, special, exemplary, or consequential damages, including but not limited to procurement of substitute
+goods or services; loss of use, data, or profits, or business interruption, however caused and on any theory of liability, whether in
+contract, strict liability, or tort (including negligence), arising in any way out of the use of the Fraunhofer Software, even if advised
+of the possibility of such damage.
+
+5. CONTACT INFORMATION
+Fraunhofer Institute for Integrated Circuits IIS
+Am Wolfsmantel 33, 91058 Erlangen
+info@iis.fraunhofer.de

deism-2.0/MANIFEST.in

@@ -0,0 +1,13 @@
+graft thirdPartyLegalNotices
+include README.md
+include deism_env_exact.yml
+include deism_env.yml
+include LICENSE
+
+graft deism
+
+global-exclude *.py[co]
+global-exclude __pycache__
+global-exclude *.so
+global-exclude *.pyd
+global-exclude .DS_Store

deism-2.0/PKG-INFO

@@ -0,0 +1,273 @@
+Metadata-Version: 2.1
+Name: deism
+Version: 2.0
+Summary: An image source-based method used to simulate room transfer functions for arbitrary room shapes.
+Home-page: https://github.com/audiolabs/DEISM
+Author: Zeyu Xu, Songjiang Tan
+Author-email: Zeyu Xu <zeyu.xu@audiolabs-erlangen.de>
+License: 
+        © Copyright (2022) Fraunhofer-Gesellschaft zur Förderung der angewandten Forschung e.V.
+        
+        1. INTRODUCTION
+        The Fraunhofer Software which means any source code, object code or binary files provided by Fraunhofer excluding third party
+        software and materials, is made available under this Software Copyright License.
+        
+        2. COPYRIGHT LICENSE
+        Internal use of the Fraunhofer Software, in source and binary forms, with or without modification, is permitted without payment
+        of copyright license fees for non-commercial purposes of evaluation, testing and academic research.
+        No right or license, express or implied, is granted to any part of the Fraunhofer Software except and solely to the extent as
+        expressly set forth herein. Any commercial use or exploitation of the Fraunhofer Software and/or any modifications thereto under
+        this license are prohibited.
+        For any other use of the Fraunhofer Software than permitted by this software copyright license You need another license from
+        Fraunhofer. In such case please contact Fraunhofer under the CONTACT INFORMATION below.
+        
+        3. LIMITED PATENT LICENSE
+        If Fraunhofer patents are implemented by the Fraunhofer Software and You use the Fraunhofer Software in Germany, the use of
+        those Fraunhofer patents for purposes of testing, evaluating and research and development is permitted within the statutory
+        limitations of German patent law. However, if You use the Fraunhofer Software in a country where the use of patents for research
+        and development purposes is not permitted without a license, you must obtain an appropriate license from Fraunhofer. It is Your
+        responsibility to check the legal requirements for any use of applicable patents.
+        Fraunhofer provides no warranty of patent non-infringement with respect to the Fraunhofer Software.
+        
+        4. DISCLAIMER
+        The Fraunhofer Software is provided by Fraunhofer "AS IS" and WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, including but
+        not limited to the implied warranties of fitness for a particular purpose. IN NO EVENT SHALL FRAUNHOFER BE LIABLE for any
+        direct, indirect, incidental, special, exemplary, or consequential damages, including but not limited to procurement of substitute
+        goods or services; loss of use, data, or profits, or business interruption, however caused and on any theory of liability, whether in
+        contract, strict liability, or tort (including negligence), arising in any way out of the use of the Fraunhofer Software, even if advised
+        of the possibility of such damage.
+        
+        5. CONTACT INFORMATION
+        Fraunhofer Institute for Integrated Circuits IIS
+        Am Wolfsmantel 33, 91058 Erlangen
+        info@iis.fraunhofer.de
+        
+Project-URL: Homepage, https://github.com/audiolabs/DEISM
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# Diffraction Enhanced Image Source Method - Arbitrary Room Geometry (DEISM-ARG)
+
+The code in this folder is able to solve the following problem: 
+
+A source and a receiver transducer with arbitrary directivity are mounted on one/two speakers; The local scattering and diffraction effects around the transducers result in complex directivity patterns. The directivity patterns can be obtained by analytical expressions, numerical simulations or measurements. 
+
+In DEISM-ARG, we can model the room transfer function between transducers mounted on one/two speakers using the image source method while incorporating the local diffraction effects around the transducers. The local diffraction effects are captured using spherical-harmonic directivity coefficients obtained on a sphere around the transducers. In addition to DEISM in shoebox rooms, DEISM-ARG can model more complex room shapes. However, for version 2.0, we now only supports convex shapes. In short, DEISM-ARG has the following features: 
+
+1. Arbitrary directivities of the source and receiver
+2. Angle-dependent reflection coefficients
+3. Convex room shapes
+
+![image-20240812131054348](/docs/figures/scenario.png)
+
+# Preparation and installing
+
+## Build locally
+
+- In you encounter **errors** like "unrecognized arguments: deism_envs_exact.yml", please type the following commands manuelly in the command line. 
+- Clone or download the repository to your local directory
+- Use the command `conda env create -f deism_env.yml` to create a Conda environment for the DEISM algorithms. If this does not work, try `conda env create -f deism_env_exact.yml` as the file **deism_envs_exact.yml** records the versions of all packages.
+- Activate the created environment by "conda activate DEISM"
+- Running `pip install -e .` will build the deism package including the c++ extensions locally. You can also modify the sources codes and check out the effects. In case you receiver errors like "ModuleNotFoundError: No module named 'pybind11" even after activated the conda environment, you can use `python -m pip install -e .` to try install again. 
+- Run scripts in the **test** folder. 
+
+## Using pip to install remotely
+
+- To be added later
+
+# Running codes
+
+## Single set of parameters
+
+The default parameters are defined in file **configSingleParam_ARG.yml**. There are two ways of running the codes: 
+
+1. You can directly run **deism_arg_singleparam_example.py** in an IDE, which utilizes the parameters defined in **configSingleParam_arg.yml**.
+2. You can run **deism_arg_singleparam_example.py** from the command line after activating the conda environment. In addition, you can access help information quickly by `python deism_arg_singleparam_example.py --help`. You can then change the parameters based on the instructions from the help message, e.g., `python deism_arg_singleparam_example.py -c 350 -zs 20` will change the parameter sound speed and the wall impedance. The new input value of the parameters then overrides the ones in file **configSingleParam_arg.yml**. After choosing the needed values, you can run the codes using, e.g., `python deism_arg_singleparam_example.py -c 350 -zs 20 --run`. 
+3. You need to specify additionally the following parameters in the function `init_parameters` of **deism_arg_singleparam_example.py**:
+   1. The vertices of the room
+   2. If rotate the room w.r.t the origin. This can be useful if you want to have some comparisons with the rooms created using pyroomacoustics.
+   3. The rotation angles of the room if it needs to be rotated.  
+4. You can suppress all output information in the command line by adding flag "--quiet" or by setting the first parameters in the configuration.yml file SilentMode to 1. 
+
+
+
+# Examples 
+
+- An example of running DEISM-ARG is **test/deism_arg_single_example.py**
+  - You can run this from IDEs or via the command line, as introduced in the previous section
+- An example of comparing different versions of DEISM-ARG is given in **test/deism_args_compare.py**. The room transfer functions are compared among:
+  - Original version (most computation-costly)
+  - LC version (fastest)
+  - Mix version (Trade-offs between Original and LC versions): Early reflections up to some changeable order (default is 2) are calculated using the original version and the higher orders are calculated using the LC version. 
+- An example of comparing DEISM-ARG and pyroomacoustics is **test/deism_arg_pra_compare.py**, Comparisons are done regarding if the following results are identical or mismatched only by a small deviation:
+  - number of images
+  - the positions of the images
+
+
+## Tips
+
+The example code only provides essential functionalities based on DEISM. For more complex scenarios, please contact the authors (zeyu.xu@audiolabs-erlangen.de) for support. In the following, a few important tips might be helpful for you: 
+
+- If you want to simulate the scenario where both the source and receiver are positioned on the same speaker, you need to run DEISM for all reflection path except for the direct path. 
+- It is recommended to set the distance at least 1m between the transducers and the walls. 
+
+
+
+# Directivities 
+
+Modeling the directivities of the source and receiver in the room acoustics simulation is receiving increasing attention. The directivities of the source or receiver can include both the transducer directional properties and the local diffraction and scatterring effects caused by the enclosure where the transducers are mounted. Modern smart speakers are typical embodiments of such scenarios. Human heads are also a very common case. 
+
+## Simple directivities
+
+- Monopole
+
+## Arbitrary directivities
+
+Some key information should be provided if you want to include your own directivity data:
+
+1. Frequencies at which the directivities are simulated or measured. A 1D array. 
+1. The spherical sampling directions around the transducer: azimuth from $0$ ( $+x$ direction) to $2 \pi$, inclination angle from $0$ ($+z$ direction)  to $\pi$. A 2D array with size (number of directions, 2).
+1. The sampled pressure field at the specified directions and frequencies. A 2D array with size (number of frequencies, number of directions).
+1. The radius of the sampling sphere. A 1D array or float number. 
+
+
+
+
+
+
+# Contributors 
+
+- M. Sc. Zeyu Xu
+- Songjiang Tan
+- M. Sc. Hasan Nazım Biçer
+- Dr. Albert Prinn
+- Prof. Dr. ir. Emanuël Habets
+
+ 
+
+# Academic publications
+
+If you use this package in your research, please cite [our paper](https://doi.org/10.1121/10.0023935):
+
+> Zeyu Xu, Adrian Herzog, Alexander Lodermeyer, Emanuël A. P. Habets, Albert G. Prinn; Simulating room transfer functions between transducers mounted on audio devices using a modified image source method. **J. Acoust. Soc. Am.** 1 January 2024; 155 (1): 343–357. https://doi.org/10.1121/10.0023935
+
+> Z. Xu, E.A.P. Habets and A.G. Prinn; Simulating sound fields in rooms with arbitrary geometries using the diffraction-enhanced image source method, Proc. of International Workshop on Acoustic Signal Enhancement (IWAENC), 2024.
+
+
+
+# Description of the codes and functions
+
+## configSingleParam_ARG.yml
+
+In this file you define the default parameters for DEISM to run. Note that this file is different from the  configSingleParam.yml on these parameters:
+
+- The dimensions are defined separately in the example script. 
+- You also need to specify if you want to rotate the room, and the rotation angles as well. 
+
+### Parameters
+
+```yaml
+# here is the configuration file for single set of parameters
+# Note: 
+# Use space instead of tab for indentation at the beginning of each line
+# Environment parameters
+Environment:
+  soundSpeed: 343 # speed of sound
+  airDensity: 1.2 # constant of air
+
+# Boundary conditions and max. reflection order
+Reflections:
+  # format of reflection coefficient: [Z_x0,Z_x1,Z_y0,Z_y1,Z_z0,Z_z1]
+  acoustImpendence: 18
+  # input:
+  # 1. AcoustImpendence: 18+0j # A single value for 6 walls, no frequency-dependency
+  maxReflectionOrder: 5 # maximal reflection order
+  reverberationTime: 1 # in seconds
+
+# Simulation parameters # 
+# positions of sound source and receiver in 3-dimensional Cartesian coordinate
+# unit(meter)
+# Note:
+# The source and receiver should be at least 1m away from the walls;
+# The distance between the source and receiver should be not less than the sum of the radii of transparent spheres
+Positions:
+  source:
+    x: 1.1
+    y: 1.1
+    z: 1.3
+
+  receiver:
+    x: 2.9
+    y: 1.9
+    z: 1.3
+
+# frequency terms
+Frequencies:
+  # unit of frequency(Hz)
+  startFrequency: 20
+  endFrequency: 1000
+  frequencyStep: 2
+  samplingRate: 2000
+
+# Directivity parameters #
+# maximal spherical harmonic directivity order
+MaxSphDirectivityOrder:
+  nSourceOrder: 5
+  vReceiverOrder: 5
+
+# Facing/Rotation of the directivities
+# Three angles are need to describe the Z-X-Z convention of rotation;
+# The rotation matrix calculation used in COMSOL, see:
+# https://doc.comsol.com/5.5/doc/com.comsol.help.comsol/comsol_ref_definitions.12.092.html
+Orientations:
+  source:
+    alpha: 0
+    beta: 0 
+    gamma: 0 
+  receiver:
+    alpha: 180
+    beta: 0 
+    gamma: 0 
+
+# parameters of the transparent sphere around the source and receiver
+# The values should be consistent with the loaded directivity files
+# For different max. sph. orders at different frequency ranges, this should allow adjustments
+Radius:
+  source: 0.4
+  receiver: 0.5
+
+# Directivity data
+# !!! Add more directivity data here !!!
+Directivities:
+	# Choices for source: 
+  # Analytic: "monopole"
+  # Simulated or measured: "speaker_cuboid_cyldriver_1"
+  source: "speaker_cuboid_cyldriver_1" 
+  # Choices for source: 
+  # Analytic: "monopole"
+  # Simulated or measured: "speaker_cuboid_cyldriver_1"
+  receiver: "speaker_cuboid_cyldriver_1" 
+
+# Other functional parameters
+# DEISM modes: You can run DEISM using different versions
+# 1. ORG: Original DEISM, which is supposed to be the most accurate, but takes the longest time
+# 2. LC: Low-complexity DEISM with vectorized calculation, which is supposed to be faster than ORG, but less accurate
+# 3. MIX: Early reflections up to order 2 are calculated using ORG, and the rest are calculated using LC
+DEISM_specs: 
+  ifRemoveDirect: 0 # If remove the direct sound from the image sources
+  Mode: "ORG" # DEISM-ARG now only supports "ORG" !!! 
+  # mixEarlyOrder: 2 # The order of reflections using DEISM-ORG if choose "MIX"
+  numParaImages: 50000 # Number of images parallel for the calculation, information for users about RAM consumption
+  # If normalize the receiver directivity if the receiver directivity is obtained by placing a point source
+  # with flow strength QFlowStrength at the receiver position and measuring the sound pressure at a sphere around the receiver
+  # You need to specify QFlowStrength after the following flag
+  ifRecerverNormalize: 1 
+  QFlowStrength: 0.001
+```
+
+
+
+[^Euler]: https://mathworld.wolfram.com/EulerAngles.html

deism-2.0/README.md

@@ -0,0 +1,222 @@
+# Diffraction Enhanced Image Source Method - Arbitrary Room Geometry (DEISM-ARG)
+
+The code in this folder is able to solve the following problem: 
+
+A source and a receiver transducer with arbitrary directivity are mounted on one/two speakers; The local scattering and diffraction effects around the transducers result in complex directivity patterns. The directivity patterns can be obtained by analytical expressions, numerical simulations or measurements. 
+
+In DEISM-ARG, we can model the room transfer function between transducers mounted on one/two speakers using the image source method while incorporating the local diffraction effects around the transducers. The local diffraction effects are captured using spherical-harmonic directivity coefficients obtained on a sphere around the transducers. In addition to DEISM in shoebox rooms, DEISM-ARG can model more complex room shapes. However, for version 2.0, we now only supports convex shapes. In short, DEISM-ARG has the following features: 
+
+1. Arbitrary directivities of the source and receiver
+2. Angle-dependent reflection coefficients
+3. Convex room shapes
+
+![image-20240812131054348](/docs/figures/scenario.png)
+
+# Preparation and installing
+
+## Build locally
+
+- In you encounter **errors** like "unrecognized arguments: deism_envs_exact.yml", please type the following commands manuelly in the command line. 
+- Clone or download the repository to your local directory
+- Use the command `conda env create -f deism_env.yml` to create a Conda environment for the DEISM algorithms. If this does not work, try `conda env create -f deism_env_exact.yml` as the file **deism_envs_exact.yml** records the versions of all packages.
+- Activate the created environment by "conda activate DEISM"
+- Running `pip install -e .` will build the deism package including the c++ extensions locally. You can also modify the sources codes and check out the effects. In case you receiver errors like "ModuleNotFoundError: No module named 'pybind11" even after activated the conda environment, you can use `python -m pip install -e .` to try install again. 
+- Run scripts in the **test** folder. 
+
+## Using pip to install remotely
+
+- To be added later
+
+# Running codes
+
+## Single set of parameters
+
+The default parameters are defined in file **configSingleParam_ARG.yml**. There are two ways of running the codes: 
+
+1. You can directly run **deism_arg_singleparam_example.py** in an IDE, which utilizes the parameters defined in **configSingleParam_arg.yml**.
+2. You can run **deism_arg_singleparam_example.py** from the command line after activating the conda environment. In addition, you can access help information quickly by `python deism_arg_singleparam_example.py --help`. You can then change the parameters based on the instructions from the help message, e.g., `python deism_arg_singleparam_example.py -c 350 -zs 20` will change the parameter sound speed and the wall impedance. The new input value of the parameters then overrides the ones in file **configSingleParam_arg.yml**. After choosing the needed values, you can run the codes using, e.g., `python deism_arg_singleparam_example.py -c 350 -zs 20 --run`. 
+3. You need to specify additionally the following parameters in the function `init_parameters` of **deism_arg_singleparam_example.py**:
+   1. The vertices of the room
+   2. If rotate the room w.r.t the origin. This can be useful if you want to have some comparisons with the rooms created using pyroomacoustics.
+   3. The rotation angles of the room if it needs to be rotated.  
+4. You can suppress all output information in the command line by adding flag "--quiet" or by setting the first parameters in the configuration.yml file SilentMode to 1. 
+
+
+
+# Examples 
+
+- An example of running DEISM-ARG is **test/deism_arg_single_example.py**
+  - You can run this from IDEs or via the command line, as introduced in the previous section
+- An example of comparing different versions of DEISM-ARG is given in **test/deism_args_compare.py**. The room transfer functions are compared among:
+  - Original version (most computation-costly)
+  - LC version (fastest)
+  - Mix version (Trade-offs between Original and LC versions): Early reflections up to some changeable order (default is 2) are calculated using the original version and the higher orders are calculated using the LC version. 
+- An example of comparing DEISM-ARG and pyroomacoustics is **test/deism_arg_pra_compare.py**, Comparisons are done regarding if the following results are identical or mismatched only by a small deviation:
+  - number of images
+  - the positions of the images
+
+
+## Tips
+
+The example code only provides essential functionalities based on DEISM. For more complex scenarios, please contact the authors (zeyu.xu@audiolabs-erlangen.de) for support. In the following, a few important tips might be helpful for you: 
+
+- If you want to simulate the scenario where both the source and receiver are positioned on the same speaker, you need to run DEISM for all reflection path except for the direct path. 
+- It is recommended to set the distance at least 1m between the transducers and the walls. 
+
+
+
+# Directivities 
+
+Modeling the directivities of the source and receiver in the room acoustics simulation is receiving increasing attention. The directivities of the source or receiver can include both the transducer directional properties and the local diffraction and scatterring effects caused by the enclosure where the transducers are mounted. Modern smart speakers are typical embodiments of such scenarios. Human heads are also a very common case. 
+
+## Simple directivities
+
+- Monopole
+
+## Arbitrary directivities
+
+Some key information should be provided if you want to include your own directivity data:
+
+1. Frequencies at which the directivities are simulated or measured. A 1D array. 
+1. The spherical sampling directions around the transducer: azimuth from $0$ ( $+x$ direction) to $2 \pi$, inclination angle from $0$ ($+z$ direction)  to $\pi$. A 2D array with size (number of directions, 2).
+1. The sampled pressure field at the specified directions and frequencies. A 2D array with size (number of frequencies, number of directions).
+1. The radius of the sampling sphere. A 1D array or float number. 
+
+
+
+
+
+
+# Contributors 
+
+- M. Sc. Zeyu Xu
+- Songjiang Tan
+- M. Sc. Hasan Nazım Biçer
+- Dr. Albert Prinn
+- Prof. Dr. ir. Emanuël Habets
+
+ 
+
+# Academic publications
+
+If you use this package in your research, please cite [our paper](https://doi.org/10.1121/10.0023935):
+
+> Zeyu Xu, Adrian Herzog, Alexander Lodermeyer, Emanuël A. P. Habets, Albert G. Prinn; Simulating room transfer functions between transducers mounted on audio devices using a modified image source method. **J. Acoust. Soc. Am.** 1 January 2024; 155 (1): 343–357. https://doi.org/10.1121/10.0023935
+
+> Z. Xu, E.A.P. Habets and A.G. Prinn; Simulating sound fields in rooms with arbitrary geometries using the diffraction-enhanced image source method, Proc. of International Workshop on Acoustic Signal Enhancement (IWAENC), 2024.
+
+
+
+# Description of the codes and functions
+
+## configSingleParam_ARG.yml
+
+In this file you define the default parameters for DEISM to run. Note that this file is different from the  configSingleParam.yml on these parameters:
+
+- The dimensions are defined separately in the example script. 
+- You also need to specify if you want to rotate the room, and the rotation angles as well. 
+
+### Parameters
+
+```yaml
+# here is the configuration file for single set of parameters
+# Note: 
+# Use space instead of tab for indentation at the beginning of each line
+# Environment parameters
+Environment:
+  soundSpeed: 343 # speed of sound
+  airDensity: 1.2 # constant of air
+
+# Boundary conditions and max. reflection order
+Reflections:
+  # format of reflection coefficient: [Z_x0,Z_x1,Z_y0,Z_y1,Z_z0,Z_z1]
+  acoustImpendence: 18
+  # input:
+  # 1. AcoustImpendence: 18+0j # A single value for 6 walls, no frequency-dependency
+  maxReflectionOrder: 5 # maximal reflection order
+  reverberationTime: 1 # in seconds
+
+# Simulation parameters # 
+# positions of sound source and receiver in 3-dimensional Cartesian coordinate
+# unit(meter)
+# Note:
+# The source and receiver should be at least 1m away from the walls;
+# The distance between the source and receiver should be not less than the sum of the radii of transparent spheres
+Positions:
+  source:
+    x: 1.1
+    y: 1.1
+    z: 1.3
+
+  receiver:
+    x: 2.9
+    y: 1.9
+    z: 1.3
+
+# frequency terms
+Frequencies:
+  # unit of frequency(Hz)
+  startFrequency: 20
+  endFrequency: 1000
+  frequencyStep: 2
+  samplingRate: 2000
+
+# Directivity parameters #
+# maximal spherical harmonic directivity order
+MaxSphDirectivityOrder:
+  nSourceOrder: 5
+  vReceiverOrder: 5
+
+# Facing/Rotation of the directivities
+# Three angles are need to describe the Z-X-Z convention of rotation;
+# The rotation matrix calculation used in COMSOL, see:
+# https://doc.comsol.com/5.5/doc/com.comsol.help.comsol/comsol_ref_definitions.12.092.html
+Orientations:
+  source:
+    alpha: 0
+    beta: 0 
+    gamma: 0 
+  receiver:
+    alpha: 180
+    beta: 0 
+    gamma: 0 
+
+# parameters of the transparent sphere around the source and receiver
+# The values should be consistent with the loaded directivity files
+# For different max. sph. orders at different frequency ranges, this should allow adjustments
+Radius:
+  source: 0.4
+  receiver: 0.5
+
+# Directivity data
+# !!! Add more directivity data here !!!
+Directivities:
+	# Choices for source: 
+  # Analytic: "monopole"
+  # Simulated or measured: "speaker_cuboid_cyldriver_1"
+  source: "speaker_cuboid_cyldriver_1" 
+  # Choices for source: 
+  # Analytic: "monopole"
+  # Simulated or measured: "speaker_cuboid_cyldriver_1"
+  receiver: "speaker_cuboid_cyldriver_1" 
+
+# Other functional parameters
+# DEISM modes: You can run DEISM using different versions
+# 1. ORG: Original DEISM, which is supposed to be the most accurate, but takes the longest time
+# 2. LC: Low-complexity DEISM with vectorized calculation, which is supposed to be faster than ORG, but less accurate
+# 3. MIX: Early reflections up to order 2 are calculated using ORG, and the rest are calculated using LC
+DEISM_specs: 
+  ifRemoveDirect: 0 # If remove the direct sound from the image sources
+  Mode: "ORG" # DEISM-ARG now only supports "ORG" !!! 
+  # mixEarlyOrder: 2 # The order of reflections using DEISM-ORG if choose "MIX"
+  numParaImages: 50000 # Number of images parallel for the calculation, information for users about RAM consumption
+  # If normalize the receiver directivity if the receiver directivity is obtained by placing a point source
+  # with flow strength QFlowStrength at the receiver position and measuring the sound pressure at a sphere around the receiver
+  # You need to specify QFlowStrength after the following flag
+  ifRecerverNormalize: 1 
+  QFlowStrength: 0.001
+```
+
+
+
+[^Euler]: https://mathworld.wolfram.com/EulerAngles.html

deism-2.0/deism/__init__.py

@@ -0,0 +1,4 @@
+from .core_deism import *
+from .data_loader import *
+from .utilities import *
+from .core_deism_arg import *