transient_pressure()
Description: Calculates the transient pressure field from an arbitrary transducer array using the Fast Nearfield Method and Time-Space Decomposition or Frequency Domain Time-Space Decomposition, depending on the input signal.
Usage
pressure = transient_pressure(transducer_array, coordinate_grid, medium, time_struct,ndiv,\
excitation_function);
pressure = transient_pressure(transducer_array, coordinate_grid, medium, time_struct,ndiv,\
excitation_function, calculation_method);
Arguments
- transducer_array A transducer_array.
- coordinate_grid A coordinate grid struct like the ones created by set_coordinate_grid.
- medium A medium struct like the ones created by set_medium.
- time_struct A time samples struct created by set_time_samples.
- ndiv The number of integral points to use.
- excitation_function An excitation function created by set_excitation_function.
- calculation_method The pressure calculation algorithm to use. Options are:
- 'fnm' Fast Nearfield Method with Time-Space Decomposition
- 'fnm transient' Fast Nearfield Method without TSD
- 'rayleigh' Transient Rayleigh-Sommerfeld method
Output Parameters
- pressure A 3-d array representing the complex pressure at each point in space.
Notes
Advanced users may wish to use the individual calculation functions directly for access to more features and options.
FDTSD calculations are not as fast as TSD calculations. It is therefore recommended that users use one of the analytical TSD expressions if possible for the greatest speed.
This function only calculates pressures in lossless media, so any attenuation parameter set by the user will be ignored.