# Difference between revisions of "OpenPSTD v1.0 overview"

(→Results) |
m (→Source and receivers) |
||

(29 intermediate revisions by 3 users not shown) | |||

Line 1: | Line 1: | ||

− | == What can you model with openPSTD | + | == What can you model with openPSTD? == |

− | openPSTD | + | openPSTD provides a visual user interface that enables to compute sound propagation in a 2D geometry. With openPSTD, the 2D geometry, bounded by edges that (partly) absorb the sound waves, can be drawn in Blender. Sources of sound and receiver positions can freely be chosen within the geometry. Sound propagation is computed in openPSTD by numerically solving the linearized Euler equations, i.e. the partial differential equations that describe sound propagation in fluid flow in the time domain. The outcome of openPSTD is a visualisation of sound propagation, by a 2D animation and by the impulse responses at the position(s) of the receiver(s). As openPSTD is an open source software, we highly encourage contributions to the code. |

+ | |||

+ | == openPSTD releases == | ||

+ | *openPSTD v1.0 has been launched in september 2014. | ||

+ | *openPSTD v1.1 has been launched in july 2015. This version is the GPU accelerated version of openPSTD v1.0. | ||

== User Interface == | == User Interface == | ||

− | to | + | The openPSTD interface is built as a add-on for Blender, a free and open source 3D modelling application. As such, it inherits the a lot of the functionality from Blender [https://www.blender.org]. For a comprehensive step-by-step guide to model a geometry in Blender please see [[Getting started with openPSTD]]. For detailed instructions on how to use Blender, users are encouraged to find some of the tutorials available [https://www.blender.org/support/tutorials/]. |

− | + | ||

− | + | It is also possible to model a geometry without using the visual Blender interface. A guide can be found here: [[Command line simulations]]. | |

== Geometry, medium and boundaries == | == Geometry, medium and boundaries == | ||

[[File:subdomains.jpg|thumb|right|200px|Subdomain modelling with openPSTD.]] | [[File:subdomains.jpg|thumb|right|200px|Subdomain modelling with openPSTD.]] | ||

− | A geometry in openPSTD must be constructed out of a subsequent arrangement of rectangles (subdomains). The interface, at which the boundaries of two adjacent subdomains coincide, does not necessarily have to match the full length of both subdomain boundaries. Hence, subdomains can have multiple neighbors at a domain boundary and hence local refinement does not necessarily propagate throughout the entire topology. The density and speed of sound of the propagation medium can be defined in the openPSTD settings. A restriction of the method is the minimum dimension of the subdomains, which is equal to the '''Grid spacing''' multiplied by the '''Window size''' (see [[openPSTD v1.0 settings]]). Once the geometry has been constructed, the acoustic absorption coefficient at the edges needs to be defined. The defined absorption coefficient corresponds to a real valued normalized surface impedance according to | + | A geometry in openPSTD must be constructed out of a subsequent arrangement of rectangles (subdomains). The interface, at which the boundaries of two adjacent subdomains coincide, does not necessarily have to match the full length of both subdomain boundaries. Hence, subdomains can have multiple neighbors at a domain boundary and hence local refinement does not necessarily propagate throughout the entire topology. The density and speed of sound of the propagation medium can be defined in the openPSTD settings. A restriction of the method is the minimum dimension of the subdomains, which is equal to the '''Grid spacing''' multiplied by the '''Window size''' (see [[openPSTD v1.0 settings]]). Once the geometry has been constructed, the acoustic absorption coefficient α at the edges needs to be defined. The defined absorption coefficient corresponds to a real valued normalized surface impedance according to |

:<math> Z = - \frac{\sqrt{1-\alpha}+1}{\sqrt{1-\alpha}-1}</math> | :<math> Z = - \frac{\sqrt{1-\alpha}+1}{\sqrt{1-\alpha}-1}</math> | ||

− | The absorption coefficients are frequency independent. The default setting in openPSTD is that boundary | + | The absorption coefficients are frequency independent. The default setting in openPSTD is that boundary reflections are independent on the angle of incidence. A locally reacting boundary can also be chosen, see [[openPSTD v1.0 settings]]. The reflection coefficient then becomes, in approximation (see [http://www.sciencedirect.com/science/article/pii/S036013231200323X van Renterghem ''et al.'' 2013]). |

:<math> R = \frac{Z\cos{\theta}-1}{Z\cos{\theta}+1} </math> | :<math> R = \frac{Z\cos{\theta}-1}{Z\cos{\theta}+1} </math> | ||

Line 28: | Line 31: | ||

</math> | </math> | ||

− | with <math>\beta = | + | with <math>\beta = 3\cdot10^{-6}c^2/ \Delta^2 </math>, Δ the grid spacing in metres, ''c'' the adiabatic speed of sound in m/s, '''''x'''''=''[x,z]'' the 2D coordinate vector and '''''x'''''<sub>s</sub> the source position. The centre(s) of the Gaussian shape(s) thus corresponds to the defined centre(s) of the sources. Although receiver positions might not correspond to a dicrete position in the mesh, spectral interpolation allows to compute the response of the source(s) in the constructed geometry at an arbitrary location in the space. |

== Mesh == | == Mesh == | ||

Line 34: | Line 37: | ||

[[File:mesh.jpg|thumb|right|200px|Schematic representation of acoustic pressure and velocity positions.]] | [[File:mesh.jpg|thumb|right|200px|Schematic representation of acoustic pressure and velocity positions.]] | ||

− | In openPSTD | + | In openPSTD, the geometry is discretised by an orthogonal equidistant grid, with '''Grid spacing''' in metres equal to the spacing of the grid points. Pressure grid positions are staggered by a half grid spacing with acoustic velocity grid positions, and the velocity position are located at the edges of a subdomain: horizontal velocity components are located at a vertical edge and vertical velocity components are located at an horizontal edge. When a geometry is drawn, a grid is created. If a dimension of a drawn subdomain does not correspond to an integer multiple of the '''Grid spacing''', the subdomain is extended such that its size (in the respective direction) becomes an integer multiple of the '''Grid spacing'''. |

Line 45: | Line 48: | ||

[[File:mesh_window.jpg|thumb|right|300px|Schematic representation of windowing the solution at the pressure positions for computing spatial derivatives in subdomain 2.]] | [[File:mesh_window.jpg|thumb|right|300px|Schematic representation of windowing the solution at the pressure positions for computing spatial derivatives in subdomain 2.]] | ||

Wave propagation in the openPSTD software is implemented according to the extended Fourier PSTD method as presented in [http://scitation.aip.org/content/asa/journal/jasa/128/4/10.1121/1.3474234 Hornikx ''et al.'' 2010]. With this numerical method, the linearized Euler equations (LEE) are solved, which allow a detailed computation of sound propagation in moving inhomogeneous media and return the linear acoustic equations for a non-moving homogeneous propagation medium. In PSTD, the spatial derivatives arising in the LEE are computed in the wavenumber domain. This implies that a spatial Fourier transform is applied to the acoustic variables, and after an operation in the wavenumber domain, an inverse Fourier transform returns the derivatives. This way of computing spatial derivatives leads to an accurate solution requiring only 2 spatial points per wavelength. | Wave propagation in the openPSTD software is implemented according to the extended Fourier PSTD method as presented in [http://scitation.aip.org/content/asa/journal/jasa/128/4/10.1121/1.3474234 Hornikx ''et al.'' 2010]. With this numerical method, the linearized Euler equations (LEE) are solved, which allow a detailed computation of sound propagation in moving inhomogeneous media and return the linear acoustic equations for a non-moving homogeneous propagation medium. In PSTD, the spatial derivatives arising in the LEE are computed in the wavenumber domain. This implies that a spatial Fourier transform is applied to the acoustic variables, and after an operation in the wavenumber domain, an inverse Fourier transform returns the derivatives. This way of computing spatial derivatives leads to an accurate solution requiring only 2 spatial points per wavelength. | ||

− | In openPSTD | + | In openPSTD, the total domain is decomposed into subdomains. The advantage of this decomposition is a higher geometrical flexibility, a lower computational complexity, it promotes object orienting programming and a parallel computational architecture. |

The computation of the horizontal spatial derivatives in a subdomain at the pressure positions is schematically depicted in the accompanied Figure. Three subdomains are needed to compute these derivatives. Prior to computing the derivatives, the variable values are multiplied by a window function. The accuracy of this technique is reported in [http://www.sciencedirect.com/science/article/pii/S0021999112001568 Hornikx ''et al.'' 2012], and increases with an increasing length of the decay of the single sided windows. | The computation of the horizontal spatial derivatives in a subdomain at the pressure positions is schematically depicted in the accompanied Figure. Three subdomains are needed to compute these derivatives. Prior to computing the derivatives, the variable values are multiplied by a window function. The accuracy of this technique is reported in [http://www.sciencedirect.com/science/article/pii/S0021999112001568 Hornikx ''et al.'' 2012], and increases with an increasing length of the decay of the single sided windows. | ||

− | Behind every edge, a boundary subdomain is included in openPSTD | + | Behind every edge, a boundary subdomain is included in openPSTD. This subdomain is not visible in the graphical interface in Blender. The waves propagate in the boundary subdomains and are absorbed by a perfectly matched layer (PML), see [http://scitation.aip.org/content/asa/journal/jasa/128/4/10.1121/1.3474234 Hornikx ''et al.'' 2010]. |

+ | |||

+ | The code is written in Python. Python takes as input a description of the boundary geometry and source and receiver positions, as it is compiled by the user interface in Blender. Python in turn outputs the resulting pressure values for the computational | ||

+ | grid as well as at specified receiver positions, which are read back into the user interface to be visualized there. | ||

== Results == | == Results == | ||

Computed results can be accessed in two ways. First, the 2D pressure field can be viewed as a function of time. This offers the possibility to interpret sound propagation in a qualitative way. The second possibility is to export the computed impulse responses at the receiver positions for further post processing. The broad band impulse responses can then be processed to frequency domain results and octave band values can be obtained. | Computed results can be accessed in two ways. First, the 2D pressure field can be viewed as a function of time. This offers the possibility to interpret sound propagation in a qualitative way. The second possibility is to export the computed impulse responses at the receiver positions for further post processing. The broad band impulse responses can then be processed to frequency domain results and octave band values can be obtained. | ||

− | ''' | + | |

+ | '''>> [[openPSTD v1.0 settings]]''' |

## Latest revision as of 10:41, 4 February 2016

## Contents |

## What can you model with openPSTD?

openPSTD provides a visual user interface that enables to compute sound propagation in a 2D geometry. With openPSTD, the 2D geometry, bounded by edges that (partly) absorb the sound waves, can be drawn in Blender. Sources of sound and receiver positions can freely be chosen within the geometry. Sound propagation is computed in openPSTD by numerically solving the linearized Euler equations, i.e. the partial differential equations that describe sound propagation in fluid flow in the time domain. The outcome of openPSTD is a visualisation of sound propagation, by a 2D animation and by the impulse responses at the position(s) of the receiver(s). As openPSTD is an open source software, we highly encourage contributions to the code.

## openPSTD releases

- openPSTD v1.0 has been launched in september 2014.
- openPSTD v1.1 has been launched in july 2015. This version is the GPU accelerated version of openPSTD v1.0.

## User Interface

The openPSTD interface is built as a add-on for Blender, a free and open source 3D modelling application. As such, it inherits the a lot of the functionality from Blender [1]. For a comprehensive step-by-step guide to model a geometry in Blender please see Getting started with openPSTD. For detailed instructions on how to use Blender, users are encouraged to find some of the tutorials available [2].

It is also possible to model a geometry without using the visual Blender interface. A guide can be found here: Command line simulations.

## Geometry, medium and boundaries

A geometry in openPSTD must be constructed out of a subsequent arrangement of rectangles (subdomains). The interface, at which the boundaries of two adjacent subdomains coincide, does not necessarily have to match the full length of both subdomain boundaries. Hence, subdomains can have multiple neighbors at a domain boundary and hence local refinement does not necessarily propagate throughout the entire topology. The density and speed of sound of the propagation medium can be defined in the openPSTD settings. A restriction of the method is the minimum dimension of the subdomains, which is equal to the **Grid spacing** multiplied by the **Window size** (see openPSTD v1.0 settings). Once the geometry has been constructed, the acoustic absorption coefficient α at the edges needs to be defined. The defined absorption coefficient corresponds to a real valued normalized surface impedance according to

The absorption coefficients are frequency independent. The default setting in openPSTD is that boundary reflections are independent on the angle of incidence. A locally reacting boundary can also be chosen, see openPSTD v1.0 settings. The reflection coefficient then becomes, in approximation (see van Renterghem *et al.* 2013).

with θ the angle of sound incidence relative to the normal to the interface.

## Source and receivers

The location of source(s) and receiver(s) can be chosen freely in the constructed geometry, see Getting started with openPSTD v1.0. Source(s) are modelled by initial pressures distributions with the following spatial Gaussian shape:

with , Δ the grid spacing in metres, *c* the adiabatic speed of sound in m/s, * x*=

*[x,z]*the 2D coordinate vector and

**x**_{s}the source position. The centre(s) of the Gaussian shape(s) thus corresponds to the defined centre(s) of the sources. Although receiver positions might not correspond to a dicrete position in the mesh, spectral interpolation allows to compute the response of the source(s) in the constructed geometry at an arbitrary location in the space.

## Mesh

In openPSTD, the geometry is discretised by an orthogonal equidistant grid, with **Grid spacing** in metres equal to the spacing of the grid points. Pressure grid positions are staggered by a half grid spacing with acoustic velocity grid positions, and the velocity position are located at the edges of a subdomain: horizontal velocity components are located at a vertical edge and vertical velocity components are located at an horizontal edge. When a geometry is drawn, a grid is created. If a dimension of a drawn subdomain does not correspond to an integer multiple of the **Grid spacing**, the subdomain is extended such that its size (in the respective direction) becomes an integer multiple of the **Grid spacing**.

.

## Solver

Wave propagation in the openPSTD software is implemented according to the extended Fourier PSTD method as presented in Hornikx *et al.* 2010. With this numerical method, the linearized Euler equations (LEE) are solved, which allow a detailed computation of sound propagation in moving inhomogeneous media and return the linear acoustic equations for a non-moving homogeneous propagation medium. In PSTD, the spatial derivatives arising in the LEE are computed in the wavenumber domain. This implies that a spatial Fourier transform is applied to the acoustic variables, and after an operation in the wavenumber domain, an inverse Fourier transform returns the derivatives. This way of computing spatial derivatives leads to an accurate solution requiring only 2 spatial points per wavelength.
In openPSTD, the total domain is decomposed into subdomains. The advantage of this decomposition is a higher geometrical flexibility, a lower computational complexity, it promotes object orienting programming and a parallel computational architecture.
The computation of the horizontal spatial derivatives in a subdomain at the pressure positions is schematically depicted in the accompanied Figure. Three subdomains are needed to compute these derivatives. Prior to computing the derivatives, the variable values are multiplied by a window function. The accuracy of this technique is reported in Hornikx *et al.* 2012, and increases with an increasing length of the decay of the single sided windows.
Behind every edge, a boundary subdomain is included in openPSTD. This subdomain is not visible in the graphical interface in Blender. The waves propagate in the boundary subdomains and are absorbed by a perfectly matched layer (PML), see Hornikx *et al.* 2010.

The code is written in Python. Python takes as input a description of the boundary geometry and source and receiver positions, as it is compiled by the user interface in Blender. Python in turn outputs the resulting pressure values for the computational grid as well as at specified receiver positions, which are read back into the user interface to be visualized there.

## Results

Computed results can be accessed in two ways. First, the 2D pressure field can be viewed as a function of time. This offers the possibility to interpret sound propagation in a qualitative way. The second possibility is to export the computed impulse responses at the receiver positions for further post processing. The broad band impulse responses can then be processed to frequency domain results and octave band values can be obtained.